项目研究：中国传统配色 zhongguo-traditional-colors

> 来源：nevertoday/zhongguo-traditional-colors > 类型：开源资源库（MIT 协议）· 538 张色卡图片 · 数据源 742 个传统色

---

一句话定性

一个用图片当载体的中国传统色色卡库——把"中国色"从干巴巴的 HEX 数字，变成"看得见、拿得走、能讲出处"的实物图卡。

本质是视觉化的色彩词典，不是代码项目。打个比方：它不是菜谱，是色卡版的《本草纲目》。你可以当图鉴翻，看到"缃绮"两个字时，旁边就有一张暖暖的杏黄卡片告诉你这是啥色。

---

逻辑全景图

触发层

- 谁需要：国风设计师 / 视频片头 / 插画师 / 想做带东方味 PPT 的人 - 痛点：搜"暮山紫"只看到 HEX 数字，不知道长啥样、不知道配啥色 - 需求：色名 + 色值 + 视觉效果 + 文化气质，一站式拿走

核心层（数据 → 渲染 → 包装，三步走）

1. 数据源：742 个传统色主表（docs/chinese-color-master-list.md），纯文本格式 色名 + HEX 2. 色卡渲染：HEX → PNG，每张含「色名 / HEX / RGB / CMYK / 推荐配色 / 气质词」 - 早期走 AI 批量生成（文件名残留 mue_oar_生成配色卡片_... 字样） - 后期用 Swift + Vision 框架做 OCR 校对 - 输出：538 张高清图 + 对应缩略图 3. 静态站点：index.html + assets/data/images.js（图片清单）→ GitHub Pages 托管 - 浏览器端可一键打包 ZIP 下载（不走服务端） 4. 自动化脚本（5 个 .mjs + 1 个 .swift） - build-manifest.mjs：扫图，生成图片清单 - build-readme.mjs：扫图，自动重写 README 预览区 - package-images.mjs：打成 ZIP 走 Release - audit-missing-colors.mjs：校对：哪些色名还没图 - ocr-color-cards.swift：OCR 校色工具

输出层

- 在线浏览站 - 单图下载（点缩略图拿原图） - 全量 ZIP（GitHub Release 附件，708MB 绕开 git 仓库体积） - 元数据：HEX / RGB / CMYK / 推荐配色 / 气质关键词

卡点层

- 文件名是 UUID + AI 工具前缀（..._cmy_01edea60-..._10.png），检索极痛苦，作者自己承认"后续可整理为 颜色名-hex-批次.png" - OCR 误识需要人工兜底（缺失颜色报告 docs/missing-colors.md 就是证据） - 708MB 走 Release 不入仓，第一次 clone 的人根本不知道还有完整包 - 传统色本来就没"标准答案"——同名"暮山紫"在不同朝代/器物/资料里可能差几个色阶

---

升级路线图

| 段位 | 标志 | 具体动作 | |------|------|---------| | 入门段（能用） | 把它当色卡素材库 | 下载 ZIP → 选 5 个喜欢的色（如「十样锦」「暮山紫」「缃绮」「天水碧」「鸦青」）→ 做一个国风小图试试 | | 进阶段（用好） | 不只抄 HEX，懂色彩文化 | 按"色相-朝代-气质"分组收藏：暖色系（赭/朱/丹）走大唐，冷色系（黛/绀/缥）走宋元；建立自己的"色卡-场景"映射笔记 | | 高手段（用活） | 从"用别人的色卡"升级到"建自己的色卡系统" | 借鉴本项目的结构（主表 + OCR 校对 + 静态站点 + 自动化脚本），套到自己的领域 |

高手和普通人的本质差距：普通人搜"中国色"→ 截图保存；高手把"颜色"抽象成 「命名 + 视觉 + 元数据 + 出处」四元组，让色卡变成可检索的知识。

---

场景迁移

底层逻辑一句话：「内容数据 + 视觉资源 + 元数据 + 静态站点 + 自动化脚本」五件套。把它从"颜色"换成别的，一样能套。

迁移 1：地方菜系色卡库

- 颜色 → 菜品照片 - 元数据：菜名 / 主要食材 / 烹饪方式 / 地域 / 味型 - 同样的痛点：搜"九转大肠"只看到文字，不知道长啥样 - 注意变量：菜品图的视觉一致性比色卡难（光线、摆盘），需要统一拍摄规范

迁移 2：古乐器音色库

- 颜色 → 音频波谱图 - 元数据：乐器名 / 调式 / 代表曲目 / 出土朝代 - 同样的痛点：搜"筑"只看到文字，听不到声 - 注意变量：音频不能像图片一样用缩略图预览，需要用波谱/频段图替代

迁移 3：私人品牌色卡管理

- 把这个仓库 fork 一份 - 把色主表换成你的 brand-colors.md - 把脚本里的扫描路径指向你的图片 - 5 分钟得到一个团队共享的品牌色卡站点

---

部署评估

收益

- 立即有 538 个考据过的中国色可用，对"国风"内容（网站/视频/PPT/插画）开箱即用 - 整套架构是"内容数据 + 静态站点 + 自动化脚本"，不依赖后端服务，部署零成本 - MIT 许可证，改造成本极低

注意事项

- HEX 不是"印刷标准答案"，做实物（刺绣/瓷器/印刷品）需要二次校色 - 文件名混乱不利于二次检索（要么忍，要么用脚本批量重命名） - 数据源是 742 色，实际成图 538 张——缺失报告里有清单，可以针对性补全

风险

- 依赖 GitHub Pages + Release 附件，如果作者弃坑或 GitHub 政策变化，资源可能失效 - 早期 AI 生成 + OCR 校对的色卡，可能有少量色名-色值不匹配，使用前肉眼比对一下

---

一句话总结

> 这个项目的灵魂，是把"文化的命名"和"技术的色值"焊死在同一张图上——让"暮山紫"不再是字典里的三个字，而是一张你能直接拖进 Figma 的色卡。