前言¶
DeepSeek Harness（DSH）在處理長上下文時依賴自動壓縮來保持性能。官方的 dsh-compaction-basic 插件提供了基礎能力，但其 thresholdRatio（默認 0.8）是靜態配置，缺乏在對話過程中動態調整的入口。開發者在調試長上下文策略或針對不同模型調整壓縮力度時，往往需要修改配置文件或重啓服務。
這是什麼¶
@kuanfu0430/dsh-compaction-tune 是一個 DeepSeek Harness 客戶端插件，由用戶 kuanfu0430 維護。它爲 DSH 的自動壓縮功能增加了 Composer 級別的控制。核心作用是在不替換原有壓縮引擎的前提下，通過 UI 實時設置壓縮閾值，並將配置持久化到本地，在下一個 agent step 生效。
核心功能¶
該插件提供兩種閾值配置模式：
1. 百分比模式：允許設置 30% 到 80% 的上下文佔用率，默認爲 60%。
2. Token 模式：允許設置 64k 到 832k 的絕對 Token 閾值，步長爲 64k，默認爲 128k。
配置值會被寫入 $DSH_HOME/settings.yaml 的 kuanfu-compaction-tune 分節中。插件在宿主機層面暴露服務 kuanfuCompactionPolicy.resolve(session)，用於讀取當前會話的壓縮策略。同時，它提供了一組 API 路由 /compaction-tune/api/*，用於查詢設置和狀態。
安裝與啓用¶
安裝該插件需要 Deep Harness 的 Web profile。
dsh plugin --profile web add github:kuanfu0430/dsh-compaction-tune
安裝完成後，重啓 dsh web。在界面上，控制芯片會出現在 conversation.input.right（Composer 輸入框的右下角）。
典型用法¶
- 重啓
dsh web後，在會話輸入框右下角找到新增的壓縮控制芯片。 - 在芯片中選擇“百分比”或“Token”模式，輸入對應數值。
- 繼續進行對話或執行 Agent 步驟，新的閾值將在下一個步驟生效。
適用場景與注意¶
此插件適用於需要針對特定會話或模型動態調整壓縮策略的開發者。但在使用前需注意以下幾點：
- 依賴後端引擎：僅安裝此插件不會增加壓縮引擎。如果 Web profile 中未加載任何
ctx.compaction後端（如dsh-compaction-basic或dsh-compaction-anchored），芯片雖然可以保存設置，但會顯示無可用後端。 - 兼容性：已在 DeepSeek Harness 0.1.1-rc.2 上測試。不聲稱與 0.1.2-alpha 兼容，因爲該版本更改了會話 slot 和 Web token 閘門。
- 子會話隔離：子會話（例如側邊欄分支）不會繼承主聊天的閾值設置，它們保留後端默認的 80% 觸發機制。
- 百分比模式限制：在模型上下文窗口無法解析之前，百分比模式不會生效。
- 安全限制：
/compaction-tune/api/*路由僅允許迴環或 Profile 信任圍欄內的請求訪問，且響應不包含消息內容或憑證。 - UI 依賴：Composer 的
conversation.input.rightslot 是 0.1.1-rc.2 的契約。若後續版本移除此 slot，芯片將無法掛載。
短結尾¶
該插件通過 UI 和持久化配置填補了 DSH 壓縮策略在運行時調整的空白，適合需要在調試中靈活控制上下文壓縮力度的開發者。更多細節可查閱其目錄頁或源碼。
