dsh-score 0.2.28 → 0.2.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -83,6 +83,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
83
83
 
84
84
  ## [Unreleased]
85
85
 
86
+ ## [0.2.29] - 2026-11-18
87
+
86
88
  ## [0.2.18] - 2026-10-04
87
89
 
88
90
  undefined
package/README.en.md ADDED
@@ -0,0 +1,525 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-score-hero-en-dark.webp">
5
+ <img src="docs/assets/dsh-score-hero-en-light.webp" width="100%" alt="dsh-score hero: the plugin name and value lines on the left; on the right, a real score card - the install row is no-evidence and drops out of the divisor, the other four dimensions carry their score and weight, the weighted total is 88/100 at grade B, and the footer marks local, on-demand, read-only probes">
6
+ </picture>
7
+
8
+ # dsh-score
9
+
10
+ **Turn any repository or npm package into a five-dimension quality scorecard with evidence links — install, maintenance, docs, security, compliance, every point traceable.**
11
+
12
+ A local scorer for DeepSeek Harness: it collects evidence with `dsh-v0.2.2-rc.4`(2026-11-18);`gh api` and `npm view` only — it never installs, builds, or runs the target — and records `no-evidence` instead of inventing a number.
13
+
14
+ [Install](#three-step-setup) · [Configuration](#configuration) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
+
16
+ [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
17
+ [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.2.1%20%3C0.3.0-4B67B4?style=flat-square&labelColor=2B3245)](#compatibility)
18
+ [![npm](https://img.shields.io/npm/v/dsh-score?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-score)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-score/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-score/actions/workflows/ci.yml)
20
+ [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24.9-339933?style=flat-square&labelColor=2B3245)](#compatibility)
21
+
22
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-score?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-score/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-score?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-score)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-score?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-score?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-score/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-score)
26
+ [![DSH Market](https://img.shields.io/badge/DSH_Market-listed-4B67B4?style=flat-square&labelColor=2B3245)](https://dsh.market/)
27
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-score)
28
+
29
+ ```sh
30
+ dsh plugin --profile <name> add dsh-score
31
+ ```
32
+
33
+ </div>
34
+
35
+ <sub>Community plugin, not affiliated with DeepSeek. Canonical repository: <https://github.com/PerryLink/dsh-score> (Gitee is a mirror).</sub>
36
+
37
+ ## What it is
38
+
39
+ `dsh-v0.2.2-rc.4`(2026-11-18);`dsh-score` is a local quality scorer for DeepSeek Harness: give it a GitHub repository or an npm package and it runs the five dimensions — install success, maintenance, documentation, security, and compliance — then returns a structured score card (`schema: "dsh-score/v1"`) or a JSON + Markdown leaderboard. Every conclusion comes from real `gh`/`npm` output and every piece of evidence carries `source`, sanitized `detail`, and `observedAt`; a dimension that gathers no evidence reports `no-evidence` (score 0, excluded from the weighted total) instead of a guessed number. Scoring is on demand only — nothing is installed, built, or executed. This plugin is the local on-demand scorer; the public evidence layer lives in [`dsh-attention-index`](https://github.com/PerryLink/dsh-attention-index).
40
+
41
+ <picture>
42
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-score-flow-v5-dark.svg">
43
+ <img src="docs/assets/dsh-score-flow-v5-light.svg" width="100%" alt="dsh-score structure: three intake channels on top (seven read-only gh api calls, npm view --json, and the reserved test_drive domain) feed evidence[]; below them the five-dimension bench whose column width is the weight (install 25 / maintenance 20 / documentation 20 / security 20 / compliance 15), with install hollow at 0 and removed from the divisor; the weight rail shows 100 to 75, the total plate computes 6615 / 75 = 88 at grade B, and three outputs close the figure: the sc_ score card, the lb_ leaderboard, and score_badge">
44
+ </picture>
45
+
46
+ ## Three-step setup
47
+
48
+ 1. **Install** (pick one channel):
49
+
50
+ ```sh
51
+ # git channel (latest main; equivalent to git+https://github.com/PerryLink/dsh-score.git)
52
+ dsh plugin --profile web add github:PerryLink/dsh-score#<commit-sha>
53
+ # npm channel (published releases)
54
+ dsh plugin --profile web add dsh-score
55
+ ```
56
+
57
+ The first `add` through the git channel fails because pnpm blocks the package's `prepare` build; copy the exact key pnpm printed into the profile's `pnpm-workspace.yaml` and re-run:
58
+
59
+ ```yaml
60
+ allowBuilds:
61
+ 'dsh-score': true
62
+ ```
63
+
64
+ Prebuilt packages from the npm channel need no build allowance.
65
+
66
+ 2. **Minimal config** (the defaults work; add keys only to change thresholds or weights):
67
+
68
+ ```yaml
69
+ - insert:
70
+ - id: score
71
+ name: dsh-score
72
+ config:
73
+ weights:
74
+ install: 25
75
+ maintenance: 20
76
+ documentation: 20
77
+ security: 20
78
+ compliance: 15
79
+ ```
80
+
81
+ 3. **Verify it mounts**:
82
+
83
+ ```sh
84
+ dsh --profile web --dump-config | grep -A2 'id: score'
85
+ ```
86
+
87
+ ```
88
+ > /score owner/repo
89
+ [1/1] owner/repo → B (88/100, healthy (weighted total 88/100))
90
+ ```
91
+
92
+ *Observed from `src/batch.ts:70`*
93
+
94
+ **Uninstall**: `dsh plugin --profile web remove dsh-score` (or remove the row from the profile patch).
95
+
96
+ > `dsh-score` does not bundle the storage stack. When the composition has no `storageDomain`, the tools still work and score persistence is disabled with a logged reason; the published `dsh-base` bundle mounts storage-domain from `0.1.2-rc.1` on (verified against the `0.1.2-rc.1` and `0.1.5-alpha.1` tarballs), so persistence is active on the published line.
97
+
98
+ ## Core capabilities
99
+
100
+ `dsh-score` compresses "can it be installed, is it maintained, are the docs complete, is it secure, does it comply" into one reviewable score card:
101
+
102
+ - **Five dimensions** — install success `25`, maintenance `20`, documentation `20`, security `20`, compliance `15` (weights configurable; defaults sum to 100).
103
+ - **Evidence discipline** — every dimension records its audit links (`source`, sanitized `detail`, `observedAt`); a dimension without evidence reports `no-evidence` (score 0, excluded from the weighted total) and never a fabricated number.
104
+ - **Structured results** — every record carries `schema: "dsh-score/v1"` with first-class fields; this is the machine-readable contract downstream tooling consumes.
105
+ - **Batch leaderboard** — `/score` hands a target list to a `score-batch` job over `ctx.jobs`, producing a JSON + Markdown leaderboard snapshot.
106
+ - **Cache and refresh** — score cards are cached per target (24 hours by default); `refresh: true` bypasses the cache and re-gathers evidence.
107
+ - **Embeddable badge** — `score_badge` returns a shields.io badge (endpoint / SVG / Markdown) plus the five-dimension JSON, and the total badge drops straight into any README.
108
+
109
+ ```text
110
+ target ──gh api / npm view──▶ five dimensions of evidence ──weighted──▶ score card dsh-score/v1 ──▶ leaderboard lb_...
111
+ │
112
+ └─ no evidence → no-evidence (score 0, excluded)
113
+ ```
114
+
115
+ ## Tools & results
116
+
117
+ ### Tool surface
118
+
119
+ | Entry | Type | Notes |
120
+ |---|---|---|
121
+ | `score` | tool | Scores one target through the five dimensions; `refresh: true` bypasses the cache, `background: true` starts a `score-batch` job |
122
+ | `/score <targets...>` | command | Scores a whitespace/comma-separated target list; progress streams through the job output and the final line names the `lb_...` for `score_report` |
123
+ | `score_report` | tool | Fetches a score card (`sc_...`), a leaderboard (`lb_...`), or — with no id — the latest leaderboard |
124
+ | `score_badge` | tool | Generates a shields.io badge and the five-dimension JSON for a target or a stored score card |
125
+ | `score-batch` | background job | The batch job over `ctx.jobs`; it scores serially and writes the leaderboard snapshot |
126
+
127
+ ### Tool parameters
128
+
129
+ ```
130
+ score(target: string, refresh?: boolean, background?: boolean)
131
+ ```
132
+
133
+ - `target` — a GitHub repository (`github:owner/repo`, `owner/repo`, a git/https URL) or an npm package name.
134
+ - `refresh: true` — bypass the score cache and re-gather evidence.
135
+ - `background: true` — start a `score-batch` job and return its id.
136
+
137
+ `score_report(id?)` returns a score card (`sc_...`), a leaderboard (`lb_...`), or — with no id — the latest leaderboard.
138
+
139
+ `score_badge(target? | id?, refresh?)`:
140
+
141
+ - `target` — score a GitHub repo or npm package through the cache and badge it; mutually exclusive with `id`.
142
+ - `id` — badge a stored score card (`sc_...`) without re-scoring.
143
+ - `refresh: true` — bypass the score cache (only applies to `target`).
144
+
145
+ ### Score card example
146
+
147
+ These are the plugin's real entry points; install once, then call one.
148
+
149
+ **Command**:
150
+
151
+ ~~~sh
152
+ score({ target: "owner/repo" })
153
+ ~~~
154
+
155
+ **Output**:
156
+
157
+ ~~~text
158
+ # Score sc_65e817eec8cd71ed
159
+
160
+ - Target: `owner/repo` (repo)
161
+ - Grade: **B** — total 88/100
162
+ - Verdict: healthy (weighted total 88/100)
163
+
164
+ | Dimension | Status | Score | Weight | Summary |
165
+ |---|---|---|---|---|
166
+ | Install success | ⬜ no-evidence | 0 | 25 | no dsh-test-drive result recorded for this target (install success unmeasured) |
167
+ | Maintenance | ✅ pass | 100 | 20 | active (2026-08-15T00:00:00.000Z; 0 open issues) |
168
+ | Documentation | 🟠 warn | 70 | 20 | 1/4 language READMEs + CHANGELOG + SECURITY |
169
+ | Security | ✅ pass | 100 | 20 | license MIT |
170
+ | Protocol compliance | ✅ pass | 81 | 15 | dsh.bundle.patch declared |
171
+ ~~~
172
+
173
+ *Observed from `README.md:141-149,169-191; tests/tools.spec.ts:64-65; tests/score.spec.ts:50-55; src/report.ts:40-53`*
174
+
175
+ **Failure branch** — input:
176
+
177
+ ~~~text
178
+ {"id":"sc_nope"}
179
+ ~~~
180
+
181
+ Output:
182
+
183
+ ~~~text
184
+ isError=true; error.message=dsh-score: no score recorded with id sc_nope
185
+ ~~~
186
+
187
+ *Observed from `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`*
188
+
189
+ **Brief examples**: `score({ target: "owner/dsh-click" })` · `score_report("sc_65e817eec8cd71ed")` · `score_badge("owner/dsh-click")`
190
+
191
+ ### Structured result
192
+
193
+ ```json
194
+ {
195
+ "schema": "dsh-score/v1",
196
+ "scoreId": "sc_8f1c2e4a9b3d7f01",
197
+ "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123" },
198
+ "scoredAt": "2026-08-16T00:00:00.000Z",
199
+ "durationMs": 3210,
200
+ "pluginVersion": "0.2.22",
201
+ "dimensions": {
202
+ "install": { "dimension": "install", "status": "no-evidence", "score": 0, "weight": 25,
203
+ "summary": "no dsh-test-drive result recorded for this target (install success unmeasured)",
204
+ "evidence": [{ "source": "test-drive", "detail": "no test-drive record found in the test_drive domain", "observedAt": "2026-08-16T00:00:00.000Z" }] },
205
+ "maintenance": { "dimension": "maintenance", "status": "pass", "score": 100, "weight": 20,
206
+ "summary": "active (2026-08-10T00:00:00Z; 0 open issues)",
207
+ "evidence": [{ "source": "gh-api", "detail": "last activity 2026-08-10T00:00:00Z", "observedAt": "2026-08-16T00:00:00.000Z" }] }
208
+ },
209
+ "total": 88,
210
+ "grade": "B",
211
+ "verdict": "healthy (weighted total 88/100)"
212
+ }
213
+ ```
214
+
215
+ Scoring: the total is a weighted average over the dimensions that gathered evidence (no-evidence dimensions are excluded and renormalized); `A` ≥ 90, `B` ≥ 75, `C` ≥ 60, `D` ≥ 40, else `F`, and `N/A` when nothing had evidence.
216
+
217
+ ### Badge & five-dimension JSON
218
+
219
+ `score_badge` generates an embeddable README badge and the five-dimension JSON for one scored target. The badge comes in three forms derived from the same card: **endpoint** (a documented shields.io static URL, zero self-hosting), **SVG** (a self-contained shields.io flat-style SVG, `badge.svg` field / `renderScoreBadge`, for offline or self-hosted READMEs), and **Markdown** (the embed snippet combining both).
220
+
221
+ Embed the total badge:
222
+
223
+ ```markdown
224
+ ![dsh-score: B · 84/100](https://img.shields.io/badge/dsh--score-B_%C2%B7_84%2F100-green)
225
+ ```
226
+
227
+ The same call returns the compact JSON API envelope (`schema: "dsh-score/badge/v1"`):
228
+
229
+ ```json
230
+ {
231
+ "schema": "dsh-score/badge/v1",
232
+ "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123" },
233
+ "scoredAt": "2026-08-16T00:00:00.000Z",
234
+ "total": 84,
235
+ "grade": "B",
236
+ "dimensions": {
237
+ "install": { "label": "install", "status": "no-evidence", "score": 0, "weight": 25, "summary": "no dsh-test-drive result recorded" },
238
+ "maintenance": { "label": "maintenance", "status": "pass", "score": 90, "weight": 20, "summary": "active (0 open issues)" },
239
+ "documentation": { "label": "docs", "status": "pass", "score": 85, "weight": 20, "summary": "README + CHANGELOG + SECURITY" },
240
+ "security": { "label": "security", "status": "warn", "score": 60, "weight": 20, "summary": "permissive license" },
241
+ "compliance": { "label": "compliance", "status": "pass", "score": 100, "weight": 15, "summary": "dsh.bundle.patch + dsh-plugin topic" }
242
+ }
243
+ }
244
+ ```
245
+
246
+ A `no-evidence` dimension keeps its honest status and score 0 — the badge and JSON never fabricate a number.
247
+
248
+ ## Configuration
249
+
250
+ All keys are optional (defaults shown); invalid values fail loudly at load.
251
+
252
+ Most-used keys:
253
+
254
+ | Key | Default | Meaning |
255
+ |---|---|---|
256
+ | `probeTimeoutMs` | `60000` | Deadline for one `gh`/`npm` probe command (ms) |
257
+ | `outputTailBytes` | `8000` | Cap on the sanitized output tail recorded per probe (bytes) |
258
+ | `cacheMaxAgeMs` | `86400000` | How long a cached score card is reused before re-scoring (0 disables the cache) |
259
+ | `staleCommitWarnDays` | `90` | Commit/publish age at which maintenance drops to `warn` |
260
+ | `staleCommitFailDays` | `365` | Commit/publish age at which maintenance drops to `fail` |
261
+ | `maxBatchTargets` | `20` | `/score` batch target cap |
262
+ | `batchConcurrency` | `1` | Batch concurrency (serial by default, avoiding API-rate contention) |
263
+ | `weights` | `{install:25, maintenance:20, documentation:20, security:20, compliance:15}` | Per-dimension weights (each 0–100; at least one must be > 0) |
264
+
265
+ <details>
266
+ <summary>Full configuration table (10 keys)</summary>
267
+
268
+ | Key | Default | Meaning |
269
+ |---|---|---|
270
+ | `probeTimeoutMs` | `60000` | Deadline for one `gh`/`npm` probe command (ms) |
271
+ | `outputTailBytes` | `8000` | Cap on the sanitized output tail recorded per probe (bytes) |
272
+ | `cacheMaxAgeMs` | `86400000` | How long a cached score card is reused before re-scoring (0 disables the cache) |
273
+ | `staleCommitWarnDays` | `90` | Commit/publish age at which maintenance drops to `warn` |
274
+ | `staleCommitFailDays` | `365` | Commit/publish age at which maintenance drops to `fail` |
275
+ | `staleIssueWarnDays` | `30` | Oldest-open-issue age (response proxy) at which maintenance drops to `warn` |
276
+ | `staleIssueFailDays` | `180` | Oldest-open-issue age at which maintenance drops to `fail` |
277
+ | `maxBatchTargets` | `20` | `/score` batch target cap |
278
+ | `batchConcurrency` | `1` | Batch concurrency (serial by default, avoiding API-rate contention) |
279
+ | `weights` | `{install:25, maintenance:20, documentation:20, security:20, compliance:15}` | Per-dimension weights (each 0–100; at least one must be > 0) |
280
+
281
+ </details>
282
+
283
+ Example override in your profile patch:
284
+
285
+ ```yaml
286
+ - insert:
287
+ - id: score
288
+ name: dsh-score
289
+ config:
290
+ cacheMaxAgeMs: 0
291
+ maxBatchTargets: 10
292
+ weights:
293
+ install: 25
294
+ maintenance: 20
295
+ documentation: 20
296
+ security: 20
297
+ compliance: 15
298
+ ```
299
+
300
+ ## FAQ
301
+
302
+ <details>
303
+ <summary>Where do score cards and leaderboards live? Are they lost without storage?</summary>
304
+
305
+ Score cards and leaderboards are stored in the `score` storage domain (tables `scores`, `leaderboards`, plus the latest-leaderboard pointer). When the composition has no `storageDomain` (a headless profile older than the base bundle's storage rows, for example), the tools still work but score persistence is disabled with a logged reason. The published `dsh-base` bundle mounts storage-domain from `0.1.2-rc.1` on (verified against the `0.1.2-rc.1` and `0.1.5-alpha.1` tarballs), so persistence is active on the published line.
306
+
307
+ </details>
308
+
309
+ <details>
310
+ <summary>When evidence is missing, does it just make up a score?</summary>
311
+
312
+ No. A failed probe, unparsable output, or a target with no resolvable GitHub repository makes that dimension report `no-evidence` (score 0, excluded from the weighted total and renormalized); when nothing has evidence the total is `N/A`. A `no-evidence` dimension also carries the failure reason (`exit N`, `timeout`, the redacted stderr tail, or `invalid JSON`) instead of an invented number.
313
+
314
+ </details>
315
+
316
+ <details>
317
+ <summary>Does it install, build, or run the target package?</summary>
318
+
319
+ No. The pipeline runs only the read-only `gh api` and `npm view` commands — it never installs, builds, or executes the target. Every CLI invocation is an argv array, never shell-interpreted, and the `owner`/`repo` segments are validated against a restricted character set before they reach an endpoint.
320
+
321
+ </details>
322
+
323
+ <details>
324
+ <summary>Can credentials leak into reports or logs?</summary>
325
+
326
+ No. Child processes inherit the provider's credential-scrubbed environment and `gh` reads its own credential store; no environment value is ever logged. All report/log strings pass through pure sanitizers: token literals, URL credentials, and bearer headers are redacted, and output tails are byte-capped.
327
+
328
+ </details>
329
+
330
+ <details>
331
+ <summary>How expensive is scoring? Will it hit GitHub API rate limits?</summary>
332
+
333
+ Score cards are cached per target (`cacheMaxAgeMs` = 24 hours by default), so repeat lookups do not re-gather evidence; use `refresh: true` or set the cache age to 0 when you need fresh data. `/score` defaults to `batchConcurrency: 1` (serial) to avoid concurrent probes competing for API quota, and a single probe waits at most `probeTimeoutMs` (60 seconds by default).
334
+
335
+ </details>
336
+
337
+ ## Security boundaries
338
+
339
+ - **No code execution.** The pipeline runs `gh api` and `npm view` only; it never installs, builds, or runs a target.
340
+ - **Argv-only subprocesses.** Every CLI invocation is an argv array, never shell-interpreted; repo owner/repo segments are validated against a restricted character set before use in an endpoint.
341
+ - **Evidence discipline.** No score is fabricated: a probe that fails or returns unparsable output yields `no-evidence`, never a number.
342
+ - **Detection vs redaction.** Secret-leak and malicious-install-script detection share the same pure regexes as redaction; both are unit-tested against extreme inputs.
343
+
344
+ ## Permissions & data
345
+
346
+ - **Permissions**: only public services are consumed — `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`; the plugin provides no Cordis service key.
347
+ - **Data**: score cards and leaderboards live in the `score` storage domain (tables `scores`, `leaderboards`, plus the latest-leaderboard pointer). Without `storageDomain` the tools still work and persistence is disabled with a logged reason.
348
+ - **Environment**: child processes inherit the provider's credential-scrubbed environment; `gh` reads its own credential store. No environment value is ever logged, and every report/log string passes through pure sanitizers with byte-capped tails.
349
+
350
+ ## Known limitations
351
+
352
+ - Repository probes require `gh` to be authenticated and network access to GitHub; npm probes require `npm` and registry access.
353
+ - A target without a resolvable GitHub repository cannot be inspected for documentation, security, or compliance (those dimensions report `no-evidence`).
354
+ - Install success depends on `dsh-test-drive` being mounted and having recorded the target; otherwise it is honestly `no-evidence`.
355
+ - The maintenance "issue response" signal is a proxy (oldest open issue age), not a direct response-time measurement.
356
+ - Score results are cached per target; use `refresh: true` (or wait past `cacheMaxAgeMs`) to force re-scoring.
357
+
358
+ ## Interoperability with other DSH plugins
359
+
360
+ `dsh-score` only exposes its own scoring surface and never takes over another plugin's lane:
361
+
362
+ - **Self-contained tool surface.** It registers exactly three tools (`score`, `score_report`, `score_badge`) and one command (`/score`), all through `ctx.effect`, so stop/hot-reload removes them.
363
+ - **No service key.** `inject` declares only `tools`, `commands`, `subprocess`, and `jobs`; `storageDomain` is read optionally through `ctx.get` and never required.
364
+ - **No client lane.** It registers no client slot key and no `webServer` route prefix.
365
+ - **No patch-layer collision.** The bundle patch only `insert`s its own row (`id: score`); it never overrides a built-in row's `config`.
366
+ - **No global mutation.** It does not patch prototypes, rewrite `process.env`, or replace the global fetch dispatcher.
367
+ - **No shared-event listeners.** It registers no waterfall listener (including `agent/pre-step`), so it takes no part in event-chain ordering and cannot short-circuit another plugin's chain.
368
+
369
+ Static evidence: the `dsh-plugin-doctor` verification badge is driven by this repository's CI output (see "Ecosystem & quality").
370
+
371
+ ## Compatibility
372
+
373
+ | Component | Version |
374
+ |---|---|
375
+ | DeepSeek Harness | **`dsh-v0.2.2-rc.4`** (GitHub tag). The `engines.dsh` gate is `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`; dev/test pins and the `typecheck:ci` ruler measure `0.2.2-rc.1`. The `ctx.jobs` seam uses the `SessionId` contract. |
376
+ | Node.js | `^22.19.0 \|\| >=24.9.0` |
377
+ | Package manager | `pnpm@11.7.0` |
378
+ | Platform | Windows / macOS / Linux (host-only plugin) |
379
+ | External tools | `gh` CLI on PATH (authenticated for API reads), `npm` CLI on PATH |
380
+
381
+ ## Ecosystem & quality
382
+
383
+ - [Gitee mirror](https://gitee.com/perrylink/dsh-score) (sync mirror; GitHub is canonical)
384
+ - [dshfind plugin page](https://dshfind.com/plugins/PerryLink/dsh-score) (installs and ranking)
385
+ - [OpenSSF Scorecard report](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-score) (driven by [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml))
386
+ - [dsh-plugin-doctor verification report](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章) (badge source)
387
+ - [DSH Market](https://dsh.market/) (listed)
388
+ - **1024 store channel**: `npm i -g dsh1024` once, then `dsh1024 plugin --profile web add dsh-score` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking)
389
+ - [Ecosystem knowledge base](https://perrylink.github.io/dsh-plugin-guide/) — measured data, not marketing: plugin development guide · plugin-selection data · maintenance criteria
390
+
391
+ ## Development
392
+
393
+ ```sh
394
+ pnpm install # node ^22.19 || >=24.9
395
+ pnpm run typecheck && pnpm run typecheck:ci && pnpm test # local checkout face + published-line face + vitest
396
+ pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack
397
+ pnpm run check:readmes # five-language README consistency
398
+ ```
399
+
400
+ - `typecheck` resolves `@deepseek-ai/*` through the local harness checkout; `typecheck:ci` checks against the published `0.2.2-rc.1` types.
401
+ - Tests use the real `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/storage stack with a scripted subprocess provider.
402
+ - Real-CLI scoring (requires `gh`/`npm` on PATH and `gh` authenticated): invoke `score` from a mounted profile.
403
+ - Release: `node scripts/release.mjs <x.y.z>` (bumps, stamps CHANGELOG, re-runs the gate, commits + tags; never pushes).
404
+ - The README images are generated programmatically by [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Pillow for the hero banner, hand-written SVG for the structure diagram) and are safe to re-run; the older single-skin flow diagram and demo images stay in `docs/assets/` for external deep links, while the READMEs reference only the new hero and flow-v5 structure diagram, each in light and dark.
405
+
406
+ Topics: `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-scoring`, `quality-score`, `leaderboard`, `supply-chain`
407
+
408
+ ## Family & thanks
409
+
410
+ This project is part of the DeepSeek Harness plugin family from [PerryLink](https://github.com/PerryLink) (all Apache-2.0). If it is useful, **a star helps the next person find it** — nothing is gated behind it.
411
+
412
+ - [@PerryLink](https://github.com/PerryLink) — creator and maintainer: the five-dimension pipeline, the `gh`/`npm` evidence probes, the structured `dsh-score/v1` contract, the `/score` batch job, the badge, and the five-language docs.
413
+
414
+ <details>
415
+ <summary>Expand all plugins</summary>
416
+
417
+ | Plugin | Status |
418
+ |---|---|
419
+ | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
420
+ | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
421
+ | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
422
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 FROZEN — see the repo README |
423
+ | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
424
+ | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
425
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 FROZEN — see the repo README |
426
+ | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
427
+ | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
428
+ | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
429
+ | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
430
+ | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
431
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 FROZEN — see the repo README |
432
+ | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
433
+ | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
434
+ | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
435
+ | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
436
+ | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
437
+ | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
438
+ | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
439
+ | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
440
+ | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
441
+ | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
442
+ | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
443
+ | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
444
+ | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
445
+ | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
446
+ | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
447
+ | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
448
+ | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
449
+ | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
450
+ | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
451
+ | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
452
+ | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
453
+ | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
454
+ | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
455
+ | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
456
+ | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
457
+ | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
458
+ | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
459
+ | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
460
+ | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
461
+ | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
462
+ | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
463
+ | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
464
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 FROZEN — see the repo README |
465
+ | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
466
+ | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
467
+ | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
468
+ | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
469
+ | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
470
+ | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
471
+ | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
472
+ | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
473
+ | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
474
+ | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
475
+ | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
476
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 RETIRED (repo archived) |
477
+ | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
478
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 RETIRED (repo archived) |
479
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 RETIRED (repo archived) |
480
+ | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
481
+ | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
482
+ | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
483
+ | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
484
+ | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
485
+ | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
486
+ | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
487
+ | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
488
+ | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
489
+ | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
490
+ | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
491
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 FROZEN — see the repo README |
492
+ | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
493
+ | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
494
+ | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
495
+ | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
496
+ | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
497
+ | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
498
+ | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
499
+ | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
500
+ | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
501
+ | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
502
+ | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
503
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 RETIRED (repo archived) |
504
+ | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
505
+ | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
506
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 FROZEN — see the repo README |
507
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 FROZEN — see the repo README |
508
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 FROZEN — see the repo README |
509
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 FROZEN — see the repo README |
510
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 FROZEN — see the repo README |
511
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRED (repo archived) |
512
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRED (repo archived) |
513
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRED (repo archived) |
514
+
515
+ </details>
516
+
517
+ ## HCB compatibility input
518
+
519
+ The host compatibility matrix and the ENTRY/FLOW/BOOST tracks are published in [HCB](https://github.com/PerryLink/dsh-hcb); this README does not maintain a second host-version matrix.
520
+
521
+ ## License
522
+
523
+ [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-score contributors
524
+
525
+ <p align="center"><sub>Apache-2.0 · Community plugin, not affiliated with DeepSeek.</sub></p>