DSH Plugins
返回列表
🧩

dsh-arg-guard

admin-security 更新于 2026.11.08

在终端中运行以下命令:

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 稳定性与工具契约的运维人员
  • 需要收紧入参、减少裸运行时错误的平台管理员