dsh-test-drive 0.3.25 → 0.3.26

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.
Files changed (46) hide show
  1. package/CHANGELOG.md +0 -0
  2. package/LICENSE +0 -0
  3. package/README.en.md +548 -0
  4. package/README.es.md +548 -0
  5. package/README.hi.md +548 -0
  6. package/README.md +337 -229
  7. package/README.pt.md +548 -0
  8. package/SECURITY.md +0 -0
  9. package/THIRD_PARTY_NOTICES.md +0 -0
  10. package/cordis.patch.yml +0 -0
  11. package/lib/index.js +1 -1
  12. package/lib/types/batch.d.ts +0 -0
  13. package/lib/types/batch.d.ts.map +0 -0
  14. package/lib/types/capability.d.ts +0 -0
  15. package/lib/types/capability.d.ts.map +0 -0
  16. package/lib/types/command.d.ts +0 -0
  17. package/lib/types/command.d.ts.map +0 -0
  18. package/lib/types/config.d.ts +0 -0
  19. package/lib/types/config.d.ts.map +0 -0
  20. package/lib/types/domain.d.ts +0 -0
  21. package/lib/types/domain.d.ts.map +0 -0
  22. package/lib/types/drive.d.ts +0 -0
  23. package/lib/types/drive.d.ts.map +0 -0
  24. package/lib/types/driver.d.ts +0 -0
  25. package/lib/types/driver.d.ts.map +0 -0
  26. package/lib/types/index.d.ts +0 -0
  27. package/lib/types/index.d.ts.map +0 -0
  28. package/lib/types/report.d.ts +0 -0
  29. package/lib/types/report.d.ts.map +0 -0
  30. package/lib/types/result.d.ts +0 -0
  31. package/lib/types/result.d.ts.map +0 -0
  32. package/lib/types/sanitize.d.ts +0 -0
  33. package/lib/types/sanitize.d.ts.map +0 -0
  34. package/lib/types/session-log.d.ts +0 -0
  35. package/lib/types/session-log.d.ts.map +0 -0
  36. package/lib/types/tools.d.ts +0 -0
  37. package/lib/types/tools.d.ts.map +0 -0
  38. package/lib/types/version.d.ts +1 -1
  39. package/lib/types/version.d.ts.map +0 -0
  40. package/lib/types/workspace.d.ts +0 -0
  41. package/lib/types/workspace.d.ts.map +0 -0
  42. package/package.json +46 -24
  43. package/README-es.md +0 -418
  44. package/README-hi.md +0 -418
  45. package/README-pt.md +0 -418
  46. package/README-zh.md +0 -417
