2026-11-16 14:17:00 Cyberbolt

DeepSeek Harness 上下文压缩插件:将 DSH 的会话历史渲染为图片,用图片代替文本摘要,保留更多信息并减少 token 消耗。
具体实现:DSH 触发上下文压缩时,保持首尾部分的原内容,将中段部分渲染成图片(渲染在本地完成,不需要调用模型),每份压缩结果旁附一份可复制的精确文本索引和 FILES 文件地图。
该插件适合长时间运行、需要反复回溯细节的会话。不适用于短聊天压缩。
快速开始: 插件 → 添加插件 → dsh-snapcompact → 新建会话 → Snapcompact (Standard)。
安装
需要 DSH 0.2.x 和 Node.js 24+。
打开 插件 → 添加插件。
安装 dsh-snapcompact。
如提示则重启,然后新建会话,选择官方模式对应的 Snapcompact 预设。
|
官方模式 |
对应的 Snapcompact 预设 |
|---|---|
|
标准模式 |
Snapcompact (Standard) |
|
PTC 模式 |
Snapcompact (PTC) |
|
创造模式 |
Snapcompact (Cordis) |
不支持极简模式——它刻意省略了 read/write/edit,Snapcompact 会违背它的设计目的。
卸载:在插件页面移除插件即可。它新增的预设会一起消失;已生成的压缩结果会作为普通摘要保留在会话中。
命令行:
dsh plugin --profile <你的 profile 名> add dsh-snapcompact
DSH Desktop 请优先使用应用内的插件页面。
其他安装来源 本地打包的 tarball 请执行: ```sh pnpm install --ignore-scripts pnpm pack dsh plugin --profile web add "file:$PWD/dsh-snapcompact-0.7.2.tgz" ``` tarball URL 请执行: ```sh dsh plugin --profile web add https://example.com/dsh-snapcompact-.tgz ``` npm 包是预构建选项,如果是本地 clone,需要先执行 `pnpm pack`(或 `pnpm run build`)。
为什么用图片代替摘要?
用图片代替摘要的思路来自 Oh My Pi 的 snapcompact;本插件是 snapcompact 在 DSH 上的独立实现。
视觉模型主要按图像面积计费,而不管图中有多少个字符。在可读上限内,密集帧每 token 能承载的信息量高于纯文本。我们将原本会压缩为文本摘要的内容渲染为图片,由此做到保留更多上下文的同时降低 tokens 消耗。
工作方式
DSH 选择安全区域 │ ▼ 确定性序列化(首尾上限、日志省略、精确 token 标记) │ ▼ snapcompact → shake → soft │ ▼ 一个压缩结果(checkpoint):首尾精确文本 + 帧 + 文本索引
|
顺序 |
方法 |
模型调用 |
输出 |
|---|---|---|---|
|
1 |
snapcompact |
无 |
密集帧、首尾精确文本、FILES 索引、精确 token 索引 |
|
2 |
shake |
无 |
超大工具输出只留首尾摘录,中间丢弃 |
|
3 |
soft |
原生摘要 |
DSH 原生文本摘要 |
snapcompact(顺序 1)只在两个条件同时成立时运行:
模型支持图片输入与计价。 此会话的路由(provider/model,例如 opencode-go/deepseek-v4.1-flash)要声明图片输入,并能确定图片计价:适配器提供价格、配置了显式的每帧上限,或对已知模型族使用带标签的保守估算。
完整 checkpoint 放得下。 整个 checkpoint 必须落在触发阈值以下的剩余空间内(阈值减去 system prompt、工具 schema、输出预留和保留尾部等不可替换部分)。
任一条件不成立,就会跳过 snapcompact,由方法链继续尝试下一个方法,最终落到原生摘要。
命令
|
入口 |
作用 |
|---|---|
|
/compact |
手动压缩;需要在 Snapcompact 预设内运行 |
|
/snapcompact status |
显示当前路由(provider/model)、触发阈值、保留尾部与可压缩空间,以及每个压缩方法能否运行 |
配置
在 插件 → Snapcompact 的设置卡中管理常用配置项。保存后只影响新会话,已有会话仍按创建时的配置运行。默认方法链为 [snapcompact, shake, soft],上下文窗口用到 80% 时触发,每次压缩最多渲染 40 帧;其余配置项需要手写 YAML,详见配置参考。
限制
不是无损压缩:渲染前后两个阶段都可能丢信息。
渲染成图时:位图字体覆盖不到的字符(emoji、生僻文字、组合符号)会显示成 ?;制表符展开为空格、连续空格折叠、ANSI 转义被剥掉。模型读的是像素而不是文本,64 位 digest 这类串不能指望从图里逐字读出。
渲染之前:序列化按固定规则省略,同一份历史每次省略的位置和数量都相同。
常规 INFO/PASS 行、堆栈调用行这类样板行,整行删除。
连续成片、结构相同的行(重复的文件清单、指标行)只留首尾各两行。
超长字段只留头尾、删去中段;帧中段文本预算不够时,保两端、舍中间。
每处省略都留下带计数的标记,如 […80ch elided…]、[…3 routine log lines elided…]。
不会丢的:错误、带标签事实、命令和路径将原样保留。
要逐字精确的内容,从文本取,不从图上取:首尾精确文本逐字保留;digest 这类读图不可靠的串收进文本索引。
是否更省 token 取决于上下文长度和所选模型。 短会话中原生摘要可能消耗更少的 token;视觉模型的图片 token 贵也可能会抵消优势。实测数据见评测结果。
压缩后不能回查。 逐字可取的只有首尾文本和文本索引;两处都没收录的字符串,事后找不回来。
排障
选择器里没有 Snapcompact 预设 确认插件已安装,按页面提示重启 DSH,然后新建**会话**,查找 **Snapcompact (Standard)**、**Snapcompact (PTC)** 和 **Snapcompact (Cordis)**。 总是回退到文本 运行 `/snapcompact status`。当前路由(provider/model)可能没有声明图片输入,或没有可用的图片计价,这是预期的安全行为。 压缩失败:"No compaction method produced a safe smaller checkpoint" 这表示每个方法(snapcompact、shake、soft)都被跳过,原因可能是缩得不够小或超出了预算。先运行 /snapcompact status,查看当前路由、可压空间和每个方法是否可用;然后等会话历史更多时重试,或换一个能正常运行的模型。错误信息会逐条列出各方法被跳过或失败的原因。
文档
开发
pnpm install --ignore-scripts pnpm run check pnpm pack
安装细节、安装检查和评测工具见贡献指南。
许可
原始应用代码为 MIT。捆绑的 GNU Unifont 18.0.01 数据保留 SIL Open Font License 1.1;Oh My Pi 的 snapcompact 设计参考为 MIT。见第三方声明。