dsh-plugin-health

dsh-plugin-health

⚠️ 已归档 / Archived:本工具的体检能力已并入 dsh-insights-kit 的 selfcheck 与「体检」页(npm 发布,一键安装)。本仓库不再维护,历史参考保留。 Archived: the health-check capability now lives in dsh-insights-kit (selfcheck + the Audit page). This repo is no longer maintained.

零依赖的 DeepSeek Harness (dsh) 插件体检 CLI · MIT · Node ≥ 20 · English

对任意 dsh 插件跑一组检查，输出带分级的体检报告（✅/⚠️/❌ + A–D，可存 Markdown / JSON），回答插件使用者和列表维护者在安装前想问的问题：

• 清单完整性 — dsh.bundle.patch 声明、cordis.patch.yml 已提交、exports["./client"] 存在、lib/index.js + lib/client.js 已发布、files 白名单、license 与 repository 元数据。
• npm 一致性 — 是否已发布？latest 是否与仓库版本脱节？（名字被抢注 / 版本滞后会在这里暴露）
• 仓库信号 — 年龄（awesome-dsh-plugin 的 ≥1 天门禁）、活跃度、star、dsh-plugin topic、是否归档/fork。
• 文档与 i18n — README / 中文 README / LICENSE。
• 只读面检查（本地 --dir 模式） — 扫描源码中的文件系统写、子进程调用与 HTTP 写动词；检查 HTML/Markdown 渲染是否带消毒手段（DOMPurify / marked / escape）。"只读"声明由代码验证，而非空口。

零依赖；仅访问公开 GitHub + npm API（设 GITHUB_TOKEN 可提高限额）。

用法

# 检查 GitHub 仓库（默认同时查 npm 发布状态）
dsh-plugin-health ice5kysl/dsh-workspace-kit
dsh-plugin-health ice5kysl/dsh-file-explorer-kit

# 检查本地插件目录（附加只读面安全扫描）
dsh-plugin-health --dir /path/to/plugin

# 输出 Markdown 报告 / JSON
dsh-plugin-health ice5kysl/dsh-workspace-kit -o report.md
dsh-plugin-health --dir /path/to/plugin --json

不安装直接跑：

npx --yes github:ice5kysl/dsh-plugin-health ice5kysl/dsh-workspace-kit

样板报告

• dsh-workspace-kit
• dsh-file-explorer-kit

计分

满分 100：warn −5、fail −20、info/pass 0。等级 A ≥ 90 · B ≥ 75 · C ≥ 60 · D < 60。扫描是启发式初筛而非安全审计 —— 采信"只读"声明前请先读说明。

开发

node index.mjs <owner/repo>   # 或 --dir …