用途:这是 Warp 客户端 UI 代码工作的规范集合,旨在让开发者(含智能体)在编写 UI 改动前先阅读,减少返工,避免重新发明组件、偏离设计系统或绕过共享抽象。
使用方式:在任何 UI 任务开始时通读一遍规范,实施时保持留意。每条规范自包含,不必全部适用,但适用时应遵循。有疑问时优先复用已有抽象而非引入新抽象;Warp UI 已有良好分解的共享组件与主题,新增一次性实现几乎总是产生偏离。新规范会随时间补充;若发现某类反复出现的 UI 错误本可由书面规则避免,可将其加入。
按钮主题规范:按钮颜色来自 app/src/view_components/action_button.rs 中共享的 ActionButtonTheme 实现,以及 crates/ui_components/src/button/themes.rs 中对应的 Theme 实现,例如 PrimaryTheme、SecondaryTheme、NakedTheme、DangerPrimaryTheme 等。这些实现编码了设计系统,保证全应用按钮颜色一致。样式化按钮时应原样使用现有主题。不要主动修改共享主题——改动 PrimaryTheme、SecondaryTheme 等会影响全应用每个按钮,可能悄悄让其他界面回归。只有当用户明确确认设计系统组件本身需要改变时,才编辑共享主题。
典型预警信号:新建 ActionButtonTheme 实现(如 FooPrimaryTheme)委托给 PrimaryTheme 只改一个方法(通常是 text_color);硬编码 ColorU::new(...) 而不用 appearance.theme() 访问器(accent、font_color(bg)、foreground 等);把 should_opt_out_of_contrast_adjustment 设为 true 以强制特定标签颜色;按功能或视图命名主题(FooPrimaryTheme、BarSubmitTheme)而非按设计系统角色命名。若某现有主题确实不合适且认为共享主题应改动,应先向用户提出,而不是单方面编辑或用一次性实现掩盖。
限制:资料未提供安装命令、具体适用平台与收费信息。