PerryLink/dsh-score

🏆 dsh-score

• 1024 商店渠道：先 npm i -g dsh1024，再 dsh1024 plugin --profile web add dsh-score（计入 deepseek1024.com 安装排行）。

为 DeepSeek Harness 插件提供多指标质量评分。

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

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

---

📖 生态实测知识库（实测数据，不是营销）：插件开发指南 · 选型实测数据 · 维护取舍判据。

⭐ 如果它帮到了你

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

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

兼容性

组件	版本
DeepSeek Harness	dsh-v0.2.1-alpha.1（GitHub tag；peer 区间已承认 alpha.2 线：>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0）。dev/test 钉号与 typecheck:ci 尺子现对照已发布的 0.1.7-rc.2 线（0.1.6-alpha.2 面已于 2026-09-18 核验：类型门 + 单元/装配测试 + 制品构建）；ctx.jobs 接缝已迁移到 alpha.2 的 SessionId 契约。
Node.js	^22.19.0 || >=24.0.0
包管理器	pnpm@11.7.0
平台	Windows / macOS / Linux（纯 host 插件）
外部工具	PATH 上的 gh CLI（已认证用于 API 读取）、PATH 上的 npm CLI

你会得到什么

• score 工具——对单个目标跑五维评分流水线；返回结构化风险卡，传 background: true 时返回 { kind: 'background', jobId }。
• /score 命令——把空白/逗号分隔的目标列表作为 score-batch 后台任务（ctx.jobs）批量评分，产出排行榜快照（JSON + Markdown）。
• score_report 工具——按 id 取回评分卡（sc_...）、排行榜（lb_...）或最新排行榜。
• 五个维度（权重可配置，默认合计 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 打印的精确键复制到 profile 的 pnpm-workspace.yaml 后重试：

allowBuilds:
  'dsh-score': true

npm 通道

dsh plugin --profile web add dsh-score

预构建包无需构建许可。重启 profile 后即可在会话中使用 score / /score。

安装与卸载

dsh plugin --profile web add dsh-score     # 安装（npm）——或上面的 git 形式
dsh plugin --profile web remove dsh-score  # 卸载

配置

所有键均可选（括号为默认值）；非法值在加载期响亮失败。

键	默认值	说明
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 + endpoint + Markdown 嵌入）与紧凑五维 JSON——见下文「徽章与 JSON API」。

Structured result sample

{
  "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.1.0",
  "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)"
}

计分：总分为收集到证据维度的加权平均（no-evidence 维度被剔除并重新归一）；A ≥ 90，B ≥ 75，C ≥ 60，D ≥ 40，否则 F，全无证据时为 N/A。

徽章与 JSON API

score_badge 为某个已评分目标生成可嵌入 README 的徽章与五维 JSON。

徽章

• 徽章：shields.io 扁平 SVG（badge.svg 字段 / renderScoreBadge）、文档化端点 URL、以及 Markdown 嵌入片段。

嵌入总徽章：

