D

dsh-doctor

github.com/moonquake2004/dsh-doctor

v0.8.9 市场与管理 以 shell 执行命令可执行外部程序启动伪终端
认证 L2已扫描 ✓健康 S/100周下载 574

DeepSeek Harness 的离线诊断工具——在**启动前**或**安装插件前**跑一次,它会告诉你社区反复报告的哪几类故障会在你机器上咬人。

作者原文(英文)

Offline diagnostic for DeepSeek Harness — 28 built-in + 5 catalog checks across env/profile/session (Layer A checks-as-data), self-update (Layer B), and a semi-automatic LLM observer (Layer C, --observe); Doctor panel in web UI settings.

中文简介由 DeepSeek 模型翻译,仅供参考。

发布
2026-10-16
源仓库无法访问 多次尝试都没连上,可能是网络问题,也可能是仓库不可达。

检测报告

关注度高。命中了不少能力模式,其中可能有需要留意的。逐条看下面的清单。
2高关注3需留意3一般16未命中
高关注需留意一般

能力清单

  • 以 shell 执行命令shell-exec高关注9 处命中
    • dsh-doctor.mjs:633const r = execFileSync('netstat', ['-ano'], { encoding: 'utf8', maxBuffer: 8 * 1024 * 1024 });
    • dsh-doctor.mjs:638const r = execFileSync('lsof', ['-nP', `-iTCP:${port}`, '-sTCP:LISTEN'], { encoding: 'utf8', maxBuffer: 4 * 1024 * 1024 …
    • dsh-doctor.mjs:647dsh = /dsh web|deepseek-ai|harness/.test(execFileSync('ps', ['-p', pid, '-o', 'command='], { encoding: 'utf8' }));
    • dsh-doctor.mjs:653const lsofP = execFileSync('lsof', ['-p', pid], { encoding: 'utf8', maxBuffer: 8 * 1024 * 1024 });
    • 看命令字符串是拼出来的还是写死的。拼接用户输入才是真正的风险。
  • 可执行外部程序spawns-processes高关注3 处命中
    • lib/index.js:9import { spawn } from 'node:child_process';
    • dsh-doctor.mjs:56import { execFileSync, spawnSync } from 'node:child_process';
    • observer.mjs:18import { spawnSync } from 'node:child_process';
    • 看它调用哪些程序。调用本机已有的工具是常见做法。
  • 启动伪终端spawns-pty需留意29 处命中
    • CHANGELOG.md:80**E4(node-pty 完整性)对完好安装报 fail。** 真机实测:node-pty 与原生二进制都在位
    • CHANGELOG.md:81(`prebuilds/darwin-arm64/pty.node`,86904 字节,位于 `/opt/homebrew/lib/node_modules/@deepseek-ai/dsh/node_modules/node-pty`),
    • CHANGELOG.md:82E4 却报「未找到 node-pty」。
    • CHANGELOG.md:861. **解析根不全**:E4 只查「PATH 里以 `node_modules/.bin` 结尾且含 `dsh` 的目录的兄弟 node-pty」
    • 伪终端等于给了一个完整 shell。确认这是插件的核心功能。
  • 写入文件writes-files需留意13 处命中
    • dsh-doctor.mjs:2349try { mkdirSync(dirname(cachePath), { recursive: true }); writeFileSync(cachePath, JSON.stringify(data, null, 2)); } cat…
    • dsh-doctor.mjs:2598try { mkdirSync(dirname(cachePath), { recursive: true }); writeFileSync(cachePath, JSON.stringify({ latest, checkedAt: n…
    • dsh-doctor.mjs:3039try { writeFileSync(join(profileDir, SNAPSHOT_FILE), JSON.stringify(snap, null, 2) + '\n'); } catch { /* 写不了不致命 */ }
    • dsh-doctor.mjs:3054writeFileSync(`${manifestPath}.dsh-doctor.pre-add.${Date.now()}`, before);
    • 看写入位置。写自己的配置目录是正常的,写系统目录不是。
  • 发起网络请求network需留意2 处命中
    • client/client.js:84const res = await fetch('/dsh-doctor/run', { cache: 'no-store' })
    • README.md:23node dsh-doctor.mjs --no-catalog # skip remote catalog fetch (bundled copy only)
    • 看请求发往哪些域名。发往作者自己的后端是常见做法。
  • 读取文件reads-files一般191 处命中
    • CHANGELOG.md:417(`readFileSync(patchFile)`、`JSON.parse(readFileSync(.../package.json))`、`readFileSync(patchPath)`)
    • CHANGELOG.md:527- 此前直接 `JSON.parse(readFileSync(profile/package.json))`:**带 BOM 时解析失败 → 置 null → P18 报"未找到 profile manifest"**,是**错误结论**…
    • dsh-doctor.mjs:101if (!p || !existsSync(join(p, 'dsh'))) continue;
    • dsh-doctor.mjs:117if (existsSync(profiles)) {
    • 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
  • 读取环境变量reads-env一般17 处命中
    • lib/index.js:43env: { ...process.env, CI: 'true' },
    • dsh-doctor.mjs:64const HOME = process.env.DSH_HOME || join(homedir(), '.dsh');
    • dsh-doctor.mjs:100for (const p of (process.env.PATH || '').split(PATH_DELIM)) {
    • dsh-doctor.mjs:411const root = process.env.DSH_DOCTOR_HARNESS_ROOT;
    • 环境变量里常混有密钥。看它是否把整个 env 都读走。
  • 动态加载模块dynamic-import一般6 处命中
    • README.md:56| P17 | client-side `require()` of a specifier the host module table cannot serve (platform seeds ∪ installed graph rows…
    • README.zh.md:51| P17 | client 端 `require()` 的模块宿主模块表无法服务(平台种子 ∪ 已装图行 ∪ 声明的 external)——warn 级;抓浏览器 `Failed to load plugins` 白屏 | [#5719]…
    • dsh-doctor.mjs:3123// 而旧探针 `cwd: profileDir` + 裸 `import(spec)` 只解析 profile 自己的 node_modules,
    • dsh-doctor.mjs:3172const r = spawnSync(process.execPath, ['--input-type=module', '-e', `await import(${JSON.stringify(entryFile)});`],
    • 动态导入本身无害,但会让依赖关系难以静态审阅。
逐条扫描明细
能力标识关注度命中次数
以 shell 执行命令shell-exec高关注9
可执行外部程序spawns-processes高关注3
启动伪终端spawns-pty需留意29
写入文件writes-files需留意13
发起网络请求network需留意2
读取文件reads-files一般191
读取环境变量reads-env一般17
动态加载模块dynamic-import一般6

这份报告的口径

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

依赖安全公告

已查询这个插件声明的全部依赖,没有匹配到已公开的安全公告。(含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题,不是插件的。)

可信度

100 健康分 S 扣分项下方逐条附证据
  • 0没有可扣分的项

认证等级 L2

  • L0内容完整性✓sha512-Ppt2JQPlnj6SLtPv… 与本地 tarball 复算一致
  • L1来源✓维护者 moonquake2004,仓库 moonquake2004/dsh-doctor(未做仓库审计)
  • L2发行✓隔离 profile 安装成功,5.4s,层已挂载
  • L3生态—还没有契约/启动记录
  • L4多方独立验证—本站不做第三方独立背书
评分口径与作者信息

从 100 分开始按规则扣减:fail −20 / major −10 / warn −5 / minor −2;star 数、下载量、LLM 输出都不参与评分

维护者
moonquake2004
仓库
https://github.com/moonquake2004/dsh-doctor
许可
MIT
最后发布
2026-10-16
周下载
574
star
3

扫描状态:已扫描。能力是事实,不是缺陷; 周下载与 star 只作参考,不参与评分。

认证等级核验的是这个包本身(内容指纹、来源、能否安装、声明是否属实);依赖漏洞是独立标注的,两者正交、不互相掩盖。可信 ≠ 无漏洞,上架 ≠ 推荐。

← 返回首页