# 维护者兼容性探针

`probes/` 保留在公开仓库中，是因为它们可以复现项目对 DSH 兼容性、崩溃恢复、候选包内容和安装生命周期的关键声明。普通用户安装或使用插件时不需要运行这些命令。

探针不是生产代码。运行产生的 clone、构建产物和日志只会写入被 Git 忽略的 `.probe-work/`。

## 前置条件

- Windows PowerShell 5.1 或 PowerShell 7；
- Git、Node.js `^22.19.0 || >=24.0.0`、Corepack 和 pnpm 11；
- 可访问 npm registry；
- publication 跨平台探针需要带 Node.js 的 WSL2/Linux；
- 安装生命周期探针需要 Microsoft Edge、Google Chrome 或 DSH Playwright 可用的 Chromium。

准备一个官方、干净、固定 commit 的 DSH checkout。`main` / `0.4.0` 当前默认验证 `0.1.2-rc.1`：

```powershell
git clone https://github.com/deepseek-ai/deepseek-harness.git <dsh-source>
git -C <dsh-source> checkout a66e4702047846cdaa10c66c9d3df3951f5ea70d
git -C <dsh-source> status --porcelain
```

最后一条命令应无输出。探针不要求特殊目录布局，也不会向 DSH checkout 写入补丁。

## 运行

在 dsh-run2skill 仓库根目录执行：

```powershell
powershell -File probes/run-dsh-contract-probes.ps1 -DshSource <dsh-source>
powershell -File probes/run-dsh-root-contract-probe.ps1 -DshSource <dsh-source>
powershell -File probes/run-dsh-rc1-profile-probe.ps1 -DshSource <dsh-source>
powershell -File probes/run-publication-contract-probe.ps1
```

验证另一个已支持 commit 时，给 DSH 相关 runner 传入 `-ExpectedDshHead <commit>`。

这些命令分别覆盖：

- Session、Storage、Learning、LLM/Skill Adapter、Remote/API Gateway、Settings 和 Purge 契约；
- 默认 `PROJECT` / `USER` Skill roots、CREATE/MERGE、并发保护和 Registry 回读；
- RC1 Profile 的真实候选包 add、disable、upgrade、uninstall、认证 Web 调用和 Client 加载；
- Windows 与 Linux/WSL 上的原子发布和崩溃恢复；

旧版 `run-install-lifecycle-probe.ps1` 是 `0.3.1` / DSH `0.1.1-rc.2` 发布线的稳定候选升级探针。维护该版本时仍需显式传入旧 baseline 和精确候选 tarball：

发布稳定版时，把已经完成候选内容扫描、并将用于 npm 与 GitHub Release 的同一个 tarball 传给安装生命周期 runner：

```powershell
powershell -File probes/run-install-lifecycle-probe.ps1 `
  -DshSource <dsh-source> `
  -ExpectedDshHead b150a551b8d465e31e418e1b2eaf5e79bbb7d28e `
  -ReleaseCandidateTarball <dsh-run2skill-0.3.1.tgz> `
  -ReleaseCandidateSha256 <sha256>
```

该 runner 会从 npm 下载已发布的 `0.1.1-alpha`（固定 SHA-256 `c674dad6102426054d59a2843270ee86aecd36789e83604c02dd6efd345fbb26`）、`0.2.0` 和 `0.3.0`，再用传入的精确候选文件验证 `0.1.1-alpha → 0.2.0 → 0.3.0 → 0.3.1`。它会检查旧 v1 数据未被改写、v2 fresh activation 未迁移旧中间项、稳定版升级保留 v2 状态和原生 Skill，以及候选版卸载后数据仍保留。

此外：

```bash
pnpm run check
pnpm run verify:candidate
```

`verify:candidate` 会运行冻结评测和崩溃矩阵，精确检查候选包文件，并扫描许可、secret-like 内容、本机路径和日志脱敏。

## 证据边界

- PASS 只绑定当前 dsh-run2skill commit、指定 DSH commit、测试源码和运行平台；其中任何一项变化都可能需要重跑。
- runner 会在执行前后确认传入的 DSH checkout 保持同一 HEAD 且工作树干净。
- 不要把 `.probe-work/`、完整终端日志、凭据、私人路径或 Session 内容提交到仓库或 Issue。