dsh-arg-guard
在终端中运行以下命令:
dsh plugin install bushizhanghan/dsh-arg-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install bushizhanghan/dsh-arg-guard 安装本插件(源码:https://github.com/bushizhanghan/dsh-arg-guard),重启 DSH 后生效。
插件介绍
DSH 会为工具输出强制校验 output.schema,但工具入参往往只在定义里写给模型看,执行前并不会对照检查。类型错了会一路掉进插件实现,最后变成裸露的 Node TypeError,既难排查,也不利于模型自我纠正。
dsh-arg-guard 在 host 的 tools/pre-execute 阶段挂载守卫:用工具自己声明的 parameters 校验每次调用。违规时在 deny 模式下拒绝执行,并把固定格式的理由(JSON 路径、期望类型、实际值)交给模型;支持 warn 先观测、skip 放行指定工具,且设计上校验失败或内部异常时默认放行,避免误伤正常调用。
校验覆盖常见 JSON Schema 规则:原始类型与联合类型、required、enum/const、嵌套对象与数组、additionalProperties、oneOf/anyOf/allOf 等;不做强转,不认识的 schema 关键字会忽略,输出仍由 host 负责。另提供 arg_guard_status 查看运行状态与近期违规,arg_guard_check 可干跑单次参数而不执行工具。
适合 DSH 插件作者、Agent 编排与运维:想先摸清 schema 与真实契约是否一致时用 warn,确认后再切 deny;也适合在拒单后复现参数,弄清是哪条路径不合规。
使用场景
- 上线新插件前用 warn 模式观察入参是否与 schema 一致
- 模型传错类型导致工具被拒时,用干跑检查定位 JSON 路径
- 在 deny 模式下把 TypeError 提前拦截为可读的 schema 违规说明
适合人员
- 编写或维护 DSH 工具的插件作者
- 负责 Agent 稳定性与工具契约的运维人员
- 需要收紧入参、减少裸运行时错误的平台管理员