项目介绍
这个资料集把品牌样式整理为可阅读的 DESIGN.md 和机器可处理的变量文件,适合学习设计规范的组织方式。品牌名称、商标和素材的许可需独立判断。
仓库为同一个品牌组织了预览页、文字规范与结构化变量,便于从多个角度理解设计语言。预览帮助快速判断视觉方向,DESIGN.md 说明规则,JSON 与 CSS 文件用于代码接入。
它更适合学习规范的组织方法,例如如何把颜色、文字和组件联系起来。实际落地时应建立自己的规范,选择可用的方法并替换品牌资产,避免把参考项目的全部视觉素材混进自己的产品。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 预览页面 | 在浏览器中观察整体布局、颜色和组件表现。 |
| 规范文档 | 阅读设计原则、组件描述与使用边界。 |
| 结构化令牌 | 通过 tokens.json 理解基础变量和语义变量的对应。 |
| CSS 变量 | 查看 variables.css 与 theme.css 如何承接设计规则。 |
| 人工与代理协作 | 让预览、文档和代码变量引用同一套规则。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 项目指南 |
| 分类 | AI 与开发 |
| 项目仓库 | ricocc/brands-design-md |
| 整理日期 | 2026-11-14 |
安装或使用条件
先确认所用项目版本、操作系统与依赖,准备独立测试目录及可恢复的数据副本。本文中的操作流程需与对应版本的官方说明配合使用。
安装与使用步骤
- 浏览仓库目录,选择一个品牌,先阅读 DESIGN.md 和预览页理解结构。
- 对照 tokens.json、variables.css 等文件,检查颜色、字体和组件变量之间的对应关系。
- 在自己的项目中建立独立规范,采用适合的组织方法,并替换为自己的名称、字体授权和视觉资产。
首次使用与操作检查
选择一个参考目录,先打开 preview HTML,再阅读 DESIGN.md,最后对照 tokens.json 与 CSS。记录一个按钮从主色变量到组件样式的完整映射。
在自己的项目中只实现一个小页面验证:标题、正文、链接、按钮和表单状态齐全后,再整理成自己的 DESIGN.md。字体授权、图标和品牌标志分别处理。
配置与常见问题
- 资料集的代码许可不自动覆盖品牌标识和第三方字体。
- 不要只凭生成文件判断品牌最新规范,正式使用前查品牌官方手册。
更新与备份
记录采用的仓库提交,并保存自己的设计变量变更历史。