suzmii
1b7261685c
登记素材上传配对的踩坑与覆盖边界：断言打在生产函数上，端到端 UI 未覆盖
- `pitfalls.md` 新增「素材上传不要把『上传前读到的 revision』贴到『上传后读到的清单』上」：现象（每次上传都先吃一条拒收提示）、根因（上传本身推进 revision，错配必然发生而非竞态）、处理（上传动作与配对读收进同一个函数，调用方拿不到中间那个 revision，也就没机会贴错）、同类文案坑（`unresolved` 三条进入路径里有两条重读是**成功**的，写成"读取磁盘清单失败"就是误报）、验证与变异，并记录关联文件与提交。
- 覆盖边界（按当下口径写清，防止后人误读）：断言打在生产函数 `uploadProjectAssetFilesAndReadSnapshot` 上 —— 它同时拥有上传与配对读，所以配对语义是真测的；但 AGC 侧**没有**「资源面板上传 → 拒收提示条」的端到端 UI 用例（现有 harness 只有聊天入口的 `/asset.upload`，资源面板 file input 无用例），因此「界面上不再出现拒收提示」是推理结论而非端到端断言，禁止当成端到端覆盖引用。
- 同一条边界同时写进 `projectResourceLiveUpdateModel.test.ts` 用例组头部，随断言一起走，避免只看测试文件的人误读。
- 纯文档 + 测试注释，无功能改动。
2026-09-11 22:19:14 +08:00
..
2026-09-05 19:48:27 +08:00
2026-09-11 22:19:14 +08:00
2026-09-01 17:00:44 +08:00
2026-09-01 17:00:44 +08:00
2026-08-22 13:17:26 +08:00