Communitygithub.com

系统设计:统一视觉语言

适用于CRM、ERP、内部仪表盘和B2B门户等管理系统的视觉与UX语言,支持桌面和移动端。在设计或审查此类界面时使用。

系统设计:统一视觉语言 是什么?

该系统设计技能(diseño-sistemas)旨在为管理类应用(如CRM、ERP、内部仪表盘和B2B门户)提供一套统一的视觉与UX语言,覆盖桌面和移动端。其核心理念是:**基底中性,数据驱动生命**——框架(背景、菜单、边框)保持平静中性的色调,而数据(图表、进度、人员、项目)则拥有色彩、形状和动画。一个没有图表、没有实体颜色、没有主角的屏幕会显得死气沉沉。该技能强调一套完整的UI组件库(tokens.css、组件示例、Tailwind配方)、针对不同系统的“中性色带”自定义规则(基于OKLCH色度)、以及10条核心原则(零摩擦、每屏一个主操作、无填充文本等)。此外,它还提供了一个10步快速创建新屏幕的工作流程,涵盖从选择参考、定义强调色和中性色、构建框架与头部、添加KPIs、赋予数据生命(颜色、头像、动画)到设计空加载和错误状态。系统还支持深色模式和移动端适配(390px),并包含一个全面的设计资产目录(示例文件、参考截图和针对特定主题的详细分析),以确保不同系统之间的一致性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brandon4320/skill-diseno-sistemas/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

系统设计:统一所有语言

基底中性,数据赋予生命。结构(背景、菜单、边框)保持平静中性,而数据则拥有色彩、形状和动画:图表、进度、人员以及带有各自颜色的项目。一个没有图表、没有实体颜色、没有主角的屏幕会显得死气沉沉。在设计仪表盘之前,请查看“生命”部分并打开06、07、08和14。同一公司中的多个系统因为共享相同的标记(tokens)、字体、圆角、状态和组件而感觉像是一个家族。不同系统之间变化的是强调色以及中性的色调。

中性不意味着灰色。 基底可以带有品牌或每个系统用途所需的色调:

  • 品牌色调: 背景带有强调色的轻微色调,例如非常淡的紫色或蓝色。
  • 带有色调的背景: 带有色调的背景和深色、低饱和的品牌色菜单(如海军蓝)取代纯白色。
  • 暖色调或冷色调 根据行业而定。
  • 深色 用于监控。

规则在于饱和度和对比度,而非颜色:中性色具有非常低的色度(OKLCH C ≤ 0.02,或画布上约0.03),始终在整个系统中保持相同的色调。它们必须让状态和强调色成为唯一真正有颜色的东西。本文档中的十六进制灰色是起点,而非强制要求:每个系统使用其色调构建自己的中性色阶梯(参见 tokens.css)。

  • 可直接粘贴的标记:tokens.css。名称使用西班牙语(fondo, superficie, tinta, texto-2, acento, verde-fondo...)。

  • 示例 位于 ejemplos/:

    • tablero-crm.html:一个CRM的完整屏幕。
    • componentes.html:所有组件的图库,包含亮色、深色和移动端视图。
    • recetas-tailwind.md:React + Tailwind v4中的组件,可直接复制。

    打开并覆盖使用它们。

  • 参考截图:referencias/01…14-*.jpg。在设计类似内容之前,打开相应的截图。

  • 按主题的完整分析,包含值和示例:analisis/01-estructura.md … analisis/15-homogeneidad.md。阅读与当前工作相关的主题。

如果此文件夹中存在 marcas.local.md,请先阅读它:其中包含了使用该技能的公司特有的强调色、色调和规则。该文件中的内容将优先于本文档中的示例值。

新屏幕的快速配方:

  1. 确定屏幕类型(仪表盘、列表、详情、日历、表单、移动端),并打开其参考和 ejemplos/ 中的示例。
  2. 定义系统的强调色和中性色调(tokens.css)。
  3. 构建框架:侧边栏位于画布上,包含面包屑的面板。
  4. 编写页头:大而轻量的显示标题、带有真实数据的副标题、一个实心按钮。
  5. 3到6个KPIs的行:一个主角,其余放在带有内部卡片的托盘内,每个都带有图形。
  6. 主体:用于进行中项目的实体卡片、用于其余内容的表格或列表、以及一个上下文侧边面板。
  7. 赋予生命:按实体赋予颜色、头像、具有状态的图表以及加载动画。
  8. 设计空状态、加载状态和错误状态(第6b节)。
  9. 在390px宽度和深色模式下进行测试。
  10. 对照参考,逐一检查第8节的清单。

