gpui-kit-design-guides

GPUI Kit Design Guides 是面向 GPUI Kit 桌面应用的设计规范文档，属于 gpui-kit 技能。指南文件路径为 references/design-guides.md，属于必须遵循的要求而非灵感参考。进行任何 UI 工作前应先阅读该文件，不应依据本页、代码库现有界面或训练数据作答。若文件缺失，可获取 https://gpui-kit.com/docs/design-guides.md，该指南是该页面的逐字副本，其中指向 ./coding-guides.md 的链接对应 gpui-kit 技能中的 Coding Guides（或 https://gpui-kit.com/docs/coding-guides.md）。新界面或重设计应通读全文；局部修改可先读“Design thesis”和“Start from the task”，再读相关章节。章节依次为：Design thesis、Learning from Shadcn、Start from the task、Visual language、Layout patterns、Components and composition、Interaction states、Feedback and overlays、Motion、Designing data-heavy interfaces、Interface language、Internationalization and platform fit、Guidance for AI-generated interfaces、Accessibility checklist、Design review checklist。不可妥协项包括：桌面优先于 Web 惯例，如键盘访问、窗口装饰、菜单、密集数据视图、可调整区域和常驻导航；按钮与链接区分，应用内命令用 Button，仅外部 URL 与邮箱地址用 Link；使用语义化 token 而非原始 hex 或 rgb(...)，间距数字为默认刻度而非固定字面值；各状态（悬停、聚焦、选中、禁用、加载、校验、危险）必须可见且一致；Escape 关闭最上层浮层并将焦点返回触发元素；文案要写明对象与动词。完成前需运行 Design review checklist。具体界面示例与完整代码未提供。