dsh-plugin-scorecard

DSH 插件体检评分卡：质量与安全审计、榜单与搜索。Quality & security scorecard, rankings and search for the dsh-plugin ecosystem.

一个 Cordis 插件，把「哪些插件值得装、哪个有风险」变成可执行的评分与报告：

• plugin_sync_catalog 同步 GitHub dsh-plugin topic 目录（star 排序，可配上限）
• plugin_audit <名称> 对单个插件出体检报告：0-100 分、A/B/C/D 等级、信号明细、证据链；高危安装脚本一票否决（🚨 封顶 30 分）
• plugin_top 榜单（按评分 / star / 最近更新）
• plugin_search <关键词> 语义搜索目录
• plugin_history <名称> 历史评分曲线（时间/分数/等级、趋势方向）
• plugin_export 导出目录与评分开放数据 JSON（默认 .dsh/scorecard-export.json）

Compatibility

Tool schemas are validated against the @deepseek-ai/dsh-tools value-schema DSL at plugin load (checked against dsh-tools 0.1.0-rc.6 and 0.1.1-rc.2). Earlier releases used JSON-Schema required at the root of output.schema and closed nested objects without declared properties, which made the host abort the whole profile boot with unsupported JSON schema: schema.required is not supported by the value schema DSL and could reject the tool's own results. Current releases fix both; if an affected version left your DSH unable to start, remove the plugin from the profile (or upgrade) — no data is lost.

评分模型

维度	满分	说明
维护活跃度	30	最近 push、star 量、是否归档
文档质量	25	README、描述、许可证、标签
npm 可装性	15	npm 包存在性、更新度、周下载
安全	30	安装脚本高危模式（curl

等级：A ≥80 · B ≥60 · C ≥40 · D <40。命中高危模式 → 封顶 30 分 + 🚨 不推荐。

安装

dsh plugin add dsh-plugin-scorecard

或编辑 profile 的组合：cordis.patch.yml 已内置 insert 条目（id: dsh-plugin-scorecard）。

配置（可选）

字段	默认	说明
githubToken	""	GitHub Token，提升 API 限额（无 Token 时 60 次/小时）
securityScan	true	是否扫描安装脚本
cacheTtlMs	900000	目录缓存 TTL（含工作区文件缓存）
catalogFile	.dsh/scorecard-catalog.json	目录持久化文件（会话工作区内）
historyFile	.dsh/scorecard-history.json	评分历史文件（会话工作区内）
historyMaxEntries	100	历史快照条数上限
exportFile	.dsh/scorecard-export.json	开放数据导出文件（会话工作区内）
maxCatalogSize	200	每次同步的仓库数上限

开发

node --check lib/index.js
node test/scorer.test.mjs   # 主模块方式（沙箱里勿用 node --test）
node test/format.test.mjs

路线图

• v0.2 ✅：目录持久化（JSON 缓存）+ 历史评分曲线（plugin_history）
• v0.3 ✅：目录增量同步（新增/更新/未变/移出）+ 开放数据导出（plugin_export）
• v0.3：Web 设置页榜单（ui-settings-plugins 扩展点）+ 开放数据导出 JSON
• v0.4：企业审计报告导出 / 私有化

License

MIT