dsh-faster-compress:后台提前准备上下文摘要,减少长对话压缩等待

前言

在 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 源码 与许可证。

  1. 打开 DSH 侧边栏 插件 → 添加插件。
  2. 在输入框填入包名(README 原文,勿自行拼接 github:owner/repo):
dsh-faster-compress
  1. 点击安装,完成后重新启动 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。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