dsh-compact
按比例精确触发的上下文压缩闸门（DeepSeek Harness 插件）。
DSH 原生在窗口用掉约 67.85% 时就开始压缩；本插件让它等到你设定的比例（默认 90%）。
触发点 = floor(窗口 × triggerRatio) ← 没有固定余量扣减
为什么需要它
DSH 0.2 把压缩引擎挂在 agent preset 里，带出厂默认 thresholdRatio: 0.8 /
headroomTokens: 65536。preset 平面任何 patch 层都够不到，所以原生触发点是：
min(W × 0.8, W − O − 65536)
在 1M 窗口 + 256K 输出预留下 = min(800000, 678464) = 678,464 = 67.85%。
你配置的比例从来不是生效的那一项。本插件绕过该公式，用 floor(W × ratio) 做闸门。
实现方式：agentPresets.serviceFor(agent,'compaction') 取到 preset 作用域的活引擎，
包住它的 compactIfNeeded；阈值以下返回 null（引擎不被调用），阈值以上原样交还。
agent/request-error 的溢出恢复永不拦截。
不改 DSH 配置文件、不改 preset、不写盘（除监视器）。卸载即完全恢复原生行为。
配置
全部走 profile 的 cordis.patch.yml（本插件是纯 host 插件，没有 GUI 设置面板）：
- id: dsh-compact
config:
enabled: true
routes: '*'
triggerRatio: 0.9
minOutputReserve: 0
dryRun: false
monitorPath: '/dsh-compact-monitor.jsonl'
| 字段 | 默认 | 含义 |
|---|---|---|
enabled |
true |
总开关 |
routes |
'*' |
生效路由：provider 或 provider/model，逗号/空格分隔 |
triggerRatio |
0.9 |
窗口用到此比例时压缩，范围 [0.05, 0.98] |
minOutputReserve |
0 |
输出保护底线（token）：剩余空间低于它则提前压缩；0 = 关闭 |
dryRun |
false |
true = 只记录判定、绝不压缩 |
monitorPath |
系统临时目录 | 判定监视器（JSONL）。空则不写 |
monitorPath 是必要的
被抑制的检查既不调用引擎、也不写会话事件，所以在会话日志里完全不可见。
监视器是唯一的观测通道，每行一条判定：
{"decision":"skip","contextWindow":1000000,"reservedCompletionTokens":256000,
"thresholdTokens":900000,"nativeThresholdTokens":678464,
"measuredTokens":14113,"surfaceTokens":11864,"pendingTokens":2249}
thresholdTokens= 本插件阈值；nativeThresholdTokens= DSH 原生阈值decision:"skip"且measuredTokens ≥ nativeThresholdTokens即：插件拦下了一次原生本会执行的压缩
安装
只需在插件页装上，不用改任何配置文件。 schema 默认值即目标配置：
enabled: true、triggerRatio: 0.9、routes: '*'、minOutputReserve: 0、dryRun: false。
命令行等价写法（CLI 会写 dependencies 与 dsh.profile.bundles）：
dsh plugin --profile web add 'dsh-compact@file:D:/桌面/DSH与自动化/dsh-compact'
要改 triggerRatio 等值时才需要在 profiles//cordis.patch.yml 加一行
（本插件是纯 host 插件，没有 GUI 设置面板）：
- id: dsh-compact
config:
triggerRatio: 0.9
monitorPath 默认 /logs/dsh-compact-monitor.jsonl，目录会自动创建。
关于热插拔
- 配置改动是热的：
cordis.patch.yml由profileReload: live+ HMR 的配置监听生效，无需重启。 - 启用/禁用是热的：插件页的开关会启用/停用该行。
- 改插件源码不是热的——因为 base bundle 的
hmr行默认root: []（只监听配置，不监听模块）。
这对本机所有插件一视同仁。若要让源码也热重载，在 profile patch 里放开监听：
- id: hmr
disabled: false
config:
root: ['.', 'D:/桌面/DSH与自动化/dsh-compact']
验证状态
- 31 项测试全过（策略 11 + host 接线 10 + 验收 10）
- 对照实验已通过（窗口 80000、输出预留 1000，只改插件比例）：
| A 组 ratio 0.05 | B 组 ratio 0.9 | |
|---|---|---|
| 引擎原生阈值 | 13464 | 13464 |
| 插件阈值 | 4000 | 72000 |
| 实测 | 14063 | 14113 |
| 决策 | delegate | skip |
| 会话压缩事件 | 有（start+summary+end） | 无 |
B 组在实测已超过原生阈值的情况下被拦下，引擎零调用；A 组同样实测下引擎真的压了。
已知局限：上述对照在 W=80000 下完成；真实 1M 部署走同一代码路径，但未在 1M 下观察到压缩。
开发中修掉的三个缺陷（都曾让它静默空转）
| # | 缺陷 | 后果 |
|---|---|---|
| 1 | setSource 整体替换配置 |
settings 文档没有 monitorPath → 监视器静默失效 |
| 2 | routedTarget 只读已记录 envelope |
首个请求前 config:null → 闸门永久早退 |
| 3 | 用 measure(session) 当压力 |
pre-step 时消息未入 surface → 恒为 0，永远放行 |
第 3 个意味着插件在修复前从未真正抑制过一次压缩。三个缺陷各有回归测试锁住。
测试
node --test test/policy.test.js test/index.test.js test/acceptance.test.js
需要 @deepseek-ai/schemastery 可解析。本目录已有 junction 指向 DSH 依赖树；
装进 profile 后由 DSH 自己的依赖树满足（verifiedWith: 0.2.0-rc.2）。
边界
- 只拦自动压力检查；溢出恢复与手动
/compact不受影响 - 不改剪枝（
dsh-compaction-tool-result-pruner是另一个插件）；触发点推后，剪枝也随之推后 routes为空字符串 = 停用闸门（不干预任何路由），不会回退到*
