用途:按 DTCG(Design Tokens Community Group)2025.10 格式管理设计令牌,核心为无依赖的 Python 实现,覆盖脚手架、校验、合并(全局基础+项目覆盖)、别名解析与 CSS 导出。
主要能力:支持 color(字符串)、dimension、duration、fontFamily、fontWeight、number、typography、shadow 类型;输出 CSS 自定义属性、Google Labs DESIGN.md(alpha)、独立 HTML 预览,以及生成提示词(gpt-image-2/nano-banana CLI 行与 /tufte-report 主题)。CSS 导入覆盖 color/dimension/duration/fontFamily/number,复合值(box-shadow、渐变、多段排版)会跳过并报告。
对比度:DTCG 只存颜色不存关系,contrast 以技能约定补充角色配对,按 APCA Lc 与 WCAG 2.x 双标度报告,默认 --standard both 同时通过;修复只移动 OKLCH 明度,保持色相与彩度;无法解析的颜色与调色阶梯只报告不判定失败;前后景同值时判为最严重失败且不给修复建议。可在令牌文件根部用 $extensions 声明 pairs / exclude,未声明则按角色推断。
用法:命令目录见 references/commands.md。validate <file> 失败为警告(exit 0),加 --strict 升级为错误(exit 1);contrast <file> 失败即 exit 1。生成的 HTML 应通过内置 stdlib HTTP 服务在 127.0.0.1 预览,交互式默认启用,--serve/--no-serve 可强制。令牌文件建议可见并提交,不放在隐藏目录。
限制:v1 不含 JSON Pointer $ref、$root、结构化颜色对象、名称限制、Style Dictionary、Figma/Pencil 导入、共享包与 skillify;品牌分层、主题覆盖、提示词等均为技能约定而非 DTCG 标准。未提供的收费、价格与支持平台信息暂未提供。