前言¶
DeepSeek Harness（DSH）在处理长上下文时依赖自动压缩来保持性能。官方的 dsh-compaction-basic 插件提供了基础能力，但其 thresholdRatio（默认 0.8）是静态配置，缺乏在对话过程中动态调整的入口。开发者在调试长上下文策略或针对不同模型调整压缩力度时，往往需要修改配置文件或重启服务。
这是什么¶
@kuanfu0430/dsh-compaction-tune 是一个 DeepSeek Harness 客户端插件，由用户 kuanfu0430 维护。它为 DSH 的自动压缩功能增加了 Composer 级别的控制。核心作用是在不替换原有压缩引擎的前提下，通过 UI 实时设置压缩阈值，并将配置持久化到本地，在下一个 agent step 生效。
核心功能¶
该插件提供两种阈值配置模式：
1. 百分比模式：允许设置 30% 到 80% 的上下文占用率，默认为 60%。
2. Token 模式：允许设置 64k 到 832k 的绝对 Token 阈值，步长为 64k，默认为 128k。
配置值会被写入 $DSH_HOME/settings.yaml 的 kuanfu-compaction-tune 分节中。插件在宿主机层面暴露服务 kuanfuCompactionPolicy.resolve(session)，用于读取当前会话的压缩策略。同时，它提供了一组 API 路由 /compaction-tune/api/*，用于查询设置和状态。
安装与启用¶
安装该插件需要 Deep Harness 的 Web profile。
dsh plugin --profile web add github:kuanfu0430/dsh-compaction-tune
安装完成后，重启 dsh web。在界面上，控制芯片会出现在 conversation.input.right（Composer 输入框的右下角）。
典型用法¶
- 重启
dsh web后，在会话输入框右下角找到新增的压缩控制芯片。 - 在芯片中选择“百分比”或“Token”模式，输入对应数值。
- 继续进行对话或执行 Agent 步骤，新的阈值将在下一个步骤生效。
适用场景与注意¶
此插件适用于需要针对特定会话或模型动态调整压缩策略的开发者。但在使用前需注意以下几点：
- 依赖后端引擎：仅安装此插件不会增加压缩引擎。如果 Web profile 中未加载任何
ctx.compaction后端（如dsh-compaction-basic或dsh-compaction-anchored），芯片虽然可以保存设置，但会显示无可用后端。 - 兼容性：已在 DeepSeek Harness 0.1.1-rc.2 上测试。不声称与 0.1.2-alpha 兼容，因为该版本更改了会话 slot 和 Web token 闸门。
- 子会话隔离：子会话（例如侧边栏分支）不会继承主聊天的阈值设置，它们保留后端默认的 80% 触发机制。
- 百分比模式限制：在模型上下文窗口无法解析之前，百分比模式不会生效。
- 安全限制：
/compaction-tune/api/*路由仅允许回环或 Profile 信任围栏内的请求访问，且响应不包含消息内容或凭证。 - UI 依赖：Composer 的
conversation.input.rightslot 是 0.1.1-rc.2 的契约。若后续版本移除此 slot，芯片将无法挂载。
短结尾¶
该插件通过 UI 和持久化配置填补了 DSH 压缩策略在运行时调整的空白，适合需要在调试中灵活控制上下文压缩力度的开发者。更多细节可查阅其目录页或源码。
