前言¶
DeepSeek Harness（DSH）采用“一切皆插件”的理念，这降低了系统的扩展门槛，但也引入了供应链安全风险。在安装第三方插件时，开发者往往难以在运行前验证代码的安全性或完整性。
dsh-plugin-guard 是一个静态分析插件，它不执行目标插件，而是通过静态审计和哈希锁定来拦截潜在风险。它在安装前进行静态审计，在安装后进行哈希与能力锁定，并提供对等搜索和机械排毒功能。
插件定位¶
- 名称：
taxueseek/dsh-plugin-guard - 维护者：taxueseek
- 类型：静态安全审计
- 核心原则：静态分析，绝不执行目标插件。
- 架构：包含“门”和“诊所”两个层面。
Gate负责安装前后的静态审计与锁定；Clinic负责对等搜索和机械排毒。
核心功能¶
-
plugin_audit（门）：安装前静态审计
在插件被安装或加载前，对代码进行静态分析，识别潜在的安全隐患。 -
plugin_verify（门）：哈希与能力锁定
插件安装后，通过哈希校验锁定插件完整性，并结合能力锁防止恶意功能被触发。 -
plugin_peers（诊所）：对等搜索
- 本地指纹：对本地已安装的插件进行指纹识别。
- 查询：搜索 GitHub 上的
topic:dsh-plugin标签以及 curated（精选）列表。如果这些结果较轻量，则使用 argo 进行查询。 - 远程：直接查询 GitHub，裁决结果为
unknown，需在安装前再次审计。
-
plugin_detox（诊所）：机械切除
对已安装的插件进行机械性切除，不保留其原始行为。
安装与启用¶
安装此插件需要使用官方提供的命令，并重启 DSH Web 服务。
dsh plugin --profile web add github:taxueseek/dsh-plugin-guard
# 重启 dsh web
典型用法¶
评分机制¶
插件会对扫描结果进行评分，初始分数为 100。
- P0：仅自动运行且包含危险组合（如
curl|bash、密钥离开机器、eval 网络内容、安装脚本中毒）。P0 扣 40 分。 - P1：工具内部出现
exec（模型必须点击触发）。P1 扣 12 分。 - P2：其他情况。P2 扣 3 分。
裁决逻辑：
* Block：任何 P0 或评分低于 40。
* Warn：任何 P1 或评分低于 75。
plugin_peers 的三种模式¶
plugin_peers 命令根据参数不同，行为有所区别：
- path：仅扫描本地路径（profile bundles）。
- query：命中 GitHub
topic:dsh-plugin+ 精选列表。如果这些列表较轻量，会使用 argo 进行查询。 - remote：直接查询 GitHub，裁决结果为
unknown。这意味着在安装前必须先进行审计。
适用场景与注意¶
此插件适用于所有需要严格管控 DSH 插件生命周期的场景，特别是对供应链安全敏感的环境。
注意事项：
1. 不输出脱敏：插件不会对敏感信息进行脱敏处理。
2. 非通用 SAST：它不是通用的静态应用安全测试工具。
3. 不能证明安全：通过审计并不代表插件绝对安全。
4. 排毒不保留行为：plugin_detox 功能是机械切除，不会保留原插件的行为逻辑。
5. 权限风险：作为插件，它以当前 DSH 进程的权限运行。在安装任何插件前，务必人工检查源码与许可证。
结语¶
dsh-plugin-guard 提供了一套静态的安全防线，通过哈希锁定和评分机制，帮助开发者识别并阻断高风险插件。更多细节和源码，可访问其 GitHub 仓库或 DSH 生态目录。
