用途:把 Sketch 文件(或形状类似的 Figma 导出)逆向为像素级还原的 React + CSS,核心约束是“每次改进不引发回归”。资料把规则按级联影响排序:上游判断出错会污染所有下游输出,因此须优先修早阶段。
主要能力与规则分类:1) 逆向迭代策略(iter-,关键):从根自顶向下转换、自底向上二分定位回归,每次变更须通过已提交基线快照,先冻结设计 token,一次只改一个组件族,保留已知良好分支。2) 图层树重建与符号解析(tree-,关键):先解析 override 为命名 props,用子树结构哈希发现重复组件,折叠无样式单子节点透传组,用子树等价提升共享样式,剪切蒙版需 isolation:isolate + clip-path,外部符号转为库导入。3) 布局算法(layout-,关键):映射 MSImmutableFlexGroupLayout 枚举到 CSS flex,用一维分离轴与二维坐标聚类推断 flex/grid,等距间隙提升为 display:flex; gap:Npx,内边距由父级承担,保留 wrappingEnabled,ignoreLayout:true 转为 absolute。4) 几何数学(geom-):组合 2D 仿射矩阵、只在 CSS 边界取整、旋转用 transform、剪切边界取交集。5) 视觉回归(diff-):抗锯齿内容用 SSIM,分区容差,Pixelmatch includeAA:false,感知哈希与子树二分定位回归,按组件而非页面存基线。6) 样式(style-)、排版(type-)、路径形状(path-)为精修层:sRGB 浮点转 hex、保留 Display-P3、atan2 算渐变角、阴影顺序反转、逐角圆角、行高转无单位、字距转 em、段落间距用 gap、曲线点转 SVG 三次贝塞尔、圆角矩形用 div、Apple 平滑圆角用超椭圆、解析期扁平化布尔运算、显式声明 fill-rule。
使用方式:先读 references/_sections.md,按优先级顺序应用;新建转换器按顺序执行,已有转换器先用子树二分与感知哈希判定回归归属阶段,再在最高归属阶段修复。新增规则可用 assets/templates/_template.md;AGENTS.md 为自动生成的目录。
适用场景:构建 Sketch→React+CSS 转换器、迭代中怕回归、排查“几乎一致”但视觉回归失败、设计快照门禁策略、自由几何下选 flex/grid/absolute、翻译 Sketch 专有原语。
限制:资料未提供具体安装命令、依赖版本、平台支持、性能数据或收费信息;内容侧重方法论与规则,部分算法需自行实现。