前言¶
在 DeepSeek Harness(DSH)里做长任务时,上下文窗口逼近上限会触发压缩:主流程往往要停下来等摘要生成,再继续下一轮模型请求。对频繁工具调用、多轮推理的会话,这种停顿会反复出现。
社区插件 更快压缩 · Faster Compress(包名 dsh-faster-compress,维护者 GallenShao)在 DSH 侧提供后台上下文压缩:在达到准备阈值后于后台生成摘要,主任务在安全余量内继续推进;到 step 边界或下一次请求前再替换上下文。下面介绍其定位、能力与安装方式。插件归类为模型推理相关能力,在 SkillHub 目录页 可查看条目;目录为社区站点,与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-faster-compress 是为 DeepSeek Harness 编写的插件,核心目标是提前准备上下文摘要,从而减少长对话里因压缩产生的等待,并通过压缩历史查看摘要结果、耗时与 token 用量。
与「到点再压缩、主线程同步等待」相比,该插件在后台并行准备摘要,准备好后在合适时机应用,并保留失败时回退原生压缩的路径。摘要与预热请求沿用当前对话的模型与已有凭据,按模型服务商规则计费;默认即用,无需 API Key,也不用编辑 YAML。
运行环境要求:Node.js ≥ 22.19;README 标明已在 DSH 0.2.0-rc.2 / 0.2.1-rc.2 上验证。许可证为 MIT(见仓库 LICENSE)。
核心功能¶
边工作边准备,到点再应用¶
达到准备阈值后,插件在后台生成摘要,主任务在安全余量内可继续推进。在下一次模型请求前替换上下文,并保留期间新增的消息;正常回合结束后也会保留摘要,供下一轮校验复用。
失败兜底¶
摘要失败或失效时,回退 DSH 原生压缩逻辑,仍可使用 /compact。
压缩历史¶
在会话顶部打开 压缩历史,可查看:
- 内容与状态:摘要、原文摘录、是否已应用,以及失败原因;
- 耗时:后台准备、压缩等待与应用后的首输出时间;
- 用量:压缩前后实测输入 token,以及摘要请求和缓存用量。
支持搜索、筛选、复制,并跟随 DSH 主题。历史数据会写入 $DSH_HOME/data/faster-compress/traces/(摘要与原文摘录);隐藏历史标签不会停止记录。
可配置项¶
进入 插件 → 已安装 → 更快压缩 · Faster Compress,修改后保存即可生效,无需重启。常用项如下:
| 设置 | 默认值 | 用途 |
|---|---|---|
| 后台准备时机 | 100% | 摘要经常来不及时可调低;比例相对于准备阈值,并非上下文容量 |
| 预热新上下文 | 关闭 | 可选额外请求,适合服务有余力且能复用缓存时 |
| 显示压缩历史标签 | 开启 | 控制会话中是否显示历史页 |
通常保持默认即可;高级选项可调整输出预留、安全余量和并发数,升级会保留已有设置。
安装与启用¶
插件以当前 DSH 进程权限运行,安装前建议浏览 GitHub 源码 与许可证。
- 打开 DSH 侧边栏 插件 → 添加插件。
- 在输入框填入包名(README 原文,勿自行拼接
github:owner/repo):
dsh-faster-compress
- 点击安装,完成后重新启动 DSH。
若只用命令行(Web 配置),可执行:
dsh plugin --profile web add dsh-faster-compress
然后重新启动 dsh web。桌面端请使用应用内的「添加插件」。
典型用法¶
安装后无需额外配置文件即可工作。长对话或工具调用密集时,留意上下文用量;当后台摘要就绪,会在下一次模型请求前自动参与替换上下文。
需要排查或复盘时,打开会话顶部的 压缩历史 查看单次压缩的状态与用量。若摘要未赶上或失败,可继续使用 DSH 自带的 /compact 走原生压缩。
调整「后台准备时机」等项:进入已安装插件的设置页,保存后立即生效。
适用场景与注意¶
适合:长对话、频繁工具调用的 DSH 会话,希望减少「停下来等摘要」的次数,并需要可观测的压缩记录。
注意:
- 后台摘要仍占用模型资源并按服务商规则计费,不能保证消除所有等待。
- 未应用的摘要只保存在内存中;重启 DSH 后会重新准备,或回退原生压缩。
- 清理
$DSH_HOME/data/faster-compress/traces/中的历史副本时,应先停止 DSH,再删除该目录。
开发与测试说明见仓库 tests/README.md;更新与发布见 CHANGELOG.md、RELEASES.md。
结尾¶
dsh-faster-compress 把上下文摘要 preparation 挪到后台,在 step 边界再提交,并辅以压缩历史与可调准备时机,面向 DSH 长任务中的压缩等待问题。条目与分类见 SkillHub 目录,源码与安装说明见 GitHub:GallenShao/dsh-faster-compress。