前言¶
在 DeepSeek Harness (DSH) 开发中,智能体的行为安全与正确性高度依赖于“工具面”的配置。开发者在组装 bundle 时,可能无意中暴露了不应被模型访问的代码执行接口或副作用工具。dsh-agent-doctor 旨在解决这一配置审计痛点,通过诊断命令对当前生效的工具表面进行静态检查。
插件介绍¶
这是一个轻量级的 DSH 健康与安全诊断插件,由用户 MkaliezZ 维护。它通过 /doctor 命令检查接收到的 Agent 的有效模型可见工具表面,并报告边界配置信号。插件本身不声称作为杀毒软件、恶意软件扫描器、沙箱或策略执行边界。
核心功能¶
插件提供以下检查项:
1. 工具清单统计:报告模型当前可见的工具数量及具体名称。
2. 预留接口可见性:检查保留的 run_code 接口是否对模型可见。
3. 启发式警告:对名称特征明显带有副作用倾向的工具发出提示(仅作提示,不拦截)。
4. AgentFuse 检查(可选):确认 AgentFuse 是否存在。
5. 批准服务信号(可选):检测批准服务是否可用。
安装与启用¶
该插件设计为 DSH bundle 的形式挂载。在 DSH 配置文件中添加以下片段即可启用:
- id: dsh-agent-doctor
name: '@mkaliezz/dsh-agent-doctor'
config:
requireAgentFuse: false
典型用法¶
在 DSH 交互界面完成 bundle 组装后,直接输入 /doctor 命令即可触发诊断并查看报告。
适用场景与注意¶
- 适用场景:需要确认 Agent 工具链是否包含不应暴露的接口(如代码执行器),或依赖 AgentFuse 进行混合编排的开发者。
- 注意:
- 本插件以当前 DSH 进程权限运行,不是进程沙箱或策略强制执行边界。
- 不是杀毒软件或恶意软件扫描器。
- 无法通过工具名称证明工具本身的安全性。
- 无法证明有效配置的不可变性。
- 使用前应检查源码与许可证。
结语¶
该插件适合作为 DSH 环境中的配置审计辅助工具,帮助开发者把控工具面的可见性。插件目录与源码仓库如下: