前言¶

在 DeepSeek Harness (DSH) 中，工具調用失敗往往意味着一次完整的模型重試：錯誤返回，模型重讀整個對話上下文，然後嘗試再次執行。在大型工作區中，這種重試會重新提交約 180k 輸入 token。約 5% 的失敗率會將 token 賬單增加 2 倍以上。merenguesl/dsh-tool-normalizer 插件位於 tools/execute 流水線上，在調用到達模型之前進行修復：填充缺失的 description，執行被遺忘的文件讀取並重試編輯，解析相對路徑，並追加可操作的提示。

插件簡介¶

此插件充當模型工具調用的自愈層，在它們到達模型之前修復失敗。

• 維護者：merenguesL
• 許可證：MIT
• 工作位置：tools/execute 流水線
• 附加功能：包含一個 Web UI 診斷儀表板

核心功能¶

插件提供以下能力：

1. Schema Auto-Healing
   將命令包裝進 run_code，填充缺失的 description，並移除 Markdown 圍欄。

2. Code-Mode Direct Tool Bridging
   重新調度 UNKNOWN_TOOL 調用。

3. Range & Path Normalizer
   解析相對路徑並檢查邊界。

4. Real-Time Telemetry & Statistics Tracker
   實時遙測與統計追蹤。

使用示例¶

• 修復 schema 不匹配，例如將 command 轉換爲 code，或填充缺失的 description。
• 重試安全的文件變異和有界範圍重試。
• 在設置中查看 KPI 卡片、排名和追蹤。

安裝與啓用¶

通過 GitHub 安裝：
https://github.com/merenguesL/dsh-tool-normalizer

適用場景與注意¶

• 適合需要高可靠性的 DSH 開發者。
• 插件在當前 DSH 進程權限下運行。
• 安裝前請檢查源碼與許可證。

結語¶

此插件通過自動修復工具調用錯誤來減少重試輪次和 token 成本，提高 agent 穩定性。詳情請參閱 GitHub。