前言¶

在 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 倉庫。