package/README-zh.md DELETED
@@ -1,417 +0,0 @@
1
- <div align="center">
2
-
3
- # 🧪 dsh-test-drive
4
- - **1024 商店渠道**:先 `npm i -g dsh1024`,再 `dsh1024 plugin --profile web add dsh-test-drive`(计入 [deepseek1024.com](https://deepseek1024.com) 安装排行)。
5
-
6
- **面向 DeepSeek Harness 插件的隔离式安装冒烟实测。**
7
-
8
- *在一次性 profile 中完成安装、冒烟、验证与清理——绝不触碰你真实的 `~/.dsh`。*
9
-
10
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
11
- [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-test-drive)
12
- [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
13
- [![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-徽章)
14
- [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-zh.svg)](https://dsh.market/)
15
- [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
16
- [![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)
17
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-test-drive?label=version)](https://github.com/PerryLink/dsh-test-drive/releases)
18
- [![npm version](https://img.shields.io/npm/v/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
19
- [![npm downloads](https://img.shields.io/npm/dm/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
20
-
21
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
22
-
23
- ```sh
24
- dsh plugin --profile <name> add dsh-test-drive
25
- ```
26
-
27
-
28
- </div>
29
-
30
- ---
31
-
32
-
33
- **📖 生态实测知识库**(实测数据,不是营销):[插件开发指南 · 选型实测数据 · 维护取舍判据](https://perrylink.github.io/dsh-plugin-guide/)。
34
-
35
- <!-- star-cta -->
36
- ## Install & uninstall(安装与卸载)
37
-
38
- ```sh
39
- dsh plugin --profile web add dsh-test-drive # 安装(npm)——或上面的 git 形式
40
- dsh plugin --profile web remove dsh-test-drive # 卸载
41
- ```
42
-
43
- ## ⭐ 如果它帮到了你
44
-
45
- 这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(95 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
46
-
47
- *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.
48
-
49
- ## What is dsh-test-drive?
50
-
51
- 面向 DeepSeek Harness 插件的隔离式安装冒烟实测。
52
-
53
- 在一次性 profile 中完成安装、冒烟、验证与清理——绝不触碰你真实的 `~/.dsh`。
54
-
55
- ![dsh-test-drive 工作流图:问题 → 封存来源 → 报告。](docs/assets/dsh-test-drive-flow.svg)
56
-
57
- *工作流概览:问题 → 封存来源 → 报告。下面的示例使用实际命令面。*
58
-
59
-
60
- *同一次运行,动图版。*
61
-
62
- ## Compatibility(兼容性)
63
-
64
- | 组件 | 版本 |
65
- |---|---|
66
- | DeepSeek Harness | **`dsh-v0.2.1-alpha.1`**(GitHub tag,2026-09-11 已核验:完整门禁链 + profile 安装冒烟)。npm 依赖线 `0.1.2-rc.1` 与 `0.1.7-rc.2`(peer 依赖 `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0`)。 |
67
- | Node.js | `^22.19.0 \|\| >=24.0.0` |
68
- | 包管理器 | `pnpm@11.7.0` |
69
- | 平台 | Windows / macOS / Linux(纯 host 插件) |
70
- | 外部工具 | PATH 上的 `dsh` CLI(自动探测,可解析 npm shim)、PATH 上的 `pnpm` |
71
-
72
- ## What you get(你能得到什么)
73
-
74
- - `test_drive` 工具 —— 单个目标跑完整流水线:`dsh plugin add` → `--dump-config` patch 校验 → headless 引导冒烟(FAILED 标记扫描 + 可选一句任务)→ 可选能力断言 → `dsh plugin remove` → 隔离清理。同步返回结构化记录;传 `background: true` 则返回 `{ kind: 'background', jobId }`。
75
- - `/testdrive` 命令 —— 把空格/逗号分隔的目标列表作为 `drive-batch` 后台任务(`ctx.jobs`)批量跑,产出矩阵报告(JSON + Markdown)。
76
- - `drive_report` 工具 —— 按 id 取回任意单次记录(`tdr_...`)、矩阵(`tdm_...`)或最新矩阵;以 Markdown 渲染。
77
- - 能力断言 —— 不止于“启动并退出”:可选的 `capability` 阶段让 agent 调用指定工具(或运行 `/command`),并核对持久会话日志确实记录了调用、观察输出包含 `expect`。干净启动只是冒烟;`observed` 才证明具名能力真实可用。
78
- - 结构化结果 —— 每条记录带判别符 `schema: "dsh-test-drive/v1"`,关键字段均为一级字段:`stages.install.status`(`pass`/`fail`)、`stages.smoke.status`(`pass`/`fail`/`boot-ok`/`skipped`)、各阶段 `durationMs`、脱敏后的 `summary`/`outputTail` 以及总判定 `verdict`(`pass`/`fail`/`partial`/`unknown`)。这是下游评分方(dsh-score)消费的机器可读契约。
79
- - 结构安全 —— 每个临时目录都由本插件以专属前缀 `dsh-test-drive-` 创建、登记在活跃所有权注册表中,且只经「dry-run → 隔离改名 → 删除」阶梯清理。宿主机 profile 永不被读取或写入。
80
-
81
- ## Quick start(快速开始)
82
-
83
- ### git 通道
84
-
85
- ```sh
86
- dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
87
- ```
88
-
89
- 首次 `add` 会因 pnpm 拦截该包的 `prepare` 构建而失败;把 pnpm 打印的精确键复制进 profile 的 `pnpm-workspace.yaml` 后重跑:
90
-
91
- ```yaml
92
- allowBuilds:
93
- 'dsh-test-drive': true
94
- ```
95
-
96
- ### npm 通道
97
-
98
- ```sh
99
- dsh plugin --profile web add dsh-test-drive
100
- ```
101
-
102
- 预构建包无需构建许可。重启 profile 后,即可在会话中使用 `test_drive` / `/testdrive`。
103
-
104
- ## DSH Desktop 不是受支持的测试宿主
105
-
106
- `test_drive` 需要一个能启动**第二个** headless DSH 进程的 `dsh` CLI。DSH Desktop 的
107
- `dsh.CMD` 只允许 `dsh plugin …`、`--dump-config` 和 `--version`,会按策略拒绝第二次
108
- headless 启动。请把 `config.dshBin` 指向 npm/pnpm 安装的 `dsh` CLI(或普通 Node + dsh
109
- JS 入口)。现在的报错会明确说明这一点,而不是“cannot parse npm shim”。
110
-
111
- ## Configuration(配置)
112
-
113
- 所有键均可选(下列为默认值);非法值在加载期响亮失败。
114
-
115
- | 键 | 默认值 | 说明 |
116
- |---|---|---|
117
- | `profileName` | `headless` | 每次一次性 DSH_HOME 内初始化的 profile 模板(base + headless bundles)。 |
118
- | `dshBin` | `""` | dsh 可执行文件的绝对路径覆盖;为空则自动探测 PATH 上的 `dsh`。 |
119
- | `headlessTask` | `"Reply with exactly: ok"` | 引导冒烟阶段的一句任务;为空则跳过该阶段。 |
120
- | `forwardEnv` | `[]` | 转发进测试 profile 子进程的环境变量**名**(绝不转发值)。 |
121
- | `allowBuilds` | `true` | 在测试 profile 中放行被拦截的 git `prepare` 构建并重试一次安装。 |
122
- | `installTimeoutMs` | `600000` | `dsh plugin add` 阶段时限。 |
123
- | `configTimeoutMs` | `60000` | `--dump-config` 阶段时限。 |
124
- | `smokeTimeoutMs` | `300000` | headless 引导冒烟阶段时限。 |
125
- | `capabilityTimeoutMs` | `300000` | 能力断言任务时限。
126
- | `capability.enabled` | `false` | 运行能力断言阶段(注册 → 调用 → 观察到)。
127
- | `capability.kind` | `tool` | 断言对象:`tool` 或 `command`。
128
- | `capability.name` | `""` | 工具或命令名(不带前导 `/`)。
129
- | `capability.args` | `""` | 调用文本:工具参数(JSON 风格)或命令参数。
130
- | `capability.expect` | `""` | 期望出现在观察输出中的字面量(不区分大小写子串)。
131
- | `uninstallTimeoutMs` | `120000` | `dsh plugin remove` 阶段时限。 |
132
- | `outputTailBytes` | `8000` | 每阶段记录的脱敏输出尾部上限(字节)。 |
133
- | `keepTempDirs` | `false` | 失败时保留临时目录供取证(所有权被放弃,由你清理)。 |
134
- | `maxBatchTargets` | `20` | `/testdrive` 批上限。 |
135
- | `batchConcurrency` | `1` | 批并发度(串行可避免 pnpm-store 争用)。 |
136
-
137
- ## Tools & surfaces(工具与界面)
138
-
139
- ### `test_drive`
140
-
141
- ```
142
- test_drive(target: string, headlessTask?: string, background?: boolean,
143
- capability?: { kind: 'tool' | 'command', name: string,
144
- args: string, expect: string })
145
- ```
146
-
147
- - `target` —— git 规格(`github:owner/repo#sha`、`git+https://...`)、npm 包名、本地路径或 `.tgz` 压缩包。
148
- - `capability` —— 冒烟后的断言:agent 以 `args` 调用 `name`(tool)或运行 `/name`(command);阶段读取持久会话日志并要求观察输出包含 `expect`。需要 `DEEPSEEK_API_KEY`(宿主环境或 `forwardEnv`);缺失时该阶段为 `skipped`,绝不算失败。
149
- - 返回完整结构化记录,样例见下。
150
- - `background: true` 启动一个 `drive-batch` 任务并返回其 id。
151
-
152
- ### `/testdrive <目标...>`
153
-
154
- 启动一个后台批任务;进度经任务输出流式推送,最后一行给出供 `drive_report` 使用的矩阵 id。
155
-
156
- ### `drive_report(id?)`
157
-
158
- 返回单次记录(`tdr_...`)、矩阵(`tdm_...`),或不传 id 时返回最新矩阵。
159
-
160
- ### 结构化结果样例
161
-
162
- ```json
163
- {
164
- "schema": "dsh-test-drive/v1",
165
- "run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
166
- "finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
167
- "harnessVersion": "0.1.7-rc.2", "pluginVersion": "0.3.10",
168
- "platform": "win32", "node": "v22.22.3" },
169
- "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
170
- "resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
171
- "hasBundleManifest": true } },
172
- "isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
173
- "hostHomeTouched": false },
174
- "stages": {
175
- "install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
176
- "summary": "install ok after allowBuilds allowance", "outputTail": "",
177
- "allowBuildsNeeded": true },
178
- "config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
179
- "summary": "dump ok (exit 0)", "outputTail": "",
180
- "patchEffective": true, "layers": ["dsh-click"] },
181
- "smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
182
- "summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
183
- "outputTail": "", "bootFailed": false, "taskCompleted": false },
184
- "capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
185
- "summary": "tool \"plugin_vet\" called and its result contains the expectation",
186
- "outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
187
- "expectMatched": true,
188
- "detail": "tool \"plugin_vet\" called and its result contains the expectation" },
189
- "uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
190
- "summary": "remove ok (exit 0)", "outputTail": "" },
191
- "cleanup": { "status": "pass", "quarantined": true, "removed": true,
192
- "summary": "owned temp root quarantined and removed" }
193
- },
194
- "verdict": "pass",
195
- "verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
196
- }
197
- ```
198
-
199
- 判定规则:安装失败、启动失败(`smoke.fail`)或能力阶段到达 `not-registered`/`failed` ⇒ `fail`;安装通过 + patch 生效 + 启动干净(`pass`/`boot-ok`)+ 卸载通过 ⇒ `pass`(`observed` 时附能力说明);已安装但后续保证缺失 ⇒ `partial`;其余 ⇒ `unknown`。
200
-
201
- ## CI (GitHub Actions)
202
-
203
- 仓库内置一个 composite [`action.yml`](action.yml),可在任意插件仓库里 `uses:` 复用:它在一次性隔离 profile 里驱动目标,并输出 CI 消费的报告对 —— Markdown(PR 评论)与 JUnit XML(状态检查)。输入 `target`(必填)/`headless-task`/`dsh-version`;输出 `markdown`/`junit`/`verdict`。驱动本身无需密钥;只有 capability 断言需要 `DEEPSEEK_API_KEY`,缺省时该阶段 `skipped` 而非失败。
204
-
205
- ## Permissions & data(权限与数据)
206
-
207
- - 只消费公开服务:`ctx.subprocess`、`ctx.jobs`、`ctx.storageDomain`、`ctx.tools`、`ctx.commands`。
208
- - 报告存于 `test_drive` storage-domain(表 `runs`、`matrices`;latest-matrix 指针)。组合中没有 `storageDomain` 时(如官方 headless profile),工具照常工作,报告持久化被禁用并记录原因。
209
- - 子进程继承的是**已剥离凭据**的环境:除非你在 `forwardEnv` 中显式点名,宿主机密钥永远不会进入被测 profile;值永不落日志。
210
- - 所有报告/日志字符串都经纯函数脱敏:令牌字面量、URL 凭据与 bearer 头被涂红,临时根路径被替换为 `<testdrive-temp>`,输出尾部按字节封顶。
211
-
212
- ## Security boundaries(安全边界)
213
-
214
- - **隔离**:每次实测在 OS 临时目录下全新 `mkdtemp` 根内进行:一次性 `DSH_HOME`、一次性工作目录、重定向的 pnpm store。被测插件代码只在那个 profile 中运行;宿主机 profile 不受影响。
215
- - **所有权**:活跃注册表记录本插件实例创建的每个根目录。清理会拒绝任何「非注册的、不在 OS 临时目录直接子级、不携带 `dsh-test-drive-` 前缀」的路径——不扫 `%TEMP%` 全量、不碰他人前缀、不碰真实家目录。
216
- - **清理阶梯**:任何变更前先打印完整 dry-run 计划(绝对路径)。删除先把根目录改名为 `dsh-test-drive-quarantine-<时间戳>` 隔离目录,核验后再删;失败则目录保持隔离并如实上报,绝不静默丢弃。成功、失败、超时、中止的所有路径都在 `finally` 中执行清理,插件卸载时再次清扫。
217
- - **`allowBuilds` 是真实权限**:放行 git 包的 `prepare` 构建意味着在安装时执行该包的代码。放行范围仅限一次性 profile,但仍只测你信任的目标,并固定 commit。
218
- - **headless 冒烟默认无密钥**:启动检查不需要凭据;完成一句任务才需要。要转发凭据请显式配置 `forwardEnv`,且绝不记录其值。
219
-
220
- ## Known limitations(已知限制)
221
-
222
- - 安装 registry/git 目标需要子进程 `dsh`/pnpm 具备网络访问。
223
- - 冒烟任务需要模型凭据才能到 `pass`;没有时如实上报 `boot-ok`。
224
- - 没有 `storageDomain` 的组合不持久化报告(`drive_report` 会诚实报错)。
225
- - `dsh` 必须能在 PATH 上定位(或配置 `dshBin`);Windows 下自动解析 npm 的 `.cmd`/`.bat` shim,若只解析到 `.ps1` 会要求配置 `dshBin`。
226
- - 批默认串行执行;提高 `batchConcurrency` 只影响 pnpm-store 磁盘争用,不影响正确性。
227
-
228
- ## Development(开发)
229
-
230
- ```sh
231
- pnpm install
232
- pnpm run typecheck && pnpm run typecheck:ci && pnpm test
233
- pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack
234
- ```
235
-
236
- - `typecheck` 经本地 harness checkout 解析 `@deepseek-ai/*`;`typecheck:ci` 对照已发布的 `0.1.7-rc.2` 类型检查。
237
- - 测试使用真实 `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/storage 栈 + 脚本化 subprocess provider。
238
- - 真实 CLI 端到端(需网络 + PATH 上的 `dsh`):`DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` —— 用真实安装冒烟循环实测本包自身 checkout。
239
- - 发布:`node scripts/release.mjs <x.y.z>`(升版本、CHANGELOG 落日期、重跑门禁、commit + tag;不 push)。
240
-
241
- ## Topics
242
-
243
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
244
-
245
- ## Contributors(贡献者)
246
-
247
- [PerryLink](https://github.com/PerryLink) —— 设计与实现。
248
-
249
- ## PerryLink DSH Plugin Family
250
-
251
- 本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件家族成员。完整名单默认折叠,避免每个 README 的首屏被长表淹没;点击展开可查看每一行及其状态。
252
-
253
- <details>
254
- <summary>展开全部插件</summary>
255
-
256
- | 插件 | 状态 |
257
- |---|---|
258
- | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
259
- | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
260
- | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
261
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | |
262
- | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
263
- | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
264
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | |
265
- | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
266
- | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
267
- | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
268
- | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
269
- | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
270
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
271
- | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
272
- | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
273
- | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
274
- | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
275
- | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
276
- | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
277
- | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
278
- | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
279
- | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
280
- | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
281
- | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
282
- | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
283
- | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
284
- | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
285
- | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
286
- | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
287
- | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
288
- | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
289
- | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
290
- | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
291
- | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
292
- | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
293
- | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
294
- | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
295
- | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
296
- | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
297
- | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
298
- | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
299
- | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
300
- | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
301
- | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
302
- | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
303
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
304
- | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
305
- | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
306
- | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
307
- | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
308
- | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
309
- | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
310
- | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
311
- | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
312
- | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
313
- | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
314
- | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
315
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
316
- | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
317
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
318
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
319
- | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
320
- | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
321
- | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
322
- | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
323
- | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
324
- | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
325
- | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
326
- | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
327
- | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
328
- | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
329
- | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
330
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
331
- | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
332
- | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
333
- | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
334
- | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
335
- | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
336
- | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
337
- | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
338
- | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
339
- | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
340
- | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
341
- | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
342
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
343
- | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
344
- | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
345
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 已冻结 — 见仓库 README |
346
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 已冻结 — 见仓库 README |
347
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 已冻结 — 见仓库 README |
348
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 已冻结 — 见仓库 README |
349
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 已冻结 — 见仓库 README |
350
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 已退役 — 见仓库 README |
351
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 已退役 — 见仓库 README |
352
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 已退役 — 见仓库 README |
353
-
354
- </details>
355
-
356
- ## License(许可证)
357
-
358
- [Apache-2.0](LICENSE)
359
-
360
- ### 从 DSH Desktop 市场安装
361
-
362
- 所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览:**市场 → 来源 → 添加来源 → 粘贴** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ 选中**。安装仍需通过市场的 npm 身份校验与你的确认。
363
-
364
- ### 示例
365
-
366
- 以下为插件真实入口;安装后调用一个即可。
367
-
368
- #### 详细示例
369
-
370
- **命令**
371
-
372
- ~~~sh
373
- test_drive({ target: "dsh-click" })
374
- ~~~
375
-
376
- **输出**
377
-
378
- ~~~text
379
- # Test drive tdr_0b9b6e6a61e3e80cc4620f2e
380
-
381
- - Target: `dsh-click` (npm)
382
- - Verdict: ✅ pass — install, patch, boot, task, and uninstall all verified
383
- - Installed: dsh-click@0.2.0
384
- - Isolation: throwaway DSH_HOME + workspace + pnpm store; host profile untouched
385
-
386
- | Stage | Result | Exit | Duration | Summary |
387
- |---|---|---|---|---|
388
- | install | ✅ pass | 0 | 1 ms | install ok (exit 0) |
389
- | config (--dump-config) | ✅ pass | 0 | 0 ms | patch effective: dsh-click |
390
- | smoke (headless boot) | ✅ pass | 0 | 0 ms | booted cleanly and the headless task completed |
391
- | capability | ⏭️ skipped | null | 0 ms | capability assertion disabled (config.capability.enabled is false and no per-drive capability given) |
392
- | uninstall | ✅ pass | 0 | 0 ms | remove ok (exit 0) |
393
- | cleanup | ✅ pass | — | — | owned temp root quarantined and removed |
394
- ~~~
395
-
396
- *来源 `README.md:153-163,174-211; tests/drive.spec.ts:73-101; src/report.ts:34-55`*
397
-
398
- #### 失败分支
399
-
400
- **输入**
401
-
402
- ~~~text
403
- {"target":" "}
404
- ~~~
405
-
406
- **输出**
407
-
408
- ~~~text
409
- isError=true; error.message=dsh-test-drive: target must be a non-empty string
410
- ~~~
411
-
412
- *来源 `plugins/dsh-test-drive/src/tools.ts:297-299 (blank target check); exercised through plugins/dsh-test-drive/tests/harness.ts`*
413
-
414
- #### 简短示例
415
-
416
-
417
-