前言¶

在 DeepSeek Harness (DSH) 開發中，每個可見的工具定義都會在每次請求中消耗輸入 token。頻繁更改工具列表會改變請求前綴，從而減少上下文緩存的重用。漸進式披露需要同時具備兩個屬性：一個小的初始請求，以及一個跨後續請求的字節穩定的工具和系統前綴。

dsh-progressive-tools 插件通過默認的 stable-proxy 模式提供這種契約：發送小而固定的工具表面，將完整目錄保留在進程內存中，並通過常規 Harness 管道執行發現的工具。

插件介紹¶

名稱：dsh-progressive-tools
所有者：everclear077
許可證：MIT
定位：Cache-stable progressive tool discovery for DeepSeek Harness。

核心功能¶

該插件提供了一套完整的工具管理機制，主要包括：

• 穩定代理模式：發送小而穩定的工具表面，保持完整目錄在進程內存中。
• 真實管道執行：通過常規 Harness 管道執行發現的工具。
• 可搜索目錄：搜索更改對話歷史，而非頂層工具列表。
• 凍結請求表面：確保請求表面在多次調用中保持穩定。
• 延遲目錄：將完整目錄保留在進程內存中。
• 安全與控制：支持審批、守衛、參數驗證、超時包裝器、結果策略、延遲上下文和取消。

安裝與依賴¶

該插件作爲 Cordis 插件運行，需要滿足特定的運行環境。

依賴項：

{
  "@deepseek-ai/cordis": "~4.0.4",
  "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
  "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
  "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.1",
  "@deepseek-ai/dsh-tools": "0.2.0-rc.1"
}

運行環境：
* Node.js：^22.19.0 或 >=24.0.0
* 包管理器：pnpm@11.19.0

典型用法¶

在實際配置中，可以通過以下方式啓用插件的核心能力：

1. 使用 stable-proxy 模式發送小而穩定的工具表面。
2. 將完整目錄保留在進程內存中，通過常規 Harness 管道執行發現的工具。
3. 搜索更改對話歷史而非頂層工具列表。
4. 設置 maxResults: 2 以減少可見工具的數量。
5. 啓用審批、守衛、參數驗證、超時包裝器、結果策略、延遲上下文和取消。

適用場景與注意¶

該插件在常規文件和編碼工作場景下效果顯著。測量數據顯示，在 100 個回合的測試中：

• 可見工具：從 71 個減少到 9 個（減少 87%）。
• 緩存讀取 Token：從 3,133,428 減少到 663,687（減少約 79%）。
• 總延遲：從 45.2 秒降低到 20.9 秒（降低約 54%）。

注意事項：
* 由於發現結果進入對話歷史，未緩存輸入 Token 可能會增加約 20%。
* S8 評分器將 tool_search 視爲失敗，可能導致評分不準確。
* 計費通常按緩存讀取而非新鮮輸入的較低費率計算。

結尾¶

DSH Progressive Tools 通過引入穩定代理模式，解決了工具定義對上下文緩存穩定性的影響。它減少了可見工具數量，顯著降低了緩存讀取 Token 和延遲，適合需要穩定性和性能優化的 DeepSeek Harness 管道。

倉庫：https://github.com/everclear077/dsh-progressive-tools
目錄：https://www.skillhub.cn/plugins/everclear077/dsh-progressive-tools