插件质量评分 PerryLink/dsh-score

🏆 dsh-score

状态：活跃。 这是本地按需运行的先验检查器；公开证据层是 dsh-attention-index。没有 FROZEN 横幅。
- 1024 商店渠道：先执行一次 npm i -g dsh1024，再执行 dsh1024 plugin --profile web add dsh-score（计入 deepseek1024.com 的安装排名）。

dshfind

为 DeepSeek Harness 插件做多维度质量评分。

五个维度，真实的 gh/npm 证据，一张加权风险卡和一份排行榜。

dsh-doctor
DSH Market

English · 简体中文 · Español · Português · हिन्दी

dsh plugin --profile <name> add dsh-score

📖 生态知识库 —— 实测数据，不是营销话术：插件开发指南 · 插件选型数据 · 维护标准。

安装与卸载

dsh plugin --profile web add dsh-score # install (npm) — or the git form above
dsh plugin --profile web remove dsh-score # uninstall

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（95 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 95 plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

dsh-score 是什么？

为 DeepSeek Harness 插件提供多维度质量评分。

五个维度，真实的 gh/npm 证据，一张加权风险卡和排行榜。

dsh-score 的工作流示意图：问题 → 封存来源 → 报告。

工作流概览：问题 → 封存来源 → 报告。下面的示例使用真实命令接口。

对比

dsh-score 的实测对比图

兼容性

| 组件 | 版本 |
| DeepSeek Harness | dsh-v0.2.1-rc.2（GitHub tag）。engines.dsh 门限为 >=0.2.1-0 <0.3.0；开发/测试固定版本和 typecheck:ci 标尺都测 0.2.1-rc.2。ctx.jobs 接缝使用 SessionId 契约。 |
| Node.js | ^22.19.0 \|\| >=24.0.0 |
| 包管理器 | pnpm@11.7.0 |
| 平台 | Windows / macOS / Linux（仅宿主插件） |
| 外部工具 | PATH 上的 gh 命令行（API 读取需已认证）、PATH 上的 npm 命令行 |

你会得到什么

- score 工具 —— 让一个目标走完五维流水线；返回结构化风险卡，或返回 { kind: 'background', jobId } 并带 background: true。
- /score 命令 —— 把以空白或逗号分隔的目标列表作为 score-batch 后台任务，经 ctx.jobs 批量评分，产出排行榜快照（JSON + Markdown）。
- score_report 工具 —— 获取任意已存评分卡（sc_...）、排行榜（lb_...），或最新排行榜。
- score_badge 工具 —— 可嵌入 README 的徽章（shields.io flat SVG + 端点 URL），以及某个已评分目标的五维 JSON。
- 五个维度（权重可配置，默认合计 100）：安装成功率 25、维护 20、文档 20、安全 20、合规 15。
- 证据纪律 —— 每个维度都记录审计链接（source、脱敏后的 detail、observedAt）；没有证据的维度报 no-evidence（分数 0，不计入加权总分），绝不编造数字。
- 结构化结果 —— 每条记录都带 schema: "dsh-score/v1" 和一等字段；这是下游工具消费的机器可读契约。

快速开始

Git 渠道

dsh plugin --profile web add github:PerryLink/dsh-score#<commit-sha>

首次 add 会失败，因为 pnpm 拦截了包的 prepare 构建；把 pnpm 打印出的确切键复制到配置档的 pnpm-workspace.yaml，再重跑：

allowBuilds:
'dsh-score': true

npm 渠道

dsh plugin --profile web add dsh-score

预构建包无需构建许可。重启配置档，然后在会话里使用 score / /score。

示例

这些是插件的真实入口；装一次，然后调用其中一个。

详细示例

命令

~~~sh
score({ target: "owner/repo" })

输出

~~~text

Score sc_65e817eec8cd71ed

- Target: owner/repo (repo)
- Grade: B — total 88/100
- Verdict: healthy (weighted total 88/100)
| 维度 | 状态 | 分数 | 权重 | 摘要 |
| 安装成功率 | ⬜ 无证据 | 0 | 25 | 该目标没有记录 dsh-test-drive 结果（安装成功率未测量） |
| 维护 | ✅ 通过 | 100 | 20 | 活跃（2026-08-15T00:00:00.000Z；0 个未关闭 issue） |
| 文档 | 🟠 警告 | 70 | 20 | 1/4 语言 README + CHANGELOG + SECURITY |
| 安全 | ✅ 通过 | 100 | 20 | 许可证 MIT |
| 协议合规 | ✅ 通过 | 81 | 15 | 已声明 dsh.bundle.patch |

观察自 README.md:141-149,169-191; tests/tools.spec.ts:64-65; tests/score.spec.ts:50-55; src/report.ts:40-53

失败分支

输入

