@snow-the/dsh-plugin-guide

检测报告

能力清单

• 以 shell 执行命令shell-exec高关注3 处命中
  • src/boot.ts:32execFileSync('taskkill', ['/PID', String(pid), '/T', '/F'], { stdio: 'ignore' });
  • src/boot.ts:147const dom = execFileSync(browser, [
  • src/boot.ts:192shell: true,
  • 看命令字符串是拼出来的还是写死的。拼接用户输入才是真正的风险。
• 可执行外部程序spawns-processes高关注1 处命中
  • src/boot.ts:11import { spawn, execFileSync } from 'node:child_process';
  • 看它调用哪些程序。调用本机已有的工具是常见做法。
• 改写用户 profileprofile-tamper高关注1 处命中
  • fuzz-scan.mjs
  • 看它改的是自己那一段还是别人的。改用户 profile 通常应由用户手动做。
• 写入文件writes-files需留意14 处命中
  • scripts/gen-ctx-catalog.mjs:137mkdirSync(dirname(args.out), { recursive: true });
  • scripts/gen-ctx-catalog.mjs:138writeFileSync(args.out, content);
  • src/boot.ts:155rmSync(profile, { recursive: true, force: true });
  • src/boot.ts:161rmSync(profile, { recursive: true, force: true });
  • 看写入位置。写自己的配置目录是正常的，写系统目录不是。
• 运行时改写自身配置modifies-own-manifest需留意3 处命中
  • test/fuzz-scan.mjs:96writeFileSync(join(dir, 'package.json'), manifestCorpus[mName]());
  • test/fuzz-scan.mjs:97if (rand() < 0.8) writeFileSync(join(dir, 'cordis.patch.yml'), patchCorpus[pName]());
  • test/fuzz-scan.mjs:102writeFileSync(join(dir, 'package.json'), mutated);
  • 运行时改写自身配置会让下次启动的行为和你看过的源码不一致。
• 可终止进程kills-processes需留意2 处命中
  • src/boot.ts:36try { process.kill(-pid, 'SIGKILL'); } catch { process.kill(pid, 'SIGKILL'); }
  • 看它终止的是自己启动的进程，还是按名字匹配到的任意进程。
• 发起网络请求network需留意1 处命中
  • src/boot.ts:45const s = net.connect({ port, host: '127.0.0.1' });
  • 看请求发往哪些域名。发往作者自己的后端是常见做法。
• 安装时执行脚本install-scripts需留意1 处命中
  • 安装脚本：prepare
• 读取文件reads-files一般39 处命中
  • scripts/gen-ctx-catalog.mjs:50if (!existsSync(dir)) {
  • scripts/gen-ctx-catalog.mjs:54for (const f of readdirSync(dir).filter((n) => n.endsWith('.md') && !n.endsWith('.zh.md')).sort()) {
  • scripts/gen-ctx-catalog.mjs:56const text = readFileSync(join(dir, f), 'utf8');
  • scripts/gen-ctx-catalog.mjs:110const srcRoot = args.src ?? defaultSrcRoots().find((p) => existsSync(join(p, 'docs', 'subsystems')));
  • 读文件是绝大多数插件的正常工作方式，本身不构成顾虑。
• 读取环境变量reads-env一般6 处命中
  • docs/node-native-practices.md:10| 用户主目录 | `process.env.USERPROFILE ?? ''` | `os.homedir()`(Win→USERPROFILE, Linux/mac→HOME) |
  • docs/node-native-practices.md:261. grep `USERPROFILE|HOMEDRIVE|HOMEPATH|process.env.HOME` → 必须 0
  • scripts/gen-ctx-catalog.mjs:28process.env.DSH_SRC_ROOT,
  • src/boot.ts:59return p.replace(/%([^%]+)%/g, (_m, k: string) => process.env[k] ?? '');
  • 环境变量里常混有密钥。看它是否把整个 env 都读走。
• 接触凭据或密钥credentials一般4 处命中
  • src/ctx-catalog.generated.ts:41{ member: "ctx.credentials", type: "CredentialProvider", subsystem: "credentials", seam: true },
  • src/ctx-notes.ts:39{ member: 'ctx.credentials', pkg: '@deepseek-ai/dsh-credentials', what: '凭证管理(密钥安全存取,不落明文)', example: 'ctx.credentials 读…
  • src/index.ts:75'Look up how to use official DSH capabilities when writing plugins: ctx.* service map (ctx.llm / ctx.tools / ctx.agents …
  • 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。

这份报告的口径

扫描读的是包里的源码，全程不执行第三方代码。 本次读了 17 个文件，扫描于 2026-10-22。 命中次数只说明源码里出现过这类调用，不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单，不是信任评分，也不是安全结论： 没扫出来的能力可能只是写法没被规则覆盖。

可信度

这个插件只在 GitHub 上发布，没有走过 npm 的分发链路。下面的梯子按 GitHub 通道的证据计算：补丁审计、钉在 commit 上的源码快照、隔离试装；L2 的「宿主启动」这一层还没有对 git 通道跑过，所以等级停在 L1。

• -10声明与实物不符：entry-missingmajor：['./dist/index.js']
• -5声明与实物不符：types-missingwarn：['./dist/index.d.ts']
• -5cordis entry id「dsh-plugin-guide」被 2 个包共用，同时安装会互相替换warn：dsh-plugin-guide
• -2没有 READMEminor