dsh-tool-error-hints

工具调用失败时，报错往往只说「不存在」，却不告诉你「哪儿存在」。弱一些的本地模型尤其容易在绝对路径上反复瞎猜，甚至把已经纠正过的错误路径再错好几遍。dsh-tool-error-hints 挂在 tools/post-execute 流水线上，只在失败结果之后追加一条可执行的上下文提示，不改写工具原始输出。

它会按失败类型给出有针对性的线索：路径不存在时列出最近的已存在祖先目录及其内容，并附带工作区根提示；命令不存在时说明容器内可能没有该可执行文件并建议先用 command -v 探测；权限不足时提醒非 root 环境下 sudo、apt-get 或写 /var 会失败；把目录当文件读时提示改用 ls。对 grep 无匹配等合法空结果，插件用 STRONG/WEAK 两级证据过滤，避免把正常输出当成错误。

设计上坚持只读（existsSync、readdirSync、statSync），绝不执行命令或写文件；提示通过 additionalContexts 追加，异常全部吞掉，以免影响正常工具流程。自测用例覆盖真报错与零误伤场景。

适合在 DeepSeek Harness 里跑长任务、工具失败率偏高，或模型容易在路径与容器环境上「猜错又重复猜」的开发者与运维场景。