@deepwhale-cn/dsh-tool-vet

装第三方插件之前，先看它会动什么。

关键词：工具审查 · 插件审查 · 装之前先查 · 权限 · 能力枚举 · 供应链安全 · postinstall · 恶意依赖 · 可信度

---

先说清楚它是什么、不是什么

是：装一个第三方插件/包之前，静态审查它会干什么 —— 执行命令、读敏感路径、往外发数据、装的时候自动跑什么。

不是：

• ❌ 不是沙箱 —— 不拦截运行，只做静态审查
• ❌ 不是运行时权限审批 —— 那是另一类工具（市场里已经很多）
• ❌ 不是漏洞库比对 —— 那是 dsh-dep-audit 的活
• ❌ 不下「安全 / 不安全」的结论 —— 只列能力，判断留给你

一句话分界：别人是门卫，这个是体检。 门卫管进出，体检告诉你这个新来的会动什么。

与 dsh-dep-audit 的分界：

dep-audit  = 查【你自己项目】的【依赖树】
tool-vet   = 审查【一个第三方包本身】的【代码能力】

---

它查什么（6 条）

规则	查什么	级别
VET-INSTALL-SCRIPT	装了就会自动执行（preinstall/install/postinstall）	🔴
VET-CRED-PATH	代码里出现 ~/.ssh、~/.aws、~/.npmrc 等凭据路径	🔴
VET-OBFUSCATION	拼接执行 / 超长编码串（MITRE ATT&CK T1027）	🔴
VET-OUTBOUND	会往网络上发东西	🟡
VET-EXEC	会执行外部命令	🟡
VET-DEP-SOURCE	依赖来自 registry 之外（git: / http: / file:）	🟡

每条都会给出：哪个文件、第几行、那行代码长什么样、依据是什么。

---

安装

dsh plugin --profile web add @deepwhale-cn/dsh-tool-vet

用法

# 审查一个本地目录
dsh-tool-vet --root /path/to/some-plugin

# 看内置演示（一个「看着正常、实际会读私钥并外发」的假插件）
dsh-tool-vet --demo

# 列出规则与依据
dsh-tool-vet --list-rules

# 出 HTML 报告
dsh-tool-vet --root /path/to/some-plugin --html

---

一个真实的例子

--demo 审查的那个假插件，描述是「给会话加一个快速笔记面板」，看起来人畜无害。

它会：

🔴 装的时候就自动执行 scripts/setup.js
🔴 读 ~/.ssh/id_rsa、~/.aws/credentials、~/.npmrc
🔴 一段 base64 串还原后 new Function() 执行
🟡 catch 网络：往 telemetry.example-collector.net 发 POST
🟡 调 child_process
🟡 依赖从 git 仓库直装，绕过 npm 包名体系

这六条，装之前就能看见。

---

边界

• 只做静态审查 —— 代码里动态拼出来的路径、从网络拉下来的代码，它看不见
• 不判定意图 —— 「读 .ssh」是能力，不是罪证。一个 SSH 工具当然要读 .ssh，所以报出来是提示你确认，不是判定它有问题
• 覆盖不到依赖内部 —— 它审查的是这一个包自己的代码，不递归进依赖树（那是 dep-audit 的范围）
• 判据是「值得警惕的能力」 —— 不是「违规」。所以这里没有法条，依据是官方文档与公开的威胁模型

---

---

深鲸网安守护系列（共 31 个）

一个插件做一件事。安全问题是链式的 —— 配套用才完整。

国内合规 ｜ 等保对照 · 日志留存 · 备案公示 · 用户同意 · 个人信息权利 · 未成年人保护 · 影响评估 · 数据分类分级 · 算法备案 · 数据出境 · 国密合规 · AI 内容标识

AI 与 Agent 治理 ｜ AI 输出信任 · 外部内容信任 · MCP 安全 · Agent 权限 · 策略核对 · 可疑指令

数据与凭据 ｜ 敏感数据 · 密钥轮换 · 数据留存 · 配置审计 · 密钥扫描

供应链与构建 ｜ 开源许可 · 依赖投毒 · CI 安全 · 工具审查 · 物料清单

权限与应急 ｜ 最小权限 · 告警外发 · 应急证据包

都在 DSH 插件市场（dsh-plugin.org）、npm 和 deepwhale.org.cn/guard.html 上。

License

MIT © 深鲸 DeepWhale