前言¶

在 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。