DeepSeek Harness Plugin Hub

发布与管理完整 Harness Profiles,发现适合你的插件。

探索

插件目录环境预设文档中心动态

社区

发布插件联系我们报告问题

相关链接

Plugin Hub GitHubDeepSeek Harness 官方项目系统状态隐私说明
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

独立、非官方社区项目,与 DeepSeek 官方无隶属、授权或背书关系。

Tool Error Hints — DeepSeek Harness 插件(DSH Plugin)
← Plugins
T

dsh-tool-error-hints

Tool Error Hints

给失败的工具结果追加可执行提示(路径不存在时给出最近的已存在目录),治弱模型瞎猜路径

插件会安装到这里;不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:ikta2010/dsh-tool-error-hints#def96301372e2e8f30bdebedb30efff0b98b2710
README兼容性版本

兼容性与来源证明

Tool Error Hints 以 dsh-tool-error-hints 发布,当前版本为 0.1.0。Plugin Hub 会校验它的 manifest,并保存精确安装来源,便于复现安装结果。

DSH 兼容范围
*
运行环境
any
发布来源
github
Registry 更新时间
2026/9/19

版本

0.1.0stable
2026/9/19

相关插件

正在加载相关插件…

最新版
0.1.0
DSH
*
HMR
重启进程
Tree shaking
未声明可安全裁剪
解包体积
未提供
文件数
未提供
Surface
any
许可证
MIT
发布源
github
GitHub
★ 0
周下载
0
最近提交
2026/9/18
查看源码 ↗
README Badge

点击下方 Badge 复制 Markdown,粘贴到 README 即可。

这是你的 Plugin?认领权益 · 优先安全扫描

验证 package.json 声明的 GitHub 仓库,即可管理这个公开页面。认领后,Hub 会优先安排当前版本的安全扫描,并在通过后公开展示结果。

认领这个 Plugin →
报告问题
DeepSeek Harness Plugin Hub
ProfilesPlugins分类动态文档登录管理 Profiles
ProfilesPlugins分类动态文档登录

相关插件

继续浏览 developer-tools 分类下经过校验的插件。

Web App@deepseek-ai/dsh-web-appdsh 浏览器界面捆绑包:位于 dsh-base 之上的 Web 补丁层,加上运行时粘合插件(提供前端 dist、Web 界面提示符、bash 运行时变量和 URL 行)Sdk Minimal@deepseek-ai/dsh-sdk-minimal独立的最小 SDK 配置包:JSON-RPC、一个 DeepSeek 适配器、持久化 Shell 和 JSONL 会话Sdk App@deepseek-ai/dsh-sdk-appdsh SDK 配置包:基于 dsh-base 提供 stdio JSON-RPC 服务和进程生命周期管理Subagent Codex@deepseek-ai/dsh-subagent-codex基于官方 app-server 协议的一次性 Codex 子代理提供程序

README

dsh-tool-error-hints

给失败的工具结果追加一条可执行的提示,治"弱模型瞎猜路径"。

为什么需要(有真实数据)

2026-09-13 对真实会话 session-7b9b38a1(本地 27B 跑长任务)的 796 条 tool/result 取证:

  • 失败 92 条(12%)
  • 最高频形态:ls: cannot access '<path>': No such file or directory [exit code: 2]

问题不在报错文案,而在报错只说"不存在"、不说"哪儿存在": 本地模型反复瞎猜绝对路径(/nas/dsh/docker/dsh、/home/ikta/bin/wake-v100.sh), 而压缩之后它会退回已经纠正过的错误写法——同一个错路径能再错 4 次。

它做什么

挂在 tools/post-execute(waterfall),在失败结果之后注入一条 source.kind='plugin' 的提示:

识别到的失败注入的提示
路径不存在最近的已存在祖先目录及其内容(模型据此即可改对)+ 工作区根提示
命令不存在说明容器内没有该可执行文件,建议先 command -v 探测
权限不足说明以非 root 运行,sudo/apt-get/写 /var 会失败
把目录当文件读提示改用 ls

误报防护(重要)

grep 未找到匹配项、(无匹配)、no matches 都是合法的空结果,不是错误。 自测时踩过这个坑,因此按证据强度分两级:

  • STRONG(No such file or directory / cannot access / 文件不存在 …)→ 抽不到路径也给兜底提示
  • WEAK(泛化的 not found / 未找到 / 找不到)→ 必须先抽出像路径的 token 才提示

自测用例 10/10 通过(5 类真报错都提示、5 类正常输出零误伤)。

配置

- id: tool-error-hints
  name: 'dsh-tool-error-hints'
  config:
    enabled: true
    roots: [/nas/dsh]      # 解析相对路径、找"最近的已存在目录"时的根
    maxEntries: 24         # 列目录条数上限
    maxHintsPerPath: 2     # 同一路径本轮最多提示几次(防刷屏)
    include: []            # 只对哪些工具生效(空=全部)
    exclude: []            # 排除哪些工具

安装

bash /nas/dsh/工具/dsh-tool-error-hints/install.sh
dsh-restart

激活方式:~/.dsh/profiles/web/cordis.patch.yml 里的 insert: 条目。 不要写进 package.json 的 dsh.profile.bundles —— 实测 dsh web 每次启动 会把 package.json 还原成出厂版本,写进去的会被冲掉(见 dsh-loop-breaker 的同类记录)。

确证是否真的加载

dump-config 只组合配置树、不 import 模块,所以"配置里有"不等于"加载了"。 插件在 apply() 时写一行加载心跳:

tail -1 ~/.dsh-logs/tool-error-hints-loaded.log
# 2026-09-13T14:10:00.000Z pid=12345 roots=/nas/dsh maxEntries=24

设计约束

  • 只读:仅 existsSync/readdirSync/statSync,绝不执行命令、绝不写文件
  • 不覆盖工具结果:只通过 additionalContexts 追加,不改写工具输出本身
  • 异常全吞:提示插件绝不能影响正常工具流程