用途:对 Penpot 设计进行设计系统/令牌治理审计,与无障碍检查区分开,聚焦令牌与系统一致性。
主要能力:收集所有填充、描边、间距、圆角值,与当前令牌系统(penpotUtils.tokenOverview())比对,报告硬编码值、偏离 4px 网格的间距、孤立/未解析令牌和重复项,每项附带建议的语义令牌与置信度。
使用方式:所有变更经 execute_code 执行,用 export_shape 视觉验证,用 penpotUtils.shapeStructure 读取结构。工作流分四阶段:检查(high_level_overview、scripts/collectStyleUsage.js、tokenOverview())、硬编码检测(scripts/detectHardcodedValues.js)、网格与孤立检查(scripts/checkGridAndOrphans.js)、生成报告(scripts/generateTokenReport.js)。报告须按 shared/report-schemas/token-governance-report.schema.json 输出 JSON 并记入运行账本。
限制:默认仅建议;唯一可自动修复的是原始值与某令牌解析值完全相等时的替换,且需在检查点显式确认。近似匹配、网格取整、新令牌创建均只建议,新令牌交由 penpot-foundations 处理。偏离网格间距只建议最近 4px 令牌,绝不静默取整。几何、新令牌、解绑永不自动执行。
适用场景:设计系统治理工程师审查 Penpot 文件中的令牌使用一致性。具体安装命令与收费信息暂未提供。