归档任务的测试附件回收
1. 适用范围
从 0.1.7 起,可回收已完成 Pi 任务中过早失败的 Playwright 诊断附件。保留完整会话、所有检查报告、错误文字、日志、覆盖率、原始证据清单和成功检查的全部产物。不会修改 CI 环境、重试次数、测试用例或检查通过条件。
按 packagePath + check.id 分组,各组保留最近失败运行的附件;时间相同的运行全部保留。多个业务包不会互相挤掉最后一份失败现场。只回收 runner.json 明确引用、原 evidence.json 登记的 trace.zip、video.webm 和 test-failed-N.png。未知附件、手动截图和 error-context.md 保留。
2. 接口
# 只读预览候选文件及字节数
wenext-test compact --task-dir /absolute/path/to/completed-task
# 按同一策略执行;可在中断后重跑
wenext-test compact --task-dir /absolute/path/to/completed-task --apply
# 不需要原业务仓库的历史文件完整性核验
wenext-test verify-evidence --output /absolute/path/to/command-run/output包导出 compactTaskDiagnostics(taskDirectory, apply = false) 和 verifyReportEvidence(outputDirectory)。verify-evidence 不证明测试通过,也不证明当前源码或环境仍适用;原 verify 继续执行成功状态、请求、版本和源码绑定校验。
3. 数据契约
compact 只接受 task.json.status=completed,检查 quality/command-runs/*/output 的已完成测试报告。预览不写入文件。返回 taskId、applied、candidateFiles、candidateBytes、candidates[{path,bytes}]、reclaimedFiles 和 reclaimedBytes。字节为逻辑大小;不承诺文件系统实际分配空间等量下降。
每个被回收的运行在 output 同级创建不可变的 diagnostic-retention.json:
{
schemaVersion: 1,
policy: "older-failed-playwright",
taskId: string,
planId: string,
manifestHash: string, // 原 evidence.json 字节的 SHA-256
createdAt: string,
files: Array<{ path: string; sha256: string; bytes: number }>
}原 evidence.json、runner.json、report.json 和 Pi 的冻结证据均不改写。收据先记录回收意图,再逐文件核验哈希并删除;中断后允许收据中的附件部分仍在,存在的文件必须匹配原哈希。重跑继续剩余附件,不重复累计已回收空间。收据不是签名授权,不能抵御拥有本机文件写权限者同时篡改全部原件与哈希。
Pi 0.1.4 的 Web 质量插件在正常 wenext_finish 完成后调用已初始化的 test-tool。旧工具不执行清理;没有选中 Web 检查时,不为清理额外联网安装工具。失败只提示并保留重试条件,不撤销任务完成。启动时设置 WENEXT_TEST_RETAIN_ALL=1 可禁用自动回收,手动 --apply 是另一次显式操作。
4. 验证与错误
| 条件 | 行为 |
|---|---|
| 活动任务、任务身份不匹配 | 拒绝回收 |
| 未登记的缺失附件、报告或日志变化 | 校验失败,不用回收记录豁免 |
| 收据哈希/planId 不匹配、列入非诊断文件 | 拒绝 |
| 路径含符号链接或越界 | 拒绝 |
| 出现额外普通文件 | 校验失败 |
Finder 等新增 .DS_Store、Thumbs.db、desktop.ini | 容忍未登记的系统元数据;已登记者仍须匹配哈希 |
| 历史报告来自旧版本或业务目录已搬迁 | 按文件和报告中的路径映射核验,不要求原业务仓库存在 |
| 较早失败运行无可识别附件 | 保留,不猜测目录内容 |
| 自动清理超时或失败 | 提示可能部分完成;按收据重试 |
5. 示例
- 正常:A、B 两轮失败后 C 成功;回收 A 的诊断附件,保留 B、C 全部产物以及 A 的所有文字证据。
- 基础:只有一次失败或全部成功,没有候选,返回零。
- 错误:为了腾空间删除整个
quality/command-runs,会破坏检查报告及 Pi 冻结证据。
6. 回归要求
预览零写入;按包/check 保留;相同时间保留;成功产物保留;失败结果不变;原 manifest 字节不变;活动任务拒绝;未登记缺失/内容变化拒绝;目录链接拒绝;中断后幂等重试;系统元数据不影响核验;旧版本报告和搬迁路径兼容。Pi 层验证完成前不调用、旧工具跳过、完整保留开关、错误警告及归档前后目录定位。
7. 正确与错误用法
错误:删掉附件后重写 evidence.json,让目录看起来从未有过附件,或把失败报告改成通过。
正确:保留原始报告和清单,记录哪些附件按策略回收。用户仍可查看每轮失败原因;被回收的早期视频与 trace 无法再回放。