为什么需要这个文档
设计决策有记忆损耗。几个月后，没有人记得”为什么按钮是直角而不是圆角”，新来的设计师或 AI 会觉得这是个疏漏，悄悄改掉它。
这个文档的目的是让每一个重要的设计取舍有据可查——不只记录”做了什么”，更记录”为什么这样做”。
什么值得记录
符合以下任意一条就记下来：
- 做了取舍：有明确的备选方案被放弃，未来可能有人质疑
- 违反直觉：选了不常见的方案，不写原因会被当 bug 改掉
- 影响范围广：多个页面或组件都受这个决策约束
- 有时效背景：当时的约束将来可能消失，届时决策应重新评估
不需要记录：显而易见的选择、纯实现细节、能从代码直接读出意图的决定。
记录格式
## [编号] 标题
**日期**：YYYY-MM
**状态**：有效 / 已推翻 / 待评审
**背景**：面临什么问题，为什么需要做这个决策。
**考虑的方案**：
- 方案 A：优点是什么，缺点是什么
- 方案 B：优点是什么，缺点是什么
**决策**：选了哪个，核心理由是什么。
**影响**：会影响哪些组件或场景，有哪些已知权衡。
决策被推翻时，不删除原条目，在原条目末尾追加推翻说明和日期，再新建一条。