上下文自动压缩subfocusx/utm-auto-compact

utm-auto-compact

DSH 上下文自动压缩插件，基于绝对 token 阈值触发。

内置的 dsh-compaction-basic 按模型窗口的 thresholdRatio（默认 0.8）进行压缩——当窗口非常大时，自动压缩几乎不会触发，用户只能手动按 /compact。本插件在 agent/status → idle 事件上调用同一个 seam（ctx.compaction.compactNow），当会话 surface 通过 ctx.tokenMeter 累积的 token 数 ≥ maxTokens 时触发。该阈值不依赖于模型窗口。

安装（DSH 配置文件）

在配置文件的 package.json 中：

"dependencies": {
"utm-auto-compact": "file:"
}

或者通过 GitHub 标签：

"dependencies": {
"utm-auto-compact": "github:/utm-auto-compact"
}

在 cordis.patch.yml 中：

utm-auto-compact:
config:
enabled: true
maxTokens: 45000

配置

| 键 | 类型 | 默认值 | 含义 |
|---|---|---|---|
| enabled | boolean | true | 开/关 |
| maxTokens | int > 0 | 30000 | 触发条件：当 surface ≥ 此值时压缩 |
| maxRetries | int ≥ 0 | 4 | 首次之外的额外尝试次数，直到 surface \node_modules\utm-auto-compact）：

cd ~/.dsh/profiles/
Copy-Item \test\run-tests.mjs .\_run-tests.mjs
node _run-tests.mjs
Remove-Item .\_run-tests.mjs

预期：24 passed, 0 failed。测试的 dig 日志会写入临时文件
（DSH_UTM_AUTO_COMPACT_LOG），不会向真实的 ~/.dsh/logs/ 写入任何内容。

限制

- 插件不决定压缩什么——这由 dsh-compaction-basic 引擎决定
（compactNow 会压缩几乎全部历史；尾部保留不会传递过来）。
- 会话中的手动 /compact 和自动插件共享同一个 seam：在自动尝试期间进行手动压缩
会得到 busy——静默处理，并会在 cooldownMs 后重试。
- “could not produce a smaller summary”——这是后端 summarizer 的限制，不是插件的
bug：在 failCooldownMs 之后我们会再次尝试。

License

MIT