返回作品 · 规范文档
本文目录

颜色使用规范

返回入口 · 文档整理版 0.1 · 2026-10-27

1. 背景与适用范围

用户确认:入职时项目没有基础规范,同一色系内有十几种相近颜色;在需求设计中合并近似色,制定色系与十级色阶标准。具体历史色值总数和逐项归并映射未留存于本次已核查材料中,不虚构前后对照。

以下将规范记录与这份代码副本的实现值并列,差异不等于设计错误,也不等于代码错误。涉及差异的任务需先确认版本,不自动改值。

2. 从基础色到界面角色

  • 基础层:base.less 中的色板原值,如 @color-teal-60。
  • 使用层:semantic.less 中按用途命名的角色,如 @color-text-1;它通常指向 CSS 变量并保留基础值作为回退。
  • 主题层:css-vars.less 定义明暗主题下的角色值。默认主题与暗色主题各自有明确选择器。

页面优先使用语义角色。这里是对已读取文件的结构说明,不是对整站运行结果的验证。

3. 主要色系的色阶

下表“规范”来自项目归档 Skill,“代码”来自同一代码副本的 base.less。统一展示原色板的亮色记录,主题映射另见后文。十级基础表没有包含所有衍生状态或例外档位。

生财绿

色阶 规范记录 代码副本 状态
10 #E9FFF8 #F1FAF8 待确认,禁止静默替换
20 #BCEDDD #C5EBDE 待确认,禁止静默替换
30 #95DBC7 #95DBC7 一致
40 #72C9B3 #72C9B3 一致
50 #51B7A1 #51B7A1 一致
60 #36A590 #36A590 一致
70 #248F80 #248F80 一致
80 #14796D #14796D 一致
90 #07645B #07645B 一致
100 #004D49 #004D49 一致

橘色

色阶 规范记录 代码副本 状态
10 #FFF7E9 #FFF7E9 一致
20 #FFE4BA #FFE4BA 一致
30 #FFCF8B #FFCF8B 一致
40 #FFB65D #FFB65D 一致
50 #FF9A2F #FF9A2F 一致
60 #FF7D00 #FF7D00 一致
70 #D25F00 #D25F00 一致
80 #A64501 #A64501 一致
90 #792E00 #792E00 一致
100 #4D1B01 #4D1B01 一致

湖蓝色

色阶 规范记录 代码副本 状态
10 #E9FFFC #E9FFFC 一致
20 #B3F6EE #B3F6EE 一致
30 #82EDE4 #82EDE4 一致
40 #54E3DC #54E3DC 一致
50 #29D9D6 #29D9D6 一致
60 #03CBD0 #03CBD0 一致
70 #01A7AF #01A7AF 一致
80 #00828E #00828E 一致
90 #00616E #00616E 一致
100 #00414E #00414E 一致

灰色

色阶 规范记录 代码副本 状态
10 #F5F6F7 #F5F6F7 一致
20 #E8EBED #E8EBED 一致
30 #D2D5DB #D2D5DB 一致
40 #BDC1C7 #BDC1C7 一致
50 #979CA3 #979CA3 一致
60 #757980 #757980 一致
70 #5D6065 #5D6065 一致
80 #3B3D40 #3B3D40 一致
90 #242528 #242528 一致
100 #0A0A0A #0A0A0A 一致

生财绿代码中还存在 teal-15(#E1FAF6)和 teal-55(#3A9F8D)。它们不是规范十档表中的常规档位,本次不删除、不将其自动纳入新标准。墨蓝色归档规范列六档,不能为凑十级生成新颜色。

4. 常用语义颜色与明暗对应

以下值按 base.less 与 css-vars.less 静态解析,并与已读 Skill 的相应语义表核对。只说明此代码副本的定义;没有运行页面进行视觉验收。颜色的可读性需要结合具体背景、字号和状态检查。

用途 CSS 角色 明亮 暗黑
品牌主色 --color-primary-6 #36A590 #51B7A1
主要文字 --color-text-1 #242528 #F5F6F7
次要文字 --color-text-2 #3B3D40 #E8EBED
辅助文字 --color-text-3 #757980 #BDC1C7
占位文字 --color-text-4 #BDC1C7 #979CA3
链接 --color-text-5 #586E93 #72C9B3
禁用文字 --color-text-6 #D2D5DB #757980
内容/卡片背景 --color-fill-1 #FFFFFF #1A1B1E
页面背景 --color-surface-canvas #F2F3F5 #0D0E10
常规边框 --color-border-2 #E8EBED #5D6065
模态遮罩 --color-overlay-a60 rgba(0, 0, 0, 0.6) rgba(0, 0, 0, 0.75)
橘色强调 --color-accent-orange-6 #FF7D00 #FF9A2F
成功反馈 --color-success-6 #52C41A #D3F3B8
警告反馈 --color-warning-6 #FA9A1D #FEEBBF
错误反馈 --color-danger-6 #F54A45 #FDD0C6
信息反馈 --color-info-6 #327CFB #C3E1FE
AI 品牌色 --color-ai-brand #00CBD0 #00E5E9

黑白透明色、角色标签和其他扩展变量仍保留在源文件,按真实需求查用;本版不把它们伪装为新增的个人设计成果。AI 品牌色只是产品功能配色,与是否具备 AI 协作能力是两回事。

5. 用法与限制

规范已有要求:

  • 角色名保持项目现有命名:text/fill/surface/border/overlay 等。不要为了文档整齐重命名代码中的变量。
  • 同一元素在明暗模式中优先引用同一个语义角色,主题层负责映射。不要把所有颜色简单反转,也不要从浅色 HEX 现场推算暗色值。
  • 迁移旧颜色时,按根目录 CLAUDE.md 的要求核对原色值与目标变量。没有精确对应时,沿用模块级主题变量方案并确认用途,不做近似替换。
  • 湖蓝色的原色板名、语义名和 CSS 名不完全相同。代码实际提供的是 –color-shqblue-;不要把旧文档中 –color-lakeblue- 的表头直接当成可调用 CSS 变量。

本次新增的检查建议:

  • 状态反馈同时提供必要的文案或图形提示,避免仅靠红绿区分。
  • 在实际背景上检查正文、辅助文字、禁用状态与链接;本包不声明已通过可访问性审核。
  • 渐变没有在本次读取的基础规范中形成可复用规则,暂不新增渐变标准。

6. 示例

以下是本次编写的使用示例,不是历史页面截图或已运行组件:

.content-sample {
  color: var(--color-text-1);
  background: var(--color-fill-1);
  border: 1px solid var(--color-border-2);
}

本例需要目标项目先加载现有主题变量;暗色切换和样式覆盖仍须在实际项目验证。

7. 必查差异

生财绿浅色两档、额外档位、状态色旧速查表、湖蓝命名等见差异记录。基础色板某一行的“映射”说明不能覆盖更具体的语义变量定义。

基于项目设计经验后续整理,供开发与 AI 查阅;实际接入效果待验证。