dsh-test-drive 0.3.25 → 0.3.27

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/README.md CHANGED
@@ -1,130 +1,197 @@
1
1
  <div align="center">
2
2
 
3
- # 🧪 dsh-test-drive
4
- - **1024 store channel**: `npm i -g dsh1024` once, then `dsh1024 plugin --profile web add dsh-test-drive` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking).
5
- [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-test-drive)
6
- [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-test-drive?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-test-drive?ref=badge)
7
- [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-test-drive/badge)](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-test-drive)
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-test-drive-hero-zh-dark.webp">
5
+ <img src="docs/assets/dsh-test-drive-hero-zh-light.webp" width="100%" alt="dsh-test-drive 配图:左列是插件名与两行价值句;右侧是一次真实实测的回执——目标 dsh-click、运行 id tdr_0b9b…、install、config、smoke、capability、uninstall、cleanup 六段的状态与耗时,隔离条写明一次性 DSH_HOME、工作目录与 pnpm store 且宿主 profile 零读写,底部是 verdict 行与 dsh-test-drive/v1 记录出口">
6
+ </picture>
7
+
8
+ # dsh-test-drive
8
9
 
9
- **Isolated install-and-smoke test drives for DeepSeek Harness plugins.**
10
+ **在一次性 profile 里装、启动、断言、卸载、清理——把「装一下看看能不能跑」变成可复现的流水线。**
10
11
 
11
- *Install, smoke, verify, and clean up in a throwaway profile — your real `~/.dsh` stays untouched.*
12
+ 面向 DeepSeek Harness 插件的隔离式安装冒烟实测:每个目标独占一个 `dsh-v0.2.2-rc.4`(2026-11-18);`mkdtemp` 根(一次性 `DSH_HOME`、一次性工作目录、重定向的 pnpm store),你真实的 `~/.dsh` 从头到尾不被读写,结果落成下游可直接消费的结构化记录。
12
13
 
