# X-已废除：教训记录

> 废除日期：2026-05-29
> 废除原因：本文档记录的是旧实现阶段的局部教训，已不符合当前从 Round0 重新搭建基础设施的项目管理口径。
> 当前依据：`PROJECT.md`、`02-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 层的验收必须包含视觉间距和空间感检查