workbuddy_skills/oil-ui-pro/references/visual-language.md

视觉语言

从整体到局部

先查看信息焦点、构图和内容密度，再调整空间、排版、色彩与细节。前一层已经解决问题时，不为显得精修而继续添加样式。

使用项目有效的视觉变量、组件和参考关系。没有标准时只定义当前需要的文字、颜色与间距角色；不凭空生成完整设计系统。

每次修改能说明：哪个可见元素、哪种关系存在问题、调整什么、期待改善什么。源码检查可以证明样式不一致，不能单独证明画面更好。

焦点与空间

• 每个任务区域有可辨认的主信息或主动作，辅助信息通过尺度、字重、对比或位置退后；不用多种强强调同时争夺注意力。
• 同类关系保持同类间距，组内更紧、组间更松。先用对齐与留白建立结构，再判断是否需要容器或分隔线。
• 留白承担分组、焦点或节奏。工具界面不为追求空旷牺牲必要信息，品牌页面也不强制塞满首屏。
• 非对称、越界图形或大尺度文字可以表达选定方向，但需要稳定的局部对齐和清楚阅读顺序；不把有意的非对称自动当成错误。
• 父布局负责区域排列，组件负责自身内部空间。同一距离不要同时由多层样式重复增加。
• 先把内容直接放在画布上，通过对齐、字号和留白组织。容器只在确有分组、选择、背景对比或操作边界时出现；不要把页面、模块、条目和条目说明逐层套成卡片。
• 分隔线和边框不要重复。每条线只做一件事：同一处分隔不叠双线、单线再加一个框；留白已经分开的地方不再补线；不要每个层级都画一遍线。线的粗细对应层级，例如粗线分版面、细线分栏，全页一致。线本身是风格的一部分时照样保留，只删重复的那些。

字体与内容

• 按标题、正文、辅助信息、标签和数据建立文字角色。角色稳定，层级有足够区别；实际内容长度决定换行和空间。
• 检查目标语言的字形、字重与回退字体。英文样例好看不能证明中文排版成立；中英混排检查基线与视觉重量。
• 正文行长与行高服务阅读；密集表格按扫描与比较安排，不套用文章排版。需要纵向比较的数字可使用等宽数字。
• 重要名称和说明不靠固定高度裁切。确需截断时保留完整内容的可访问入口，避免相近名称截断后无法区分。
• 先写具体产品内容再调布局。按钮说明动作结果；价值表达使用真实用途，不用空泛口号、虚构背书或无意义英文填版。

可读性是交付门槛

字号与行高在真实视口、实际字体和 100% 阅读尺寸下判断，缩略图只能用来判断构图。阅读型页面的中文正文通常从 16–18px 起步，产品界面正文 14–16px，每天长时间使用的高密度工具可以到 13–14px（见设计方向里的密度）；正文无单位行高 1.6–1.75；操作文字通常 14–16px。它们是起点，不是跨产品的死规定。不要靠 9–12px 的说明、低对比细字或压缩行高营造“精致”。信息太多先删冗余、调层级或重排。

多行中文标题通常先用 1.2–1.35 的行高，按真实字形检查。不要照搬英文大写海报的极紧行高，不把标题高度固定为单行，不用负外边距挤压后续内容。展示字确需更紧时，必须看过每个支持视口的实际换行并确认字形不碰撞。

中文断行要主动控制：text-wrap: pretty 或 balance 只能减少孤字，不能消除。数字和单位（38 秒、47 分钟）、“不会”这类不可拆的词用不换行包起来；首屏说明、页边批注这类短段落按语义手动断句。行末只剩一两个字，或者词被拆到两行，都算缺陷。

验收时看长标题、两到三行正文、中英混排、数字单位与字体回退；在窄屏和放大阅读后检查行间、上下区块及按钮内部。文字重叠、截断关键信息或被相邻区域压住属于未完成。先修行高、内容驱动高度和容器伸缩，再考虑减小字号。

示例数据要像真的

