AI UI/UX 设计手册

这是一套供 AI 开发项目时按需查阅的设计参考。每次实现一个界面，都应能回答：为谁解决什么问题、为什么选这个方案、异常时怎么办、怎样验证。

内容同时面向开发者、设计者和编程 Agent。默认环境为 Web 与响应式应用；移动端、小程序、桌面端、语音和空间交互会说明差异，具体平台能力仍需查该平台文档。

产品实现基线

所有 UI 任务先读 00 · 阅读协议 和 23 · 实现质量关卡。界面文案面向用户；共享代码按语义与变化原因组织；规则和数值有来源；长内容、复杂交互与后续页面同样进入设计和验证范围。

这些要求贯穿下列主题，不能只在首次展示的首页执行。可下载项目规则模板，适配到实际项目文档中。

先按任务找答案

系列目录

给 AI 的最短使用方式

把下面这段连同当前项目的需求交给 AI。仓库路径只在本项目中有效；跨项目使用时复制对应文件或提供部署后的 URL。

参考 docs/books/ui-ux/ 中的设计手册完成当前界面。
先阅读 00 和 23，再按任务选择章节，列出本次采用的规则 ID 和理由。
优先遵循当前项目明确的需求、设计稿、组件库和平台规范。
先输出页面模块、状态矩阵、语义 token 和待决设计问题，再实现。
区分行为规则与界面文案。适用条件不满足时，不机械套用默认建议。
面向用户写文案；复用按语义分层；规则与数值有来源；个例有边界。
交互包含竞态、取消与生命周期；后续页面同样沿用设计依据与状态样式。
交付时附正常、空、失败、长内容、窄屏状态的证据和未验证项。

机器索引：ai-context.json。配色数据：palettes.json。基础样式：tokens.css。设计简报：design-brief.example.json。

本版的覆盖边界

“所有交互、所有场景、所有配色”适合作为持续积累的方向。具体组合没有有限的完整清单。本版提供分类骨架、常见决策、边界条件和可扩展格式；8 组配色、12 类风格是可用起点，不是设计的全集。

目前给出了常见业务场景的设计模式，演示只实现其中少量交互。原生平台细则、复杂数据可视化、地图、音视频剪辑、游戏手柄与空间交互仍需要专项设计和验证。文章、代码与演示各自标明用途，不把参考代码等同于生产级组件或完整的无障碍认证。