基本原则:零摩擦、每屏一个主操作、无填充文本、每个带列表的按钮在点击后都应定位到对应的行。

1. 应用框架(参考02, 03, 07, 13)

  • 画布为 bg-fondo (#F4F4F5)。侧边栏直接位于画布上,宽度为240–256像素。
  • 内容位于 bg-panel 或 bg-superficie 面板中,具有 rounded-[var(--radius-marco)] 圆角,距边框和侧边栏各8px,并带有1px边框。
  • 侧边栏:
    • 顶部是标志或公司选择器。可选地,使用 ⌘K 搜索。
    • 带有11px texto-3 标签的分组,大写字母和 tracking-wider。
    • 32–36px 高的项目,带有16px灰色图标和右侧的灰色计数。
    • 活动项目为 bg-superficie(或 bg-tinta text-white)药丸形状:永远不要使用品牌颜色。
    • 底部是用户(头像、姓名和角色)。
  • 面板顶部栏: 56px高,带有 border-b。左侧是面包屑(“部分 / 页面”,父级为灰色)。右侧是 ⌘K 搜索、通知和头像。
  • 页面页头:
    • 20–24px 标题,500–600字重,tracking-tight。
    • 下方是带有真实状态数据的灰色副标题:“12待开票 · 3已逾期”,永远不要使用通用描述。
    • 操作在右侧,同一行。
  • 固定垂直顺序: 页头 → 筛选器和视图(分段控件)→ KPIs行 → 主体。
  • 带上下文的主体: grid-cols-[1fr_360px],左侧是列表或日历,右侧是详情面板(01, 02, 07)。
  • 详情卡片: 3列 [1fr_1.6fr_1fr],包含数据、带计数标签的活动以及关联的公司(03)。

1b. 生命(让其不同于整洁的电子表格的部分)

查看06(Gr8r)、07(Loops)、08(Finora)和14(Solexa)。每个仪表盘至少应包含以下5个资源:

  1. 按实体赋予颜色。 每个项目、客户、人或服务都有其固定颜色,来自数据调色板,并通过ID分配。它出现在:

    • 其图标或头像;
    • 其进度条;
    • 其迷你折线图;
    • 表格中的线条。 这是最能赋予生命的部分(06:每个项目和每个人都有自己的颜色)。
  2. 每个数字都带有一个图形。 带有渐变区域的迷你折线图、刻度条(07:彩色细线直到百分比)、分段条(06:10个块中的1个)或进度环(09, 13, 14)。孤零零的数字是死的。

  3. 每屏一个主角。 一张充满色彩的卡片,带有强调色渐变、白色大数字和白色折线图并带有一个标记点(08“总支出”,09“完成一半”)。

  4. 实体卡片,而不仅仅是表格。 对于“进行中”的项目(项目、服务、大机会),使用像06那样的网格卡片:

    • 优先级药丸和标签;
    • 大标题和2行描述;
    • 分段条,显示“3/6已完成 · 到期12月15日”;
    • 活动迷你折线图;
    • “后续步骤”带有复选框和“+ 添加”。
  5. 人物带脸。 照片或插图头像。如果没有,则使用彩色字母组合。为参与者叠放头像。团队以卡片形式显示,带有工作负载条(06“团队”)。

  6. 带状态的图表。 活动的条或点为实心,其余为阴影或淡化。深色工具提示显示“值 | 占比 | vs. 其他”(08)。当前月份以“MTD”格式阴影显示(07)。

  7. 带有氛围的背景。 面板顶部区域使用系统色调的非常柔和的渐变(08),或者页头横幅使用照片或插图(14),或者促销或计划卡片(06和14,线条插图)。

  8. 有目的的运动。 加载时,数字计数到其值(约600毫秒),条从0增长,线条绘制。悬停时,卡片上移1–2px,边框突出。成功时在原位显示toast。全部使用 ease-out 并尊重 prefers-reduced-motion。

  9. 带有内部卡片的托盘(“高级”外观)。 KPI不是一个扁平盒子:它是一个带有16px圆角和4px内边距的 bg-suave 托盘,其中包含:

    • 顶部,托盘上的标签带图标和 ⋯(07);
    • 内部,一个白色卡片,12px圆角,数字及其图形;
    • 底部,托盘上的页脚带图标、上下文和增量(06)。 图标也采用相同模式:一个36–40px的白色正方形,带有最小边框和阴影,位于托盘上(08)。
  10. 留白。 慷慨的内边距(大卡片20–24)和间距16–20。数字28–40px。高级界面需要呼吸:如果看起来拥挤,先移除内容而不是缩小。

限制: 颜色存在于数据、实体和一个主角中。框架(菜单、背景、边框、文本)保持中性。

2. 排印(分析02)

  • 两个声音,而非一个:
    • 显示字体 用于标题、问候语和数字:一种有特色的几何或无衬线字体,如Outfit、General Sans、Satoshi或Plus Jakarta(08使用了这类字体)。
    • 文本字体 用于界面:Plus Jakarta Sans、Manrope或Inter。
    • 等宽字体 具有个性(JetBrains Mono、Geist Mono)用于代码(PR-0241, FAC-01101),并且在技术或监控仪表盘中,也用于数字(14)。
    • 单独使用Geist或Inter会显得“基础”。
  • 大而轻量的标题: 问候语或页面标题使用36–44px大小,400字重,tracking-tight(06“晚上好,Alex”,08)。大的不需要加粗。
  • 字号比例:11 / 12 / 13 / 14 / 16 / 20 / 24 / 32 / 40。一个卡片不混合超过3种字号。
  • 字重:正文和标题使用400,卡片标题和操作使用500,数字使用500–600。不使用700。
  • 数据 = 上方12–13px灰色标签 + 下方14px tinta 值。 永远不要在详情卡片内的同一行写“标签:值”。
  • 数字使用 tabular-nums,金额右对齐。货币符号、分币和单位 使用 texto-3,比主值小一个级别:$ 24.957,81。
  • 元数据在一行中,12px灰色,以“ · ”连接:“催收 · FAC-01101 · 2分钟前”。
  • 大写字母仅用于菜单分组标签。表格标题、按钮和标签页使用首字母小写。

3. 颜色(分析03)

  • 有三个平面(fondo → panel → superficie),深度由色调、1px边框和最小阴影产生(参见第4节)。

  • 根据每个系统定制的中性色:

    • 单一阶梯: 每个系统为其中性色选择色调(来自其品牌或用途),并在整个阶梯中使用:背景、面板、边框和三个文本层级。
    • 低色度: 色调应被感知为“氛围”,而非颜色。如果背景与状态药丸竞争,则说明饱和度过高。
    • 不混合: 永远不要在同一系统中混合冷和暖的阶梯。
    • 可以超越灰色: 带有色调的背景或深色品牌菜单也是有效的。条件是内容仍处于明亮可读的表面,状态是唯一强烈的音符。
  • 文本使用 tinta / texto-2 / texto-3,它们是与色调相同的中性色。禁止使用 #000 在 #FFF 上。

  • 每个系统只有一个强调色,仅用于主按钮、开关、焦点、未读点和移动端的活动标签页。永远不要用于标题、卡片背景或菜单。

  • 按系统设置强调色: 每个系统或公司只有一个强调色(其品牌颜色)。如果没有既定品牌,使用石墨色 #18181B。技能的其余部分对所有系统都相同。

  • 状态 = 药丸: 10%背景色 + 饱和文本色 + 6px圆点。永远不要使用饱和背景加白色文本,并且永远不要只用颜色:必须带有文字。

    • 绿色:已完成、已收款、在线。
    • 琥珀色:待定、部分完成、即将到期。
    • 红色:已逾期、失败、离线。
    • 蓝色:进行中、信息性。
    • 灰色:草稿、已取消、已退款。
  • 正常状态不上色。 红色仅用于需要立即操作的内容。如果屏幕上有超过3个红色元素,它们应分组为一个警告。

  • 数据调色板(dato-1…6,最多6个)仅存在于图表、进度条和类型图标中。在表格中,它显示为3px的线条,从不涂满整行。

  • 预测、部分或未选择的内容以阴影或30%透明度显示;实际内容实心显示。例如,当前月份显示为“MTD”样子(07, 08)。

  • 每屏最多一个充满颜色的英雄卡片(08, 09)。

  • 完成前,统计颜色:灰色 + 1个强调色 + 最多4个状态色 + 最多6个数据色。

4. 表面、圆角和间距(分析04)

分层圆角。 内部的每一层圆角都略小于包含它的层(内部圆角 ≈ 外部圆角 − 内边距)。不要发明其他值:

元素圆角
应用框架(整个系统在一个盒子中)26
主面板20
卡片 / 托盘 / 工作表20
托盘内部的卡片16
按钮 / 输入框 / 搜索框 / 方形图标11–12
小按钮 / 药丸 / 标签7–9,或圆形用于筛选和“+12 %”

在移动端,卡片圆角为20–24。

间距。 比例 4 / 8 / 12 / 16 / 20 / 24 / 32 / 40,不使用10、14或18。

  • 内边距:卡片16–20(如果密集或在移动端则为12),面板26–28。
  • 网格间距:14。
  • 大块之间:28。
  • 章节之间:32–40的间距加上一个标题。永远不要使用粗线或有色背景。

边框和阴影。

  • 边框始终为1px borde。不使用2px或彩色边框,焦点除外。
  • 三级阴影,始终柔和,使用墨色调(永远不是纯黑):
    • 最小(0 1px 2px /.05):用于带边框的按钮、托盘内部的卡片、菜单活动项和方形图标。这赋予了它们高级的“立体感”。
    • 悬停时(0 14px 30px -18px /.3,同时上移2px):用于可点击的卡片。
    • 浮动(0 24px 48px -16px /.22):用于菜单、工作表、模态框和toast。黑色主按钮自带阴影和顶部亮光(inset 0 1px 0 /.12)。
    • 静止的内容卡片使用边框,不使用大阴影。

细分。 要细分卡片,使用全宽带(border-t 或 suave 背景)或托盘+白色卡片模式(参见“生命”第9点)。不推荐叠放三层带边框的盒子。行内指标使用 divide-x 分隔。

5. 组件

KPI卡片(06, 07, 13, 14 · 分析06)

  • 始终包含标签 + 数字 + 上下文行。没有“关于什么”或“相对于什么”的数字是不应该出现的。
  • 数字使用 tinta(24–28px, 600, tabular-nums)。颜色仅用于增量、药丸或条。
  • 增量 说明其周期(“+12% vs. 上月”、“本周+3”),带有箭头 ↗/↘,其颜色取决于对业务是好是坏,而非符号:如果逾期率下降,则为绿色。
  • 如果有逾期内容,页脚带有警告图标和红色文字显示数量(“2已逾期 · 需要关注”)。
  • 针对目标的进度显示为分段条或环,带有“已完成X / Y · 剩余Z天”。如果剩余时间少于总时间的20%,该文本变为红色。
  • 如果只有3–4个指标,它们可以共享一个微型折线图,每个指标使用自己的数据颜色。

实体卡片

  • 用于进行中的事项:项目、活动、开放机会、大型服务、活跃客户。
  • 尺寸:大约 1fr / 1fr / 1fr 网格,最小宽度280px。
  • 布局:左上角的状态药丸 + 右上角的更多菜单 (⋯);大标题(实体名称 + 标签);2行描述;全宽进度条,带有“X / Y 项 · 到期日期”;活动迷你折线图;底部为“后续步骤”列表,带有复选框和“+ 添加”输入。
  • 高级选项:卡片可以有一个顶部彩色条(2px,使用用户/实体的颜色)或一个带有渐变背景的顶部区域(用于促销卡片)。

表格和数据列表

  • 表头: 灰色,12–13px,首字母小写。在密集列表中使用粘性表头。
  • 行: 48–56px高。行与行之间的分隔线使用 divide-y 加 divide-gray-200。
  • 交互: 悬停时行背景改变。点击行打开侧面板或导航到详情(不要在新页面打开)。单击图标按钮打开操作菜单。
  • 内容: 第一列通常是实体名称 + 其彩色点。数字列右对齐。操作列是图标(编辑、删除、更多)。包含用于状态的彩色药丸。
  • 分页: 使用“显示 20 / 50 / 100” + 页面按钮(带数字的按钮),而不是无限滚动(用于管理列表)。

筛选器和分段控件

  • 分段控件 用于视图切换(“概览” / “详情” / “列表”):圆角药丸形状,bg-superficie 用于非活动项,bg-white 或 bg-panel 用于活动项(无颜色)。
  • 筛选器: 位于分段控件下方的一行。可以是:下拉选择器(带有搜索的小型组合框)、日期范围选择器(开始 / 结束)或标签筛选器(一行可点击的药丸)。
  • 搜索: 位于面板右上角或筛选器行中。始终带有 ⌘K 快捷键提示。

侧面板(上下文面板)

  • 位于主体右侧,360px宽。用于详情、活动日志、相关实体。
  • 顶部:标题 + 关闭按钮。下部:选项卡(“详情”、“活动”、“文件”),活动选项卡带有计数。
  • 内容:实体卡片、堆叠头像、迷你表格、带有时间戳的活动条目。

6. 状态和动画

6b. 空状态、加载状态和错误状态

  • 空状态: 中央插图(线条艺术或图标)+ 标题“尚无数据” + 解释说明(“目前没有待处理发票”)。可选地,一个“添加第一个”按钮。
  • 加载状态: 骨架屏。使用 bg-suave 占位符,具有柔和脉冲动画。不应闪烁或跳跃。
  • 错误状态: 红色信息框(10%红色背景 + 红色文本)位于顶部,带有关闭按钮。文本:“加载数据时出错。[重试]”。
  • 部分失败: 如果某个KPI卡失败,其数字变为“---”,其颜色变为灰色,并显示一个小的重试图标。

6c. 动画原则

  • 加载动画:数字计数(400–800毫秒),条增长,线条绘制。
  • 悬停动画:卡片上移2px并带有增强阴影(300毫秒,ease-out)。按钮背景变暗(不要改变边框)。
  • 状态变化动画:切换滑出(200毫秒),toast淡入然后淡出(3秒后)。
  • 尊重 prefers-reduced-motion:禁用所有运动(无计数,无绘制,无悬停)。仅在 <html> 上使用CSS,或通过 useReducedMotion。

7. 深色模式(分析07)

  • 颜色反转:背景变为深色(#18181B),表面变为稍浅的深色(#27272A),文本变为浅色(#F4F4F5)。
  • 保持相同的色阶层次:fondo → panel → superficie。
  • 强调色保持相同(品牌颜色)。状态色也保持不变。数据调色板也保持不变。
  • 边框和阴影:边框在深色背景上变为 #3F3F46。阴影更为微妙(更深的不透明度,但保持相同的扩散和模糊)。
  • 图像和图标:可能需要浅色版本。白色图标变为浅灰色或强调色。
  • 在 <html> 上使用 class="dark" 或通过系统偏好测试(prefers-color-scheme)。

8. 最终清单(在完成每个屏幕之前检查)

  • 是否使用了正确的框架?(画布 + 面板 + 侧边栏)
  • 标题是否大而轻量(36–44px, 400, tracking-tight)?
  • 副标题是否包含真实数据(“12待开票 · 3已逾期”)?
  • 是否只有一个按钮?(是的,一个实心按钮。没有第二个实心按钮。)
  • KPIs行:是否有主角卡片(带颜色渐变)?
  • 是否有实体卡片(用于进行中项目)而不仅仅是表格?
  • 每个实体是否有颜色(头像、进度条、迷你折线图)?
  • 每个数字是否都带有图形(迷你折线图、条、环、分段条)?
  • 是否有空状态、加载状态和错误状态?
  • 它在390px宽度上看起来好吗?
  • 它在深色模式下看起来好吗?
  • 颜色是否仅限于:中性色 + 1个强调色 + 最多4个状态色 + 最多6个数据色?
  • 是否使用了正确的间距比例(4 / 8 / 12 / 16 / 20 / 24 / 32 / 40)?
  • 是否使用了正确的圆角值(26 / 20 / 20 / 16 / 11–12 / 7–9)?
  • 边框是否为1px且柔和?
  • 阴影是否为三级(最小 / 悬停 / 浮动)且柔和?
  • 动画是否尊重 prefers-reduced-motion?
  • 是否阅读了该主题在 analisis/ 中的相应分析文件?
  • 是否阅读了 marcas.local.md(如果存在)并应用了其规则?

9. 设计资产

此技能文件夹包含以下资产:

  • tokens.css:所有CSS变量(字体、颜色、圆角、间距)。可直接粘贴。
  • ejemplos/:
    • tablero-crm.html:一个完整CRM屏幕的HTML(带有CSS和JS)。在浏览器中查看。
    • componentes.html:所有独立组件的HTML图库(卡片、表格、输入框、按钮、菜单)。
    • recetas-tailwind.md:React + Tailwind v4代码片段,可直接复制。
  • referencias/:参考截图(01…14-*.jpg)。在开始设计之前打开它们。
  • analisis/:按主题的详细分析(01-estructura.md 到 15-homogeneidad.md)。包含值、示例和原理。
  • marcas.local.md(可选):特定于公司的覆盖规则。它存在于 SKILL.md 旁边。

相关技能