插件试驾台 PerryLink/dsh-test-drive

🧪 dsh-test-drive

- 1024 store channel：先执行一次 npm i -g dsh1024，再执行 dsh1024 plugin --profile web add dsh-test-drive（会计入 deepseek1024.com 的安装排名）。

dshfind

为 DeepSeek Harness 插件提供隔离的安装与冒烟试驾。

在一次性配置档里安装、冒烟、验证、清理 —— 你真实的 ~/.dsh 原封不动。

dsh-doctor
DSH Market

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

dsh plugin --profile <name> add dsh-test-drive

📖 生态知识库 —— 实测数据，不是营销话术：插件开发指南 · 插件选型数据 · 维护标准。

安装与卸载

dsh plugin --profile web add dsh-test-drive # install (npm) — or the git form above
dsh plugin --profile web remove dsh-test-drive # uninstall

⭐ 如果它帮到了你

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

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.

dsh-test-drive 是什么？

为 DeepSeek Harness 插件提供隔离的安装与冒烟试驾。
在一次性配置档里安装、冒烟、验证、清理——你真实的 ~/.dsh 全程不动。

dsh-test-drive 的工作流示意图：问题 → 密封来源 → 报告。

工作流概览：问题 → 密封来源 → 报告。下面的示例都用真实命令接口。

兼容性

| 组件 | 版本 |
| DeepSeek Harness | dsh-v0.2.1-alpha.1（GitHub tag，2026-09-11 验证：完整门禁链 + 配置档安装冒烟）。npm 依赖行 0.1.2-rc.1 和 0.1.7-rc.2（peer dependencies >=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0） |
| Node.js | ^22.19.0 \|\| >=24.0.0 |
| 包管理器 | pnpm@11.7.0 |
| 平台 | Windows / macOS / Linux（仅宿主插件） |
| 外部工具 | PATH 上的 dsh 命令行（自动探测，会解析 npm shims）、PATH 上的 pnpm |

你能得到什么

- test_drive 工具——让一个目标走完整条流水线：dsh plugin add → --dump-config 补丁检查 → 无头启动冒烟（扫描 FAILED 标记 + 可选的一次性任务）→ 可选的能力断言 → dsh plugin remove → 隔离清理。同步返回结构化记录，或返回 { kind: 'background', jobId } 并带 background: true。
- /testdrive 命令——把空格或逗号分隔的目标列表作为 drive-batch 后台任务批量驱动，跑在 ctx.jobs 上，产出矩阵报告（JSON + Markdown）。
- drive_report 工具——取回任意已存运行（tdr_...）、矩阵（tdm_...）或最新矩阵，渲染成 Markdown。
- 能力断言——不止「启动并退出」：可选的 capability 阶段驱动一个无头任务，调用指定工具（或运行 /command），再核对持久会话日志确实记下了这次调用，且观测到的输出包含 expect。干净启动只是冒烟测试；observed 才证明某项能力真的可用。
- 结构化结果——每条记录都带判别字段 schema: "dsh-test-drive/v1"，字段都是一等公民：stages.install.status（pass/fail）、stages.smoke.status（pass/fail/boot-ok/skipped）、stages.capability.status（observed/invoked/not-registered/skipped/failed）、各阶段的 durationMs、脱敏后的 summary/outputTail，以及总体 verdict（pass/fail/partial/unknown）。这就是下游评分器（dsh-score）消费的机器可读契约。
- 从构造上保证安全——每个临时目录都由本插件创建，带专用前缀 dsh-test-drive-，登记在实时归属注册表里，只走「试运行 → 隔离重命名 → 删除」这套阶梯移除。宿主配置档从不读、也不写。

快速开始

Git 渠道

dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>

第一次 add 会失败，因为 pnpm 拦截了包的 prepare 构建；把 pnpm 打印出的那个 key 原样抄进配置档的 pnpm-workspace.yaml，再跑一次：

allowBuilds:
'dsh-test-drive': true

npm 渠道

sh
dsh plugin --profile web add dsh-test-drive

预构建包不需要构建许可。重启配置档，然后在会话里使用 test_drive / /testdrive。

