長期運行的智能體任務會積累大量工具輸出，導致上下文迅速膨脹。DeepSeek Harness 的設計理念是“一切皆插件”，允許在不修改核心代碼的情況下擴展上下文管理能力。dsh-context-compression-improved 是 dsh-context-compression-selector 的改進分叉，專注於提供可審計的工具結果上下文壓縮策略，並新增了正交的代碼骨架壓縮門。
這是一個爲 DeepSeek 模型優化的上下文壓縮選擇器插件。它通過預壓縮、聚合替換、歷史緊湊等機制減少上下文長度。與上游的主要區別是增加了代碼骨架壓縮門，專門處理超大源代碼工具結果，在保留關鍵聲明的同時大幅縮減冗餘代碼體。
核心功能¶
該插件提供多種壓縮策略，均記錄了決策日誌（階段、壓縮器、觸發條件、跳過原因及 token 數）：
- Fresh 預壓縮：在模型接收新工具結果之前，先對超大的結果段進行壓縮。
- Aggregate 預壓縮：當工具結果材料增長超過預算時，再次對新鮮材料進行壓縮。
- 歷史 / 微緊湊：用符合條件的舊工具結果替換當前結果，同時保留最近的上下文。
- TailTrim：可選的自定義尾部減少路徑。
- Native profile：顯式保留 Harness 風格的 head/middle/tail 剪切。
- 代碼骨架門：這是新增的正交功能。當啓用時，超大源代碼工具結果（如
read_file）首先嚐試骨架減少：保留導入和類型/函數/類聲明，省略函數體，但保留函數體中的錯誤行。如果骨架無法生成或驗證，則回退到原始頭部修剪。
安裝與啓用¶
通過插件安裝：
dsh plugin --profile web add dsh-context-compression-improved@dsh-0.2.0
安裝後，進入 Harness 的設置界面。在“Context Compression Selector”設置區域，選擇一個壓縮配置文件，設置“Auto Compact trigger level”，並切換“Code skeleton compression”開關。該開關默認爲關閉狀態。
適用場景與注意¶
- 模型支持：僅支持 DeepSeek 系列模型，包括
deepseek-v4-flash、deepseek-v4-pro和deepseek-v4-flash-vision-exp。插件依賴官方 DeepSeek 分詞器進行無損測量和有損壓縮。如果缺少正確的分詞器，插件會回退到保留原始結果。 - 代碼骨架默認關閉：配置項爲
codeSkeleton: { enabled: false }。只有手動開啓後，對超大源代碼結果纔會生效。 - 會話凍結：設置修改後，僅對新建的會話生效，已運行的會話配置不變。
- 代碼格式：
codeSkeleton配置項必須是{ enabled: boolean }格式，格式錯誤會在運行時拋出異常。
該插件通過分層壓縮策略和代碼骨架門，幫助開發者控制上下文長度，提升 DeepSeek 模型的推理效率。項目遵循 MIT 許可證，源碼託管在 GitHub。
