微清除压缩层 Perfirstvito/dsh-compaction-micro

dsh-compaction-micro

用于 DeepSeek Harness 压缩的独立微清除层。它会在自己的 microThresholdRatio 下——低于摘要阈值——将白名单内、可重复运行的工具结果清除为占位符，从而减少昂贵的模型摘要运行频率。它是一个观察者：它从不修改模型请求，不进行模型调用，并且每次重写都是单节点的 tool/result 内容替换，前面会有一个 compaction/prune 影子价格事件，因此持久日志始终是可重建的真相来源。

裁剪（修剪）和完整（摘要）仍由官方的 dsh-compaction-tool-result-pruner 和 dsh-compaction-basic 负责。

组合

将此 bundle 挂载在 dsh-compaction-basic 之前。它的 agent/pre-step 和 agent/request-error 监听器以 prepend: true 注册，因此无论挂载顺序如何，它们都会先运行：

- name: '@deepseek-ai/dsh-token-meter'
- name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
- name: '@deepseek-ai/dsh-compaction-basic'
config:
thresholdRatio: 0.9
- name: 'dsh-compaction-micro'
config:
clearableTools: [read, glob, grep, web_search, web_fetch]
retainRecent: 3
microThresholdRatio: 0.85
reservedTokens: 0

工作原理

1. agent/pre-step（prepend）：测量压力；当 totalTokens >= floor((contextWindow - reservedTokens) × microThresholdRatio) 时，从最旧的开始清除白名单内的工具结果，保留最新的 retainRecent 个可见。随后官方后端会重新测量更小的表面，并在清除已缓解足够压力时跳过摘要。
2. agent/request-error（prepend）：在确认上下文溢出时，先清除白名单内的结果，然后委托给官方的 prune + summarize + retry。

配置

| 字段 | 默认值 | 含义 |
| clearableTools | [] | 微层可清除其结果的工具名称。为空则禁用该层。仅列出只读、可重复运行的工具——该服务不会验证这一属性。 |
| retainRecent | 3 | 最新的可清除结果始终保留可见。 |
| microThresholdRatio | 0.85 | 在有效窗口的这一比例下清除。必须位于 (0, 1] 范围内。 |
| reservedTokens | 0 | 在缩放阈值之前从路由上下文窗口中减去的 token 数。 |
| auto | true | 安装自动监听器；false 仅暴露 ctx.microCompaction.clearSession()。 |

白名单由操作者拥有，是安全关口：read/glob/grep 和只读 web 工具是预期成员；write、edit、shell、子进程和工作流工具必须排除在外。

开发

通过将本地 DeepSeek Harness 检出中的工作区包 junction 到 node_modules/@deepseek-ai（参见该检出中的 packages// 和 vendor/*），然后针对它进行构建：

npm run typecheck # tsc -p tsconfig.json --noEmit
node --import tsx --test tests/micro.test.ts

运行时冒烟测试（从 DSH 检出中运行）：

dsh plugin --profile headless add link:
DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1 DEEPSEEK_API_KEY=mock-key \
dsh --profile headless "run the pwsh tool once and report"

许可证

MIT