docs(tests): record recoverable deletions and cleanup verification

docs/协作/测试脚本清理-2026-10-21.md

@@ -0,0 +1,53 @@
+# 测试脚本清理与入口整理
+
+日期：2026-10-21（Asia/Shanghai）。用户明确授权整理并批量删除；本次是测试工程维护，不改变 B01/B02 产品验收结论。
+
+- 基线：`f512a0f3fd2b8a4f74f1ba530bde17e6c212205a`，保留远端刚加入的 Dev 启动 SOP。
+- **清理代码 SHA：`a839d23e129e14c65c4d216c238414b47cd9ad63`**。
+- `src/` 无改动；不删除用户数据、不改依赖锁文件、不清除 Git 历史。
+
+## 删除与保留
+
+删除 **115 个追踪文件 / 111,158 字节**：105 个无活动依赖的一次性 REA 操作 JSON、10 个已停用的直接 WorkBuddy CDP 工具。删除前逐项验证内容与基线相同；[完整清单](evidence/test-cleanup-20261021/deletions.json) 包含原因、引用、原哈希及恢复方法。
+
+保留：
+- 26 个有现行文档复跑、媒体或字体恢复用途的候选 REA 配置。
+- REA 恢复程序、工具自测、source manifest/生成源码/证据，以及有效产品回归、构建和发布工具。
+- 6 个仍有诊断用途或尚不能证明失效的根级候选工具，包括有 npm 入口的 shot；不因“没挂 npm”就删除。
+- 原始历史验收文档不重写；其中已删除脚本链接须按记录的历史 SHA 查看，不能把历史路径误当现行命令。
+
+脚本目录追踪文件由 **472 → 359**（删除 115，增加入口说明与 reporting 回归两文件）。这不是删除 115 个产品测试，也不代表测试覆盖缩减了同等数量。未保留另一份 scripts/archive 副本；需要时从 Git 恢复，禁止复活已禁用的原版采集方式。
+
+恢复单个文件：
+
+```sh
+git restore --source=f512a0f3fd2b8a4f74f1ba530bde17e6c212205a -- <清单中的路径>
+```
+
+## 测试入口与结果
+
+- 新增 `npm test` → `test:core`：类型检查 + chat/sessions/persistence/conversation 离线基线。不是全产品或 UI 验收。
+- 新增 `test:alignment:dom` 严格入口；DOM 依赖缺失/错误时失败，不静默降级。普通 `test:alignment` 无依赖时明确输出 DOM SKIP。
+- 推荐技能后端将 required-offline PASS 与 real-package PASS/SKIP 分开。缺可选缓存只能 SKIP；显式指定的坏路径或其他 I/O 错误失败，不冒充通过。
+- 新增 `test:reporting` 六项真实 subprocess 结果契约回归。
+- 移除失效的 `wb:capture` npm 入口，更新 AGENTS 历史说明。
+- [scripts/README.md](../../scripts/README.md) 明确核心、专项、Windows UI、REA/发布工具的用途及安全边界；根 README 增加入口。没有执行现场诊断或把所有脚本一键批跑。
+
+## 验证
+
+[命令证据](evidence/test-cleanup-20261021/verification.txt)：
+
+| 命令 | 结果 |
+| --- | --- |
+| `npm test` | 退出 0，核心类型/状态/存储/渲染回归通过 |
+| `npm run test:reporting` | 退出 0，6/6；覆盖显式 SKIP、严格 DOM 缺依赖/坏模块、可选缓存与显式坏 ZIP |
+| 设置 DOM 路径后 `npm run test:alignment:dom` | 退出 0，offline 10 套与 DOM 7 套通过；SDK 部分仍为 mock |
+| `test:recommended-skills`、`test:recommended-skills:dom` | 退出 0；后者 45 项，前者真实发布包为 SKIP，未冒充执行 |
+| `npm run build` | 退出 0，包含类型检查与产物构建 |
+| `git diff --check` | 通过 |
+
+独立静态审查核对 115 项删除与清单完全一致；115 个唯一 npm 脚本目标存在；扫描 1,181 个保留代码/配置文件，没有发现删除造成的 live import、runner、fixture、构建/发布或 REA 恢复依赖断裂。残余 wb-icons 出处注释和 wb-home CSS 前缀不是执行依赖。
+
+未启动真实 Electron/原版/模型、未下载真实技能或发布。没有运行全部工具或 Windows 测试；静态引用检查和 Linux 构建不能冒充全部环境通过。已有 token 门禁问题不在本轮修复范围，未修改其 baseline。
+
+后续若继续整理，应复用公共 React/Electron 测试夹具并逐模块迁移，而非一次改写所有仍有效测试；本次没有为统一目录而大面积移动有效脚本。