设计规范
从业务迭代中整理基础样式、组件状态与使用规则,建立明暗模式的用色对应,并呈现课程图标与双端界面设计。

03 规范文档
把设计规则整理成可查阅的文档
以 DESIGN.md 统一原则与索引,将颜色、文字、布局和效果拆分为详规,供开发与 AI 按需查阅。
一个入口,四份基础详规
把规则与使用方法写清楚
生财有术 · 基础设计规范
以生财绿建立品牌识别,通过颜色、文字、间距与层级组织内容。本文是基础规范的统一入口:先了解原则,再按任务查阅对应详规。
1. 适用范围
用于生财有术 PC 与移动端的基础视觉设计,涵盖颜色、文字、布局和效果。PC 沿用紧凑布局取向;双端的文字与尺寸单位分别查用。
本文件维护原则与阅读索引,具体参数和使用场景只在对应详规中维护。
2. 按任务查阅
| 要确定什么 | 查阅文件 | 包含内容 |
|---|---|---|
| 用什么颜色 | 颜色规范 | 主要色系、语义角色、明暗主题与用色示例 |
| 文字如何分层 | 文字规范 | PC/移动端字号、行高、字重与字体用途 |
| 空间如何组织 | 布局规范 | 圆角、间距、内边距、布局变量与尺寸单位 |
| 如何区分层级 | 效果规范 | 阴影、遮罩、叠放层级、动效与交互反馈 |
DESIGN.md 原则与阅读入口
docs/
├── color-guidelines.md 颜色
├── typography-guidelines.md 文字
├── layout-guidelines.md 布局
└── effect-style-guidelines.md 效果
3. 核心原则
按用途选色
先判断是文字、背景、边框还是反馈,再选择对应的语义颜色。页面引用角色名,不随意散用 HEX 色值,也不因颜色相近就替换成另一个角色。
明暗主题保持同一角色
同一个用途在两种主题下使用同名变量,由主题决定具体色值。暗色不是把亮色直接反转,需要结合实际背景检查文字、边界与状态是否清晰。
字号、行高与字重配套使用
先确定端别和内容层级,再选择已有组合。标题、正文、辅助信息各有用途,不为局部强调随意增加一套文字样式。
用间距表达关系
关系紧密的元素靠近,同组内容与不同区块逐级拉开。圆角、间距和内边距从已有档位中选择,并按具体场景使用。
效果服务内容与层级
阴影用于区分承载层级,遮罩用于突出前景,动效用于提示变化。采用已有参数,避免仅为装饰新增效果。
4. 交给 AI 使用时
- 说清任务。 明确 PC 或移动端、目标页面,以及要处理的内容。
- 按需读规范。 先读本文件,再读任务涉及的详规,不只依据目录或某个示例生成页面。
- 核对项目。 检查现有语义变量、字体和尺寸单位,优先沿用已有实现;发现规范与代码不同,先核对原因,不擅自全局替换。
- 按规则制作。 使用已有颜色角色、文字组合与布局档位;没有依据的参数先说明缺口,不自行补成项目标准。
- 检查实际结果。 查看两种主题、长文本、布局边界与交互反馈,记录问题发生在哪里,再修改对应规则或实现。
DESIGN.md 这个文件名本身不会让 AI 自动读取。接入项目时,应在项目已有的 CLAUDE.md、AGENTS.md 或任务提示中明确引用本文件与相关详规。
5. 检查与维护
- 颜色是否按用途选用,同一角色的明暗表现是否清晰。
- 字号、行高与字重是否来自同一组约定,长文本是否易读。
- 圆角与间距是否符合场景,是否正确处理 PC/移动端的单位。
- 阴影、遮罩与层级是否有明确用途,操作反馈是否可辨认。
发现问题时,先区分是规则不清楚、参数不合适,还是实现没有遵守规则。更新对应详规中的参数或用法,再检查实际应用;只有范围或文件结构变化时才更新本入口,避免同一数值在多处维护。
颜色使用规范
返回入口 · 文档整理版 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. 必查差异
生财绿浅色两档、额外档位、状态色旧速查表、湖蓝命名等见差异记录。基础色板某一行的“映射”说明不能覆盖更具体的语义变量定义。
文字使用规范
返回入口 · 文档整理版 0.1 · 2026-10-27
1. 选择顺序
先确定 PC 或移动端,再确定标题、正文、辅助信息等角色,最后选择对应的字号/行高组合与字重。下面保留原项目 Skill 的表格,不套用参考教程的字体或数值。
原规范用“细体”称呼 400、“常规”称呼 500,这是该项目的命名,不作为通用字体术语解释。实现时以数值为准。历史材料中的字体资源路径尚未逐一检查加载效果,不能据此判断每个终端最终渲染了哪种字体。
2. 已有规则与参数
4.0 字重对照表(5 档)
| 字重 | CSS font-weight | 使用场景 |
|---|---|---|
| 细体 | 400 | 长段落正文、辅助描述、弱化信息 |
| 常规 | 500 | 默认字重,正文、按钮文字、导航项、大部分文本 |
| 半粗 | 600 | 区块标题、卡片标题、Tab 选中态、需要强调的文本 |
| 粗体 | 700 | 页面大标题、核心数据、重要强调 |
| 特粗 | 900 | Hero 展示、落地页大字、品牌数字 |
选择原则: 默认写 500,需要突出用 600,特别重要用 700,只有 Hero/落地页用 900。400 用于长文本阅读或刻意弱化的信息。
淘汰值: 300 和 800 不再使用。旧代码碰到时:300→400,800→700。
4.1 Web 端文字规范
| 分类 | 字号 (px) | 行高 (px) | 常规(500) | 半粗(600) | 粗体(700) |
|---|---|---|---|---|---|
| 标题 | 24 | 36 | ✓ | ✓ | ✓ |
| 标题 | 22 | 32 | ✓ | ✓ | |
| 标题 | 20 | 30 | ✓ | ✓ | |
| 标题 | 18 | 28 | ✓ | ✓ | |
| 标题 | 16 | 26 | ✓ | ✓ | |
| 正文 | 15 | 24 | ✓ | ✓ | |
| 正文 | 14 | 22 | ✓ | ✓ | ✓ |
| 小字 | 13 | 20 | ✓ | ✓ | |
| 备注 | 12 | 18 | ✓ | ✓ | |
| 备注 | 11 | 18 | ✓ | ✓ | |
| 备注 | 10 | 16 | ✓ |
400(细体)可用于任意分类的长文本/弱化场景,900(特粗)仅用于 Hero/落地页展示。 只能使用以上字号/行高组合,禁止自定义字号。
4.2 移动端文字规范
注意:以下为代码中实际写入的值(已 ÷ 2),不是设计稿值。
| 分类 | 字号 (px) | 行高 (px) | 常规(500) | 半粗(600) | 粗体(700) |
|---|---|---|---|---|---|
| 标题 | 18 | 26 | ✓ | ||
| 标题 | 16 | 24 | ✓ | ✓ | |
| 大正文 | 15 | 23 | ✓ | ✓ | |
| 正文 | 14 | 22 | ✓ | ✓ | ✓ |
| 小字 | 13 | 20 | ✓ | ✓ | |
| 小字 | 12 | 18 | ✓ | ✓ | |
| 备注 | 11 | 17 | ✓ | ✓ | |
| 备注 | 10 | 16 | ✓ | ✓ |
4.3 字体家族
| 字体名 | 文件 | 用途 |
|---|---|---|
| PingFang SC / Noto Sans SC | fonts-subset.css | 中文正文 |
| Noto Serif SC | fonts-subset.css | 中文标题(衬线) |
| Outfit | fonts-subset.css | 英文数字 |
| Space Mono | fonts-subset.css | 等宽/代码 |
| DIN | DIN_Alternate_Bold.ttf | 数字展示 |
| Alibaba PuHuiTi | fonts.css | 品牌标题 |
3. 具体使用
- 普通正文先从相应端的正文组合选择。标题、备注不能因为能查到数值就互相替换。
- 文字强调优先使用现有层级,不通过不断增加字号或字重创建新等级。
- 中文正文、数字、代码各按表中的用途选择;品牌字体或衬线字体不自动成为所有页面的默认字体。
- 移动端表格写的是代码中的字号/行高值。设计稿值和其他尺寸的换算见布局规范,不得把整张设计稿所有数值统一除以二。
4. 限制与本次新增检查建议
归档表中的 10/11/12px 是备注、小字等特定层级,不代表长正文可以采用同样的小字号。不要将教程中的示例“正文不小于 14px”冒充历史项目全量遵循过的规则。
本次新增检查:在最终展示尺寸检查长文本、截断、数字、不同系统字体的可读性;若现有组合不能满足真实需求,说明场景后确认调整,不由 AI 自行新增字号。字间距与统一数字排版方式没有充分依据,本版不补造参数。
曾有另一份“最终版”速查卡将常规字重写为 400,而该项目 Skill 与根目录速查均写默认 500。本版按本副本两份文件记录 500;具体旧页面不得因此被批量改写,差异见确认事项。
圆角、间距与布局规范
返回入口 · 文档整理版 0.1 · 2026-10-27
1. 原则与密度
原规范明确:PC 采用紧凑布局取向;关系紧密的同级内容间距小于跨区块间距,布局优先用 gap 表达相邻关系。
参考教程建议描述不同密度。本项目现有材料没有完整的“紧凑/标准/宽松”三套参数,本版不凭空补成三套规范。页面密度应根据实际内容量与既有页面确认。下列是历史通用表,不意味着任意页面可以统一套用。
2. 归档档位及场景
| 值 | 场景 |
|---|---|
| 0 | 分割线、全宽元素 |
| 2px | 极小元素(进度条、小色块) |
| 4px | 小标签、小徽标 |
| 6px | 按钮、输入框、菜单项(输入框另有 8px 记录,见差异清单;不可直接用于改造) |
| 8px | 卡片、下拉菜单、选择器 |
| 12px | 大卡片、突出容器 |
| 16px | 弹窗、底部面板顶部圆角(16px 16px 0 0);弹窗另有 8px 记录,待确认 |
| 50% | 正圆(头像、圆形按钮) |
| 9999px | 胶囊形(胶囊按钮、胶囊标签) |
淘汰值: 10px → 统一改 12px;99px/100px → 统一改 9999px。
间距与布局
6.0 可用间距值
2px 4px 6px 8px 10px 12px 16px 20px 24px 32px 40px 64px
禁止使用 5px 7px 9px 15px 等不在上表中的值。
6.1 Gap(flex 间距)— 优先使用
| 场景 | 推荐 gap |
|---|---|
| 图标与文字 | 4px |
| 标签组 / 按钮组 | 8px |
| 列表项间 | 12px |
| 表单字段间 | 12px ~ 16px |
| 卡片内各区块 | 16px |
| 相邻卡片间 | 16px ~ 20px |
| 页面大区块间 | 24px ~ 32px |
6.2 Padding 场景对照
| 场景 | 推荐 padding |
|---|---|
| 小标签 / 徽标 | 4px 8px |
| 小按钮 | 4px 12px |
| 中按钮 | 8px 16px |
| 大按钮 | 12px 20px |
| 输入框 | 8px 12px |
| 卡片 | 16px 20px |
| 弹窗内容区 | 24px 32px |
| 移动端页面水平边距 | 0 32px(另有 @spacing = 30px,待确认) |
| PC 端页面水平边距 | 0 24px |
6.3 布局变量
| 变量 | 值 | 用途 |
|---|---|---|
| @spacing | 30px | 移动端页面左右边距 |
| @pc-spacing | 24px | PC 端页面左右边距 |
| @navbar | 96px | 移动端导航栏 |
| @pc-navbar | 48px | PC 端导航栏 |
| @max-width | 1050px | PC 端最大容器宽度 |
6.4 间距规则
- 优先用 gap(父容器控制),减少 margin 使用
- 间距选择原则:同级元素间距 < 跨级元素间距(视觉分组)
3. 尺寸单位:结合实际配置判断
已读取此副本的 postcss.config.cjs:rootValue 为 75;font-size、line-height 与多个 border-width 属性被排除转换;还有文件路径与选择器例外。
| 属性或范围 | 已有文档/代码记录 | 使用限制 |
|---|---|---|
| 移动端 font-size、line-height | 750px 二倍稿按原约定除以二写入,不进入 px2rem 转换 | 只用于该项目既有约定,不适用于所有移动端工程 |
| width、padding 等 | 文档示例保持设计值,由工具转换 | 先确认目标文件和选择器不在排除范围 |
| 边框宽度 | 配置中列有转换排除项 | 不套用“所有非文字尺寸都自动转 rem”的概括 |
| .no-rem、.vc-、.pc-、–pc 等 | 选择器黑名单中存在 | 先确认最终 CSS 输出;本次未构建项目 |
4. 怎么选择
图标与文本、标签组等优先按场景表;跨区块按照内容关系选择更大间距。不要用不同圆角随意制造层级,也不要因教程提到“派生圆角”就自行引入本项目未定义的计算公式。
输入框圆角、弹窗圆角与内边距、移动端水平边距存在相互冲突的记录。涉及这些项目时,保留当前目标组件并查正式稿/实现,确认后再修改。完整记录见差异清单。
本次新增检查:确认端别与单位后再使用档位;不要在一次文档整理中批量替换旧代码。原规范的淘汰映射是设计约定,不构成本次修改业务样式的指令。
效果与反馈规范
返回入口 · 文档整理版 0.1 · 2026-10-27
1. 范围
本次保留已有规范中的阴影、遮罩、叠放层级和轻量动效。参考教程中的玻璃效果、背景模糊、渐进模糊不在本次已核实的项目规范范围内,不补写为已完成资产。
阴影用于区分承载层级,遮罩用于弱化背景并突出前景;先选场景,再查现有参数,避免为装饰叠加效果。
2. 阴影档位(归档记录)
| 档位 | 值 | 场景 |
|---|---|---|
| shadow-sm | 0 1px 3px rgba(0,0,0,0.1) |
轻微提升:输入框聚焦、小卡片 |
| shadow-md | 0 4px 16px rgba(0,0,0,0.1) |
中等提升:下拉菜单、悬浮卡片 |
| shadow-lg | 0 8px 24px rgba(0,0,0,0.12) |
高提升:弹窗、浮层 |
| shadow-xl | 0 16px 48px rgba(0,0,0,0.2) |
最高提升:全屏弹窗 |
| shadow-up | 0 -4px 16px rgba(0,0,0,0.05) |
底部弹出面板 |
| shadow-focus | 0 0 0 4px #b3f6ee |
聚焦环 |
以上是文档中的名称与数值,不保证存在同名 CSS 类或变量。尤其 shadow-focus 是聚焦环记录,不能直接视为已确认的统一焦点样式,见差异清单。
3. 遮罩
使用颜色规范中的 overlay 角色,保持明暗对应。原组件章节将弹窗遮罩写为黑色 80%,与语义层的模态遮罩记录存在差异;本版不合并成一个默认值。涉及具体弹窗时确认目标组件,不直接覆盖其现有行为。
4. 层级档位(归档记录)
| 名称 | 值 | 场景 |
|---|---|---|
| z-base | 1 | 基础定位 |
| z-dropdown | 10 | 下拉菜单、工具提示 |
| z-sticky | 100 | 固定导航栏、吸顶 |
| z-popover | 200 | 弹出框、浮层 |
| z-modal | 1000 | 模态弹窗 |
| z-toast | 2000 | Toast、系统通知 |
这些是规范命名,不代表项目每个组件已改用同名变量或统一值。复用组件前查看其挂载位置与现有层级,避免只提升数字解决遮挡。
5. 动效(归档记录)
| 场景 | 时长 | 备注 |
|---|---|---|
| Hover 颜色变化 | 100ms | transition-colors |
| 标准过渡 | 150ms | duration-base |
| 弹窗动画 | 200ms | fade-in + scale 95%→100% |
| 出场动画 | 200ms | fade-out + scale 100%→95% |
克制原则:动效应微妙、不引人注目,避免过度动画。
6. 交互反馈与可读性
原规范覆盖 Hover、Active、Disabled、Error 和 Focus。悬停与选中引用现有语义色;移动端考虑触摸按下反馈;错误提示保留明确的状态信息。
历史聚焦环分别出现文字说明 3px、代码类 ring-2、阴影表 4px 的记录,尚未统一。不得直接复制“无 outline”而没有等效的可见焦点。
本次新增检查建议:实际检查键盘焦点、暗色下遮罩与前景分离、禁用状态可辨识性、动效是否妨碍内容阅读。以上是待执行的检查要求,不是已通过验收的结论;本次没有运行页面。
7. 待确认项
焦点环、弹窗遮罩与旧 Hover 固定色值的差异见差异清单。没有依据时不新增玻璃、模糊、渐进模糊、渐变或新的动画预设。