示例数据会暴露模板感，即使视觉层已经很好。要避开：整数指标（1,000 位用户、+10%）、张三李四和示例公司、每条都是“2 小时前”、写着“标题”“描述”的占位字、页面上反复出现的“了解更多”“立即开始”。真实数据是不整齐的：1,238 位用户、+1.83%，时间有“刚刚”“昨天 16:12”“3 月 14 日”；名字有长有短，顺带验证长名字的排版。按钮说出具体动作，例如“保存草稿”“周二发送”。一页上有很多演示（组件目录、模板库、功能展示）时，让它们共用一个具体的虚构场景：同一个产品、同一批人、同一组文件和数字，演示之间互相呼应，比各自编一条“示例标题”可信得多；不要把库名、技术栈当成演示内容。

色彩与表面

颜色按文字、背景、动作、选中与状态等含义使用。品牌色与语义状态可以共存，但不能只靠颜色区别重要状态。

边框、阴影、材质和渐变要与方向一致，并帮助分层、表达氛围或建立品牌识别。不要把紫色、圆角、渐变列为一律禁用；问题在于无意义重复、主次混乱和不适合任务。

避免每张普通卡片都使用不同的强调色、重边框与重阴影。相同层级保持一致重量；内部嵌套轮廓与外部容器协调。

配色做两个自检：去掉所有发光和模糊后，配色是否还成立；能否说出一个用类似配色的成功产品或出版物。表面层级可以用色温和色相的偏移来区分，不只靠明暗。选完配色再问一句：这组颜色是从这个产品的内容、用户或品牌里推出来的，还是一组放在哪个产品上都不出错的安全色？是后者，就回到产品重新找。

质感按调性的完成度取用，不混用：

• 精致一端：表面的高光、层次柔和的阴影、细微的冷暖交叉色、细线分隔。
• 粗粝一端：手工和印刷留下的痕迹，从这个方向的生成引擎里找，不套一组固定的道具。

核对文字、控件边界、焦点和选中态在实际背景上的可辨认性，尤其是图像、透明和动态背景。遵循项目已有的可访问性目标；基础阅读与操作不能依赖猜测。

模型默认审美自查

先做一个总测试：把画面给人看，说“这是 AI 做的”，对方会不会马上相信？好的界面应该让人问“这是怎么做出来的”，而不是“这是哪个 AI 做的”。

没有明确风格依据时，模型容易生成下列默认做法。它们都不是禁令，但每出现一项，都要能说出它怎样服务当前北极星；说不出就换成方向卡里的具体选择：

• 无来由的渐变、柔光、玻璃拟态和发光描边。
• 配色说不出来自这个产品的理由，只是因为它“不会出错”“显得高级”或者“这个行业都这么用”。判断不看是哪种颜色，任何颜色都可以用，只看理由是否来自这个产品。
• 中文界面从头到尾只用思源黑体或系统黑体，标题没有自己的字体性格。
• 在页面里画假的浏览器窗口、红黄绿三个圆点、写着 9:41 的手机状态栏或整台手机外壳。浏览器和设备本身已经提供这些，产品本身是浏览器或设备模拟器时除外。
• 所有内容都装进同样圆角、同样阴影的卡片，卡片里再套卡片。
• 首屏固定为左右分栏：左边大标题，右边说明、按钮或一张图；下方接三列图标特性卡。换了字体和颜色，这个骨架也常常原样保留。
• 用表情符号或随手找的图标给每个标题做装饰；最典型的是 2px 描边的通用图标放进浅色底圆角方块，每个标题配一个。
• 工具、后台，以及画廊、商店、信息流这类内容页，顶部放超大标题、口号或解释这个页面的段落，把第一排内容推出首屏；用一整块深色圆角卡片装“下一步”动作；每一列、每个区块下面一行解释它是干什么的。
• 用单侧色条标重点：引文、提示、答题反馈、当前项、紧急卡片，左边或右边加一条 2–4px 的彩色边线。这是最常见的模型默认之一，“它在表达状态”不能当理由。状态用元素本身表达：状态词加颜色或图标、整块底色、字重、位置和顺序。单侧的线只用来分隔结构，例如侧栏和主区之间、表格的列之间，并且用中性色。
• 用星星、闪光、魔法棒、机器人表示 AI 功能。图标应表达实际动作或结果，例如摘要、翻译、转写。
• 全页只用一种无衬线字体，标题与正文尺度相差不大，标题没有自己的性格。
• 每个区块都有英文眉标、胶囊徽章和一句空泛口号，例如“一站式”“赋能”“开启全新体验”。中文产品用英文做字标、表头和分区名（WORKSPACE、CONTENT OBJECT、FIELD NOTES）也属于这一类。
• 界面上写满制作说明：“示例”“待核实”“概念图”“示意图”“按钮未接入”，或者“仅保存在此浏览器”这类解释实现方式的话，挂在字段旁、图片角落或页脚。这些是写给委托人的话，放进交付说明。
• 所有间距相同，页面没有松紧节奏，也没有一处视觉重心。
• 随意给文字上色、加高亮，或者到处加描述性小字和标签，留出没有用途的空白区域。
• 首屏之后接一排三栏功能格：编号或图标、小标题、两行说明，内容和首屏重复。首屏再有辨识度，到这里也会退回模板。
• 界面完全不动，或只有悬停变色；有动效时各动各的：每个区块套同一个淡入上移，按钮、面板和数字之间没有关系。
• 自己画的下拉、开关、滚动条，比平台原生组件更难用。
• 文案抽象，用晦涩的比喻代替具体说明。方向的比喻也会渗进功能：按钮叫“检查采样”，导航画成一圈轨道。比喻只管视觉气质，功能名、按钮和导航用产品本身的说法。

