D

dsh-plugin-doctor

github.com/PerryLink/dsh-plugin-doctor

v0.7.0 开发与运行时 可执行外部程序写入文件

一款面向 dsh 插件的「完整性 + 运行时健康」一体化检查工具。零依赖(只用 Node ≥22 自带的能力), 一次运行同时覆盖四个层面:

作者原文(英文)

Zero-dependency static + sandbox smoke detector for DeepSeek Harness (dsh) plugins: package-structure gates (R), cordis contract scans (K), keyless-headless sandbox smoke (D), and ecosystem-listing checks (CC).

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

dshdsh-plugindeepseek-harnesscordisplugindoctorlintverification
分类
dev
发布
2026-10-10
版本
v0.7.0

检测报告

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

能力清单

  • 可执行外部程序spawns-processes高关注2 处命中
    • .github/actions/doctor/index.mjs:13import { spawnSync } from 'node:child_process'
    • lib/util.mjs:2import { spawnSync } from 'node:child_process'
    • 看它调用哪些程序。调用本机已有的工具是常见做法。
  • 写入文件writes-files需留意12 处命中
    • doctor.mjs:149try { rmSync(abs, { recursive: true, force: true }) } catch (e) { console.error(`清理失败: ${e.message}`); return 3 }
    • doctor.mjs:163mkdirSync(logDir, { recursive: true })
    • doctor.mjs:288writeFileSync(opts.json, JSON.stringify(contract, null, 2) + '\n', 'utf8')
    • doctor.mjs:300writeFileSync(opts.json, JSON.stringify(envelope, null, 2) + '\n', 'utf8')
    • 看写入位置。写自己的配置目录是正常的,写系统目录不是。
  • 读取文件reads-files一般71 处命中
    • lib/checks-collections.mjs:26if (!existsSync(p)) return skip('认证仓本地不存在(--workspace 外运行无法核对)')
    • lib/checks-collections.mjs:48if (!existsSync(dir)) return skip('adp-list 本地不存在')
    • lib/checks-collections.mjs:49const hits = readdirSync(dir).filter((f) => f === `${g.slug}.yml` || f.startsWith(`${g.slug}--`))
    • lib/checks-collections.mjs:53const text = readFileSync(path.join(dir, f), 'utf8')
    • 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
  • 接触凭据或密钥credentials一般33 处命中
    • CHANGELOG.md:34The first version warned whenever a publish workflow referenced `secrets.NPM_TOKEN` or set
    • CHANGELOG.md:232`NPM_TOKEN` secret had expired, which had blocked this work for several rounds,
    • CHANGELOG.md:233so the release path was switched to a credential that cannot expire. See the
    • CHANGELOG.md:253after a credential fix without inventing a version. The tag-matches-version
    • 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。
  • 读取环境变量reads-env一般17 处命中
    • lib/host-surface.mjs:38if (process.env.DSH_INSTALL_DIR) candidates.push(process.env.DSH_INSTALL_DIR)
    • lib/host-surface.mjs:47const home = process.env.HOME || process.env.USERPROFILE
    • lib/host-surface.mjs:48if (process.env.APPDATA) candidates.push(path.join(process.env.APPDATA, 'npm', 'node_modules', '@deepseek-ai', 'dsh'))
    • .github/actions/doctor/index.mjs:18const actionPath = process.env.GITHUB_ACTION_PATH
    • 环境变量里常混有密钥。看它是否把整个 env 都读走。
  • 动态加载模块dynamic-import一般4 处命中
    • lib/checks-package.mjs:214+ '(cordis Loader 也是用 `import(name)` 装载),因此这一行永远挂不上。\n'
    • lib/host-surface.mjs:86const cat = await import(pathToFileURL(catalogPath).href)
    • lib/host-surface.mjs:186const m = await import(pathToFileURL(mod).href)
    • scripts/refresh-host-surface.mjs:98const catalog = await import(`file://${catalogPath.replace(/\\/g, '/')}`)
    • 动态导入本身无害,但会让依赖关系难以静态审阅。
逐条扫描明细
能力标识关注度命中次数
可执行外部程序spawns-processes高关注2
写入文件writes-files需留意12
读取文件reads-files一般71
接触凭据或密钥credentials一般33
读取环境变量reads-env一般17
动态加载模块dynamic-import一般4

这份报告的口径

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

依赖安全公告

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

← 返回全部插件