DeepSeek Harness 安全插件 dsh-mcpguard

DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。在构建智能体时，MCP 服务器配置和技能文件本质上是文本。攻击者可能在这些文件中埋入 Prompt 注入指令、同形异义字或危险的 Shell 命令。dsh-mcpguard 是 DSH 生态中的首个安全插件，旨在扫描这些文件，拦截可能危害 AI 代理的行为。

插件定位¶

该插件由 ChenLaoshiYF 维护，采用 MIT 许可证。它作为标准的 DSH 插件提供两个工具：一个用于静态配置扫描，另一个提供实验性的运行时观察模式。整个插件完全在本地机器运行，不需要守护进程、云端服务或外部 API 密钥。

核心功能¶

静态扫描
- 扫描技能目录和 MCP 配置文件。
- 检测 Prompt 注入（如 “ignore previous instructions”）、同形异义字（homoglyphs）、不可见 Unicode（如零宽字符）、危险 Shell 命令（如 eval、curl | sh）以及凭证泄露。
- 扫描结果以 JSON 格式输出，包含文件评分、规则 ID、严重程度和 offending excerpt。报告中所有敏感信息（API keys、tokens）均已脱敏。
运行时观察（实验性）
- v0.2 版本引入了 mcpguard_observe 工具。
- 它附加到 tools/pre-execute 钩子，监视工具调用（包括 MCP 工具）。
- 设计上永远不会阻断工具执行。它仅用于记录、日志和报告，决策权完全在用户手中。任何内部错误会自动降级为允许执行并记录日志。

安装与启用¶

通过命令行安装：

dsh plugin --profile web add "github:ChenLaoshiYF/dsh-mcpguard"

或者通过界面操作：在 Settings → Plugins 中安装后，重启 dsh --profile web。

典型用法¶

安装完成后，插件会提供以下工具：

mcpguard_scan: 扫描默认目标（MCP 配置 + 技能目录）。
mcpguard_scan_path: 扫描你指定的任意路径。
mcpguard_observe: 运行时观察摘要。

示例输出（JSON 格式）：

{
  "total": 3,
  "bySeverity": {
    "critical": 1,
    "high": 2
  },
  "recent": [...]
}

安全与隐私¶

插件内置了多重安全机制以防止误伤和隐私泄露：

隐私保护: 没有任何网络请求，没有遥测数据上传。
文件扫描限制: 大于 256 KB 的文件会被跳过；递归扫描深度限制在 8 层。
敏感目录保护: 即使显式指向，.ssh、.aws、.gnupg 目录也绝不会被扫描。
结果脱敏: 报告中所有 sk- 开头的密钥、ghp_ 开头的 token、SSH 私钥块和 JWT 都会被替换为 ***。

兼容性与注意¶

该插件已针对 DeepSeek Harness 0.1.0-rc.5 进行测试。由于 DSH 处于开发者预览阶段，API 可能会有变动。如果遇到兼容性问题，建议在 GitHub 上提交 Issue。

总结¶

dsh-mcpguard 专注于解决 AI 智能体开发中的文本安全痛点。它提供了一个轻量级、本地化的扫描和观察方案，帮助开发者在代码进入运行时环境前发现潜在的注入风险和配置隐患。

插件目录: https://www.skillhub.cn/plugins/ChenLaoshiYF/dsh-mcpguard
GitHub 仓库: https://github.com/ChenLaoshiYF/dsh-mcpguard