展开本页目录
开始前准备什么
- Node.js与npm已可运行；练习只需本地文本文件和官方@google/design.md CLI，不需要Stitch账号或付费生成。
- 固定当前CLI版本并保留版本号；DESIGN.md仍为alpha格式，升级前先在练习副本复核。
- 本课给出作者自制规则文件和预期，不把预期JSON冒充已执行的官方CLI返回。
- 保留冲突原稿
- 固定发布版和规范
- 读真实lint原文
- 另设重复检查门槛
- 合并权威颜色说明
- 重跑两层检查
- 交付版本差异报告
1. 保留冲突原稿
使用两段Colors和独立Photography的DESIGN-conflict.md，另备批准主色#184A45。
不要在检查前合并，先保留能复现问题的输入。
2. 固定发布版和规范
记录实际npm版本0.4.0，并保存main规范所述重复章节/顶层key要求。
规范要求和发布实现可能不同，二者分别记录。
3. 读真实lint原文
本课实际0.4.0对重复标题退出0，仅有section-order warning；跨YAML顶层colors重复也是warning。
不能写成CLI已经以error拒绝这两个样本。
官方界面与功能位置
以下为官方文档配图，具体版本与账号入口以当前产品为准。本课练习输入与验收对照见相邻步骤。
4. 另设重复检查门槛
运行作者check-duplicate.py检查本课标题唯一性和已知顶层组重复。
这是本课交付门槛，覆盖范围写清，不冒称完整官方解析器。
5. 合并权威颜色说明
按brand-approval.json保留一个Colors，删除冲突说法。
Photography是自定义上下文，应继续保留。
6. 重跑两层检查
对修复文件分别运行官方lint和作者重复检查，保留各自stdout与退出码。
官方零退出和项目门槛通过是两个不同结论。
7. 交付版本差异报告
打包原稿、修复稿、规范链接和两层检查记录。
升级CLI后重新执行，不能把0.4.0行为当永远不变。
下载本课材料并开始操作
练习包包含本课的具体输入、可编辑数据、正反样例与七步说明。index.html 可离线查看原件和验收参考，actual-results.csv 用于记录你实际操作后的结果。
怎样确认已经完成
- 原稿重复由本课独立门槛检出，不能只看官方exit0。
- 修复后Colors唯一且Photography保留。
- 实际0.4.0行为与main规范要求分栏记录。
常见问题
规范说重复章节不行，为什么CLI还退出0？
固定 CLI 0.4.0 并保存重复章节/跨 YAML 重复键的原始 lint，按规范另加独立冲突检查。确认批准主色只定义一次，再比较导出结果；本课样本退出零不代表没有重复冲突。
那是不是后写Colors会安全覆盖前面？
不能依赖这种未承诺行为。先按品牌批准值合并成唯一来源，再同时运行官方lint和项目重复检查，升级版本后重测。