浏览全部

开发与运行时 · v0.7.0

dsh-plugin-doctor

github.com/PerryLink/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 项能力
许可
Apache-2.0
发布
2026-10-10
维护者
perrylink
插件 ID
1018

安装命令

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.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, '/')}`)
    • 动态导入本身无害,但会让依赖关系难以静态审阅。
  • 接触凭据或密钥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

返回首页