dsh-compaction-policy-engine
在终端中运行以下命令:
dsh plugin install T-splines/dsh-compaction-policy-engine
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install T-splines/dsh-compaction-policy-engine,从 https://github.com/T-splines/dsh-compaction-policy-engine 安装并在 agent 作用域正确挂载 compaction-control 引擎行。
插件介绍
当你的网关暴露大量模型 id,或多条路由共享同一套压缩策略时,官方 compaction 引擎的 modelPolicies 只能逐个写死 (provider, model) 对:新模型会静默落回全局阈值,维护成本高且容易踩坑。dsh-compaction-policy-engine 是 @deepseek-ai/dsh-compaction-basic 的子类,在保留选区、工具配对、摘要框架与落盘事务等官方语义的前提下,用 models[] → providers{} → default 三层结构做逐字段解析——一条供应商规则即可覆盖该 provider 下全部模型,模型层也可以只改 threshold,其余字段从上层继承。
核心能力围绕「可运营的分层策略」展开:threshold / retain 支持按比例或绝对 token 双单位,并按路由声明的窗口换算,没有窗口时不猜测而在真正需要策略时点名报错;设置面板与 settings.yaml 热加载(约每秒轮询),改策略不必重启即可在下次压缩生效,并与挂载行 config 做部分文档合并,避免面板保存抹掉 profile 里的 models[]。摘要侧提供 summarizationFallback 回退链,companion 还会注册上下文策略提示词,避免模型因误判「快满」而擅自停工;手动 /compact 以持久事务运行,断线不中断,失败原因如实上报。
适合在 DSH 0.2.2-rc.x、Node 20+ 环境下,已用或打算用官方压缩引擎、但需要跨很多路由做统一或分层阈值治理的团队与个人:少量精确 (provider, model) 覆盖继续用官方 modelPolicies 即可;当你需要供应商级兜底、热调策略、会话徽标观测触发层与摘要路由时,再选用本插件。挂载时务必在 agent 实际解析 ctx.compaction 的 realm 上替换引擎行,避免与 compaction-basic 双引擎并存导致异常早触发。
使用场景
- 网关暴露大量模型 id,需要按供应商统一阈值而不用逐个枚举
- 多条路由共享同一套 retain / 摘要策略,希望模型层只改 threshold
- 需要在不重启的前提下热调压缩策略,并用会话徽标观察触发层与摘要路由
适合人员
- 在多路由 DSH agent 上运维上下文窗口与压缩阈值的平台同学
- 维护 web / headless preset 并需要正确挂载 ctx.compaction 的集成开发者
- 已从 compaction-basic 迁移、需要供应商层与设置面板治理策略的高级用户