压缩阈值调节 kuanfu0430/dsh-compaction-tune

@kuanfu0430/dsh-compaction-tune

为 DeepSeek Harness 自动压缩添加一个输入框控件：可设置百分比（30–80）或绝对 token 阈值。该值存储在 $DSH_HOME/settings.yaml 中的 kuanfu-compaction-tune 分节下，并在下一个 agent step 生效。

在 DeepSeek Harness 输入框旁加入自动压缩门槛控制：可设 百分比（30–80） 或 绝对 token 数。设置写入 $DSH_HOME/settings.yaml 的 kuanfu-compaction-tune 分节，下一个 agent step 生效。

本仓库的预定上架条目见 docs/awesome-dsh-plugin.yml。请等仓库满一天且提交数 ≥ 10 再向 awesome-dsh-plugin 发 PR。

本仓预定上架条目见 docs/awesome-dsh-plugin.yml。请等仓库满一天且提交数 ≥ 10 再向 awesome-dsh-plugin 发 PR。

这不是什么 / 這不是什麼

官方 @deepseek-ai/dsh-compaction-basic 已在插件 YAML 中有一个静态的 thresholdRatio（默认 0.8）。该字段没有对话中的控制。本插件是实时 UI / 基于 settings 的策略；它不替代压缩引擎，也不注册 /compact。

官方 @deepseek-ai/dsh-compaction-basic 已有插件 YAML 里的静态 thresholdRatio（预设 0.8），但没有对话中可调的控制。本插件是实时 UI／settings 政策，不取代压缩引擎，也不注册 /compact。

安装 / 安裝

已在 DeepSeek Harness 0.1.1-rc.2 上测试。不声称兼容 0.1.2-alpha（会话 slot 与 Web token 闸门已变更）。

已在 DeepSeek Harness 0.1.1-rc.2 验证。不宣称相容 0.1.2-alpha（会话 slot 与 Web token 闸门已变）。

dsh plugin --profile web add github:kuanfu0430/dsh-compaction-tune

重启 dsh web。控件出现在 conversation.input.right（输入框右下）。

重启 dsh web。控件挂在 conversation.input.right（输入框右下）。

根目录 package.json 声明了 dsh.bundle.patch 以及 cordis.patch.yml，因此 dsh plugin add 可以安装它。没有构建步骤。

根目录 package.json 已宣告 dsh.bundle.patch 与 cordis.patch.yml，可直接用 dsh plugin add 安装，无需编译。

行为 / 行為

- 百分比模式默认为 60%，范围 30–80%。
- Token 模式默认为 128k，范围 64k–832k，步长 64k。
- Host 平面服务 kuanfuCompactionPolicy.resolve(session) 返回冻结的 { mode, percent, tokens }。设置了 parentSession、origin !== 'subagent' 且 seedLength === 0 的子会话（例如侧边栏分支）会得到 null；这些会话保留后端 80% 的默认值。
- 官方后端（@deepseek-ai/dsh-compaction-basic）：当已用 token 越过有效阈值且低于 80% 安全上限时，本插件会调用 compactIfNeeded(agent, 'context-overflow')。必须使用 overflow 触发器，因为官方压力监听器仍然以 80% 为门槛。如果有效阈值已经处于 80% 上限，本插件不会触发，官方监听器仍是唯一的触发器。
- 可选锚定后端（@kuanfu0430/dsh-compaction-anchored）：如果加载了该后端，本插件不会注册第二个触发器。它仅暴露策略服务，供锚定引擎读取。
- 高于当前模型窗口 80% 的 token 阈值在 UI 和官方回退触发器中都会被限制。
- /compaction-tune/api/* 下的宿主路由仅限于回环地址 / 配置文件信任围栏。响应包含设置、token/窗口元数据、后端身份和压缩状态——不包含消息内容或凭据。

限制 / 限制

- 仅安装本插件不会添加压缩引擎。Web 配置文件已自带 compaction-basic；在没有任何 ctx.compaction 的情况下，chip 仍会保存设置，但会显示没有可用后端。
- 在无法解析所路由模型的上下文窗口之前，百分比模式不会生效。
- 上述子会话永远不会继承主聊天阈值。
- 编辑器插槽 conversation.input.right 是 0.1.1-rc.2 契约。如果后续 DSH 构建移除了该插槽，chip 将无法挂载。

开发 / 開發

node --check index.js client.js
node ./test.mjs

许可证

MIT