DSH Desktop 不是受支持的测试宿主

test_drive 需要一个能启动第二个无头 DSH 进程的 dsh 命令行。DSH Desktop 启动器（dsh.CMD）只允许 dsh plugin …、--dump-config 和 --version，按策略拒绝第二次无头启动。请把 config.dshBin 指向 npm/pnpm 安装的 dsh 命令行（或纯 Node + dsh JS 入口）。现在错误信息会明确说明这一点，不再报「cannot parse npm shim」。

示例

下面是插件的真实入口；安装一次，然后调用其中一个。

详细示例

命令

~~~sh
test_drive({ target: "dsh-click" })

输出

~~~text
Test drive tdr_0b9b6e6a61e3e80cc4620f2e

- Target: dsh-click (npm)
- Verdict: ✅ pass — install, patch, boot, task, and uninstall all verified
- Installed: dsh-click@0.2.0
- Isolation: throwaway DSH_HOME + workspace + pnpm store; host profile untouched

| Stage | Result | Exit | Duration | Summary |
| install | ✅ pass | 0 | 1 ms | install ok (exit 0) |
| config (--dump-config) | ✅ pass | 0 | 0 ms | patch effective: dsh-click |
| smoke (headless boot) | ✅ pass | 0 | 0 ms | booted cleanly and the headless task completed |
| capability | ⏭️ skipped | null | 0 ms | capability assertion disabled (config.capability.enabled is false and no per-drive capability given) |
| uninstall | ✅ pass | 0 | 0 ms | remove ok (exit 0) |
| cleanup | ✅ pass | — | — | owned temp root quarantined and removed |

摘自 README.md:153-163,174-211; tests/drive.spec.ts:73-101; src/report.ts:34-55

失败分支

输入

~~~text
{"target":" "}

输出

~~~text
isError=true; error.message=dsh-test-drive: target must be a non-empty string

摘自 plugins/dsh-test-drive/src/tools.ts:297-299 (blank target check); exercised through plugins/dsh-test-drive/tests/harness.ts

简要示例

配置

所有键都是可选的（默认值如下）；值无效会在加载时直接报错。

| 键 | 默认值 | 说明 |
| profileName | headless | 在每个一次性 DSH_HOME 内初始化的配置档模板（base + headless 包）。 |
| dshBin | "" | 覆盖 dsh 可执行文件的绝对路径；留空则自动在 PATH 上查找 dsh。 |
| headlessTask | "Reply with exactly: ok" | 启动冒烟阶段的一次性任务；留空则跳过该阶段。 |
| forwardEnv | [] | 转发到测试配置档子进程的环境变量名（绝不转发值）。 |
| allowBuilds | true | 在测试配置档里把被拦截的 git prepare 构建加入允许列表，并重试安装一次。 |
| installTimeoutMs | 600000 | dsh plugin add 阶段的超时时间。 |
| configTimeoutMs | 60000 | --dump-config 阶段的超时时间。 |
| smokeTimeoutMs | 300000 | 无头启动冒烟阶段的超时时间。 |
| capabilityTimeoutMs | 300000 | 能力断言任务的截止时间。 |
| capability.enabled | false | 运行能力断言阶段（registered → invoked → observed）。 |
| capability.kind | tool | 断言对象：tool 或 command。 |
| capability.name | "" | 工具或命令名（不带前导 /）。 |
| capability.args | "" | 调用文本：工具参数（JSON 风格）或命令词。 |
| capability.expect | "" | 观测输出中期望出现的字面量（不区分大小写的子串）。 |
| uninstallTimeoutMs | 120000 | dsh plugin remove 阶段的截止时间。 |
| outputTailBytes | 8000 | 每个阶段记录的脱敏输出尾部上限。 |
| keepTempDirs | false | 失败时保留临时目录以便取证（所有权已放弃，由你清理）。 |
| maxBatchTargets | 20 | /testdrive 批量上限。 |
| batchConcurrency | 1 | 批量并发数（串行可避免 pnpm store 争用）。 |

工具与入口

test_drive

test_drive(target: string, headlessTask?: string, background?: boolean,
capability?: { kind: 'tool' | 'command', name: string,
args: string, expect: string })

