dsh-compact
DeepSeek Harness 上下文自动压缩、手动压缩与溢出恢复插件
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zixin947/dsh-compact#dc0f63ea5942308c83607a3f99418d6bdfabea69Compact 以 dsh-compact 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-compact 是面向 DeepSeek Harness 的上下文压缩插件，用于在对话接近模型上下文上限时自动生成检查点摘要，并在发生上下文溢出时进行有界恢复。
该插件最初随 Deepseek Harness EAC 开发，独立仓库用于单独维护和分发插件本体。
/compact 命令和设置页中的手动压缩入口。当包含该插件的 EAC 版本正式发布后，插件会作为内置组件安装，不需要重复添加。
完全退出正在运行的 DSH 服务，然后执行：
dsh plugin --profile web add "github:zixin947/dsh-compact#main"
安装完成后重新启动 DSH Web 服务。
默认挂载配置由 cordis.patch.yml 提供：
- id: compact
name: 'dsh-compact'
如果目标 Agent preset 需要独立的 Agent 级压缩入口，可以在对应组合中挂载：
- id: compact-agent
name: 'dsh-compact/agent'
isolate:
compaction: true
toolResultPruner: true
dsh-compact/agent 会在同一个 Agent 局部作用域中组合压缩引擎、/compact 命令和工具结果裁剪器。
| 配置项 | 默认值 | 说明 |
|---|---|---|
enabled | true | 是否启用自动压缩和溢出恢复 |
thresholdRatio | 0.75 | 上下文达到模型窗口的 75% 时触发自动压缩 |
retainRatio | 0.20 | 压缩后保留最近约 20% 的上下文 |
recoverOnOverflow | true | 上下文溢出时是否尝试压缩恢复 |
maxOverflowRetries | 1 | 原请求发生溢出后允许的最大恢复重试次数 |
modelPolicies | [] | 按 provider 和 model 精确覆盖默认策略 |
示例：
- id: compact
name: 'dsh-compact'
config:
enabled: true
thresholdRatio: 0.75
retainRatio: 0.20
recoverOnOverflow: true
maxOverflowRetries: 1
modelPolicies:
- provider: youchu
model: deepseek-v4-flash
thresholdRatio: 0.80
retainRatio: 0.20
约束：
thresholdRatio 允许范围为 0.50 到 0.95。retainRatio 允许范围为 0.05 到 0.50。retainRatio 必须小于对应的 thresholdRatio。provider + model 精确匹配。每次 Agent 请求开始前，插件读取当前模型的上下文窗口和会话 Token 估算值。达到触发阈值时：
每次压力检查只进行一次压缩。如果压缩后仍高于阈值，当前请求不会立即进行第二轮摘要；后续普通请求仍可再次触发压缩。
当模型明确返回上下文窗口超限错误时，插件可以压缩当前会话并重试原请求。恢复次数受 maxOverflowRetries 限制，取消中的请求不会重试，也不会无限循环。
如果首次摘要调用成功返回但没有任何文本，插件会删除用于普通 Agent 工作的 system prompt 和工具定义，再使用相同会话消息重试一次。其他模型或网络错误不会被误判为可重试的空摘要错误。
| 入口 | 用途 |
|---|---|
dsh-compact | 设置、状态接口和默认插件入口 |
dsh-compact/agent | 组合压缩引擎、命令和工具结果裁剪器 |
dsh-compact/engine | 压缩引擎入口 |
dsh-compact/client | Web 设置界面入口 |
一般使用者只需要挂载 dsh-compact 或 dsh-compact/agent，不建议单独挂载内部实现入口。
@deepseek-ai/dsh 0.1.0-rc.7 及相同插件 API 的版本。发现问题时，请在 GitHub Issues 提交，并尽量附上：