dsh-doctor
github.com/astra3294/dsh-doctor
v0.4.3
其他
可执行外部程序以 shell 执行命令写入文件
认证 L1已扫描 ✓健康 A/90周下载 524
DSH Doctor 是 Harness「把自己改坏」两种典型情况的安全网:**开得了但无法对话**(WebUI 能打开但对话循环坏了),以及**根本起不来**(改了配置、依赖或插件后启动失败)。WebUI 还能打开时,Doctor 按钮调用仅限本机访问的 Host 救援服务;Harness 起不来时,同一套引擎以独立 CLI 运行——包括捕获启动失败的启动探针,和「一键恢复到最近健康检查点」的重置,让插件开发者可以放心折腾、随时回到能
作者原文(英文)
Deterministic diagnostics and recovery for DeepSeek Harness
中文简介由 DeepSeek 模型翻译,仅供参考。
deepseekdeepseek-harnessdshdoctordiagnosticsrecovery
检测报告
关注度高。命中了不少能力模式,其中可能有需要留意的。逐条看下面的清单。
2高关注4需留意3一般15未命中
高关注需留意一般
能力清单
- 可执行外部程序
spawns-processes高关注3 处命中lib/cli.js:3import { spawn, spawnSync } from "node:child_process";lib/index.js:6import { spawn, spawnSync } from "node:child_process";lib/index.js:1941return `setTimeout(() => { const { spawn } = require('child_process'); const p = spawn(${JSON.stringify(command)}, ['--p…- 看它调用哪些程序。调用本机已有的工具是常见做法。
- 以 shell 执行命令
shell-exec高关注1 处命中lib/cli.js:3084shell: true,- 看命令字符串是拼出来的还是写死的。拼接用户输入才是真正的风险。
- 写入文件
writes-files需留意12 处命中lib/cli.js:333await mkdir(path, {lib/cli.js:345await handle.writeFile(content);lib/cli.js:350await rename(temporary, path);lib/cli.js:397await handle.writeFile(JSON.stringify({- 看写入位置。写自己的配置目录是正常的,写系统目录不是。
- 启动伪终端
spawns-pty需留意9 处命中lib/cli.js:181message: "A native module (such as node-pty) failed to load: its prebuild for this Node ABI is missing. Run npm rebuild …lib/cli.js:2649en: "A native module (like node-pty) has no prebuild for this Node ABI and the boot fails. Run npm rebuild for it, or sw…lib/cli.js:2650zh: "某个原生模块(如 node-pty)没有当前 Node ABI 的预编译产物导致启动失败。对它执行 npm rebuild,或换用官方支持的 Node 版本。"lib/cli.js:3163if (process.platform === "win32") spawn("cmd", [- 伪终端等于给了一个完整 shell。确认这是插件的核心功能。
- 发起网络请求
network需留意6 处命中lib/cli.js:1849const response = await fetch("https://registry.npmjs.org/@deepseek-ai%2Fdsh/latest", { signal: AbortSignal.timeout(5e3) …lib/cli.js:2884const response = await fetch(source, {lib/cli.js:2911const response = await fetch("https://registry.npmjs.org/dsh-doctor/latest", { signal: AbortSignal.timeout(1e4) });lib/cli.js:2991const response = await fetch("https://raw.githubusercontent.com/AdamPlatin123/awesome-dsh-plugins/main/PLUGINS.md", { si…- 看请求发往哪些域名。发往作者自己的后端是常见做法。
- 可终止进程
kills-processes需留意5 处命中lib/cli.js:115process.kill(child.pid, "SIGKILL");lib/cli.js:359process.kill(pid, 0);lib/cli.js:661process.kill(pid, 0);lib/cli.js:753process.kill(status.pid, "SIGTERM");- 看它终止的是自己启动的进程,还是按名字匹配到的任意进程。
- 读取文件
reads-files一般32 处命中lib/cli.js:319return await readFile(path, "utf8");lib/cli.js:368record = JSON.parse(await readFile(lockPath, "utf8"));lib/cli.js:451entries = await readdir(dir, { withFileTypes: true });lib/cli.js:823const profiles = profile === void 0 ? (await readdir(root, { withFileTypes: true })).filter((entry) => entry.isDirectory…- 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
- 读取环境变量
reads-env一般15 处命中lib/cli.js:26const candidate = explicit ?? process.env.DSH_HOME;lib/cli.js:130const dshHome = options.dshHome ?? process.env.DSH_HOME ?? join(homedir(), ".dsh");lib/cli.js:233...process.env,lib/cli.js:722...process.env,- 环境变量里常混有密钥。看它是否把整个 env 都读走。
- 动态加载模块
dynamic-import一般4 处命中lib/types/repair.d.ts:17}): Promise<import("./types.js").DoctorCheckpoint>;lib/types/repair.d.ts:20}): Promise<import("./types.js").DoctorCheckpoint>;lib/types/repair.d.ts:26checkpoints: import("./types.js").DoctorCheckpoint[];lib/types/service.d.ts:17scan(runtimeEntries?: readonly RuntimePluginEntry[], options?: ScanOptions, runtimeModel?: RuntimeModelStatus): Promise<…- 动态导入本身无害,但会让依赖关系难以静态审阅。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 可执行外部程序 | spawns-processes | 高关注 | 3 |
| 以 shell 执行命令 | shell-exec | 高关注 | 1 |
| 写入文件 | writes-files | 需留意 | 12 |
| 启动伪终端 | spawns-pty | 需留意 | 9 |
| 发起网络请求 | network | 需留意 | 6 |
| 可终止进程 | kills-processes | 需留意 | 5 |
| 读取文件 | reads-files | 一般 | 32 |
| 读取环境变量 | reads-env | 一般 | 15 |
| 动态加载模块 | dynamic-import | 一般 | 4 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 38 个文件,扫描于 2026-10-15。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
依赖安全公告
这个插件声明的依赖中,有 3 条已公开的安全公告 (最高等级:中):
| 等级 | 依赖包 | 编号 | 摘要 |
|---|---|---|---|
| 中 | semver | CVE-2022-25883 | semver vulnerable to Regular Expression Denial of Service 修复版本:5.7.2, 6.3.1, 7.5.2 详情 → |
| 中 | yaml | CVE-2023-2251 | Uncaught Exception in yaml 修复版本:2.2.2 详情 → |
| 低 | yaml | CVE-2026-33532 | yaml is vulnerable to Stack Overflow via deeply nested YAML collections 修复版本:1.10.3, 2.8.3 详情 → |
查询的是依赖声明范围的下界(如 ^4.2.0 查 4.2.0),
不是实际安装到的版本。真正装的时候如果解析到了修复版本,就不受影响——
所以这是「可能受影响」,不是「这个插件有漏洞」。数据来自
OSV.dev。