插件质量评分卡zoahdev/dsh-quality-score

dsh-quality-score

npm

CI
License: MIT
dsh-plugin

用于 DeepSeek Harness（dsh）插件的质量评分卡：0-100 分 + 等级 + 各组件明细，并附有问题与修复建议。

基于与生态系统供应链健康扫描相同的方法论：清单完整性、peer 可解析性、dist-tag 健康度（#2763 类问题）、失效范围、新鲜度，以及 dsh-tools peer 兼容性。零运行时依赖，只读。

安装

dsh plugin add dsh-quality-score

或独立运行：

npx dsh-quality-score dsh-dep-audit

CLI

dsh-quality-score  [--json]
dsh-quality-score --batch  [--json]
dsh-quality-score --batch-registry  [--category ] [--json]

打印分数、等级、组件明细、问题与建议。--batch 会为文件中的每个包名评分（每行一个，# 注释会被忽略），并打印排名排行榜——这是构建全注册表质量表的基石。

npx dsh-quality-score dsh-dep-audit
npx dsh-quality-score dsh-vault --json
npx dsh-quality-score --batch registry-names.txt

在 harness 内使用（可由 agent 调用）

向你的 dsh agent 提问：

给这个插件打个质量分：quality_score，包名 dsh-dep-audit。
Score this plugin: quality_score with name set to the npm package.

返回一份 dsh-quality-score/v1 报告：

{
"schema": "dsh-quality-score/v1",
"name": "dsh-dep-audit",
"ok": false,
"score": 65,
"grade": "C",
"components": [
{ "id": "manifest", "name": "Manifest completeness", "max": 20, "earned": 20, "note": "version 0.1.1" },
{ "id": "peer-resolvable", "name": "Peer resolvability", "max": 20, "earned": 20, "note": "1 peer range(s)" },
{ "id": "dist-tag", "name": "Dist-tag health", "max": 15, "earned": 15, "note": "latest=0.1.1" },
{ "id": "dead-ranges", "name": "Dead ranges", "max": 15, "earned": 15, "note": "none" },
{ "id": "freshness", "name": "Freshness", "max": 10, "earned": 10, "note": "2026-08-18" },
{ "id": "dsh-tools-peer", "name": "dsh-tools peer compat", "max": 10, "earned": 0, "note": "declared ^0.1.0-rc.6; dsh-tools latest=0.0.1-rc.1" }
],
"issues": ["declared @deepseek-ai/dsh-tools peer range is contradicted by the broken latest dist-tag (#2763 class)"],
"suggestions": ["Install with @deepseek-ai/dsh-tools@0.1.0-rc.7 (or the matching rc) until the official latest is fixed"],
"error": null
}

组件
| 组件 | 满分 | 衡量内容 |
|---|---|---|
| manifest | 20 | 最新版本中是否存在 name / version / description / license |
| peer-resolvable | 20 | 每个 peer 范围都有已发布的匹配版本 |
| dist-tag | 15 | latest 与 next 不一致（#2763 类） |
| dead-ranges | 15 | peer 范围引用了未发布的包名 |
| freshness | 10 | 最新发布在 365 天内 |
| dsh-tools-peer | 10 | 声明的 dsh-tools peer 被当前 latest dist-tag 满足 |

等级：A ≥ 95 · B ≥ 85 · C ≥ 70 · D ≥ 55 · F 以下。

为什么存在

- 注册表有 900+ 插件；质量信号存在（dsh-ecosystem、dsh-recommend），但没有任何东西能仅凭 npm 元数据给出每个插件的可操作评分及修复建议。
- 与供应链健康扫描相同的证据基础——官方侧修复一个 dist-tag 就能提升整个生态的分数。
- 零运行时依赖、只读；离线时优雅降级。

开发

pnpm install
pnpm typecheck
pnpm build
pnpm test
pnpm test:integration

CI 在 Windows 上运行 dsh-plugin-doctor 预检、单元测试（mock 注册表）、打包产物集成，以及全新 profile 的 dsh web 启动冒烟测试。

许可证

MIT © 2026 zoahdev

dsh-quality-score（中文）

DeepSeek Harness（dsh）插件的质量评分卡：0-100 分 + 等级 + 分项明细，带问题与修复建议。

方法学与 生态供应链健康扫描 一致：manifest 完整度、peer 可解析性、dist-tag 健康（#2763 类）、死依赖、新鲜度、dsh-tools peer 兼容性。零运行时依赖、只读。

安装

dsh plugin add dsh-quality-score

独立使用：

npx dsh-quality-score dsh-dep-audit
npx dsh-quality-score --batch registry-names.txt   # 批量评分，输出质量榜单

在 harness 内使用（agent 可调用）

给这个插件打个质量分：quality_score，包名 dsh-dep-audit。

返回 dsh-quality-score/v1 报告（结构见英文版 JSON 示例）。

分项

| 组件 | 满分 | 衡量 |
|---|---|---|
| manifest | 20 | latest 版本是否含 name/version/description/license |
| peer-resolvable | 20 | 每个 peer 范围是否有已发布版本匹配 |
| dist-tag | 15 | latest 与 next 不一致（#2763 类） |
| dead-ranges | 15 | peer 范围引用不存在的包名 |
| freshness | 10 | latest 发布时间是否在 365 天内 |
| dsh-tools-peer | 10 | 声明的 dsh-tools peer 是否被当前 latest 满足 |

等级：A ≥ 95 · B ≥ 85 · C ≥ 70 · D ≥ 55 · F 以下。

为什么需要它

- 注册表 900+ 插件，质量信号存在但没有“npm 元数据就能给分 + 修复建议”的插件。
- 与供应链健康扫描同一证据基础；官方修一个 dist-tag 就能拉高全生态分数。
- 零运行时依赖、只读；离线优雅降级。

开发

pnpm install
pnpm typecheck
pnpm build
pnpm test
pnpm test:integration

CI 跑 dsh-plugin-doctor 预检、单元测试（mock 注册表）、打包集成、Windows 全新 profile 的 dsh web 启动冒烟。

许可证

MIT © 2026 zoahdev
相关生态工具

- dsh-dep-audit - 依赖供应链卫生
- dsh-quality-score - 插件质量评分卡 + 全注册表排行榜
- dsh-ecosystem - 健康扫描、影响、趋势、实时仪表盘
- dsh-tutorials - 双语插件流水线教程
常见问题

- 如何安装？ 使用 dsh plugin add dsh-quality-score，或直接运行 CLI（参见 README）。
- 需要 API 密钥吗？ 不需要。
- 是只读的吗？ 默认是；任何写入/应用操作都需要显式标志。