前言¶
DeepSeek Harness (DSH) 採用插件化架構，社區生態中提供了多種工具來擴展智能體能力。在上下文管理方面，官方默認的壓縮後端（compaction-basic）每次壓縮都會讓模型重新總結舊對話，這不僅消耗額外的 token，且結果不穩定。dsh-dcp 針對這一痛點，提供了一個確定性壓縮後端。
核心定位¶
dsh-dcp 是由 fan56 維護的 DSH 插件，定位爲確定性上下文剪枝壓縮後端。它不調用 LLM 進行摘要，只保留對話中出現的事實（如路徑、命令、報錯、用戶原話），因此輸出穩定，相同輸入永遠得到相同結果。
核心功能¶
該插件主要解決以下問題：
- 零 LLM 調用摘要：壓縮過程本身不消耗任何額外 token。
- 輸出穩定：去除了 LLM 生成的不確定性。
- 中文友好：內容逐字保留，不做英文轉寫；按 CJK 真實密度計價（中/日/韓/全角約 2 字符/token），而非沿用宿主的低估值。
- 機制繼承：繼承了 DSH 官方的安全機制、觸發策略、保留尾巴與事務鎖，檢查點格式兼容。
- 命令支持：提供
/dcp命令用於壓縮、查看狀態和調參。
安裝與啓用¶
安裝過程非常簡單，使用 npm 即可完成。
1、安裝插件包：
npm i @aiwayds/dsh-dcp
2、運行初始化腳本：
npx dsh-dcp-setup
該腳本會自動處理配置備份和冪等判斷，確保安裝過程安全且不覆蓋現有配置。
使用方法¶
插件掛載後，可以在會話中直接使用 /dcp 命令：
/dcp：立即壓縮歷史上下文（零 LLM 調用）。/dcp status：查看當前配置和節省的 token。/dcp set dedup true：在會話內動態調整參數。
插件支持多種觸發條件，包括壓力觸發、溢出恢復、輪數觸發（默認每 50 條 assistant message 觸發一次）以及模型切換觸發。
卸載¶
如需卸載，請使用官方提供的腳本或 DSH 插件管理命令。
通過腳本卸載：
npx dsh-dcp-setup --remove
通過 DSH 插件管理：
dsh plugin remove @aiwayds/dsh-dcp
注意事項¶
- 版本要求：本插件要求 DSH 版本 >= 0.1.7-rc.1，不再支持 alpha 線。
- 功能範圍：插件不做語義歸納，只保留出現的事實。需要深度語義摘要的場景，建議繼續使用官方的
compaction-basic。 - 計價機制：默認按 CJK 真實密度計價，中文場景下不會出現 token 預算被餓死的情況。
結語¶
dsh-dcp 適合需要穩定、低成本上下文壓縮的場景，特別是中文對話。它通過代碼替代 LLM 調用，大幅降低了上下文管理的成本。