要求精简时给出具体操作，例如“改成以图片为中心的网格，去掉渐变、发光和多余容器”。只说“像苹果一样极简”几乎不起作用。

检查时截图整页，逐项对照。出现三项以上，通常说明方向还停在默认模板，应回到方向卡重新确定主构图和主视觉，而不是逐个替换装饰。

控件与图标

同一界面维持一致的图标语言、光学大小与文字对齐。通用图标优先使用成熟资源；特殊品牌插图单独制作，不为每个标题机械添加图标。

可点击元素需要可识别的入口及相应反馈。默认、按下、聚焦、选中、禁用与处理中表达不同含义；鼠标悬停不能替代触屏与键盘入口。反馈变化保持点击区域与邻近布局稳定。

控件是一套语法：圆角、描边、字重、阴影、按下时的位移、选中的表达和状态图标，在按钮、输入、标签、开关和空状态之间用同一套逻辑。方向不只贯穿整页，也贯穿每个控件。按钮和输入框还停在组件库的默认样子，换了主色也认不出是哪个产品，就说明控件还没有进入方向。

陌生图标配可见文字；纯图标按钮仍需可访问名称。箭头符号有含义：↗ 表示打开新页面或外部链接，提交、检查这类原地动作不用它。静态标签和装饰不要伪装成按钮，行内按钮不要误触外层卡片动作。

图标库也会趋同

模型的默认是 Lucide 或 Heroicons：24px、2px 描边、圆头端点。库本身没有问题，问题是每个方向都用同一套、同一种摆法。图标和字体一样是方向的一部分，在方向卡里写明用哪一套、什么粗细和端点，或者干脆不用。

方向的气质	可以考虑	特点
精致、编辑、奢侈	Phosphor 的 Thin 或 Light，Iconoir	细描边，配细字重的衬线或无衬线
工业、仪器、企业工具	Carbon，Material Symbols 的 Sharp，Radix Icons	直角端点、网格严格；Radix 专为 15px 的紧凑界面设计
友好、圆润、消费	Phosphor 的 Fill 或 Duotone，MingCute	圆角端点，实心或双色
中文产品，需要大量业务图标	IconPark，Remix Icon	覆盖面广；IconPark 能调描边粗细、端点和主题
需要连续调粗细和填充	Material Symbols	可变字体，填充、字重、光学尺寸都能连续调节
像素、游戏、复古	Pixelarticons	像素网格
品牌标志	Simple Icons	各品牌标志的矢量形状

