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/CHANGELOG.md +2 -0
- package/README.en.md +548 -0
- package/README.es.md +548 -0
- package/README.hi.md +548 -0
- package/README.md +337 -229
- package/README.pt.md +548 -0
- package/lib/index.js +1 -1
- package/lib/types/version.d.ts +1 -1
- package/package.json +24 -24
- package/README-es.md +0 -418
- package/README-hi.md +0 -418
- package/README-pt.md +0 -418
- package/README-zh.md +0 -417
package/README.md
CHANGED
|
@@ -1,130 +1,197 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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
|
-
|
|
10
|
+
**在一次性 profile 里装、启动、断言、卸载、清理——把「装一下看看能不能跑」变成可复现的流水线。**
|
|
10
11
|
|
|
11
|
-
|
|
12
|
+
面向 DeepSeek Harness 插件的隔离式安装冒烟实测:每个目标独占一个 `dsh-v0.2.2-rc.4`(2026-11-18);`mkdtemp` 根(一次性 `DSH_HOME`、一次性工作目录、重定向的 pnpm store),你真实的 `~/.dsh` 从头到尾不被读写,结果落成下游可直接消费的结构化记录。
|
|
12
13
|
|
|
13
|
-
[
|
|
14
|
-
[](https://github.com/topics/dsh-plugin)
|
|
15
|
-
[](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
|
|
16
|
-
[](https://dsh.market/)
|
|
17
|
-
[](#)
|
|
18
|
-
[](https://github.com/PerryLink/dsh-test-drive/actions)
|
|
19
|
-
[](https://github.com/PerryLink/dsh-test-drive/releases)
|
|
20
|
-
[](https://www.npmjs.com/package/dsh-test-drive)
|
|
21
|
-
[](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
|
-
[
|
|
16
|
+
[](LICENSE)
|
|
17
|
+
[](#兼容性)
|
|
18
|
+
[](https://www.npmjs.com/package/dsh-test-drive)
|
|
19
|
+
[](https://github.com/PerryLink/dsh-test-drive/actions/workflows/ci.yml)
|
|
20
|
+
[](#兼容性)
|
|
21
|
+
|
|
22
|
+
[](https://github.com/PerryLink/dsh-test-drive/stargazers)
|
|
23
|
+
[](https://www.npmjs.com/package/dsh-test-drive)
|
|
24
|
+
[](https://dshfind.com/plugins/PerryLink/dsh-test-drive?ref=badge)
|
|
25
|
+
[](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-test-drive)
|
|
26
|
+
[](https://dsh.market/)
|
|
27
|
+
[](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
|
-
|
|
37
|
+
## 它是什么
|
|
35
38
|
|
|
36
|
-
|
|
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
|
-
|
|
40
|
-
|
|
41
|
-
dsh
|
|
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
|
-
|
|
48
|
+
1. **安装**(两通道):
|
|
47
49
|
|
|
48
|
-
|
|
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
|
-
|
|
59
|
+
```yaml
|
|
60
|
+
allowBuilds:
|
|
61
|
+
'dsh-test-drive': true
|
|
62
|
+
```
|
|
52
63
|
|
|
53
|
-
|
|
64
|
+
npm 通道的预构建包不需要构建许可。重启 profile 后,即可在会话中使用 `test_drive` / `/testdrive`。
|
|
54
65
|
|
|
55
|
-
|
|
66
|
+
2. **最小配置**(默认即可用;只有要跑能力断言时才需要 `capability.*` 与 `forwardEnv`):
|
|
56
67
|
|
|
57
|
-
|
|
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
|
-
|
|
83
|
+
3. **验证已生效**(重启后):
|
|
60
84
|
|
|
85
|
+
```sh
|
|
86
|
+
dsh --profile web --dump-config | grep -A3 'id: test-drive'
|
|
87
|
+
```
|
|
61
88
|
|
|
89
|
+
然后对一个已知目标发起第一次实测:
|
|
62
90
|
|
|
63
|
-
|
|
91
|
+
```text
|
|
92
|
+
test_drive({ target: "dsh-click" })
|
|
93
|
+
→ verdict pass · tdr_0b9b6e6a61e3e80cc4620f2e · 完整记录见下方「示例」
|
|
94
|
+
```
|
|
64
95
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
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
|
-
|
|
103
|
+
所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览:**市场 → 来源 → 添加来源 → 粘贴** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ 选中**。安装仍需通过市场的 npm 身份校验与你的确认。
|
|
74
104
|
|
|
75
|
-
|
|
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
|
-
##
|
|
107
|
+
## 核心能力
|
|
83
108
|
|
|
84
|
-
|
|
109
|
+
`dsh-test-drive` 把一次「装机验证」拆成可观察、可回放的阶段:
|
|
85
110
|
|
|
86
|
-
|
|
87
|
-
|
|
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
|
-
|
|
126
|
+
### 工具面
|
|
91
127
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
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
|
-
|
|
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
|
-
|
|
100
|
-
dsh plugin --profile web add dsh-test-drive
|
|
101
|
-
```
|
|
136
|
+
### 结构化结果
|
|
102
137
|
|
|
103
|
-
|
|
138
|
+
判定规则:安装失败、启动失败(`smoke.fail`)、或能力阶段到达 `not-registered` / `failed` ⇒ `fail`;安装通过 + patch 生效 + 启动干净(`pass` / `boot-ok`)+ 卸载通过 ⇒ `pass`(能力阶段 `observed` 时附说明);已安装但后续保证缺失 ⇒ `partial`;其余 ⇒ `unknown`。
|
|
104
139
|
|
|
105
|
-
|
|
140
|
+
<details>
|
|
141
|
+
<summary>完整记录样例(dsh-test-drive/v1)</summary>
|
|
106
142
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
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
|
-
|
|
180
|
+
</details>
|
|
114
181
|
|
|
115
|
-
|
|
182
|
+
### 示例
|
|
116
183
|
|
|
117
|
-
|
|
184
|
+
以下为插件真实入口;安装后调用一个即可。
|
|
118
185
|
|
|
119
|
-
|
|
186
|
+
**详细示例** — 命令 `test_drive`,输入:
|
|
120
187
|
|
|
121
|
-
|
|
188
|
+
```sh
|
|
122
189
|
test_drive({ target: "dsh-click" })
|
|
123
|
-
|
|
190
|
+
```
|
|
124
191
|
|
|
125
|
-
|
|
192
|
+
输出:
|
|
126
193
|
|
|
127
|
-
|
|
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
|
-
|
|
148
|
-
|
|
149
|
-
**Input**
|
|
214
|
+
**失败分支** — 输入:
|
|
150
215
|
|
|
151
|
-
|
|
216
|
+
```text
|
|
152
217
|
{"target":" "}
|
|
153
|
-
|
|
218
|
+
```
|
|
154
219
|
|
|
155
|
-
|
|
220
|
+
输出:
|
|
156
221
|
|
|
157
|
-
|
|
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
|
-
|
|
228
|
+
**简短示例**:`test_drive` · `/testdrive` · `drive_report`
|
|
229
|
+
|
|
230
|
+
## 配置
|
|
164
231
|
|
|
232
|
+
所有键均可选(下列为默认值);非法值在加载期响亮失败。`cordis.patch.yml` 逐键内联注释。
|
|
165
233
|
|
|
234
|
+
最常用键:
|
|
166
235
|
|
|
167
|
-
|
|
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
|
-
|
|
247
|
+
<details>
|
|
248
|
+
<summary>完整配置表(19 个键)</summary>
|
|
170
249
|
|
|
171
|
-
|
|
|
250
|
+
| 键 | 默认值 | 含义 |
|
|
172
251
|
|---|---|---|
|
|
173
|
-
| `profileName` | `headless` |
|
|
174
|
-
| `dshBin` | `""` |
|
|
175
|
-
| `headlessTask` | `"Reply with exactly: ok"` |
|
|
176
|
-
| `forwardEnv` | `[]` |
|
|
177
|
-
| `allowBuilds` | `true` |
|
|
178
|
-
| `installTimeoutMs` | `600000` | `dsh plugin add`
|
|
179
|
-
| `configTimeoutMs` | `60000` | `--dump-config`
|
|
180
|
-
| `smokeTimeoutMs` | `300000` |
|
|
181
|
-
| `capabilityTimeoutMs` | `300000` |
|
|
182
|
-
| `capability.enabled` | `false` |
|
|
183
|
-
| `capability.kind` | `tool` |
|
|
184
|
-
| `capability.name` | `""` |
|
|
185
|
-
| `capability.args` | `""` |
|
|
186
|
-
| `capability.expect` | `""` |
|
|
187
|
-
| `uninstallTimeoutMs` | `120000` | `dsh plugin remove`
|
|
188
|
-
| `outputTailBytes` | `8000` |
|
|
189
|
-
| `keepTempDirs` | `false` |
|
|
190
|
-
| `maxBatchTargets` | `20` | `/testdrive`
|
|
191
|
-
| `batchConcurrency` | `1` |
|
|
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
|
-
|
|
199
|
-
|
|
200
|
-
|
|
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
|
-
|
|
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
|
-
|
|
293
|
+
<details>
|
|
294
|
+
<summary>会碰我真实的 <code>~/.dsh</code> 吗?</summary>
|
|
209
295
|
|
|
210
|
-
|
|
296
|
+
不会。每次实测都在 OS 临时目录下的一个全新 `mkdtemp` 根内进行:一次性 `DSH_HOME`、一次性工作目录、重定向的 pnpm store,被测插件的代码只在那套临时 profile 里执行。宿主机 profile 既不被读取也不被写入,结构化记录里的 `isolation.hostHomeTouched` 恒为 `false`。清理只认本插件登记过的目录,绝不扫描 `%TEMP%`、不碰他人前缀、不碰真实家目录。
|
|
211
297
|
|
|
212
|
-
|
|
298
|
+
</details>
|
|
213
299
|
|
|
214
|
-
|
|
300
|
+
<details>
|
|
301
|
+
<summary>组合里没有 <code>storageDomain</code> 时,报告会丢吗?</summary>
|
|
215
302
|
|
|
216
|
-
|
|
303
|
+
工具照常工作,只是报告不持久化:插件会记录一条原因后禁用持久化,`drive_report` 会如实报错而不是假装成功。反过来,有 `storageDomain` 的组合会把记录写进 `test_drive` 领域(表 `runs`、`matrices` 与 latest-matrix 指针)。
|
|
217
304
|
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
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
|
-
|
|
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
|
-
|
|
401
|
+
### GitHub Action(action.yml)
|
|
258
402
|
|
|
259
|
-
|
|
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`
|
|
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
|
-
|
|
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
|
-
|
|
431
|
+
配图由 [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) 程序化生成(Python + Pillow),可重复执行:`python scripts/gen-readme-assets.py`。
|
|
295
432
|
|
|
296
|
-
-
|
|
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
|
-
##
|
|
435
|
+
## 家族与致谢
|
|
303
436
|
|
|
304
|
-
|
|
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
|
-
|
|
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
|
|
442
|
+
<summary>展开全部插件</summary>
|
|
337
443
|
|
|
338
|
-
|
|
|
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)** | 🧊
|
|
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)** | 🧊
|
|
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)** | 🧊
|
|
428
|
-
| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊
|
|
429
|
-
| **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊
|
|
430
|
-
| **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊
|
|
431
|
-
| **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊
|
|
432
|
-
| **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫
|
|
433
|
-
| **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫
|
|
434
|
-
| **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫
|
|
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
|
|
546
|
+
[LICENSE](LICENSE)(Apache License 2.0)© 2026 dsh-test-drive contributors
|
|
547
|
+
|
|
548
|
+
<p align="center"><sub>Apache-2.0 · 社区插件,与 DeepSeek 无关。</sub></p>
|