## 背景

[English](../en-US/ui-spec-modification-notes.md) | [中文](../zh-CN/ui-spec-modification-notes.md) | [日本語](../ja-JP/ui-spec-modification-notes.md)

原型生成过程中，页面数量与类型会持续增长（Web + Mobile），如果没有统一的 UI 规范，很容易出现：

- 同类页面布局不一致（表格/表单/详情）
- 状态色与状态文案口径不一致
- Mobile 与 Web 视觉语言割裂
- 交互方式随意（新建页、页内表单、抽屉/弹窗使用不统一）

因此引入统一且可编辑的 UI 规范文件：`/prototype_ui_convention.md`。

## 如何修改 UI 规范

- 直接编辑目标项目根目录的 `/prototype_ui_convention.md`
- 建议只改“口径”，不要写具体实现细节：
  - 色彩与状态映射
  - 表格/表单/详情的通用结构
  - Drawer/Modal 的使用规则
  - 字体与间距（Web/Mobile）
  - 文案与反馈（成功/失败/权限/空态/错误态）
- 修改完成后重跑 `/vspec:verify`，使生成/更新的页面整体对齐新规范

## 不建议的修改

- 不建议把规范写成某个页面的特例规则（会破坏整体一致性）
- 不建议引入新的 UI 组件库（除非项目技术栈明确要求）
- 不建议在规范中硬编码大量页面级颜色/尺寸（优先抽象为少量全局变量与结构规则）
