# 前端设计原则 - **功能**:规定页面的信息架构与视觉层级取舍,并列出「模型默认做法」禁用清单,保证每屏只服务一个主任务、层级靠对齐与留白而不是靠堆容器与装饰。 - **何时用**:新增页面或重构页面结构时;决定某块内容放主区还是收起时;评审 UI 层级时。出现新页面或大范围 UI 改动时,须同时走 `skills/ui-review/`(见下「独立评审」)。 ## 规则 ### 页面信息架构 - **一屏一个主角。** 动手前先回答「用户来这一屏是看什么、做什么」,让那件事占据最大面积与最强对比;其余信息靠更小的字号、更轻的字重、更低的对比或靠边的位置退到后面。同一屏里不让两种强调同时抢注意力。 - **内容先行,页面不自述。** 内容型页面的首屏就是第一排内容本身或工作区;**不放"这个页面是干什么的"说明段落**。页面标题已说清的事不再补一行副标题;操作提示放控件附近(`.scope-field` 的 label、输入框 placeholder),不放页面顶部当导语。 - **低频操作不进工具栏,主操作只有一个。** 主操作显眼且每屏不超过一个;次级操作视觉从属(`plain` / 默认尺寸);**更低的低频操作收进「更多」下拉或设置入口**,不要一排等权按钮平铺。 - **按用户心智分模块,不按实现分按钮。** 同一件事的多个入口是两个并列的**内容区块**(各自有标题、说明与主入口),不是工具栏上的两个按钮。 - **渐进披露。** 复杂或低频的选项默认收起(折叠区、弹窗、抽屉),用户需要时展开;不要把全部字段、全部说明一次铺满首屏。 - **待办与汇总各成一块。** 需要用户处理的内容(待归类等)独立成块并给出条数;纯指标汇总独立成块,不与待办混排。 ### 视觉层级 - **间距表达分组:** 同一种关系用同一种间距;一组之内紧(8–12px),组与组之间松(14–24px)。先用对齐和留白立结构,再考虑容器与分隔线。 - **分隔线只做一件事:** 同一处分隔不叠双线、不「线 + 边框框」重复;留白已经分开的地方不再补线。全页线的粗细一致,粗细差对应层级差。 - **容器只在必要时加:** 需要分组、表示选中、拉开背景对比或划出操作范围时才用 `.surface-card`。不要把页面、区块、条目、条目说明一层层套成卡片。 - **同层级等重:** 同一层级的卡片看起来一样重;嵌套的圆角与外层协调(内层 ≤ 外层)。 - **每屏过一遍减法:** 逐区块删文字与装饰,只把删了会影响理解的放回去。删完主角没有变大变强的,说明删得不对或本来就不该有。 ### 模型默认做法禁用清单 以下写法是 agent 生成界面的默认倾向,不是经过判断的选择;除非能说出**来自本产品的理由**,一律不用: - 层层套卡片、每个层级都画一遍边框线。 - 单侧彩色边条(引文、当前项左侧加一根色条)。 - 每张普通卡片配不同的强调色、粗边框、重阴影。 - 标题上方加全大写小眉标;meta 信息用 `A · B · C` 串起来。 - 无来由的渐变、发光、emoji 当图标。 - 全站统一的「淡入上移」入场动画;每张卡片都有的 hover 位移。 - 空泛文案:「了解更多」「立即开始」「高级」「丝滑」「无缝」。 - 组件库默认样子只改主色(换了主色也认不出是哪个产品)。 - 数字指标配一个大号数字 + 大渐变强调色(默认处理,不是最优处理)。 ### 文案即设计 - 按钮说清按下去会发生什么(「保存草稿」而不是「提交」);同一动作在整个流程中同名——按钮写「发布」,成功提示就写「已发布」。 - 用用户能理解的语言命名,不用系统内部叫法;不写设计说明类文字进界面(「示例」「示意图」「仅保存在本机」)。 - 错误说清**原因 + 怎么修**,不道歉、不含糊;空状态给下一步动作,不给情绪。 ### 独立评审 - **触发条件:新页面,或大范围 UI 改动**(整页重构、视觉语言变更、新增信息区块),交付前必须走 `skills/ui-review/`:取图 → 派无上下文的独立评审者 → 按清单修 → 下一轮逐条核对。 - 小改动、局部低风险调整不走技能,按 `roles/ui-review-checklist.md` 自检即可。 - 评审结论(轮次、分数或问题处理情况)写进交付说明;没做独立评审的,明确写出来。 ### 设计系统锚点 - 调性、色板/间距/文字角色/组件语法的**当前取值**见 `roles/design-system.md`;新增颜色、间距、圆角、字号先在那里登记,再落 `src/assets/main.css` 的变量。 - 组件里禁止写颜色字面量(既有规则,见 `roles/code-standards.md`)。