D

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
分类
other
发布
2026-08-15
版本
v0.4.3

检测报告

关注度高。命中了不少能力模式,其中可能有需要留意的。逐条看下面的清单。
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 条已公开的安全公告 (最高等级:中):

等级依赖包编号摘要
中semverCVE-2022-25883semver vulnerable to Regular Expression Denial of Service
修复版本:5.7.2, 6.3.1, 7.5.2 详情 →
中yamlCVE-2023-2251Uncaught Exception in yaml
修复版本:2.2.2 详情 →
低yamlCVE-2026-33532yaml is vulnerable to Stack Overflow via deeply nested YAML collections
修复版本:1.10.3, 2.8.3 详情 →

查询的是依赖声明范围的下界(如 ^4.2.0 查 4.2.0), 不是实际安装到的版本。真正装的时候如果解析到了修复版本,就不受影响—— 所以这是「可能受影响」,不是「这个插件有漏洞」。数据来自 OSV.dev。

← 返回全部插件