前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。随着插件生态的扩展，开发者需要安装第三方工具以扩展 Agent 能力。这带来了两个具体问题：一是插件的 npm 依赖是否存在已知漏洞，二是插件源码本身是否存在恶意行为。dsh-plugin-security 为 DSH 插件提供了一套安全门控机制。

插件简介¶

这是一款 DeepSeek Harness 插件的安全门控工具，由用户 dushaobindoudou 维护。它解决的核心问题是：如何在 Agent 调用插件工具时，拦截高风险操作，并提供依赖审计和源码审查能力。

核心功能¶

该插件包含以下核心能力：
* 依赖与源码扫描：扫描已安装插件的源码和 npm 依赖安全公告。
* 风险分级：将插件标记为 High Risk（高风险）、At Risk（有风险）、No Risk Found（无风险）或 Whitelisted（白名单）。
* 调用门控：在模型执行高风险插件的工具前，弹出 Allow once（仅允许本次）/ Allow（允许）/ Disable（禁用）的选项。
* 智能体审查：提供 Agent 技能，允许对可疑插件进行审查。
* 状态同步：与 DSH 的插件管理器状态保持同步。
* 设置管理：提供设置页面，支持过滤、报告导出和管理操作。
* Agent 工具：内置 security_scan 和 security_review 两个工具。
* 配置模式：支持 off（关闭）、report-only（仅报告）、enforce（强制执行）三种模式。
* 白名单机制：支持白名单，内置受保护条目。
* 静态证据验证：对非恶意代码进行静态证据验证。

安装与启用¶

安装前需确保环境满足要求：
* DSH 版本：0.2.x
* Node.js 版本：20+（推荐 24）

使用官方命令安装：

dsh plugin --profile web add dsh-plugin-security@latest

安装后，Web 配置文件会自动热重载并立即扫描所有插件。对于其他配置文件，请替换 web 为相应的配置文件名称。插件升级后需要重启 DSH。

使用方法¶

插件安装后，可通过以下方式使用：
* 设置页面：进入 DSH 的设置 → Security Gate。在此页面可以过滤插件风险等级、查看安全公告和静态证据、导出 JSON 或 Markdown 报告，或对插件执行启用/禁用/重置/卸载操作。
* 调用时拦截：当模型尝试调用高风险插件的工具时，会在输入框旁显示一个提问卡片，询问是否允许。
* 智能体审查：在对话中直接要求，例如：”Use the dsh-plugin-security skill to review my plugins”。Agent 会调用 security_scan 收集证据，执行技能中的五个问题，并使用 security_review 存储审查结果。

配置说明¶

在设置页面（$DSH_HOME/plugin-security/state.json）中可配置以下项：
* Mode（模式）：默认为 report-only。
* off：不进行扫描、门控或强制执行。
* report-only：扫描、记录并门控调用，但不自动禁用插件。
* enforce：在确认恶意审查时自动禁用插件。
* Auto-disable threshold（自动禁用阈值）：默认为 critical。设置为 never 可关闭自动禁用。
* Upgrade suggestions：默认关闭，用于建议依赖升级命令。

Agent 工具¶

插件为 Agent 提供了两个工具：
* security_scan：扫描指定包（package?）、强制扫描（force?）或获取证据（evidence?）。
* security_review：审查指定包，返回裁决（malicious/suspicious/benign）及置信度。

注意事项¶

• 受保护条目：官方 @deepseek-ai/* 包、dsh-plugin-sentinel 以及插件自身内置的受保护条目，不会被检查，也不会被该插件禁用或卸载。
• 行为定义：使用 fetch、process.env、文件系统或子进程本身并不代表恶意行为，静态匹配是证据，裁决取决于依赖事实和 Agent 的上下文审查。
• 状态存储：状态存储在 $DSH_HOME/plugin-security/ 目录，文件权限为 0700/0600。
• 日志限制：操作日志最多保留 200 条。
• 权限风险：插件在 DSH 进程权限下运行，安装前请检查源码和许可证。

结语¶

dsh-plugin-security 为 DSH 插件生态提供了一个可落地的安全解决方案。它结合了静态分析、依赖审计和运行时门控，帮助开发者在不牺牲灵活性的前提下控制安全风险。

插件详情：
* 目录页：https://www.skillhub.cn/plugins/dushaobindoudou/dsh-plugin-security
* GitHub：https://github.com/dushaobindoudou/dsh-plugin-security