Skip to content

归档任务的测试附件回收 ​

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. 接口 ​

sh
# 只读预览候选文件及字节数
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:

ts
{
  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 无法再回放。