用 Iconify 可以按名称取到上面大多数库的单个 SVG。

• 一个产品只用一套。 需要补缺时，挑描边、端点和圆角一致的，统一成相同的画布尺寸和描边宽度。
• 粗细跟字重走。 图标描边接近同尺寸正文的笔画粗细：细字配 1–1.5px，粗黑体配 2px 以上或实心。图标尺寸约为字号的 1–1.25 倍，按视觉中心和文字对齐，不按外框。
• 能不用就不用。 编辑类方向常用字符本身：→ ↗ ※ §、编号、缩写。只在能加快识别的地方用图标。
• 品牌时刻手绘。 核心动作、空状态这类少数位置，可以用方向自己的线条语言画专属 SVG；通用动作仍用库。
• 小样内联。 自包含小样只内联用到的 SVG，不引用图标字体或 CDN。存量项目沿用已有的库，换库属于改版。
• 核对许可。 多数是 MIT、Apache 或 ISC；SF Symbols 只能用在 Apple 平台的界面里，不能用于网页；需要署名的库按要求署名。

细节

好效果常常体现在模型不会主动做的小事上。它们单看都很小，加在一起就是“做出来的”和“生成出来的”之间的差别。结构和主视觉定下来以后，逐项过一遍；单个细节单独修，不为修一个细节改动整体结构。

粗粝一端的方向同样讲究细节，只是讲究的方式不同：套印错位、毛边和颗粒要有意为之、方向和幅度一致，不能和随手没对齐混在一起；用代码画这些质感的做法见 点缀与特效。下面的形状与表面偏向精致一端，粗粝方向按自己的质感取舍；文字、对齐、状态和资源两端都适用。

形状与表面

• 嵌套圆角要同心：内层圆角约等于外层圆角减去两者之间的内边距，内层不大于外层。
• 阴影用两层叠成：一层贴近、较实的接触阴影，一层远而淡的环境阴影。阴影颜色带一点背景的色相，不用纯黑；同一层级的阴影保持一致。
• 高分屏上的细分隔线用 0.5px 或半透明色；边框和阴影不同时给重的。
• 压在图像上的文字，靠图像本身的安静区域和局部遮罩保证对比，不给整张图盖浓重渐变。

文字

• 中文正文字距保持 0。展示字号可以收紧，字越大越可以收，但要看实际字形不碰撞；全大写的英文小标签加 5–10% 字距。
• 中文用全角标点，引号用“”。行首不出现句号、逗号和右引号，行尾不出现左引号和左括号，可以用 line-break: strict；浏览器支持时用 text-spacing-trim 做标点挤压。
• 中文和英文、数字之间的间距全页一致：支持时用 text-autospace，否则统一手写空格，不要一处有一处没有。
• 数字用等宽数字；单位比数字小一级或更淡；金额、时间、百分比的格式全页统一，例如 1,238、+1.83%、16:12。
• 标题按语义断行，不留孤字，见上文“可读性是交付门槛”。

对齐

• 图标和文字按视觉中心对齐，不按外框；圆形、三角形图标需要光学微调。
• 大号标题的字形自带左侧空隙，要微调 1–3px，让它看起来和下方正文左对齐。
• 数字列右对齐，小数位对齐。
• 按钮文字在按钮里视觉居中；中文字形偏上或偏下时微调。

状态

• 每个可点元素都有悬停、按下、焦点、禁用和处理中状态；状态变化不改变尺寸、不挤动旁边内容，处理中的按钮保持原宽度。
• 焦点环、文字选中色、输入光标、复选框和单选框的强调色跟随方向，不留浏览器默认的蓝色。
• 深色或有色背景上的滚动条调成协调的颜色；可滚动区域的边缘用淡出提示还有内容。
• 空、加载、错误状态和默认状态一样用心，不是事后补的一行灰字。

资源

• 位图按显示尺寸的 2 倍准备，图标用矢量。
• 图片加载前先占好比例，不让布局跳动。
• 网页标题、标签页图标和分享图与方向一致。