~~~text
{"id":"sc_nope"}

输出

~~~text
isError=true; error.message=dsh-score: no score recorded with id sc_nope

观察自 plugins/dsh-score/src/tools.ts:351-354 (throw); plugins/dsh-score/tests/tools.spec.ts:95-99 (unknown id); plugins/dsh-score/README.md:179-181 (score_report); exercised through plugins/dsh-score/tests/harness.ts

简要示例

配置

所有键都是可选的（默认值如下）；值不合法会在加载时直接报错。

| 键 | 默认值 | 说明 |
| probeTimeoutMs | 60000 | 单条 gh/npm 探测命令的截止时间。 |
| outputTailBytes | 8000 | 每次探测记录的净化输出尾部上限。 |
| cacheMaxAgeMs | 86400000 | 缓存评分卡在重新评分前的复用时长（0 表示禁用缓存）。 |
| staleCommitWarnDays | 90 | 提交/发布年龄达到该值时，维护维度降为 warn。 |
| staleCommitFailDays | 365 | 提交/发布年龄达到该值时，维护维度降为 fail。 |
| staleIssueWarnDays | 30 | 最早未关闭 issue 的年龄（响应代理指标）达到该值时，维护维度降为 warn。 |
| staleIssueFailDays | 180 | 最早未关闭 issue 的年龄达到该值时，维护维度降为 fail。 |
| maxBatchTargets | 20 | /score 批量上限。 |
| batchConcurrency | 1 | 批量并发数（串行可避免 API 限流争用）。 |
| weights | {install:25, maintenance:20, documentation:20, security:20, compliance:15} | 各维度权重（每项 0–100；至少有一项必须 > 0）。 |

工具与入口

score

score(target: string, refresh?: boolean, background?: boolean)

- target —— GitHub 仓库（github:owner/repo、owner/repo、git/https URL）或 npm 包名。
- refresh: true 绕过评分缓存，重新收集证据。
- background: true 启动 score-batch 任务并返回其 id。

/score <targets...>

启动一个后台批量任务；进度通过任务输出流式推送，最后一行给出 score_report 要用的排行榜 id。

score_report(id?)

返回评分卡（sc_...）、排行榜（lb_...），或者在不传 id 时返回最新排行榜。

score_badge(target? | id?, refresh?)

为单个目标生成可嵌入 README 的徽章，以及五维 JSON：
- target — 给 GitHub 仓库或 npm 包打分（走缓存），再生成徽章；与 id 互斥。
- id — 给已存好的评分卡（sc_...）生成徽章，不重新打分。
- refresh: true — 跳过评分缓存（只对 target 生效）。

返回徽章（SVG + 端点 + Markdown 嵌入片段）和精简的五维 JSON —— 见 徽章与 JSON API。

结构化结果示例

{
"schema": "dsh-score/v1",
"scoreId": "sc_8f1c2e4a9b3d7f01",
"target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123" },
"scoredAt": "2026-08-16T00:00:00.000Z",
"durationMs": 3210,
"pluginVersion": "0.2.22",
"dimensions": {
"install": { "dimension": "install", "status": "no-evidence", "score": 0, "weight": 25,
"summary": "no dsh-test-drive result recorded for this target (install success unmeasured)",
"evidence": [{ "source": "test-drive", "detail": "no test-drive record found in the test_drive domain", "observedAt": "2026-08-16T00:00:00.000Z" }] },
"maintenance": { "dimension": "maintenance", "status": "pass", "score": 100, "weight": 20,
"summary": "active (2026-08-10T00:00:00Z; 0 open issues)",
"evidence": [{ "source": "gh-api", "detail": "last activity 2026-08-10T00:00:00Z", "observedAt": "2026-08-16T00:00:00.000Z" }] }
},
"total": 88,
"grade": "B",
"verdict": "healthy (weighted total 88/100)"
}

评分规则：总分是各维度得分的加权平均，只算收集到证据的维度（无证据的维度剔除后重新归一化）；A ≥ 90，B ≥ 75，C ≥ 60，D ≥ 40，其余为 F；所有维度都没有证据时记 N/A。

徽章与 JSON API

score_badge 针对一个已打分的目标，生成可嵌入 README 的徽章和五维 JSON。

徽章

三种形式，都来自同一张已定稿的评分卡：

- 端点 — 一个 shields.io 静态 URL，有文档说明，可直接粘进 README 当图片（无需自建服务）。
- SVG — 自包含的 shields.io flat 风格 SVG（badge.svg 字段 / renderScoreBadge），适合离线或自建 README。
- Markdown — 把两者合在一起的嵌入片段。

在任意 README 里嵌入总分徽章：

五维 JSON

同一次调用还会返回精简的 JSON API 信封（schema: "dsh-score/badge/v1"）：