![dsh-score: B · 84/100](https://img.shields.io/badge/dsh--score-B_%C2%B7_84%2F100-green)

五维 JSON

• 五维 JSON：install/maintenance/documentation/security/compliance 各自的 status/score/weight/summary，外加加权 total 与字母 grade（schema: "dsh-score/badge/v1"）。

no-evidence 维度保持诚实状态并计 0 分——徽章与 JSON 绝不伪造数字。

权限与数据

• 只消费公开服务：ctx.subprocess、ctx.jobs、ctx.storageDomain、ctx.tools、ctx.commands。
• 评分卡与排行榜存于 score 存储域（表 scores、leaderboards；最新排行榜指针）。组合里没有 storageDomain（如官方 headless profile）时工具仍可用，评分持久化被禁用并记录原因。官方 dsh-base bundle 自 0.1.2-rc.1 起就挂载 storage-domain（已对 0.1.2-rc.1 与 0.1.5-alpha.1 的 tarball 核验），因此已发布线上持久化是启用的。
• 子进程继承 provider 已剥离凭据的环境；gh 读取其自身的凭据存储。任何环境变量值都不被记录。
• 所有报告/日志字符串经过纯脱敏函数：token 字面量、URL 凭据、bearer 头被脱敏，尾部按字节截断。

安全边界

• 不执行代码。流水线只运行 gh api 与 npm view；绝不安装、构建或运行目标。
• 仅 argv 子进程。每次 CLI 调用都是 argv 数组，绝不经过 shell 解释；owner/repo 段在用于端点前先做受限字符集校验。
• 证据纪律。不编造评分：探测失败或输出不可解析时返回 no-evidence，绝不填数字。
• 检测与脱敏分离。密钥泄露与恶意安装脚本检测复用与脱敏同一套纯正则，二者均有极端输入单测。

已知限制

• 仓库探测需要 gh 已认证且有到 GitHub 的网络；npm 探测需要 npm 与 registry 访问。
• 无法解析出 GitHub 仓库的目标无法检查文档、安全或合规（这些维度报告 no-evidence）。
• 安装成功率依赖 dsh-test-drive 已挂载且已记录该目标；否则如实为 no-evidence。
• 维护维度的“issue 响应”是代理信号（最久未关闭 issue 年龄），不是直接响应时长测量。
• 评分按目标缓存；用 refresh: true（或等过 cacheMaxAgeMs）强制重评。

开发

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 checkout 解析 @deepseek-ai/*；typecheck:ci 对照已发布的 0.1.7-rc.2 类型。
• 测试使用真实 Context/Session/ToolRuntime/LocalJobRegistry/存储栈，子进程 provider 为脚本化实现。
• 真实 CLI 评分（需 PATH 有 gh/npm，gh 已认证）：在已挂载 profile 中调用 score。
• 发布：node scripts/release.mjs <x.y.z>（升版本、盖 CHANGELOG、重跑门禁、提交 + tag；绝不 push）。

主题

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

贡献者

PerryLink — 设计与实现。

PerryLink DSH Plugin Family

This project is one of the 44 DeepSeek Harness plugins maintained by PerryLink. If this one helps you, the others likely will too:

Plugin	One-liner
dsh-auto-review	Second-model auto-review on the approval chain, fail-closed by default
dsh-autotier	Automatic strong/cheap model-tier routing with deterministic risk guards and a /tier command
dsh-background-agents	Durable background child agents with a Web UI sidebar, messaging and interrupt
dsh-budget	Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel.
dsh-catalog	DSH Desktop Market standard catalog source for the PerryLink family
dsh-cert-mcp	Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence
dsh-checkpoint-rewind	Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore
dsh-claude-move	Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH
dsh-click	Cross-platform native desktop control for DeepSeek Harness — Windows first.
dsh-composer-history	Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-data-quality	Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here)
dsh-defend	Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness.
dsh-doublecheck	Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-draw	Unified static-image generation routing for DeepSeek Harness.
dsh-fast	Read-only performance diagnostics for DeepSeek Harness.
dsh-fund-research	Deterministic research reports for Chinese public mutual funds
dsh-github	GitHub PR/issues integration for DSH, every write gated by approval
dsh-industry-research	Industry research orchestration that seals its deliverables through this plugin's ctx.researchReport.assemble
dsh-laya	Laya typed decisions (noul/choice/score) as a first-class Cordis service and model-visible tools
dsh-library	Local document knowledge base for DeepSeek Harness.
dsh-local-ai	Local-model (Ollama) integration for DeepSeek Harness.
dsh-lsp-actions	LSP diagnostics, formatting, completion, code actions and rename over language servers
dsh-mask	PII masking middleware: anonymize at the model boundary, restore at the display layer
dsh-mcp-panel	Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors
dsh-memento	Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool
dsh-observe	OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.
dsh-output-styles	Claude Code outputStyles-equivalent runtime style switching
dsh-permission-rules	Claude Code-style declarative allow/deny/ask permission rules with audit
dsh-plugin-certification	Community certification registry with repro-checkable grades and badges
dsh-plugin-doctor	Zero-dependency static + sandbox smoke detector for DSH plugins
dsh-plugin-guide	Plugin-development knowledge base as an on-demand agent skill
dsh-plugin-kit	Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins
dsh-plugin-upgrade	One-package, one-corridor-index plugin upgrade skill: routes a repository to the matching closed corridor card
dsh-reach	Multi-channel approval/question bridge: WeChat/Telegram/Feishu, session console
dsh-research-report	Verifiable research-report engine: content-addressed evidence ledger and sealed versions
dsh-score	Multi-dimensional quality scoring for DeepSeek Harness plugins.
dsh-session-pin	Pin sessions in the Web sidebar with durable ordering
dsh-session-sync	Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.
dsh-skill-pack-security	Security-audit skill pack: secret scan, dependency and supply-chain review
dsh-talk	Voice-first session loop for DeepSeek Harness: talk to it, hear it answer.
dsh-team-rooms	Cross-session team rooms: shared message bus, task board and timeline
dsh-test-drive	Isolated install-and-smoke test drives for DeepSeek Harness plugins.
dsh-ticktick	TickTick/Dida365 task bridge: session-header panel + 11 tools
dsh-translate	Vendor parameter translation and deterministic JSON repair for DeepSeek Harness.

从 DSH Desktop 市场安装

所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览：市场 → 来源 → 添加来源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中。安装仍需通过市场的 npm 身份校验与你的确认。

许可证

Apache-2.0