开发与运行时 · v0.7.0
dsh-plugin-doctor
用于 dsh 插件的一体化“完整性 + 运行时健康”检查器。
作者原文(英文)
An all-in-one "integrity + runtime health" checker for dsh plugins.
简介取自插件 README 开头,由 DeepSeek 模型翻译,仅供参考。
dshdsh-plugindeepseek-harnesscordisplugindoctorlintverification
认证 L3已扫描 ✓健康 S/100周下载 1.4k
6 项能力安装命令
dsh plugin --profile web add @perrylink/dsh-plugin-doctor@0.7.0
已试装 · 层已挂载
已在一个隔离的 profile 里真装过:包能装上,并且插件层挂载成功。这一条是实测结果,不是作者的声明。
检测报告
关注度高。命中了不少能力模式,其中可能有需要留意的。逐条看下面的清单。
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')- 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
- 读取环境变量
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.USERPROFILElib/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, '/')}`)- 动态导入本身无害,但会让依赖关系难以静态审阅。
- 接触凭据或密钥
credentials一般1 处命中lib/host-surface.data.mjs:621"credentials": [- 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 可执行外部程序 | spawns-processes | 高关注 | 2 |
| 写入文件 | writes-files | 需留意 | 12 |
| 读取文件 | reads-files | 一般 | 71 |
| 读取环境变量 | reads-env | 一般 | 17 |
| 动态加载模块 | dynamic-import | 一般 | 4 |
| 接触凭据或密钥 | credentials | 一般 | 1 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 28 个文件,扫描于 2026-10-15。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
可信度
100
健康分 S
扣分项下方逐条附证据
- 0没有可扣分的项
认证等级 L3
- L0静态结构与契约✓sha512-G9HGKY2lBB2c7d6E… 与本地 tarball 复算一致,补丁与入口齐备
- L1配置组合与依赖图✓跨包无 entry id 冲突,插入模块可解析,目录内 peer 满足
- L2隔离沙箱冒烟✓隔离 profile 安装成功,3.4s,层已挂载;宿主带它启动(booted)
- L3运行时健康监控✓抽样会话内未观测到外部进程 / 越界写 / 外连(2 个事件)
评分口径与作者信息
从 100 分开始按规则扣减:fail −20 / major −10 / warn −5 / minor −2;star 数、下载量、LLM 输出都不参与评分
- 维护者
- perrylink
- 仓库
- https://github.com/PerryLink/dsh-plugin-doctor
- 许可
- Apache-2.0
- 最后发布
- 2026-10-10
- 周下载
- 1.4k
- star
- 4
扫描状态:已扫描。能力是事实,不是缺陷; 周下载与 star 只作参考,不参与评分。
认证等级只回答四件事:包本身是否完整可解析(L0)、能不能与别的插件组合(L1)、隔离环境里装不装得上并起得来(L2)、抽样运行时有没有异常(L3)。依赖漏洞、仓库存活、下载量都不参与评级,只作为独立信号标注。可信 ≠ 无漏洞,上架 ≠ 推荐。
| Node 要求 | ^22.19.0 || >=24.0.0 |
|---|---|
| 第三方依赖 | 0 个(纯自包含) |
| bundle patch | ./cordis.patch.yml |
| 依赖安全公告 | 已查询全部依赖,没有匹配到已公开的安全公告(含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题,不是插件的。) |
元数据
| 主页 | https://www.npmjs.com/package/@perrylink/dsh-plugin-doctor |
|---|---|
| 仓库最近提交 | 2026-10-13 |
| 仓库创建 | 2026-09-07 |
DSH