{
"schema": "dsh-score/badge/v1",
"target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123" },
"scoredAt": "2026-08-16T00:00:00.000Z",
"total": 84,
"grade": "B",
"dimensions": {
"install": { "label": "install", "status": "no-evidence", "score": 0, "weight": 25, "summary": "no dsh-test-drive result recorded" },
"maintenance": { "label": "maintenance", "status": "pass", "score": 90, "weight": 20, "summary": "active (0 open issues)" },json
"documentation": { "label": "docs", "status": "pass", "score": 85, "weight": 20, "summary": "README + CHANGELOG + SECURITY" },
"security": { "label": "security", "status": "warn", "score": 60, "weight": 20, "summary": "permissive license" },
"compliance": { "label": "compliance", "status": "pass", "score": 100, "weight": 15, "summary": "dsh.bundle.patch + dsh-plugin topic" }
}
}

no-evidence 维度保留真实状态和 0 分——徽章和 JSON 都不会编造数字。

权限与数据

- 只消费公开服务：ctx.subprocess、ctx.jobs、ctx.storageDomain、ctx.tools、ctx.commands。
- 评分卡和排行榜存放在 score 存储域（表 scores、leaderboards；最新排行榜指针）。组合里没有 storageDomain 时（早于基础包存储行的配置档，比如 0.1.1-rc.2 时代的 headless 配置档），工具照常可用，评分持久化关闭，并记录原因。已发布的 dsh-base 包从 0.1.2-rc.1 起挂载存储域（已对照 0.1.2-rc.1 和 0.1.5-alpha.1 的 tarball 验证），所以已发布线上持久化是生效的。
- 子进程继承服务商清理过凭据的环境；gh 读取自己的凭据存储。任何环境值都不会写进日志。
- 所有报告/日志字符串都经过纯净化器：token 字面量、URL 凭据、bearer 头一律脱敏，尾部按字节截断。

安全边界

- 不执行代码。 流水线只运行 gh api 和 npm view；从不安装、构建或运行目标。
- 子进程只用 argv。 每次命令行调用都是 argv 数组，从不经 shell 解释；仓库 owner/repo 段在用于端点前，先按受限字符集校验。
- 证据纪律。 不编造分数：探测失败或输出无法解析时给出 no-evidence，绝不给数字。
- 检测与脱敏。 密钥泄露检测和恶意安装脚本检测与脱敏共用同一套纯正则；两者都针对极端输入做了单元测试。

已知限制

- 仓库探测要求 gh 已认证，且能访问 GitHub 网络；npm 探测要求 npm 和 registry 访问。
- 目标没有可解析的 GitHub 仓库时，无法检查文档、安全、合规（这些维度报 no-evidence）。
- 安装是否成功取决于 dsh-test-drive 是否挂载并记录了目标；否则如实报 no-evidence。
- 维护性的「issue 响应」信号是代理指标（最老未关闭 issue 的年龄），不是直接测量的响应时间。
- 评分结果按目标缓存；用 refresh: true（或等过 cacheMaxAgeMs）强制重新评分。

开发 sh
pnpm install
pnpm run typecheck && pnpm run typecheck:ci && pnpm test
pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack

- typecheck 通过本地 harness 检出解析 @deepseek-ai/*；typecheck:ci 对照已发布的 0.1.7-rc.2 类型做检查。
- 测试使用真实的 Context/Session/ToolRuntime/LocalJobRegistry/存储栈，搭配脚本化的子进程服务商。
- 真实命令行评分（需要 gh/npm 在 PATH 中，且 gh 已认证）：从挂载的配置档调用 score。
- 发布：node scripts/release.mjs <x.y.z>（升版本号、写入 CHANGELOG、重跑校验、提交并打标签；从不推送）。

主题

dsh、dsh-plugin、deepseek-harness、deepseek、cordis、plugin-scoring、quality-score、leaderboard、supply-chain

贡献者

PerryLink — 设计与实现。

PerryLink DSH 插件家族

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。下方名单默认折叠，好让每个 README 的首屏都保持简短；展开即可查看每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | 🧊 已冻结 — 见仓库 README |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | 🧊 已冻结 — 见仓库 README |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-budget | 🧊 已冻结 — 见仓库 README |
| dsh-claude-move | 🧊 已冻结 — 见仓库 README |
| dsh-defend | 🧊 已冻结 — 见仓库 README |
| dsh-draw | 🧊 已冻结 — 见仓库 README |
| dsh-reach | 🧊 已冻结 — 见仓库 README |
| dsh-background-agents | 🚫 已退役 — 见仓库 README |
| dsh-session-pin | 🚫 已退役 — 见仓库 README |
| dsh-team-rooms | 🚫 已退役 — 见仓库 README |

许可证

Apache-2.0