在 100% 和 200% 缩放下各看一遍关键区域（无法用浏览器缩放时，用宽高减半、像素比为 2 的视口截图代替）；把局部截图放大，检查对齐、边缘和标点。

克制：大胆在结构，克制在细节

大胆和克制作用在不同层面，并不冲突。结构上大胆：首屏骨架、主视觉和一处结构性突破可以走得很远。细节上克制：其余元素安静下来，让主角成立。一页只有一个主角，可以是一张图、一句巨大的标题或一个图形装置；其余的字号、颜色、容器和动效都为它退后。满屏都在出招，和满屏米色卡片一样，都是没有取舍。

克制要落成预算，和调性里“克制”的翻译一致：

• 一页的字号 4–6 级，字重 2–3 种，字族不超过 2–3 个（展示、正文，可选等宽）。级数少，级差要大。
• 强调色约占画面 10% 以内，只用在主动作、选中和需要立刻识别的状态上。
• 划线、倾斜、跨界、手写批注这类特别处理，一页一处，放在最能放大北极星的位置。
• 先做准三处基本动效，让它们彼此呼应；装饰性的动效一页最多一两处，见 动效。

预算是起点。方向明确需要更多时，例如拼贴或喧闹的调性，写出理由即可。

克制不等于极简。用户选定强烈风格后，减法应让风格更集中，不把它变成通用白底模板。减法删的是装饰和重复，不删帮助判断的信息：工具与决策界面里，对象名称、比较依据、当前选择和下一步动作是主角，删掉它们界面不会更高级，只会失去用途。删减后检查用户是否还能确定当前对象、理解代价、发现主动作和判断结果；不能用更少的文字代替更清楚的结构。

删元素

逐项判断元素是否帮助识别、判断、操作、反馈，或对选定品牌与情绪有明确贡献。贡献说不清时尝试移除，对照前后效果。优先删重复标题、无语义徽章、多余容器和竞争性装饰。一张合适的图、几句必要文字和一个动作就能承载页面时，让它们成立；不为“完整”追加卖点卡片、数据徽章和重复的行动按钮。

删文字

模型爱加字：每个区块都是“眉标 + 标题 + 副标题”三件套，内容页顶部还要加一段解释这个页面是干什么的，每个字段下面一行提示，“点击下方按钮开始”这种描述界面的话，“新”徽章、脚注，以及解释图片内容的图注。

• 逐句问：删掉后，用户是否仍知道眼前是什么、能做什么？画面、位置或交互已经表达了的，就删。
• 用展示代替描述：能放产品真正交付的东西，例如一份真实的结果或一段真实数据，就不写一段话去形容它。
• 一个区块只讲一件事：一句标题，最多一段说明。需要第三层文字时，通常说明这个区块该拆开或删掉。
• 叙事页面的字数预算：首屏标题约 15 字以内，说明约 40 字以内，按钮 2–6 字，空状态一句话加一个动作。产品界面不按字数砍，按“逐句问”删重复和解释。
• 做完后删一轮：逐区块尝试删掉 30–50% 的文字，只把删了会影响理解的放回来。
• 不先加字再调淡：不先添一堆小字，再用降低对比来补救。设计理由、源文件名、组件术语和装饰性英文留在说明或按需展开处。
• 必须留下的：错误原因、单位、选择范围、陌生动作的标签、风险和后果。

编辑剩下的文字

文案需要一次主动编辑：用用户会说的话重写空泛口号，保留具体对象、动作和结果；可以继承用户原有的表达。不要把第一轮生成的文案当作不可改变的内容，也不要为了补满版式编造信息。

模型写的中文常带翻译腔，交付前逐句改掉：用分号把两件事串成一句；“交代当前情况”“带读者回到”“保持内容明确”这类书面套话；标题写成字段名，例如“受控勾选”“禁用等级”。改成一句只讲一件事的短句，标题用人会说的短语，例如“生成中锁定”“回到最新”。

模型写的文案往往是整页最弱的部分。标题、主张和按钮这类关键文案，优先用用户提供的原话，或交给用户亲自改写；交付时标出哪些仍是模型写的占位文案。