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

生财有术 · 基础设计规范

以生财绿建立品牌识别,通过颜色、文字、间距与层级组织内容。本文是基础规范的统一入口:先了解原则,再按任务查阅对应详规。

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 使用时

  1. 说清任务。 明确 PC 或移动端、目标页面,以及要处理的内容。
  2. 按需读规范。 先读本文件,再读任务涉及的详规,不只依据目录或某个示例生成页面。
  3. 核对项目。 检查现有语义变量、字体和尺寸单位,优先沿用已有实现;发现规范与代码不同,先核对原因,不擅自全局替换。
  4. 按规则制作。 使用已有颜色角色、文字组合与布局档位;没有依据的参数先说明缺口,不自行补成项目标准。
  5. 检查实际结果。 查看两种主题、长文本、布局边界与交互反馈,记录问题发生在哪里,再修改对应规则或实现。

DESIGN.md 这个文件名本身不会让 AI 自动读取。接入项目时,应在项目已有的 CLAUDE.md、AGENTS.md 或任务提示中明确引用本文件与相关详规。

5. 检查与维护

  • 颜色是否按用途选用,同一角色的明暗表现是否清晰。
  • 字号、行高与字重是否来自同一组约定,长文本是否易读。
  • 圆角与间距是否符合场景,是否正确处理 PC/移动端的单位。
  • 阴影、遮罩与层级是否有明确用途,操作反馈是否可辨认。

发现问题时,先区分是规则不清楚、参数不合适,还是实现没有遵守规则。更新对应详规中的参数或用法,再检查实际应用;只有范围或文件结构变化时才更新本入口,避免同一数值在多处维护。

历史记录中尚有部分规范与代码差异,查阅差异记录;本展示版本的整理范围见版本说明。

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