13
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
14
- [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
15
- [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-test-drive.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
16
- [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
17
- [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
18
- [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-test-drive/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-test-drive/actions)
19
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-test-drive?label=version)](https://github.com/PerryLink/dsh-test-drive/releases)
20
- [![npm version](https://img.shields.io/npm/v/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
21
- [![npm downloads](https://img.shields.io/npm/dm/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
14
+ [安装](#三步上手) · [配置](#配置) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
22
15
 
23
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
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)](#兼容性)
18
+ [![npm](https://img.shields.io/npm/v/dsh-test-drive?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-test-drive)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-test-drive/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-test-drive/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)](#兼容性)
21
+
22
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-test-drive?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-test-drive/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-test-drive?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-test-drive)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-test-drive?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-test-drive?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-test-drive/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-test-drive)
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-test-drive)
24
28
 
25
29
  ```sh
26
30
  dsh plugin --profile <name> add dsh-test-drive
27
31
  ```
28
32
 
29
-
30
33
  </div>
31
34
 
32
- ---
35
+ <sub>社区插件,与 DeepSeek 官方无关。唯一仓库:<https://github.com/PerryLink/dsh-test-drive>(Gitee 为镜像)。</sub>
33
36
 
34
- **📖 Ecosystem knowledge base** — measured data, not marketing: [plugin development guide · plugin-selection data · maintenance criteria](https://perrylink.github.io/dsh-plugin-guide/).
37
+ ## 它是什么
35
38
 
36
- <!-- star-cta -->
37
- ## Install & uninstall
39
+ `dsh-test-drive` 把「这个插件到底装不装得上、启不启得来」变成一条六段流水线:`dsh plugin add` 装进一个一次性 `DSH_HOME` → `--dump-config` 核对 bundle patch 层确实生效 → headless 启动一遍并扫描 loader 失败标记 → 可选地做一次能力断言(让 agent 调用某个具名工具或命令,核对持久会话日志里确实记下了这次调用、观察输出里确实出现期望字面量)→ `dsh plugin remove` → 按 dry-run → 隔离改名 → 删除的阶梯清掉本插件拥有的临时根。每段都带状态、退出码、耗时与脱敏后的输出尾部,最终是一条 `schema: "dsh-test-drive/v1"` 的结构化记录:单目标用 `test_drive`,批量用 `/testdrive`,回看用 `drive_report`。
38
40
 
39
- ```sh
40
- dsh plugin --profile web add dsh-test-drive # install (npm) — or the git form above
41
- dsh plugin --profile web remove dsh-test-drive # uninstall
42
- ```
41
+ <picture>
42
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-test-drive-flow-v5-dark.svg">
43
+ <img src="docs/assets/dsh-test-drive-flow-v5-light.svg" width="100%" alt="dsh-test-drive 结构图:本插件拥有的一个临时根被画成隔离舱——舱内是 home/、workspace/、pnpm-store/ 三个一次性子根与 install → config → smoke → capability → uninstall 五段竖向阶段脊;舱底是 finally 排空闸(dry-run 计划 → 隔离改名 → 删除重试),pass、fail、超时、中止都走这一条。舱外左侧是入口三表面、目标类型与从不被打开的宿主 profile;右侧出舱的是 dsh-test-drive/v1 结构化记录、有序判定规则与 /testdrive 批矩阵">
44
+ </picture>
43
45
 
44
- ## ⭐ 如果它帮到了你
46
+ ## 三步上手
45
47
 
46
- 这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(95 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
48
+ 1. **安装**(两通道):
47
49
 
48
- *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.
50
+ ```sh
51
+ # npm 渠道(已发布版本;预构建包无需构建许可)
52
+ dsh plugin --profile web add dsh-test-drive
53
+ # git 渠道(最新 main;等价于 git+https://github.com/PerryLink/dsh-test-drive.git)
54
+ dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
55
+ ```
49
56
 
57
+ git 渠道首次 `add` 会因 pnpm 拦截该包的 `prepare` 构建而失败;把 pnpm 打印的精确键复制进 profile 的 `pnpm-workspace.yaml` 后重跑:
50
58
 
51
- ## What is dsh-test-drive?
59
+ ```yaml
60
+ allowBuilds:
61
+ 'dsh-test-drive': true
62
+ ```
52
63
 
53
- Isolated install-and-smoke test drives for DeepSeek Harness plugins.
64
+ npm 通道的预构建包不需要构建许可。重启 profile 后,即可在会话中使用 `test_drive` / `/testdrive`。
54
65
 
55
- Install, smoke, verify, and clean up in a throwaway profile — your real `~/.dsh` stays untouched.
66
+ 2. **最小配置**(默认即可用;只有要跑能力断言时才需要 `capability.*` 与 `forwardEnv`):
56
67
 
57
- ![Workflow diagram for dsh-test-drive: question → sealed sources → report.](docs/assets/dsh-test-drive-flow.svg)
68
+ ```yaml
69
+ - insert:
70
+ - id: test-drive
71
+ name: dsh-test-drive
72
+ config:
73
+ headlessTask: "Reply with exactly: ok"
74
+ forwardEnv: [DEEPSEEK_API_KEY]
75
+ capability:
76
+ enabled: true
77
+ kind: tool
78
+ name: plugin_vet
79
+ args: '{}'
80
+ expect: pass
81
+ ```
58
82
 
59
- *Workflow overview: question → sealed sources → report. The examples below use the real command surface.*
83
+ 3. **验证已生效**(重启后):
60
84
 
85
+ ```sh
86
+ dsh --profile web --dump-config | grep -A3 'id: test-drive'
87
+ ```
61
88
 
89
+ 然后对一个已知目标发起第一次实测:
62
90
 
63
- ## Compatibility
91
+ ```text
92
+ test_drive({ target: "dsh-click" })
93
+ → verdict pass · tdr_0b9b6e6a61e3e80cc4620f2e · 完整记录见下方「示例」
94
+ ```
64
95
 
65
- | Component | Version |
66
- |---|---|
67
- | DeepSeek Harness | **`dsh-v0.2.1-alpha.1`** (GitHub tag, verified 2026-09-11: full gate chain + profile install smoke). npm dependency lines `0.1.2-rc.1` and `0.1.7-rc.2` (peer dependencies `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0`) |
68
- | Node.js | `^22.19.0 \|\| >=24.0.0` |
69
- | Package manager | `pnpm@11.7.0` |
70
- | Platform | Windows / macOS / Linux (host-only plugin) |
71
- | External tools | `dsh` CLI on PATH (auto-detected, npm shims parsed), `pnpm` on PATH |
96
+ **卸载**:`dsh plugin --profile web remove dsh-test-drive`(或从 profile patch 删掉该行)。
97
+
98
+ > `test_drive` 需要一个能启动**第二个** headless DSH 进程的 `dsh` CLI。DSH Desktop 的 launcher(`dsh.CMD`)只允许 `dsh plugin …`、`--dump-config` 与 `--version`,会按策略拒绝第二次 headless 启动——报错会明确说明这一点,而不是「cannot parse npm shim」。请把 `config.dshBin` 指向 npm/pnpm 安装的 `dsh` CLI,或普通 Node + dsh JS 入口。
99
+
100
+ <details>
101
+ <summary>从 DSH Desktop 市场安装</summary>
72
102
 
73
- ## What you get
103
+ 所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览:**市场 → 来源 → 添加来源 → 粘贴** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ 选中**。安装仍需通过市场的 npm 身份校验与你的确认。
74
104
 
75
- - `test_drive` tool — one target through the complete pipeline: `dsh plugin add` → `--dump-config` patch check → headless boot smoke (FAILED-marker scan + optional one-shot task) → optional capability assertion → `dsh plugin remove` → quarantined cleanup. Returns the structured record synchronously, or `{ kind: 'background', jobId }` with `background: true`.
76
- - `/testdrive` command — batch drive of a whitespace/comma-separated target list as a `drive-batch` background job over `ctx.jobs`, producing a matrix report (JSON + Markdown).
77
- - `drive_report` tool — fetch any stored run (`tdr_...`), matrix (`tdm_...`), or the latest matrix; rendered as Markdown.
78
- - Capability assertion — beyond "booted and exited": the optional `capability` stage drives one headless task that calls a named tool (or runs a `/command`) and verifies the durable session log recorded the invocation and the observed output contains `expect`. A clean boot is only a smoke test; `observed` proves a named capability really works.
79
- - Structured results — every record carries the discriminator `schema: "dsh-test-drive/v1"` with first-class fields: `stages.install.status` (`pass`/`fail`), `stages.smoke.status` (`pass`/`fail`/`boot-ok`/`skipped`), `stages.capability.status` (`observed`/`invoked`/`not-registered`/`skipped`/`failed`), per-stage `durationMs`, sanitized `summary`/`outputTail`, and an overall `verdict` (`pass`/`fail`/`partial`/`unknown`). This is the machine-readable contract downstream scorers (dsh-score) consume.
80
- - Safety by construction — every temp directory is created by this plugin under a dedicated `dsh-test-drive-` prefix, tracked in a live ownership registry, and removed only through a dry-run → quarantine-rename → delete ladder. The host profile is never read or written.
105
+ </details>
81
106
 
82
- ## Quick start
107
+ ## 核心能力
83
108
 
84
- ### Git channel
109
+ `dsh-test-drive` 把一次「装机验证」拆成可观察、可回放的阶段:
85
110
 
86
- ```sh
87
- dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
111
+ - **`test_drive` 工具** —— 单个目标跑完整流水线,同步返回结构化记录;传 `background: true` 则启动 `drive-batch` 后台任务并返回 `{ kind: 'background', jobId }`。
112
+ - **`/testdrive <目标...>` 命令** —— 空格/逗号分隔的目标列表,作为一个 `drive-batch` 后台任务批量跑;进度经任务输出流式推送,最后产出矩阵报告(JSON + Markdown),末行给出矩阵 id。
113
+ - **`drive_report` 工具** —— 按 id 取回任意单次记录(`tdr_...`)、矩阵(`tdm_...`),或不传 id 取最新矩阵,以 Markdown 渲染。
114
+ - **能力断言** —— 不止于「启动并退出」:可选的 `capability` 阶段让 agent 以 `args` 调用具名工具(`kind: tool`)或运行 `/命令`(`kind: command`),核对持久会话日志确实记下这次调用、且观察输出包含 `expect`。干净启动只是冒烟,`observed` 才证明具名能力真实可用。
115
+ - **结构化结果** —— 每条记录带判别符 `schema: "dsh-test-drive/v1"`,关键字段均为一级字段:`stages.install.status`、`stages.smoke.status`、`stages.capability.status`、各阶段 `durationMs`、脱敏后的 `summary` / `outputTail`,以及总判定 `verdict`(`pass` / `fail` / `partial` / `unknown`)。这是下游评分方(dsh-score)消费的机器可读契约。
116
+ - **结构安全** —— 每个临时目录都由本插件以专属前缀 `dsh-test-drive-` 创建、登记在活跃所有权注册表中,且只经 dry-run → 隔离改名 → 删除的阶梯清理。宿主机 profile 永不被读取或写入。
117
+
118
+ ```text
119
+ target ──dsh plugin add──▶ 一次性 DSH_HOME ──--dump-config──▶ patch 层
120
+ │ │
121
+ ├──headless boot──▶ FAILED-marker 扫描
122
+ ├──capability────▶ tool/command + 会话日志
123
+ └──dsh plugin remove──▶ quarantine → delete
88
124
  ```
89
125
 
90
- The first `add` 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:
126
+ ### 工具面
91
127
 
92
- ```yaml
93
- allowBuilds:
94
- 'dsh-test-drive': true
95
- ```
128
+ | 表面 | 形态 | 返回 / 说明 |
129
+ |---|---|---|
130
+ | `test_drive` | 工具 | 完整结构化记录(同步),或 `{ kind: 'background', jobId }` |
131
+ | `/testdrive` | 命令 | 一个 `drive-batch` 后台任务;末行给出供 `drive_report` 使用的矩阵 id |
132
+ | `drive_report` | 工具 | `tdr_...` 单次记录 / `tdm_...` 矩阵 / 最新矩阵,Markdown 渲染 |
96
133
 
97
- ### npm channel
134
+ `test_drive` 的 `target` 接受 git 规格(`github:owner/repo#sha`、`git+https://...`)、npm 包名、本地路径或 `.tgz` 压缩包;`capability` 形如 `{ kind: 'tool' | 'command', name, args, expect }`,需要 `DEEPSEEK_API_KEY`(宿主环境或 `forwardEnv`),缺失时该阶段为 `skipped`,绝不算失败。
98
135
 
99
- ```sh
100
- dsh plugin --profile web add dsh-test-drive
101
- ```
136
+ ### 结构化结果
102
137
 
103
- Prebuilt packages need no build allowance. Restart the profile, then use `test_drive` / `/testdrive` from a session.
138
+ 判定规则:安装失败、启动失败(`smoke.fail`)、或能力阶段到达 `not-registered` / `failed` ⇒ `fail`;安装通过 + patch 生效 + 启动干净(`pass` / `boot-ok`)+ 卸载通过 ⇒ `pass`(能力阶段 `observed` 时附说明);已安装但后续保证缺失 ⇒ `partial`;其余 ⇒ `unknown`。
104
139
 
105
- ## DSH Desktop is not a supported test host
140
+ <details>
141
+ <summary>完整记录样例(dsh-test-drive/v1)</summary>
106
142
 
107
- `test_drive` needs a `dsh` CLI that can boot a **second** headless DSH process.
108
- The DSH Desktop launcher (`dsh.CMD`) only permits `dsh plugin …`, `--dump-config`,
109
- and `--version`; it rejects a second headless boot by policy. Point `config.dshBin`
110
- at an npm/pnpm-installed `dsh` CLI (or a plain Node + `dsh` JS entry) instead.
111
- The error now says this explicitly rather than "cannot parse npm shim".
143
+ ```json
144
+ {
145
+ "schema": "dsh-test-drive/v1",
146
+ "run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
147
+ "finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
148
+ "harnessVersion": "0.1.7-rc.2", "pluginVersion": "0.3.13",
149
+ "platform": "win32", "node": "v22.22.3" },
150
+ "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
151
+ "resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
152
+ "hasBundleManifest": true } },
153
+ "isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
154
+ "hostHomeTouched": false },
155
+ "stages": {
156
+ "install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
157
+ "summary": "install ok after allowBuilds allowance", "outputTail": "",
158
+ "allowBuildsNeeded": true },
159
+ "config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
160
+ "summary": "dump ok (exit 0)", "outputTail": "",
161
+ "patchEffective": true, "layers": ["dsh-click"] },
162
+ "smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
163
+ "summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
164
+ "outputTail": "", "bootFailed": false, "taskCompleted": false },
165
+ "capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
166
+ "summary": "tool \"plugin_vet\" called and its result contains the expectation",
167
+ "outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
168
+ "expectMatched": true,
169
+ "detail": "tool \"plugin_vet\" called and its result contains the expectation" },
170
+ "uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
171
+ "summary": "remove ok (exit 0)", "outputTail": "" },
172
+ "cleanup": { "status": "pass", "quarantined": true, "removed": true,
173
+ "summary": "owned temp root quarantined and removed" }
174
+ },
175
+ "verdict": "pass",
176
+ "verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
177
+ }
178
+ ```
112
179
 
113
- ### Examples
180
+ </details>
114
181
 
115
- These are the plugin's real entry points; install once, then call one.
182
+ ### 示例
116
183
 
117
- #### Detailed example
184
+ 以下为插件真实入口;安装后调用一个即可。
118
185
 
119
- **Command**
186
+ **详细示例** — 命令 `test_drive`,输入:
120
187
 
121
- ~~~sh
188
+ ```sh
122
189
  test_drive({ target: "dsh-click" })
123
- ~~~
190
+ ```
124
191
 
125
- **Output**
192
+ 输出:
126
193
 
127
- ~~~text
194
+ ```text
128
195
  # Test drive tdr_0b9b6e6a61e3e80cc4620f2e
129
196
 
130
197
  - Target: `dsh-click` (npm)
@@ -140,123 +207,200 @@ test_drive({ target: "dsh-click" })
140
207
  | capability | ⏭️ skipped | null | 0 ms | capability assertion disabled (config.capability.enabled is false and no per-drive capability given) |
141
208
  | uninstall | ✅ pass | 0 | 0 ms | remove ok (exit 0) |
142
209
  | cleanup | ✅ pass | — | — | owned temp root quarantined and removed |
143
- ~~~
210
+ ```
144
211
 
145
212
  *Observed from `README.md:153-163,174-211; tests/drive.spec.ts:73-101; src/report.ts:34-55`*
146
213
 
147
- #### Failure branch
148
-
149
- **Input**
214
+ **失败分支** — 输入:
150
215
 
151
- ~~~text
216
+ ```text
152
217
  {"target":" "}
153
- ~~~
218
+ ```
154
219
 
155
- **Output**
220
+ 输出:
156
221
 
157
- ~~~text
222
+ ```text
158
223
  isError=true; error.message=dsh-test-drive: target must be a non-empty string
159
- ~~~
224
+ ```
160
225
 
161
226
  *Observed from `plugins/dsh-test-drive/src/tools.ts:297-299 (blank target check); exercised through plugins/dsh-test-drive/tests/harness.ts`*
162
227
 
163
- #### Brief examples
228
+ **简短示例**:`test_drive` · `/testdrive` · `drive_report`
229
+
230
+ ## 配置
164
231
 
232
+ 所有键均可选(下列为默认值);非法值在加载期响亮失败。`cordis.patch.yml` 逐键内联注释。
165
233
 
234
+ 最常用键:
166
235
 
167
- ## Configuration
236
+ | 键 | 默认值 | 含义 |
237
+ |---|---|---|
238
+ | `profileName` | `headless` | 每次一次性 DSH_HOME 内初始化的 profile 模板(base + headless bundles)。 |
239
+ | `dshBin` | `""` | `dsh` 可执行文件的绝对路径覆盖;为空则自动探测 PATH(Windows 下解析 npm 的 `.cmd`/`.bat` shim)。 |
240
+ | `headlessTask` | `"Reply with exactly: ok"` | 引导冒烟阶段的一句任务;为空则跳过该阶段。 |
241
+ | `forwardEnv` | `[]` | 转发进测试 profile 子进程的环境变量**名**(绝不转发值,值永不落日志)。 |
242
+ | `allowBuilds` | `true` | 在测试 profile 中放行被拦截的 git `prepare` 构建并重试一次安装。 |
243
+ | `capability.enabled` | `false` | 是否运行能力断言阶段(注册 → 调用 → 观察到)。 |
244
+ | `capability.expect` | `""` | 期望出现在观察输出中的字面量(不区分大小写子串)。 |
245
+ | `keepTempDirs` | `false` | 失败时保留临时目录供取证(所有权被放弃,由你清理)。 |
168
246
 
169
- All keys are optional (defaults shown); invalid values fail loudly at load.
247
+ <details>
248
+ <summary>完整配置表(19 个键)</summary>
170
249
 
171
- | Key | Default | Description |
250
+ | 键 | 默认值 | 含义 |
172
251
  |---|---|---|
173
- | `profileName` | `headless` | Profile template initialized inside each throwaway DSH_HOME (base + headless bundles). |
174
- | `dshBin` | `""` | Absolute dsh executable override; empty auto-detects `dsh` on PATH. |
175
- | `headlessTask` | `"Reply with exactly: ok"` | One-shot task for the boot-smoke stage; empty skips the stage. |
176
- | `forwardEnv` | `[]` | Environment VARIABLE NAMES (never values) forwarded into test-profile child processes. |
177
- | `allowBuilds` | `true` | Allowlist a blocked git `prepare` build in the test profile and retry the install once. |
178
- | `installTimeoutMs` | `600000` | `dsh plugin add` stage deadline. |
179
- | `configTimeoutMs` | `60000` | `--dump-config` stage deadline. |
180
- | `smokeTimeoutMs` | `300000` | Headless boot-smoke stage deadline. |
181
- | `capabilityTimeoutMs` | `300000` | Capability-assertion task deadline. |
182
- | `capability.enabled` | `false` | Run the capability-assertion stage (registered → invoked → observed). |
183
- | `capability.kind` | `tool` | What to assert: `tool` or `command`. |
184
- | `capability.name` | `""` | Tool or command name (no leading `/`). |
185
- | `capability.args` | `""` | Invocation text: tool arguments (JSON-ish) or command words. |
186
- | `capability.expect` | `""` | Literal expected in the observed output (case-insensitive substring). |
187
- | `uninstallTimeoutMs` | `120000` | `dsh plugin remove` stage deadline. |
188
- | `outputTailBytes` | `8000` | Cap on the sanitized output tail recorded per stage. |
189
- | `keepTempDirs` | `false` | Keep temp dirs on failure for forensics (ownership is dropped; you clean up). |
190
- | `maxBatchTargets` | `20` | `/testdrive` batch cap. |
191
- | `batchConcurrency` | `1` | Batch concurrency (serial avoids pnpm-store contention). |
192
-
193
- ## Tools & surfaces
194
-
195
- ### `test_drive`
252
+ | `profileName` | `headless` | 每次一次性 DSH_HOME 内初始化的 profile 模板(base + headless bundles)。 |
253
+ | `dshBin` | `""` | `dsh` 可执行文件的绝对路径覆盖;为空则自动探测 PATH(Windows 下解析 npm 的 `.cmd`/`.bat` shim)。 |
254
+ | `headlessTask` | `"Reply with exactly: ok"` | 引导冒烟阶段的一句任务;为空则跳过该阶段。 |
255
+ | `forwardEnv` | `[]` | 转发进测试 profile 子进程的环境变量**名**(绝不转发值,值永不落日志)。 |
256
+ | `allowBuilds` | `true` | 在测试 profile 中放行被拦截的 git `prepare` 构建并重试一次安装。 |
257
+ | `installTimeoutMs` | `600000` | `dsh plugin add` 阶段时限(毫秒)。 |
258
+ | `configTimeoutMs` | `60000` | `--dump-config` 阶段时限(毫秒)。 |
259
+ | `smokeTimeoutMs` | `300000` | headless 引导冒烟阶段时限(毫秒)。 |
260
+ | `capabilityTimeoutMs` | `300000` | 能力断言任务时限(毫秒)。 |
261
+ | `capability.enabled` | `false` | 是否运行能力断言阶段(注册 → 调用 → 观察到)。 |
262
+ | `capability.kind` | `tool` | 断言对象:`tool` 或 `command`。 |
263
+ | `capability.name` | `""` | 工具或命令名(不带前导 `/`)。 |
264
+ | `capability.args` | `""` | 调用文本:工具参数(JSON 风格)或命令参数。 |
265
+ | `capability.expect` | `""` | 期望出现在观察输出中的字面量(不区分大小写子串)。 |
266
+ | `uninstallTimeoutMs` | `120000` | `dsh plugin remove` 阶段时限(毫秒)。 |
267
+ | `outputTailBytes` | `8000` | 每阶段记录的脱敏输出尾部上限(字节)。 |
268
+ | `keepTempDirs` | `false` | 失败时保留临时目录供取证(所有权被放弃,由你清理)。 |
269
+ | `maxBatchTargets` | `20` | `/testdrive` 批上限。 |
270
+ | `batchConcurrency` | `1` | 批并发度(串行可避免 pnpm-store 争用)。 |
196
271
 
197
- ```
198
- test_drive(target: string, headlessTask?: string, background?: boolean,
199
- capability?: { kind: 'tool' | 'command', name: string,
200
- args: string, expect: string })
272
+ </details>
273
+
274
+ profile patch 中的覆盖示例:
275
+
276
+ ```yaml
277
+ - insert:
278
+ - id: test-drive
279
+ name: dsh-test-drive
280
+ config:
281
+ headlessTask: "Reply with exactly: ok"
282
+ forwardEnv: [DEEPSEEK_API_KEY]
283
+ capability:
284
+ enabled: true
285
+ kind: tool
286
+ name: plugin_vet
287
+ args: '{}'
288
+ expect: pass
201
289
  ```
202
290
 
203
- - `target` — git spec (`github:owner/repo#sha`, `git+https://...`), npm name, local path, or `.tgz` tarball.
204
- - `capability` — assertion after the boot smoke: the agent calls `name` (tool) or runs `/name` (command) with `args`; the stage reads the durable session log and requires the observed output to contain `expect`. Needs `DEEPSEEK_API_KEY` (host env or `forwardEnv`); without it the stage is `skipped`, never failed.
205
- - Returns the full structured record; see the sample below.
206
- - `background: true` starts a `drive-batch` job and returns its id.
291
+ ## FAQ
207
292
 
208
- ### `/testdrive <targets...>`
293
+ <details>
294
+ <summary>会碰我真实的 <code>~/.dsh</code> 吗?</summary>
209
295
 
210
- Starts one background batch job; progress streams through the job output, and the final line names the matrix id for `drive_report`.
296
+ 不会。每次实测都在 OS 临时目录下的一个全新 `mkdtemp` 根内进行:一次性 `DSH_HOME`、一次性工作目录、重定向的 pnpm store,被测插件的代码只在那套临时 profile 里执行。宿主机 profile 既不被读取也不被写入,结构化记录里的 `isolation.hostHomeTouched` 恒为 `false`。清理只认本插件登记过的目录,绝不扫描 `%TEMP%`、不碰他人前缀、不碰真实家目录。
211
297
 
212
- ### `drive_report(id?)`
298
+ </details>
213
299
 
214
- Returns a run record (`tdr_...`), a matrix (`tdm_...`), or — with no id — the latest matrix.
300
+ <details>
301
+ <summary>组合里没有 <code>storageDomain</code> 时,报告会丢吗?</summary>
215
302
 
216
- ### Structured result sample
303
+ 工具照常工作,只是报告不持久化:插件会记录一条原因后禁用持久化,`drive_report` 会如实报错而不是假装成功。反过来,有 `storageDomain` 的组合会把记录写进 `test_drive` 领域(表 `runs`、`matrices` 与 latest-matrix 指针)。
217
304
 
218
- ```json
219
- {
220
- "schema": "dsh-test-drive/v1",
221
- "run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
222
- "finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
223
- "harnessVersion": "0.1.7-rc.2", "pluginVersion": "0.3.13",
224
- "platform": "win32", "node": "v22.22.3" },
225
- "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
226
- "resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
227
- "hasBundleManifest": true } },
228
- "isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
229
- "hostHomeTouched": false },
230
- "stages": {
231
- "install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
232
- "summary": "install ok after allowBuilds allowance", "outputTail": "",
233
- "allowBuildsNeeded": true },
234
- "config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
235
- "summary": "dump ok (exit 0)", "outputTail": "",
236
- "patchEffective": true, "layers": ["dsh-click"] },
237
- "smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
238
- "summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
239
- "outputTail": "", "bootFailed": false, "taskCompleted": false },
240
- "capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
241
- "summary": "tool \"plugin_vet\" called and its result contains the expectation",
242
- "outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
243
- "expectMatched": true,
244
- "detail": "tool \"plugin_vet\" called and its result contains the expectation" },
245
- "uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
246
- "summary": "remove ok (exit 0)", "outputTail": "" },
247
- "cleanup": { "status": "pass", "quarantined": true, "removed": true,
248
- "summary": "owned temp root quarantined and removed" }
249
- },
250
- "verdict": "pass",
251
- "verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
252
- }
305
+ </details>
306
+
307
+ <details>
308
+ <summary>被测插件的子进程会拿到我的密钥吗?</summary>
309
+
310
+ 默认不会。子进程继承的是**已剥离凭据**的环境;除非你在 `forwardEnv` 里显式点名某个变量(只写变量**名**),宿主机密钥不会进入被测 profile,而且这些值永不落日志。所有报告与日志字符串还会过纯函数脱敏:令牌字面量、URL 凭据、bearer 头被涂红,临时根路径替换为 `<testdrive-temp>`,输出尾部按字节封顶。
311
+
312
+ </details>
313
+
314
+ <details>
315
+ <summary>为什么冒烟阶段经常只到 <code>boot-ok</code>?</summary>
316
+
317
+ 因为启动检查本身不需要凭据,而真跑完一句任务需要模型凭据。没有凭据时插件如实上报 `boot-ok`——既没有 loader 失败,也没有跑完任务——而不是把没验证过的东西记成 `pass`。要让它走到 `pass`,请显式配置 `forwardEnv` 转发凭据(值仍不进日志)。
318
+
319
+ </details>
320
+
321
+ <details>
322
+ <summary>实测失败时临时目录会残留吗?</summary>
323
+
324
+ 不会静默残留。清理在 `finally` 里执行,覆盖成功、失败、超时与中止,插件卸载时还会再扫一次;删除前先把根目录改名为 `dsh-test-drive-quarantine-<时间戳>` 隔离目录再核验,失败时目录保持隔离并如实上报。想保留现场取证就设 `keepTempDirs: true`,此时所有权会被放弃,由你自己清理。
325
+
326
+ </details>
327
+
328
+ ## 安全边界
329
+
330
+ - **隔离**:每次实测在 OS 临时目录下全新 `mkdtemp` 根内进行:一次性 `DSH_HOME`、一次性工作目录、重定向的 pnpm store。被测插件代码只在那个 profile 中运行;宿主机 profile 不受影响。
331
+ - **所有权**:活跃注册表记录本插件实例创建的每个根目录。清理会拒绝任何「非注册的、不在 OS 临时目录直接子级、不携带 `dsh-test-drive-` 前缀」的路径——不扫 `%TEMP%` 全量、不碰他人前缀、不碰真实家目录。
332
+ - **清理阶梯**:任何变更前先打印完整 dry-run 计划(绝对路径)。删除先把根目录改名为 `dsh-test-drive-quarantine-<时间戳>` 隔离目录,核验后再删;失败则目录保持隔离并如实上报,绝不静默丢弃。成功、失败、超时、中止的所有路径都在 `finally` 中执行清理,插件卸载时再次清扫。
333
+ - **`allowBuilds` 是真实权限**:放行 git 包的 `prepare` 构建意味着在安装时执行该包的代码。放行范围仅限一次性 profile,但仍只测你信任的目标,并固定 commit。
334
+ - **headless 冒烟默认无密钥**:启动检查不需要凭据;完成一句任务才需要。要转发凭据请显式配置 `forwardEnv`,且绝不记录其值。
335
+
336
+ ## 权限与数据
337
+
338
+ - **服务面**:只消费公开服务 —— `ctx.subprocess`、`ctx.jobs`、`ctx.storageDomain`、`ctx.tools`、`ctx.commands`;其中 `storageDomain` 是可选依赖,缺失时启动与实测都不受影响。
339
+ - **权限**:`dshWorkshop` manifest 声明 `fs:read`、`fs:write`、`subprocess:spawn`、`session:append`、`network:inherit`、`native-code:none` —— 写权限只用于自己创建的临时根与报告落盘,`network:inherit` 只是继承宿主(被测目标的 registry/git 安装本来就需要网络)。
340
+ - **数据**:报告存于 `test_drive` storage-domain(表 `runs`、`matrices`;latest-matrix 指针);没有该领域时报告不持久化并记录原因。
341
+ - **会话日志**:子进程继承已剥离凭据的环境,`forwardEnv` 只转发变量名;所有报告/日志字符串都经纯函数脱敏 —— 令牌字面量、URL 凭据与 bearer 头被涂红,临时根路径被替换为 `<testdrive-temp>`,输出尾部按字节封顶。
342
+
343
+ ## 已知限制
344
+
345
+ - **DSH Desktop 不是受支持的测试宿主。** `test_drive` 需要能启动第二个 headless 进程的 `dsh` CLI,而 `dsh.CMD` launcher 只允许 `dsh plugin …`、`--dump-config` 与 `--version`;请把 `dshBin` 指向 npm/pnpm 安装的 `dsh`。
346
+ - 安装 registry/git 目标需要子进程 `dsh`/pnpm 具备网络访问。
347
+ - 冒烟任务需要模型凭据才能到 `pass`;没有时如实上报 `boot-ok`。
348
+ - 没有 `storageDomain` 的组合不持久化报告(`drive_report` 会诚实报错)。
349
+ - `dsh` 必须能在 PATH 上定位(或配置 `dshBin`);Windows 下自动解析 npm 的 `.cmd`/`.bat` shim,若只解析到 `.ps1` 会要求配置 `dshBin`。
350
+ - 批默认串行执行;提高 `batchConcurrency` 只影响 pnpm-store 磁盘争用,不影响正确性。
351
+
352
+ ## 与其他 DSH 插件的互操作性
353
+
354
+ `dsh-test-drive` 只暴露两个工具与一个命令,不参与别的插件的接缝:
355
+
356
+ - **命名空间隔离。** 只注册 `test_drive`、`drive_report` 两个工具与 `/testdrive` 一条命令,不占用内置工具或插件已用的裸名。
357
+ - **不占客户端与 HTTP 资源。** 本包含无 `client/` 半,不注册客户端 slot、不注册 `webServer` 路由、不装 `agent/pre-step` / `tools/post-execute` 等 waterfall 监听器(`AGENTS.md` 明确记录:本插件当前不注册任何 waterfall 监听器),也不改全局对象。
358
+ - **无服务键冲突。** 不提供任何 service key,只消费 `subprocess`、`jobs`、`tools`、`commands` 与可选的 `storageDomain`。
359
+ - **patch 层只插自己一行。** 组合包 patch 只 `insert` 自己的 `test-drive` 行,从不覆写内置行的 `config`。
360
+ - **注册即 effect。** 工具、命令与领域关闭都在 `ctx.effect` 内注册,停止/热重载只撤销自己注册的东西,临时目录注册表也会在 disposer 里扫尾。
361
+
362
+ ## 兼容性
363
+
364
+ | 维度 | 状态 |
365
+ |---|---|
366
+ | Harness | DeepSeek Harness `dsh-v0.2.2-rc.4`(GitHub tag,2026-11-18 已核验:完整门禁链 + profile 安装冒烟)。npm 依赖线 `0.1.2-rc.1` 与 `0.1.7-rc.2`;`engines.dsh`:`>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0` |
367
+ | Node | `^22.19.0 \|\| >=24.9.0` |
368
+ | 包管理器 | `pnpm@11.7.0` |
369
+ | 平台 | Windows / macOS / Linux(纯 host 插件,无 UI 半) |
370
+ | 外部工具 | PATH 上的 `dsh` CLI(自动探测,可解析 npm shim)、PATH 上的 `pnpm` |
371
+
372
+ ## 生态与质量
373
+
374
+ - [Gitee 镜像](https://gitee.com/perrylink/dsh-test-drive)(同步镜像,以 GitHub 为准)
375
+ - [dshfind 插件页](https://dshfind.com/plugins/PerryLink/dsh-test-drive)(安装量与排名)
376
+ - [OpenSSF Scorecard 报告](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-test-drive)(由 [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml) 驱动)
377
+ - [dsh-plugin-doctor 验证报告](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)(由本仓的 [.github/workflows/plugin-doctor.yml](.github/workflows/plugin-doctor.yml) 驱动)
378
+ - [DSH Market](https://dsh.market/)(已上架)
379
+ - **1024 商店渠道**:先 `npm i -g dsh1024`,再 `dsh1024 plugin --profile web add dsh-test-drive`(计入 [deepseek1024.com](https://deepseek1024.com) 安装排行)
380
+ - [生态实测知识库](https://perrylink.github.io/dsh-plugin-guide/):插件开发指南 · 选型实测数据 · 维护取舍判据
381
+
382
+ ## 开发
383
+
384
+ ```sh
385
+ pnpm install # node ^22.19 || >=24.9
386
+ pnpm run typecheck # tsc:src + tests,经本地 harness checkout 解析 @deepseek-ai/*
387
+ pnpm run typecheck:ci # tsc:对照已发布的宿主类型
388
+ pnpm test # vitest
389
+ pnpm run build # node scripts/prepare.mjs(tsdown bundle + 声明)
390
+ pnpm run verify:self-contained # 依赖 spec 均来自 registry
391
+ pnpm run verify:artifacts # 发布文件齐全 + lib/index.js 可 import
392
+ pnpm run check:readmes # 五语 README 一致性
393
+ pnpm pack # 发布 tarball
253
394
  ```
254
395
 
255
- Verdict rules: install failure, boot failure (`smoke.fail`), or a capability stage that reached `not-registered`/`failed` ⇒ `fail`; install pass + patch effective + clean boot (`pass`/`boot-ok`) + uninstall pass ⇒ `pass` (with a capability note when `observed`); anything installed but missing a later assurance ⇒ `partial`; otherwise `unknown`.
396
+ - `typecheck` 经本地 harness checkout 解析 `@deepseek-ai/*`;`typecheck:ci` 对照已发布的宿主类型检查。
397
+ - 测试使用真实 `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/storage 栈 + 脚本化 subprocess provider。
398
+ - 真实 CLI 端到端(需网络 + PATH 上的 `dsh`):`DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` —— 用真实安装冒烟循环实测本包自身 checkout。
399
+ - 发布:`node scripts/release.mjs <x.y.z>`(升版本、CHANGELOG 落日期、重跑门禁、commit + tag;不 push)。
256
400
 
257
- ## CI (GitHub Actions)
401
+ ### GitHub Action(action.yml)
258
402
 
259
- The repository ships a composite [`action.yml`](action.yml) that reuses `dsh-test-drive` in any plugin repo. It drives a target in an isolated throwaway profile and emits the report pair CI consumes: Markdown (PR comment) and JUnit XML (test reporter / status check).
403
+ 仓库内置一个 composite [`action.yml`](action.yml),可在任意插件仓库里 `uses:` 复用:它在一次性隔离 profile 里驱动目标,并输出 CI 消费的报告对 —— Markdown(PR 评论)与 JUnit XML(测试报告/状态检查)。
260
404
 
261
405
  ```yaml
262
406
  # .github/workflows/test-drive.yml
@@ -280,76 +424,38 @@ jobs:
280
424
  run: cat "${{ steps.drive.outputs.markdown }}"
281
425
  ```
282
426
 
283
- `action.yml` inputs: `target` (required), `headless-task` (optional smoke task), `dsh-version` (the `dsh` CLI spec). Outputs: `markdown`, `junit` (report paths), and `verdict` (`pass`/`fail`/`partial`/`unknown`). The drive itself stays keyless (install → patch check → boot smoke → uninstall → cleanup); a capability assertion is the only stage that needs `DEEPSEEK_API_KEY`, and it is `skipped`, never failed, without one.
284
-
285
- The same report pair is available programmatically: `renderDriveResult` / `renderMatrix` (Markdown) and `renderDriveJUnitXml` / `renderMatrixJUnitXml` (JUnit) are exported from the package root over a settled `DriveResult` or `MatrixRecord`.
286
-
287
- ## Permissions & data
427
+ `action.yml` 输入:`target`(必填)、`headless-task`(可选冒烟任务)、`dsh-version`(`dsh` CLI 规格);输出:`markdown`、`junit`(报告路径)与 `verdict`(`pass`/`fail`/`partial`/`unknown`)。驱动本身无需密钥(install → patch 校验 → 启动冒烟 → 卸载 → 清理);只有 capability 断言需要 `DEEPSEEK_API_KEY`,缺省时 `skipped` 而不是失败。
288
428
 
289
- - Only public services are consumed: `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`.
290
- - Reports are stored in the `test_drive` storage-domain (tables `runs`, `matrices`; latest-matrix pointer). When the composition has no `storageDomain` (e.g. the shipped headless profile), tools still work and report persistence is disabled with a logged reason.
291
- - Child processes inherit a credential-scrubbed environment: host secrets never reach a tested profile unless you explicitly name them in `forwardEnv`. Values are never logged.
292
- - All report/log strings pass through pure sanitizers: token literals, URL credentials, and bearer headers are redacted, temp-root paths are replaced with `<testdrive-temp>`, and tails are byte-capped.
429
+ 同一对报告也可编程取得:`renderDriveResult` / `renderMatrix`(Markdown)与 `renderDriveJUnitXml` / `renderMatrixJUnitXml`(JUnit)从包根导出,作用于已结算的 `DriveResult` 或 `MatrixRecord`。
293
430
 
294
- ## Security boundaries
431
+ 配图由 [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) 程序化生成(Python + Pillow),可重复执行:`python scripts/gen-readme-assets.py`。
295
432
 
296
- - **Isolation.** Each drive runs inside a fresh `mkdtemp` root under the OS temp dir: a throwaway `DSH_HOME`, a throwaway working directory, and a redirected pnpm store. The tested plugin's code only ever runs in that profile; your host profile is untouched.
297
- - **Ownership.** A live registry records every root this plugin instance creates. Cleanup refuses anything that is not a registered direct child of the OS temp dir carrying the `dsh-test-drive-` prefix — no `%TEMP%` sweeps, no foreign prefixes, no real-home paths.
298
- - **Cleanup ladder.** Before any mutation the full dry-run plan is logged (absolute paths). Removal renames the root into a `dsh-test-drive-quarantine-<ts>` directory first, verifies, then deletes; failures leave the directory quarantined and reported, never silently dropped. Cleanup runs in a `finally` on success, failure, timeout, and abort, and again on plugin teardown.
299
- - **`allowBuilds` is a real permission.** Allowing a git package's `prepare` build executes that package's code at install time. The allowance is scoped to the throwaway profile only, but only test targets you trust, and pin commits.
300
- - **Headless smoke is keyless by default.** The boot check needs no credentials; completing the one-shot task does. Forward credentials explicitly (`forwardEnv`) and never log them.
433
+ Topics:`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
301
434
 
302
- ## Known limitations
435
+ ## 家族与致谢
303
436
 
304
- - Installing registry/git targets requires network access from the child `dsh`/pnpm processes.
305
- - The smoke task needs model credentials to reach `pass`; without them it reports the honest `boot-ok`.
306
- - In compositions without `storageDomain`, reports are not persisted (`drive_report` fails honestly).
307
- - `dsh` must be locatable on PATH (or set `dshBin`); on Windows the npm `.cmd`/`.bat` shim is parsed automatically, a bare `.ps1` resolution asks for `dshBin`.
308
- - Batches default to serial execution; raising `batchConcurrency` shares the pnpm-store disk, not correctness.
437
+ 本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件家族成员(全部 Apache-2.0)。如果这个插件帮到了你,**给个 star** —— 它不解锁任何功能,但会让下一个人更容易找到它。
309
438
 
310
- ## Development
311
-
312
- ```sh
313
- pnpm install
314
- pnpm run typecheck && pnpm run typecheck:ci && pnpm test
315
- pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack
316
- ```
317
-
318
- - `typecheck` resolves `@deepseek-ai/*` through the local harness checkout; `typecheck:ci` checks against the published `0.1.7-rc.2` types.
319
- - Tests use the real `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/storage stack with a scripted subprocess provider.
320
- - Real-CLI end-to-end (requires network + `dsh` on PATH): `DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` — drives this package's own checkout through the real install-smoke loop.
321
- - Release: `node scripts/release.mjs <x.y.z>` (bumps, stamps CHANGELOG, re-runs the gate, commits + tags; never pushes).
322
-
323
- ## Topics
324
-
325
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
326
-
327
- ## Contributors
328
-
329
- [PerryLink](https://github.com/PerryLink) — design and implementation.
330
-
331
- ## PerryLink DSH Plugin Family
332
-
333
- This project is part of the DeepSeek Harness plugin family from [PerryLink](https://github.com/PerryLink). The roster stays collapsed below so every README keeps a short first screen; expand it to see every row and its status.
439
+ - [@PerryLink](https://github.com/PerryLink) —— 创建者与维护者:单目标流水线、能力断言阶段、临时目录所有权与隔离清理阶梯、结构化结果契约与五语文档。
334
440
 
335
441
  <details>
336
- <summary>Expand all plugins</summary>
442
+ <summary>展开全部插件</summary>
337
443
 
338
- | Plugin | Status |
444
+ | 插件 | 状态 |
339
445
  |---|---|
340
446
  | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
341
447
  | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
342
448
  | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
343
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 FROZEN — see the repo README |
449
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 已冻结 — 见仓库 README |
344
450
  | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
345
451
  | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
346
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 FROZEN — see the repo README |
452
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 已冻结 — 见仓库 README |
347
453
  | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
348
454
  | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
349
455
  | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
350
456
  | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
351
457
  | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
352
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
458
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 已冻结 — 见仓库 README |
353
459
  | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
354
460
  | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
355
461
  | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
@@ -382,7 +488,7 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
382
488
  | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
383
489
  | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
384
490
  | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
385
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
491
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 已冻结 — 见仓库 README |
386
492
  | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
387
493
  | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
388
494
  | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
@@ -394,10 +500,10 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
394
500
  | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
395
501
  | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
396
502
  | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
397
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
503
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 已退役(仓库已归档) |
398
504
  | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
399
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
400
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
505
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 已退役(仓库已归档) |
506
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 已退役(仓库已归档) |
401
507
  | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
402
508
  | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
403
509
  | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
@@ -409,7 +515,7 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
409
515
  | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
410
516
  | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
411
517
  | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
412
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
518
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 已冻结 — 见仓库 README |
413
519
  | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
414
520
  | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
415
521
  | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
@@ -421,20 +527,22 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
421
527
  | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
422
528
  | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
423
529
  | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
424
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
530
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 已退役(仓库已归档) |
425
531
  | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
426
532
  | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
427
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 FROZEN — see the repo README |
428
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 FROZEN — see the repo README |
429
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 FROZEN — see the repo README |
430
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 FROZEN — see the repo README |
431
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 FROZEN — see the repo README |
432
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRED — see the repo README |
433
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRED — see the repo README |
434
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRED — see the repo README |
533
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 已冻结 — 见仓库 README |
534
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 已冻结 — 见仓库 README |
535
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 已冻结 — 见仓库 README |
536
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 已冻结 — 见仓库 README |
537
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 已冻结 — 见仓库 README |
538
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 已退役(仓库已归档) |
539
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 已退役(仓库已归档) |
540
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 已退役(仓库已归档) |
435
541
 
436
542
  </details>
437
543
 
438
544
  ## License
439
545
 
440
- [Apache-2.0](LICENSE)
546
+ [LICENSE](LICENSE)(Apache License 2.0)© 2026 dsh-test-drive contributors
547
+
548
+ <p align="center"><sub>Apache-2.0 · 社区插件,与 DeepSeek 无关。</sub></p>