DeepSeek Harness (DSH) 生态中插件数量众多,目前缺乏一个基于 npm 元数据、能直接给出“具体分数”和“修复建议”的质量评估工具。dsh-quality-score 针对这一痛点,为 DSH 插件提供了一套标准化的质量评分体系。
插件概览¶
- 名称:dsh-quality-score
- 维护者:zoahdev
- 类别:模型推理
- 许可证:MIT
这是一个 DeepSeek Harness (dsh) 插件的质量评分卡。它基于与生态供应链健康扫描相同的方法论,为每个插件生成 0-100 的综合评分、等级以及分项明细,并列出具体问题与修复建议。
安装¶
使用官方命令安装插件:
dsh plugin add dsh-quality-score
该插件零运行时依赖,默认只读操作,无需 API Key。
核心功能¶
- 评分与评级:输出 0-100 分的综合分数,并自动计算等级(A-F)。
- 分项明细:将评分拆解为多个具体组件,展示每个组件的得分与满分。
- 问题与建议:识别插件配置中的潜在问题,并提供修复建议。
- 批量排行榜:支持批量扫描,生成插件质量榜单。
- Agent 调用:可作为工具集成到 DSH Agent 中,通过
quality_score工具调用。 - 技术特性:无运行时依赖,离线环境可优雅降级。
使用方法¶
CLI 命令行¶
对单个插件进行评分:
dsh-quality-score <npm-name>
对列表中的多个插件进行批量评分并输出排行榜(文件中每行一个包名,# 开头的行被视为注释):
dsh-quality-score --batch <names-file>
Agent 调用¶
在 DSH Agent 会话中,可以直接调用 quality_score 工具。Agent 将返回包含 schema、score、grade、components、issues 和 suggestions 的结构化报告。
评分组件¶
评分由以下六个组件构成,总分 100 分:
| 组件 | 满分 | 衡量标准 |
|---|---|---|
manifest |
20 | latest 版本是否包含 name、version、description 和 license |
peer-resolvable |
20 | 每个 peer 依赖范围是否有已发布的匹配版本 |
dist-tag |
15 | latest 标签的健康度(如 #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 < 55