从唯一事实源自动生成、永远同步的文档站

毕业项目：治设计系统最痛的那个病——文档永远过时。你要造的是一个「自己跟着设计变」的文档站：规范值改一处，色板页、字阶页、组件页全部自动同步。做完这个，你就从「画图的人」正式变成「定义系统的人」。

01先备料：把规范收进一个文件

把你的色板、字阶、间距、圆角、阴影整理成一份结构化的规范文件（让它帮你：「把 @设计规范.md 和组件预览页里的值整理成一份 design-tokens 文件」）。这个文件从此是唯一事实源——组件页（第 4 课）和文档站（这节课）都从它取值。

02跟做：一段提示词

读 @design-tokens.json（我的色板、字阶、间距等规范值），
自动生成一份设计系统文档网页：
1. 色板页：每个颜色显示名称、色值、用途说明，
   以及它和常用底色的对比度是否达标（复用检查器的公式）
2. 字阶页：每级字号用真实文字渲染效果 + 使用场景说明
3. 间距 / 圆角 / 阴影页：全部用真实样例展示，不用示意图
4. 「给开发的对照说明」页：每个规范值怎么引用、命名规则是什么
5. 关键要求：token 文件一更新，重跑一次构建，全站同步——
   给我一个「一句话重建」的命令
6. 顶部标注文档版本和最后同步时间。

03让它「活」到底：接上团队流程

• 部署上线：让它把文档站部署成真网址（造物课那套），团队和外包收一个链接，永远是最新版；
• 变更日志：加一条规矩「每次 token 变更自动记一行日志（改了什么、为什么）」——半年后这份日志就是你们设计决策的历史；
• 新项目启动包：文档站 + 组件预览页 + 检查器，三件套打包就是你的「设计系统启动包」——接新项目时它就是你的第一交付物。

04检查点