- target —— git 规格（github:owner/repo#sha、git+https://...）、npm 包名、本地路径或 .tgz 压缩包。
- capability —— 启动冒烟之后的断言：智能体调用 name（工具）或运行 /name（命令），并传入 args；该阶段读取持久化会话日志，要求观测输出包含 expect。需要 DEEPSEEK_API_KEY（宿主环境或 forwardEnv）；没有它时该阶段为 skipped，绝不会失败。
- 返回完整结构化记录；见下方示例。
- background: true 会启动 drive-batch 任务并返回其 id。

/testdrive <targets...>

启动一个后台批量任务；进度通过任务输出流式推送，最后一行给出矩阵 id，供 drive_report 使用。

drive_report(id?)

返回运行记录（tdr_...）、矩阵（tdm_...），或不带 id 时返回最新矩阵。

结构化结果示例 json { "schema": "dsh-test-drive/v1",
"run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
"finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
"harnessVersion": "0.1.7-rc.2", "pluginVersion": "0.3.13",
"platform": "win32", "node": "v22.22.3" },
"target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
"resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
"hasBundleManifest": true } },
"isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
"hostHomeTouched": false },
"stages": {
"install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
"summary": "install ok after allowBuilds allowance", "outputTail": "",
"allowBuildsNeeded": true },
"config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
"summary": "dump ok (exit 0)", "outputTail": "",
"patchEffective": true, "layers": ["dsh-click"] },
"smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
"summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
"outputTail": "", "bootFailed": false, "taskCompleted": false },
"capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
"summary": "tool \"plugin_vet\" called and its result contains the expectation",
"outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
"expectMatched": true,
"detail": "tool \"plugin_vet\" called and its result contains the expectation" },
"uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
"summary": "remove ok (exit 0)", "outputTail": "" },
"cleanup": { "status": "pass", "quarantined": true, "removed": true,
"summary": "owned temp root quarantined and removed" }
},
"verdict": "pass",
"verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
}

判定规则：安装失败、启动失败（smoke.fail），或能力阶段落到 not-registered/failed ⇒ fail；安装通过 + 补丁生效 + 干净启动（pass/boot-ok）+ 卸载通过 ⇒ pass（能力为 observed 时附一条说明）；已安装但缺少后续保障 ⇒ partial；其余情况 ⇒ unknown。

CI（GitHub Actions）

仓库自带一个复合 action.yml，可在任意插件仓库里复用 dsh-test-drive。它会在一次性的隔离配置档里驱动目标，并输出 CI 消费的报告对：Markdown（PR 评论）和 JUnit XML（测试报告器 / 状态检查）。
yaml

.github/workflows/test-drive.yml

name: test-drive
on: [pull_request, workflow_dispatch]
jobs:
smoke:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Drive this plugin
id: drive
uses: PerryLink/dsh-test-drive@v0.2.4
with:
target: github:${{ github.repository }}#${{ github.sha }}
- name: Publish JUnit
uses: EnricoMi/publish-unit-test-result-action@v2
with:
files: ${{ steps.drive.outputs.junit }}
- name: Comment the report
run: cat "${{ steps.drive.outputs.markdown }}"
action.yml 的 inputs：target（必填）、headless-task（可选的冒烟任务）、dsh-version（dsh 命令行规格）。Outputs：markdown、junit（报告路径）、verdict（pass/fail/partial/unknown）。驱动本身全程不需要密钥（安装 → 补丁检查 → 启动冒烟 → 卸载 → 清理）；只有能力断言这一阶段需要 DEEPSEEK_API_KEY，没有密钥时它标记为 skipped，绝不会失败。

同一对报告也能以编程方式获取：renderDriveResult / renderMatrix（Markdown）和 renderDriveJUnitXml / renderMatrixJUnitXml（JUnit）从包根导出，入参是已结算的 DriveResult 或 MatrixRecord。

权限与数据

