DESIGN.md自定义字段:区分colours拼写错误与合法扩展,防止主色被悄悄丢掉 素材身份:作者原创输入/可编辑参考。目标工具未在本轮执行。 先打开 index.html;input.csv 是原始字段,reference.csv 是验收基准,negative.csv 是故意构造的坏样例。 actual-results.csv 保留未测状态,实际执行后再填写。 前置条件: Node.js与npm已可运行;练习只需本地文本文件和官方@google/design.md CLI,不需要Stitch账号或付费生成。 固定当前CLI版本并保留版本号;DESIGN.md仍为alpha格式,升级前先在练习副本复核。 本课给出作者自制规则文件和预期,不把预期JSON冒充已执行的官方CLI返回。 操作步骤: 1. 建立误拼和扩展两个副本 在typo版把colors写成colours,在extension版保留colors并添加x-brand-note。 两份文件的品牌说明与组件内容保持相同,便于区分触发原因。 2. 逐份运行lint 分别保存原始finding,查看unknown-key或token-like-ignored是否命中。 不预先把所有未知键都当error,官方对扩展与像token的误放有不同处理。 3. 回查有效设计状态 CLI的JSON报告主要含findings与summary;根据unknown-key、token-like-ignored和broken-ref定位误拼,再用修复后的真实export确认primary进入消费产物。 若界面恰好用了相近颜色,也不能证明被忽略的字段已正确读取。 4. 修正误拼的顶层键 只把colours改回colors,保留原值与组件引用。 不要顺手删除x-brand-note,除非它确实不再需要。 5. 导出验证真实消费 对修复文件导出CSS,查primary的实际输出值。 若报告仍提示缺主色,检查是不是另一份文件被命令使用。 6. 保留合法扩展文本 把x-brand-note内容写入交付说明,确认规范工具没有强迫它变成颜色。 扩展能保留不代表任何下游生成器都会执行其中的自然语言要求。 7. 交付两类处理依据 整理误拼修复前后、合法扩展和导出结果三份证据。 说明每个字段属于规范token还是项目自定义上下文,避免团队后续误删。 验收: 误拼的颜色被修复并进入实际导出。 合法扩展未被当作需要删除的错误。 文档清楚区分已消费token与保留说明。 官方资料: https://github.com/google-labs-code/design.md 图片身份:assets/ 为内置image_gen生成的原创练习输入缩略版,原始文件保留在网站图片来源地址。可编辑SVG为作者原生排版。