edit | blame | history | raw

X-已废除:教训记录

废除日期:2026-05-29
废除原因:本文档记录的是旧实现阶段的局部教训,已不符合当前从 Round0 重新搭建基础设施的项目管理口径。
当前依据:PROJECT.md02-P/AGENTS.md、当前 Round 的 QA 计划和复盘文档。
本文仅保留为历史材料,不作为当前 QA checklist 或验收项来源。

每次踩坑就记一笔,以后不再犯。


教训 001:三区视觉间距纳入验收项

日期: 2026-05-25
来源: PO 验收当前 .app 时发现 Space Lane 和 App Shelf 之间没有足够视觉间距,两区"交织在一起"。
问题描述: AlignerMainView 中 VStack(spacing: 24) 不够,Space 卡片(200×110)的阴影(radius 10-16)会渗入 App Shelf 区域,两区视觉上无独立感。
根因: QA 验收 checklist 中没有"三区视觉间距"这一项——专注了功能正确性,忽略了视觉空间感。
修复: 三区之间插入显式 Color.clear.frame(height:) 间距控件,替代依赖 VStack spacing。
后续措施:
1. QA checklist 新增"三区视觉间距"验收项
2. 所有新增 View 层的验收必须包含视觉间距和空间感检查