- 只消费公共服务：ctx.subprocess、ctx.jobs、ctx.storageDomain、ctx.tools、ctx.commands。
- 报告存放在 test_drive 存储域（表 runs、matrices；最新矩阵指针）。组合中没有 storageDomain 时（例如随包发布的无头配置档），工具照常工作，报告持久化关闭，并记录原因。
- 子进程继承的是抹掉凭据的环境：宿主密钥永远不会到达被测配置档，除非你在 forwardEnv 里显式点名。值永远不会写进日志。
- 所有报告/日志字符串都经过纯函数清洗器：token 字面量、URL 凭据、bearer 头会被脱敏，临时根路径替换为 <testdrive-temp>，尾部按字节截断。

安全边界

- 隔离。 每次驱动都在 OS 临时目录下新建的 mkdtemp 根里运行：一次性的 DSH_HOME、一次性的工作目录、重定向的 pnpm store。被测插件的代码只在这个配置档里运行；你的宿主配置档不受影响。
- 归属。 一份实时注册表记录本插件实例创建的每个根。清理只接受位于 OS 临时目录下、带 dsh-test-drive- 前缀、且已注册的直接子目录——不扫 %TEMP%，不碰外来前缀，不碰真实 home 路径。
- 清理阶梯。 任何改动之前先记录完整 dry-run 计划（绝对路径）。删除时先把根重命名为 dsh-test-drive-quarantine-<ts> 目录，校验后再删除；失败则把目录留在隔离区并上报，绝不悄悄丢弃。清理在 finally 中执行，成功、失败、超时、中止都跑，插件拆卸时再跑一次。
- allowBuilds 是实打实的权限。 允许 git 包的 prepare 构建，就等于在安装时执行该包的代码。这项许可只作用于一次性配置档，但只测你信任的目标，并锁定 commit。
- 无头冒烟默认不需要密钥。 启动检查不需要凭据；完成一次性任务才需要。显式转发凭据（forwardEnv），且绝不记录。

已知限制

- 安装 registry/git 目标需要子 dsh/pnpm 进程能访问网络。
- 冒烟任务需要模型凭证才能达到 pass；没有凭证时，它会如实报告 boot-ok。
- 在没有 storageDomain 的组合里，报告不会持久化（drive_report 会如实失败）。
- dsh 必须能在 PATH 上找到（或设置 dshBin）；在 Windows 上，npm 的 .cmd/.bat shim 会自动解析，只解析到 .ps1 时会要求提供 dshBin。
- 批次默认串行执行；调高 batchConcurrency 只会共享 pnpm-store 磁盘，不影响正确性。

开发 sh
pnpm install
pnpm run typecheck && pnpm run typecheck:ci && pnpm test
pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack

- typecheck 通过本地 harness checkout 解析 @deepseek-ai/*；typecheck:ci 对照已发布的 0.1.7-rc.2 类型做检查。
- 测试使用真实的 Context/Session/ToolRuntime/LocalJobRegistry/storage 栈，配一个脚本化的子进程服务商。
- 真实命令行端到端（需要网络 + PATH 上有 dsh）：DSH_TESTDRIVE_E2E=1 pnpm run test:e2e —— 用真实的 install-smoke 循环驱动本包自己的 checkout。
- 发布：node scripts/release.mjs <x.y.z>（升版本、写入 CHANGELOG、重跑门禁、提交 + 打标签；从不推送）。

主题

dsh、dsh-plugin、deepseek-harness、deepseek、cordis、plugin-testing、install-smoke、compatibility-matrix、ci

贡献者

PerryLink —— 设计与实现。

PerryLink DSH 插件家族

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。下方名单默认折叠，好让每个 README 的首屏都保持简短；展开即可看到每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-budget | 🧊 已冻结 —— 见仓库 README |
| dsh-claude-move | 🧊 已冻结 —— 见仓库 README |
| dsh-defend | 🧊 已冻结 —— 见仓库 README |
| dsh-draw | 🧊 已冻结 —— 见仓库 README |
| dsh-reach | 🧊 已冻结 —— 见仓库 README |
| dsh-background-agents | 🚫 已退役 —— 见仓库 README |
| dsh-session-pin | 🚫 已退役 —— 见仓库 README |
| dsh-team-rooms | 🚫 已退役 —— 见仓库 README |

许可证

Apache-2.0