前言¶
在 DeepSeek Harness (DSH) 的插件生态中，一切皆插件。当开发者引入第三方插件时，需要确认其安全性，例如是否泄露 Token、是否有恶意网络连接或混淆代码。dsh-security-guard 插件提供了一套静态扫描方案，帮助在 DSH 环境中检测已安装插件的安全状况。
插件概览¶
这是一个由 weisofns 维护的 DSH 插件。它提供 28 条规则静态扫描器、风险评分、白名单/黑名单策略、本地 Web 仪表盘以及 DSH 内的风险弹窗功能。
核心功能¶
- 静态扫描器：内置 28 条规则，覆盖偷 Token、数据外发、动态执行、混淆、网络、供应链、持久化、提权等场景。
- 启动自检：安装后自动扫描 profile 下已安装的 dsh 插件包。
- DSH 工具注册：为模型注册
security_scan_plugins、security_scan_plugin和security_guard_report工具。 - 告警机制：支持控制台输出、事件总线，可选 Webhook，支持等级过滤和限流。
- 本地 Web 仪表盘：提供可视化面板，支持 JSON API。
- 远程规则更新：支持
remoteSources远程规则 JSON，可选定时自动更新。
检测规则¶
插件内置 28 条检测规则，主要类别包括：
- Token 相关 (TOK)：硬编码 Token、Token 外发、读取 DSH 凭据、环境变量凭据。
- 数据外发 (EXF)：可疑外发域名、DNS-ICMP 隧道、剪贴板读取外发。
- 动态执行 (EXE)：动态代码执行、子进程执行、远程代码加载。
- 代码混淆 (OBF)：高熵字符串、解码后执行、JSFuck 极简混淆。
- 网络监听 (NET)：未授权监听、WebSocket 外发、代理配置篡改。
- 文件系统 (FS)：越界文件写入、删除系统文件、全盘文件搜索。
- 进程操作 (PRO)：进程注入、权限提升。
- 供应链安全 (SUP)：可疑 install 脚本、依赖混淆、Git 仓库投毒。
- 持久化 (PER)：启动项植入、Shell 配置篡改。
- 敏感服务 (PRIV)：请求敏感 DSH 服务、拦截核心服务。
安装¶
使用官方插件加载方式安装。请先完全退出 DSH Host，然后执行：
dsh plugin --profile web add ./dsh-security-guard-2.1.0.tgz
重启 DSH 后，插件自动开始工作。
配置说明¶
插件通过 cordis.patch.yml 配置。关键配置项包括：
- enabled：是否启用插件。
- scanOnStart：启动时是否扫描。
- autoUpdateRules：是否自动更新规则。
- enableWebPanel / webPanelPath：是否启用 Web 仪表盘及其路径。
- remoteSources：远程规则 JSON URL 列表。
- whitelist / blacklist：白名单和黑名单策略。
- minLevel：告警最小等级。
- webhookUrl：Webhook 地址。
使用方法¶
- 对话扫描：在 DSH 对话中输入“扫描一下我的插件安全”或“检查哪些插件有风险”。
- 模型调用：模型会自动调用注册的工具返回风险报告。
- Web 仪表盘：浏览器访问
http://127.0.0.1:<DSH端口>/security-guard打开可视化面板。
兼容性¶
- Node.js 版本 >= 20。
- 零第三方运行时依赖。
- 依赖 DeepSeek Harness 官方插件加载方式 (
dsh.bundle.patch+cordis.patch.yml)。 @deepseek-ai/dsh-tools为可选依赖。
注意事项¶
该插件以当前 DSH 进程权限运行。安装前建议检查源码与许可证。
