# 测试记录维护规则

本目录保存 QtDesktopPet 每次正式回归、候选发布和性能验收的长期记录。验收标准定义在
`../QtDesktopPet_测试清单与验收标准.md`，本目录只记录某一次构建的实际执行结果。

## 文件规则

- 每次验收创建独立文件：`YYYY-MM-DD_<version>_<commit>.md`。
- 已完成记录不覆盖；复测结果追加在原记录的“缺陷与复测”部分。
- `index.md` 维护所有测试轮次和最终结论。
- 工作树不干净时，commit 后增加 `-dirty`，并记录差异摘要。
- 状态统一使用 `PASS / FAIL / BLOCKED / NOT_RUN`。

## 数据边界

- 允许提交：测试环境、用例结论、脱敏错误摘要、性能统计摘要和缺陷编号。
- 禁止提交：API Key、Authorization、完整用户对话、完整服务端错误正文、真实用户路径和原始性能 CSV。
- 原始性能 CSV 保存在 `reports/perf/`，该目录不进入 Git。
- 自动化临时输出保存在 `internal/qa/out/`，该目录不进入 Git。

## 工作流

1. 从 `TEMPLATE.md` 创建本次记录并填写不可变构建信息。
2. 执行内部自动化和静态检查，粘贴摘要而不是完整原始日志。
3. 按功能测试清单分批手测，用户反馈后更新本次记录。
4. 执行性能采样，将审核后的 Markdown 摘要纳入本次记录。
5. 在 `index.md` 登记结论；存在阻断问题时不得标记为可发布。