前言¶

在 DeepSeek Harness（DSH）的智能体开发流程中，工具执行返回的长文本结果会不断累积，迅速填满模型上下文窗口。dsh-token-optimizer 插件提供了一种确定性、可恢复的压缩机制，用于处理这些冗余结果，并控制 token 消耗。

这是什么¶

这是一个由 Snow-ea 维护的插件，旨在为 DeepSeek Harness 提供确定性、可恢复的工具结果压缩和缓存感知压缩。它作为根级适配器管理压缩逻辑，并提供 Web 可视化界面。

核心功能¶

• 工具结果压缩：在结果反复进入模型上下文前进行压缩。
• PTC 日志压缩：压缩子调度日志副本，不改变 run_code 程序接收到的完整结构值。
• 可恢复归档：归档所有有损替换，并通过 retrieve_spill 接口提供精确、会话授权的恢复能力。
• 根级适配器：提供根级 BasicCompactionEngine 适配器，默认压缩比 62.5%，同时保留 DSH 的缓存感知重放、Session API 和路由图像账户。
• Web 仪表盘：通过分离的 Conversation、Renderer 和 Session 客户端契约，提供 Web 对话仪表盘。

安装与启用¶

插件依赖 DeepSeek Harness 0.2.0-rc.2。在 Web profile 下安装：

dsh plugin --profile web add dsh-token-optimizer@0.2.3

安装后需重启现有的 dsh web 进程。安装包会启用恢复、投影、Web 仪表盘以及所有四种智能体模式下的 62.5% 自动压缩引擎。

典型用法¶

插件的早期压缩由布尔值 compaction 控制（默认为开启）。

1. 禁用早期压缩：

    - id: dsh-token-optimizer
      config:
        compaction: false

禁用后，工具结果压缩、`retrieve_spill`、会话投影和仪表盘仍保持活跃，但根级 `ctx.compaction` 提供者及压力/溢出监听器将被注销。

2. 调整压缩阈值：

    - id: dsh-token-optimizer
      config:
        thresholdRatio: 0.5
        retainRatio: 0.16

注意：`retainRatio` 必须严格低于 `thresholdRatio`，否则上游引擎将拒绝加载。

注意事项¶

• 配置覆盖机制：Profile patch 会替换插件的整个 config，而非深度合并。若需修改部分配置，必须显式写出其他字段以保留默认值。
• 运行模式差异：在 Standard、PTC 和 Creator 模式下，该插件在隔离引擎之前运行，实现 62.5% 的压缩；Minimal 模式不使用预设压缩组，直接使用根引擎。
• 溢出子系统：插件使用 DSH 的溢出子系统（dsh-spill-local 和 dsh-spill-policy），并充当持久化归档的检索权威。
• 许可证：遵循 MIT 许可证。

结尾¶

该工具通过压缩策略与可恢复机制，帮助开发者有效管理 DSH 上下文膨胀。更多细节可参考插件目录或 GitHub 仓库。