GPUI Component：原生桌面设计指南

是什么 这篇指南是 GPUI Component 面向桌面应用与 AI 辅助开发的规范层，不是组件 API 说明。它先提出“原生、安静、精准”的设计主张，再将判断落实到任务建模、窗口构成、视觉层级、主题令牌、交互状态与组件组合。

核心设计 论证起点是先写清主任务、对象、即时操作、决策信息及完整状态，再决定布局，因此反对从 dashboard 网格或组件目录出发。视觉上优先用字号、字重、间距和分隔建立层级，限制强调预算，避免卡片套卡片。工程上使用 cx.theme() 的语义色，支持明暗与自定义主题；交互上坚持键盘可达、显式焦点、区域负责滚动，并把窗口、面板、侧栏、菜单和可调整区域视为桌面优势。文章借鉴 Shadcn 的开放组合与可读代码，但明确不照搬网页习惯。

关键洞察 它把设计质量与工程可维护性、AI 可理解性绑定：语义化部件、稳定令牌和明确状态，既帮助用户形成心智模型，也减少生成式界面中的随意样式与隐藏动作。

边界与风险 这是 GPUI 桌面场景的规范，不是跨平台视觉模板；紧凑密度、卡片、颜色和新 primitive 都需由任务证明。正文为截取内容，且无视觉证据，无法验证实际组件实现与最终界面，结论主要针对方法论。