Skip to content
Back to search

image-to-code

SkillWorks with Claude CodeGitHub

像素级 750px 图片转代码与高清切图工作流。当 Codex 需要把当前选中的 UI 图片、截图、App/Web 设计稿、Figma 图片导出稿或设计长图转换为代码,并输出独立透明 PNG 切图资源时使用。适用于严格 1:1 等比例还原、画板宽度精确 750px、高清放大切图、防模糊和背景抠除、必要时用 image2/imagegen 抠透明 PNG、文本可编辑、简单图形原生矢量/代码化,最终代码需要自适应适配,或需要把完成稿导出/导入 Figma 为可编辑图层的任务。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yuzhworkhard-wq--image-to-code/badge.svg)](/listings/yuzhworkhard-wq--image-to-code)

HTML

<a href="/listings/yuzhworkhard-wq--image-to-code"><img src="/api/listings/yuzhworkhard-wq--image-to-code/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Place the repository directory in your Codex skills folder:

~/.codex/skills/image-to-code

Install dependencies:

python3 -m pip install -r requirements.txt

The helper scripts use Pillow and NumPy.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 443 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: image-to-code
  3. description: 像素级 750px 图片转代码与高清切图工作流。当 Codex 需要把当前选中的 UI 图片、截图、App/Web 设计稿、Figma 图片导出稿或设计长图转换为代码,并输出独立透明 PNG 切图资源时使用。适用于严格 1:1 等比例还原、画板宽度精确 750px、高清放大切图、防模糊和背景抠除、必要时用 image2/imagegen 抠透明 PNG、文本可编辑、简单图形原生矢量/代码化,最终代码需要自适应适配,或需要把完成稿导出/导入 Figma 为可编辑图层的任务。
  4. ---
  5. # Image To Code
  6. ## 目标
  7. 把用户提供或当前选中的 UI 图片还原为代码,并导出必要的独立高清切图资源。
  8. 原图就是视觉合同。不要把它重新设计成“更合理”的界面,不要做排版优化,不要主观调整间距。必须先按 750px 宽度等比归一化,再按原图元素的位置、比例、层级、颜色、透明度和样式进行还原。
  9. 750px 是设计基准坐标,不是最终页面的唯一显示宽度。生产代码必须在保持 750px 基准稿不变的前提下提供自适应缩放;切图资源必须有足够像素密度,不能因为源 bbox 小而在页面里发糊。高清切图只提高 PNG 文件真实像素,不改变它在页面里的位置和显示大小。
  10. ## 最高优先级规则
  11. 当用户要求“严格等比例缩放至画板宽度精确 750px”时,这条规则高于所有常规前端、设计和响应式建议。
  12. - 整体画板宽度必须精确为 `750px`。
  13. - 画板高度必须根据原图宽高比自动计算,不能人为设定或优化。
  14. - 所有元素必须使用同一个全局缩放比例。
  15. - 保持所有元素的相对位置、相对大小、层级关系、堆叠顺序、颜色、透明度、阴影、渐变、圆角、描边和样式属性。
  16. - 禁止自动调整任何元素的位置、大小、对齐、间距、排版或视觉层级。
  17. - 禁止重新设计、优化布局、合并独立元素、拉伸素材、改变颜色或简化效果。
  18. - 禁止把图标或位图强行转换为矢量路径。
  19. - 禁止使用相似图标库、相似插画、AI 生成图、CSS 临摹图或占位素材替代原图中的图标/位图。
  20. - 禁止自动创建 Figma/export 的 Slice 对象。只有在需要切图资源时,才按元素边界导出独立 PNG 文件。
  21. - 如果代码优雅性和视觉还原发生冲突,视觉还原优先。
  22. - 750px 基准稿必须可精确复核;生产页面必须同时提供按容器/视口等比缩放的自适应版本。
  23. ## 跨目录调用一致性
  24. 无论用户在哪个项目文件夹调用本 skill,都必须只以本次用户提供/选中的原图为视觉源。不要沿用其他会话、其他文件夹、旧示例或历史任务里的结构、素材、配色、页面区域和实现假设。
  25. - 每次调用都必须重新读取当前源图尺寸。
  26. - 每次调用都必须重新测量当前源图元素坐标。
  27. - 每次调用都必须重新建立当前源图的图层分类表。
  28. - 不得复用旧项目里的图标、插画、头像、卡片素材或布局参数,除非用户明确指定这些就是源素材。
  29. - 不得因为当前项目已有组件或 CSS,就把原图自动改造成项目现有组件样式。
  30. - 如果没有源图局部切图能力,宁可保留完整局部裁片作为临时素材并说明限制,也不要用“看起来差不多”的替代图重画。
  31. ## 执行流程
  32. 1. 检查输入图片和项目约束。
  33. 2. 把原图等比归一化到 750px 宽度。
  34. 3. 建立 `layers.manifest.json`:记录每个图层的原图 bbox、缩放后 bbox、类型、z-index、导出文件名。
  35. 4. 为每个 bitmap/icon 资源确定 `asset_scale_factor`,默认 `2`,小图标、低分辨率源图或抠边脏时用 `3` 或 `4`。
  36. 5. 先按 manifest 导出高清切图资源,再写代码。禁止先凭感觉写代码再补切图。
  37. 6. 对所有 icon/illustration/复杂位图默认要求透明 PNG;本地背景抠除不干净、审计失败或棋盘格/黑底/白底预览仍有脏底时,必须使用 image2/imagegen 做透明 PNG 背景抠除兜底,并保持页面显示外框、构图和主体位置不变。
  38. 7. 在 750px 基准画板中使用 manifest 的精确坐标实现代码。
  39. 8. 完成 750px 基准代码后,进入自适应细化阶段:加外层 fit wrapper,按容器或视口整体缩放 750px 画板,不得对子元素重新排版。
  40. 9. 分模块校验:矢量、文本、位图/图标切图分别验收。
  41. 10. 做整页 750px 叠图复核,并做 375px 手机宽度和至少一个其他手机宽度的自适应截图。
  42. 11. 根据具体错位、缺图、裁切、样式差异或手机端溢出继续迭代。
  43. 12. 交付代码、高清切图资源、manifest 和简短还原报告。
  44. 13. 代码和 QA 完成后,若用户要求 Figma 或需要继续交付,按同一份 manifest/code/assets 导出可编辑 Figma 图层规格或本地 Figma importer;只有需要直接写入远端 Figma 文件时,才索取 Figma 链接和写入权限。
  45. ## 输入检查
  46. 开始前先确认:
  47. - 原图尺寸和宽高比
  48. - 目标类型:网页、移动端界面、组件、海报、邮件、游戏 UI 或静态 HTML
  49. - 是否已有项目框架和技术栈
  50. - 是否要求只输出代码、只输出切图,还是代码加切图
  51. - 哪些文字必须变成可编辑文本
  52. - 哪些复杂图形需要保留为透明 PNG
  53. - 是否有明确的响应式断点、最大宽度、嵌入容器或移动端/桌面端展示要求
  54. 如果仓库已有框架,遵循现有框架。没有项目时,静态页面优先使用 HTML/CSS/JS;只有在组件结构或交互确实需要时才使用 React/Vite。
  55. ## 750px 等比归一化
  56. 假设原图尺寸为 `source_width x source_height`:
  57. ```text
  58. scale = 750 / source_width
  59. final_width = 750
  60. final_height = round(source_height * scale)
  61. scaled_x = original_x * scale
  62. scaled_y = original_y * scale
  63. scaled_width = original_width * scale
  64. scaled_height = original_height * scale
  65. ```
  66. 同一个 `scale` 必须应用到:
  67. - 所有坐标
  68. - 所有宽高
  69. - 所有圆角
  70. - 所有描边
  71. - 所有阴影偏移和模糊
  72. - 所有渐变位置
  73. - 所有图标和位图外框
  74. - 所有文字字号、行高和字间距
  75. 主交付物是锁定的 750px 定稿画板。响应式规则不能影响 750px 版本的坐标、比例和叠图复核。最终代码必须在 750px 基准外再提供自适应缩放层。
  76. ## 强制 Manifest
  77. 任何图片转代码 + 切图任务都必须先创建 manifest。manifest 是布局和切图的唯一数据源,不允许在代码里重新估算位置。
  78. 每个图层至少记录:
  79. ```json
  80. {
  81. "id": "card-wallet-illustration",
  82. "type": "bitmap",
  83. "source_bbox": { "x": 338, "y": 520, "width": 116, "height": 122 },
  84. "scaled_bbox": { "x": 338, "y": 520, "width": 116, "height": 122 },
  85. "z_index": 24,
  86. "asset": "assets/illustrations/card-wallet-illustration.png",
  87. "asset_pixel_width": 232,
  88. "asset_pixel_height": 244,
  89. "asset_scale_factor": 2,
  90. "css_display_width": 116,
  91. "css_display_height": 122,
  92. "transparent_required": true,
  93. "notes": "从当前源图裁切,保持原图露出比例"
  94. }
  95. ```
  96. 规则:
  97. - `source_bbox` 必须来自当前源图测量,不得凭布局推算。
  98. - `scaled_bbox` 必须由同一个 `scale` 计算得到。
  99. - bitmap/icon 的 `asset_pixel_width/height` 可以高于 `scaled_bbox.width/height`,但代码里的 `css_display_width/height` 必须等于 `scaled_bbox` 尺寸。也就是文件分辨率 2x/3x,页面占位仍是原元素外框大小。
  100. - `asset_scale_factor = asset_pixel_width / css_display_width`。默认至少 `2`;小于 `64px` 的图标、源图压缩明显、边缘脏或放入页面后发糊时使用 `3` 或 `4`。
  101. - 代码中的每个图片层、文本层、矢量层都必须能追溯到 manifest。
  102. - 如果实现截图和原图不一致,先修 manifest 坐标,再修代码。
  103. - 没有 manifest 的交付视为未完成。
  104. - `assets/icons/`、`assets/illustrations/`、卡片插画、导航图标、按钮图标、状态图标和不规则装饰图默认 `transparent_required: true`。不得因为抠图困难、背景和卡片颜色接近、或本地脚本抠除失败就把它改成 `false`。
  105. - 只有照片、真实产品图、截图、纹理背景、完整矩形 banner 或背景本身就是视觉内容的位图,才允许 `transparent_required: false`,并必须在 `notes` 里说明为什么保留矩形背景。
  106. - 如果某个 PNG 的四角 alpha 不为 0、棋盘格上出现白/灰/页面底色矩形、或 `audit_png_assets.py --require-transparent-bg` 失败,manifest 必须保持 `transparent_required: true`,并重出资源;不能通过改 manifest 跳过验收。
  107. ## Bbox 测量和预览
  108. 切图区域不能凭感觉。每个需要导出的资源必须先完成 bbox 预览校验,再导出 PNG。
  109. 流程:
  110. 1. 在原图原始尺寸上测量 `source_bbox`,不要在浏览器缩放预览图上估算。
  111. 2. bbox 必须覆盖完整元素外框,包括透明留白、浅色底形、阴影、半透明边缘和被遮挡但可见的外缘。
  112. 3. 对边界不确定的资源,建立 2-3 个候选 bbox,选择能完整覆盖且不多带相邻元素的最大安全框。
  113. 4. 使用 `scripts/preview_bboxes.py` 或等效方式,把 manifest 中的 bbox 画到源图上生成预览图。
  114. 5. 只有当预览框与原图元素完整外框对齐后,才允许切图。
  115. 6. 如果预览框框到了相邻文字、相邻图标、卡片背景大块区域,必须修 bbox。
  116. 7. 如果导出后发现缺失、贴边、白底、灰底,必须回到 bbox 预览步骤重测,不能只在 PNG 上修补。
  117. 8. 如果源图 bbox 很小,预览通过后仍必须高清导出;不要把低像素裁片直接当生产素材。
  118. 交付报告必须包含 bbox 预览图路径或说明已做等效原图框选复核。
  119. ## 图层分类规则
  120. 实现前必须把每个可见元素归类:
  121. - **文本图层**:全部还原为可编辑文本或代码文本。匹配文字内容、字体、字号、字重、行高、字间距、颜色、透明度、对齐方式、换行和精确坐标。
  122. - **简单矢量/规则图形**:矩形、圆形、线条、边框、按钮背景、分割线、简单渐变和简单阴影,转为 CSS/Figma 原生形状或代码。
  123. - **位图/图标切图**:按钮图标、导航图标、功能图标、状态图标、头像、产品图、卡片插画、装饰图、背景素材、不规则复杂图形,全部从当前源图中提取为独立透明 PNG。不得用相似图标、相似插画、CSS 临摹、emoji、字体图标或生成图替代。
  124. - **复杂图表/可视化**:复杂图形整体保留为透明 PNG 图层;图表中的可读文字单独提取为可编辑文本,覆盖在对应位置。
  125. 每个独立图标和位图都必须保持独立图层和独立文件。不得合并、编组导出或做成 sprite,除非用户明确要求。
  126. ## 视觉规格提取
  127. 编码前先为自己写一份简短视觉提取记录:
  128. - 画板尺寸、缩放比例和最终高度
  129. - 页面网格、主要区域、对齐边缘和层级顺序
  130. - 外边距、模块间距、卡片内边距和重复节奏
  131. - 字体、字号、字重、行高、字间距、大小写
  132. - 背景色、文字色、边框色、强调色、阴影色、渐变色
  133. - 图片、图标、插画和背景素材的裁切方式
  134. - 阴影、模糊、透明度、混合模式、圆角和描边
  135. 尽量使用测量工具、截图、图像采样和浏览器计算样式,不要只靠目测。无法获得原字体时,选择最接近的可用字体,并通过字号、字重、行高和间距微调到视觉一致。
  136. ## 布局锁定规则
  137. 布局不允许使用自动流式排版来“复刻大概结构”。必须用 750px 画板坐标系锁定。
  138. - 根画板必须是 `width: 750px`,高度等于归一化高度。
  139. - 画板内所有关键层必须使用 manifest 坐标定位。
  140. - 页面预览时可以整体缩放画板,但不能对子元素重新排版。
  141. - 禁止使用 flex/grid 的自动分布结果替代原图坐标;flex/grid 只能在数值完全等于 manifest 坐标时作为实现手段。
  142. - 顶部头像区、数据区、会员条、四宫格卡片、更多服务、底部导航必须分别和原图同 x/y/width/height。
  143. - 如果截图里出现内容整体上移、下移、卡片变宽、间距变大、头像被裁、底部导航位置变化,直接判定布局失败。
  144. ## 切图计划
  145. 不要把整张设计稿切成一张大图,除非用户明确要求静态位图。文字、按钮、卡片、边框、分割线等应尽量用代码实现。但复杂插画、头像和图标必须从当前源图裁切,不能重绘。
  146. 必须导出独立透明 PNG 的内容:
  147. - 所有图标
  148. - 头像、logo、状态栏图标、底部导航图标
  149. - 产品图、截图、照片
  150. - 卡片内的钱包、礼物、徽章、星星、勾选章、装饰块等复杂插画和不规则装饰图
  151. - 复杂图表、数据可视化和手绘元素
  152. - 纹理、遮罩、复杂阴影或无法稳定用 CSS 复现的图形
  153. - 无法从现有图标库准确还原的 logo 或品牌标识
  154. 不要为这些内容导出切图:
  155. - 普通文字
  156. - 简单按钮、卡片、边框、分割线、标签、输入框
  157. - 简单 CSS 渐变、阴影、圆角矩形或网格背景
  158. - 只有在与原图形状、比例、线宽、端点、圆角和视觉重量完全一致时,才允许用项目现有图标系统复现;否则必须从原图提取 PNG。
  159. 涉及切图时必须阅读 `references/slicing.md`,按其中的命名、格式、透明背景和禁止裁边规则执行。
  160. 优先使用或等效执行 `scripts/extract_png_asset.py` 从源图按 bbox 导出高清 PNG。该脚本不会自动 trim,输出 PNG 文件像素画布等于 `bbox * asset_scale_factor`,页面显示外框仍等于 `scaled_bbox`,可在高清像素画布内移除纯色背景并保留 alpha。
  161. 推荐命令:
  162. ```bash
  163. scripts/extract_png_asset.py source.png assets/icons/icon-home-01.png \
  164. --x 120 --y 88 --width 32 --height 32 \
  165. --scale-factor 3 \
  166. --css-width 32 --css-height 32 \
  167. --remove-bg floodfill \
  168. --manifest layers.manifest.json \
  169. --id icon-home-01
  170. ```
  171. 导出规则:
  172. - 默认 `--scale-factor 2`;小图标、低分辨率源图、边缘脏或放入页面后发糊时用 `3` 或 `4`。
  173. - 背景抠除必须发生在高清像素画布里,不能先把低清图抠干净失败后再直接放大。
  174. - manifest 必须记录 PNG 文件真实像素尺寸和 CSS 显示尺寸;代码显示尺寸必须等于 `scaled_bbox`,不能因为 PNG 是 2x/3x 就把页面位置撑大。
  175. 导出前必须先用 `scripts/preview_bboxes.py` 检查 bbox 区域。没有 bbox 预览校验的切图结果不可信。
  176. ## 禁止近似重绘
  177. 下列行为全部视为失败,即使页面看起来“更规整”或“更清晰”:
  178. - 把原图的小图标换成 lucide、Material Icons、SF Symbols 或其他相似图标。
  179. - 把原图卡片里的钱包、礼盒、徽章、星星、人物头像、状态栏图标重新画成另一套风格。
  180. - 把原图中靠左/靠右/局部露出的插画改成居中、放大、缩小或重新裁切。
  181. - 把四宫格、服务宫格、会员条、底部导航重新排版成更均匀的布局。
  182. - 为了适配代码组件,把原图卡片高度、圆角、间距、文字位置、图片比例改掉。
  183. - 把原图的小装饰图放大成主视觉,或把原图的大图缩小成装饰。
  184. - 用渐变、阴影或 CSS 图形模拟复杂位图,导致形状和原图不一致。
  185. 如果无法精准矢量化或代码化某个复杂元素,必须把该元素从源图按完整外框提取为 PNG,而不是近似重绘。
  186. ## 透明背景硬规则
  187. 凡是 manifest 中 `transparent_required: true` 的资源,最终 PNG 必须有 alpha 通道,并且目标背景必须透明。
  188. - 图标、按钮符号、导航符号、卡片插画、金币/礼物/钱包/人物/装饰图等不规则资源默认都属于 `transparent_required: true`,即使它们原来放在彩色卡片、渐变区或浅色底上。
  189. - PNG 不能带白底、灰底、页面底色或卡片底色,除非该底色是元素本身的一部分。
  190. - 从截图裁切出的白/灰/纯色背景必须抠除,但页面显示画布和构图不能改变;高清 PNG 的文件像素尺寸仍按 `asset_scale_factor` 保留。
  191. - 切图 bbox 必须先覆盖完整元素并额外外扩安全留白,再做背景抠除;不得先抠除再按主体重新裁边。
  192. - 抠除背景后不得 trim,不得重新计算 bbox,不得让主体贴边。
  193. - 本地 `remove-bg corners/floodfill` 或等效抠图仍有白边、灰边、脏底、缺角时,必须使用 image2/imagegen 的图片编辑能力做透明 PNG 背景抠除兜底。
  194. - 使用 image2/imagegen 时必须把当前高清裁片作为编辑目标,只允许移除背景为透明 alpha;禁止重新生成相似图标、相似头像、相似插画或改变主体形状、颜色、比例、角度、阴影、边缘和画布尺寸。
  195. - 交付前必须在棋盘格、黑底、白底上检查透明边缘。只在原页面背景上看不出脏底不算通过。
  196. - 必须运行 `scripts/audit_png_assets.py --require-transparent-bg` 或等效审计检查所有 `transparent_required: true` 的 PNG;如果默认 Python 缺 Pillow/numpy,必须换用可用运行时、安装依赖或用等效脚本重跑,不能跳过。
  197. - 审计中出现 `transparent_bg_ok=false`、`corner_alpha_max` 高于阈值、`has_alpha_channel=false`、或 `touches_edge` 未解释清楚时,必须重出 PNG。典型失败是插画文件四角 alpha 为 255,说明仍带完整矩形背景。
  198. - 如果无法可靠抠除背景,必须说明并保留完整局部裁片作为临时失败态,不能谎称透明切图完成。
  199. ## 防裁切硬规则
  200. 切图宁可画布偏大并保留透明留白,也绝不能裁掉任何一段内容。任何“只截到一段”“边缘缺一块”“阴影/浅色底被削掉”“图标贴边”的结果都判定为失败。
  201. - 切图边界必须来自原图中该元素的完整视觉外框,而不是来自抠图后的深色主体外框。
  202. - 图标包含浅色圆形/八边形底、阴影、光晕、渐变底时,底形属于完整视觉范围,不能被忽略。
  203. - 如果图标主体和浅色底需要拆层,浅色底必须用代码/矢量单独复现,图标 PNG 仍必须保留完整主体和必要透明留白。
  204. - 如果无法稳定判断真实边界,必须向四周扩展安全留白,默认至少 `4px-12px`,而不是缩小裁切框。
  205. - 导出的 PNG 中,任何非透明像素触碰画布四边都必须判定为疑似裁切,必须扩大画布重出。
  206. - 有阴影、模糊、发光、抗锯齿边缘的资源,必须保留完整半透明像素,不能只保留不透明主体。
  207. - 服务宫格、底部导航、功能入口这类图标,必须逐个图标整件导出,不能从图标中间截取局部,也不能只截一个角、一条边或一个内部符号。
  208. - 切图尺寸校验不只看视觉是否像,还必须检查页面显示尺寸是否覆盖原元素完整外框、PNG 文件像素尺寸是否符合 `asset_scale_factor`。
  209. ## 自适应细化硬规则
  210. 750px 基准画板写完后,必须单独做一轮手机端适配;没有 375px 验证的交付视为未完成。
  211. - 750px 坐标系保持锁定:`.artboard` 或等效根画板仍是 `width: 750px`,高度仍是归一化高度。
  212. - 自适应只发生在外层:`scale = min(1, availableWidth / 750)`,其中 `availableWidth` 是容器宽度或视口宽度。
  213. - 手机 App/移动端界面默认全宽适配:在 `320px-430px` 视口内默认 `availableWidth = 100vw`,不要自动减 `16px/32px` 外边距;只有原图本身有外部留白、用户要求嵌入容器,或网页场景需要页面 gutter 时才加 gutter。
  214. - 外层占位尺寸必须同步缩放:wrapper 的实际宽高应等于 `750 * scale` 和 `final_height * scale`,不能让未缩放的 750px 画板撑开页面。
  215. - 禁止用 `min-width: 750px`、固定 `body` 宽度、横向滚动、浏览器缩放、截图缩放或只改 `zoom` 来冒充手机端适配。
  216. - 禁止为了适配 375px 重新排版子元素、改字号、改间距、改坐标或改图层尺寸;子元素仍追溯 manifest 坐标。
  217. - 如果用户明确要求桌面网页式响应式重排,必须先完成 750px 像素版和整体缩放版,再把重排作为额外版本,并在交付说明中标明偏离原图的位置。
  218. - 375px 全宽演示时,渲染宽度应接近 `375px`,缩放比例应接近 `0.5`;如有 gutter,必须在报告里说明实际可用宽度和比例。
  219. ## 代码实现规则
  220. - 首先匹配原图,不做主观优化。
  221. - 在 750px 基准画板中优先使用精确像素坐标和固定尺寸。
  222. - 可以使用绝对定位实现锁定画板,只要更有利于还原。
  223. - 使用 CSS 变量保存提取出的颜色、圆角、间距、字体和阴影 token。
  224. - 保留真实内容层级,不要用说明文字或占位文案替代原内容。
  225. - 不要增加原图不存在的外层卡片、装饰容器或嵌套结构。
  226. - 字间距默认按原图提取;原图没有明显 tracking 时保持 `0`。
  227. - 不要用视口宽度直接缩放字体。
  228. - 交付代码必须有自适应外层,不能只写死 750px。自适应外层只负责整体等比缩放或在更大容器中居中显示,不得对子元素重新排版。
  229. 推荐结构:
  230. ```html
  231. <main class="fit-shell">
  232. <div class="fit-box">
  233. <section class="artboard">...</section>
  234. </div>
  235. </main>
  236. ```
  237. ```css
  238. :root {
  239. --board-w: 750;
  240. --board-h: 1624;
  241. --fit-gutter: 0px;
  242. --board-scale: min(1, calc((100vw - var(--fit-gutter) * 2) / (var(--board-w) * 1px)));
  243. }
  244. .fit-shell {
  245. width: 100%;
  246. display: grid;
  247. place-items: start center;
  248. overflow-x: clip;
  249. }
  250. @media (min-width: 751px) {
  251. .fit-shell {
  252. --fit-gutter: 24px;
  253. }
  254. }
  255. .fit-box {
  256. width: calc(var(--board-w) * 1px * var(--board-scale));
  257. height: calc(var(--board-h) * 1px * var(--board-scale));
  258. overflow: hidden;
  259. }
  260. .artboard {
  261. position: relative;
  262. width: calc(var(--board-w) * 1px);
  263. height: calc(var(--board-h) * 1px);
  264. transform: scale(var(--board-scale));
  265. transform-origin: top left;
  266. }
  267. ```
  268. 如果需要按父容器而不是视口适配,使用 `ResizeObserver` 或项目现有容器测量方式设置 `--board-scale = containerWidth / 750`。无论哪种方式,750px QA 截图时必须让 `--board-scale: 1`。
  269. 如果 CSS 除法在目标浏览器或项目构建链中不稳定,使用一小段 JS 设置缩放变量:
  270. ```js
  271. const root = document.documentElement;
  272. const fitShell = document.querySelector(".fit-shell");
  273. const fit = () => {
  274. const availableWidth = fitShell.getBoundingClientRect().width;
  275. root.style.setProperty("--board-scale", String(Math.min(1, availableWidth / 750)));
  276. };
  277. new ResizeObserver(fit).observe(fitShell);
  278. window.addEventListener("resize", fit);
  279. fit();
  280. ```
  281. ## Figma 可编辑图层导入
  282. 涉及把完成稿导出/导入 Figma 为可编辑图层时,必须阅读 `references/figma-editable-export.md`。这里的“可编辑”指文本是 Figma text node,简单形状是 Figma shape,复杂位图是独立 image fill;禁止把整页截图当作唯一生产图层。
  283. 代码完成并通过 750px/手机端 QA 后,如果用户要求 Figma,必须生成可编辑 Figma 导出物。不要在代码实现前打断用户索取 Figma 链接,除非用户一开始就明确要求直接写入某个 Figma 文件。
  284. 询问模板:
  285. ```text
  286. 代码和切图已经完成。我可以继续导出一个可编辑 Figma 图层版本:优先生成本地 Figma importer;如果你要我直接写入某个 Figma 文件,请提供文件链接并确认我有写入权限。
  287. ```
  288. 执行规则:
  289. 1. 使用 `layers.manifest.json`、完成代码的 computed styles、CSS tokens 和 PNG assets 生成 `figma_layer_spec.json` 或等效 layer spec;不要从最终网页截图重新猜图层。
  290. 2. 默认生成独立本地 Figma importer(例如 `figma-code-import/manifest.json` + `code.js`),把 manifest、样式和 PNG assets 嵌入或打包进去。这个 importer 不依赖任何特定本地插件或本机路径。
  291. 3. 如果当前环境有 Figma MCP/API/token/浏览器权限,并且用户提供目标文件链接,可以用同一份 layer spec 直接写入 Figma。
  292. 4. 如果没有直接写入权限,仍必须交付本地 importer 或 layer spec;不得简单回答“导入不了”。
  293. 5. 在 Figma 中创建 `750px x final_height` frame,按 `z_index` 从低到高创建图层,并保持每个图层的 `id` 或可读名称。
  294. 6. 文本图层创建为 Figma text node;简单矢量/规则图形创建为 Figma shape;位图/图标/头像/复杂插画使用独立高清 PNG image fill,显示尺寸等于 manifest 的 `css_display_width/height`。
  295. 7. 可用整页 QA render 作为隐藏且 locked 的 reference layer,但必须标明不是生产图层,不能覆盖真实可编辑层。
  296. 8. 导入或生成 importer 后检查 frame 尺寸、图层数量、z-index、文本可编辑性、PNG 清晰度和透明边缘。
  297. Figma 导出报告必须包含:Figma 文件链接或本地 importer 路径、目标页面/frame 名称、导入的文本/矢量/PNG 图层数量、替代字体或不可编辑图层限制、是否有 hidden locked reference layer。
  298. ## 验收与复核
  299. 只要能渲染浏览器页面,就必须截图验证:
  300. 1. 启动本地页面或开发服务器。
  301. 2. 截取 750px 画板截图。
  302. 3. 与 750px 归一化原图进行叠图对比。
  303. 4. 分别校验矢量图层、文本图层、位图/图标切图模块。
  304. 5. 将浏览器视口切到 `375px` 宽,截取手机端截图,检查画板是否按比例缩放到可用宽度、没有横向滚动、没有未缩放 750px 内容撑开页面。
  305. 6. 再检查至少一个其他手机宽度,优先 `320px`、`390px`、`414px` 或 `430px` 中最接近用户演示设备的尺寸。
  306. 7. 先修正最大差异:画板尺寸、层级顺序、坐标、宽高、背景、字体大小、手机端缩放比例和横向溢出,再修细节效果。
  307. 8. 重复截图和对比,直到剩余差异都有明确原因。
  308. 必须保留一个 QA 对照方式:可以是半透明底图 overlay、单独对比截图、或差异图。最终生产层不能依赖整页底图,但开发验收必须能证明实现层和源图对齐。
  309. 可以使用 `scripts/compare_images.py` 做快速图片差异指标检查。像素指标只是辅助判断;字体抗锯齿、系统字体替换和浏览器渲染差异可能导致可接受的少量差异。
  310. 切图资源交付前必须运行或等效执行 `scripts/audit_png_assets.py --require-transparent-bg`:检查 PNG 四边是否有非透明像素贴边、是否包含 alpha 透明通道、角落背景是否透明,并在有 manifest 时校验每张 PNG 的真实像素宽高 `asset_pixel_width/height`。任何 `touches_edge`、`transparent_bg_ok=false` 或宽高不一致都必须先修复。若审计脚本因缺 Pillow/numpy 等依赖失败,必须换用可用 Python、安装依赖或写等效审计;依赖失败不能作为跳过透明检查的理由。
  311. 还必须检查透明度:透明 PNG 如果 `has_alpha_channel=false`、背景区域 alpha 不为 0、或在棋盘格上出现白/灰色矩形底,判定失败。
  312. ## 验收标准
  313. - 整体画板宽度必须精确为 `750px`。
  314. - 在 `375px` 手机视口中,页面不得出现横向滚动;`document.documentElement.scrollWidth` 必须小于等于视口宽度加 `1px` 容差。
  315. - 在 `320px-430px` 常见手机宽度中,fit wrapper 必须按可用宽度等比缩放整张 750px 画板,不能露出未缩放的 750px 固定宽内容。
  316. - 矢量形状的坐标、宽高、圆角、描边、渐变、颜色和透明度必须对齐 750px 原图,主观允许误差为 `0px`。
  317. - 文本内容、坐标、字号、字重、行高、字间距、颜色、对齐方式和换行必须对齐原图。
  318. - 每个图标/位图 PNG 的真实像素尺寸必须等于 manifest 的 `asset_pixel_width/height`,页面显示尺寸必须等于对应元素外框 `css_display_width/height`。
  319. - `assets/icons/` 和 `assets/illustrations/` 中的 PNG 除非被明确记录为照片/截图/矩形背景素材,否则必须通过透明背景审计;带完整白底、灰底、页面底色或卡片底色矩形视为失败。
  320. - 放入页面后任一高清 PNG 仍明显发糊,判定失败,必须提高 `asset_scale_factor` 或重新获取更高清源素材。
  321. - 位图/图标必须保留完整透明留白和边缘像素,禁止自动裁边、智能缩边、内容自适应裁剪。
  322. - 位图/图标 PNG 中如有非透明像素贴到画布边缘,默认视为裁切失败,必须扩大边界重出图,除非原图元素本身明确被父容器裁切。
  323. - 任一图标、头像、插画、状态栏、导航图标不是来自当前源图,且与原图形状/比例/风格不完全一致,判定失败。
  324. - 任一卡片插画的位置、大小、露出区域、裁切方式与原图不一致,判定失败。
  325. - 任一模块因为自动排版导致整体坐标、间距、宽高和原图不一致,判定失败。
  326. - 最终页面由切图、矢量和文本拼装后,必须与 750px 原图全覆盖复核,无缺图、无裁切、无错位、无层级错误。
  327. ## 交付说明
  328. 完成后只需要简短说明:
  329. - 修改或新增的代码文件
  330. - 切图资源目录
  331. - 750px 画板尺寸
  332. - `layers.manifest.json`
  333. - bbox 预览图或等效框选复核说明
  334. - 做过哪些截图和模块校验
  335. - 做过哪些手机端宽度校验,尤其是 375px 的实际渲染宽度、缩放比例和横向溢出检查
  336. - `audit_png_assets.py` 或等效 PNG 边缘/尺寸审计结果
  337. - 是否已导出 Figma 可编辑 layer spec/importer;如已直接写入 Figma,提供 Figma 导入报告
  338. - 已知限制,例如缺少原字体、源图像素不足、部分元素被遮挡
  339. 不要写冗长解释。真正的交付证明是代码、切图资源和复核截图。
README.md · README · 461 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Image to Code
  2. `image-to-code` is a Codex skill for turning a selected UI image, screenshot, or Figma export into an adaptive code implementation, high-density transparent PNG assets, and optional editable Figma layer output.
  3. `750px` is the baseline coordinate system used for measurement and QA. It is not the only final display width. The final production output should include a responsive fit wrapper that scales the locked 750px artboard to mobile viewports or embedding containers without reflowing individual layers.
  4. `image-to-code` 是一个用于 Codex 的图片转代码 skill:它把选中的 UI 图片、截图或 Figma 导出稿还原为最终可自适应展示的代码,同时导出 2x/3x/4x 高清透明 PNG 切图资源,并可在后续拆分为可编辑 Figma 图层。
  5. `750px` 是测量、定位和复核用的基准坐标系,不是最终页面唯一显示宽度。最终生产代码必须在保持 750px 基准稿可精确复核的前提下,通过外层 fit wrapper 按手机视口或容器宽度整体等比缩放。
  6. ## Contents
  7. - [中文说明](#中文说明)
  8. - [English Guide](#english-guide)
  9. - [Repository Structure](#repository-structure)
  10. - [License](#license)
  11. ## 中文说明
  12. ### 核心定位
  13. 这个项目不是普通前端模板,也不是“重新设计”工具。它是一套 Codex skill 工作流,用来约束图片转代码任务中的测量、切图、代码、响应式适配、QA 和 Figma 后续导入。
  14. 核心产出包括:
  15. - 自适应前端代码:以 750px 锁定画板为基准,外层整体缩放适配 `320px-430px` 手机宽度、375px 演示宽度或指定容器宽度。
  16. - 独立高清 PNG 资源:图标、头像、插画、复杂装饰、产品图等从当前源图切出,默认 2x,必要时 3x 或 4x。
  17. - `layers.manifest.json`:记录每个图层的源图 bbox、750px 基准 bbox、z-index、资源路径、PNG 像素尺寸和 CSS 显示尺寸。
  18. - 透明背景与防裁切 QA:bbox 预览、PNG alpha 审计、棋盘格/黑底/白底检查、整页截图差异对比。
  19. - 可选 Figma 输出:代码与 QA 完成后,可按同一份 manifest/code/assets 拆成 Figma text node、shape、image fill 和本地 importer。
  20. ### 安装方式
  21. 把整个目录放到 Codex 的 skills 目录:
  22. ```text
  23. ~/.codex/skills/image-to-code
  24. ```
  25. 安装脚本依赖:
  26. ```bash
  27. python3 -m pip install -r requirements.txt
  28. ```
  29. 当前脚本依赖 Pillow 和 NumPy。
  30. ### 如何触发
  31. 在 Codex 中点名 skill:
  32. ```text
  33. 使用 $image-to-code 将当前选中的 UI 图片转换为自适应代码,并导出透明 PNG 切图资源。
  34. ```
  35. 也可以自然描述:
  36. ```text
  37. 把这张移动端设计图还原成 HTML/CSS,最终页面要自适应手机宽度,图标和插画请按 2x/3x 单独切成透明 PNG,后面还要能导入 Figma。
  38. ```
  39. ### 750px 基准与自适应最终产物
  40. `750px` 的作用是建立稳定的设计坐标系:
  41. ```text
  42. scale = 750 / source_width
  43. baseline_width = 750
  44. baseline_height = round(source_height * scale)
  45. scaled_x = source_x * scale
  46. scaled_y = source_y * scale
  47. scaled_width = source_width_of_layer * scale
  48. scaled_height = source_height_of_layer * scale
  49. ```
  50. 同一个缩放比例应用到坐标、宽高、圆角、描边、阴影、字体和渐变位置。这个 750px 版本用于精确复核和截图对比。
  51. 最终页面还必须提供自适应外层:
  52. - `.artboard` 或等效根画板保持 `width: 750px` 和归一化高度。
  53. - 所有子图层继续使用 manifest 中的 750px 基准坐标,不重新排版。
  54. - 外层 wrapper 根据容器或视口计算 `scale = min(1, availableWidth / 750)`。
  55. - wrapper 的实际占位宽高同步缩放,避免未缩放的 750px 内容撑开页面。
  56. - 375px 手机演示时,常见缩放比例约为 `0.5`;还需要检查至少一个其他手机宽度。
  57. 推荐结构:
  58. ```html
  59. <main class="fit-shell">
  60. <div class="fit-box">
  61. <section class="artboard">...</section>
  62. </div>
  63. </main>
  64. ```
  65. ```css
  66. :root {
  67. --board-w: 750;
  68. --board-h: 1624;
  69. --board-scale: min(1, calc(100vw / (var(--board-w) * 1px)));
  70. }
  71. .fit-shell {
  72. width: 100%;
  73. display: grid;
  74. place-items: start center;
  75. overflow-x: clip;
  76. }
  77. .fit-box {
  78. width: calc(var(--board-w) * 1px * var(--board-scale));
  79. height: calc(var(--board-h) * 1px * var(--board-scale));
  80. overflow: hidden;
  81. }
  82. .artboard {
  83. position: relative;
  84. width: calc(var(--board-w) * 1px);
  85. height: calc(var(--board-h) * 1px);
  86. transform: scale(var(--board-scale));
  87. transform-origin: top left;
  88. }
  89. ```
  90. 如果需要按父容器而不是视口适配,可以用 `ResizeObserver` 设置 `--board-scale`。无论哪种方式,750px QA 截图时都应能让缩放比例回到 `1`。
  91. ### 标准工作流程
  92. 1. **检查输入图和项目约束**
  93. 确认源图尺寸、目标技术栈、是否需要代码加切图、哪些文字要可编辑、哪些复杂图形要保留为 PNG、最终展示宽度和是否需要 Figma 输出。
  94. 2. **归一化到 750px 基准画板**
  95. 计算统一缩放比例,建立 `750px x baseline_height` 的 QA 坐标系。
  96. 3. **建立 `layers.manifest.json`**
  97. manifest 是布局、切图、代码和 Figma 导出的共同数据源。不要先写近似页面再补图。
  98. 4. **预览 bbox**
  99. 切图前先在源图上画出每个资源 bbox:
  100. ```bash
  101. scripts/preview_bboxes.py source.png layers.manifest.json qa/bbox-preview.png --only-type bitmap
  102. ```
  103. 5. **按 2x/3x/4x 导出高清 PNG**
  104. 使用 `asset_scale_factor` 放大文件真实像素,同时保持页面 CSS 显示尺寸等于原元素外框。
  105. 6. **实现 750px 锁定画板**
  106. 文本和简单图形尽量代码化,复杂图标/插画/头像/产品图使用独立 PNG 图层。每个关键图层都应能追溯到 manifest。
  107. 7. **增加自适应 fit wrapper**
  108. 在完成 750px 基准稿后单独做手机端适配。适配只发生在外层整体缩放,不改变子元素坐标、字号、间距或尺寸。
  109. 8. **分模块 QA**
  110. 分别检查文本层、矢量/规则图形、PNG 位图/图标资源。
  111. 9. **截图复核**
  112. 截 750px 基准图,与归一化原图对比;再截 375px 和至少一个其他手机宽度,检查无横向滚动、无溢出、无未缩放 750px 内容撑开页面。
  113. 10. **可选导出 Figma**
  114. 代码和 QA 完成后,如果用户要求 Figma,基于 manifest/code/assets 生成可编辑 Figma 图层规格或本地 importer。
  115. ### Manifest 示例
  116. `asset_pixel_width/height` 是 PNG 文件真实像素尺寸;`css_display_width/height` 是页面和 Figma 中显示的尺寸。2x/3x/4x 不会改变布局占位。
  117. ```json
  118. [
  119. {
  120. "id": "icon-home-01",
  121. "type": "bitmap",
  122. "source_bbox": { "x": 120, "y": 88, "width": 32, "height": 32 },
  123. "scaled_bbox": { "x": 120, "y": 88, "width": 32, "height": 32 },
  124. "z_index": 12,
  125. "asset": "assets/icons/icon-home-01.png",
  126. "asset_pixel_width": 96,
  127. "asset_pixel_height": 96,
  128. "asset_scale_factor": 3,
  129. "css_display_width": 32,
  130. "css_display_height": 32,
  131. "transparent_required": true,
  132. "notes": "3x 高清导出,页面仍按 32x32 显示"
  133. },
  134. {
  135. "id": "title-name",
  136. "type": "text",
  137. "text": "橘子果酱",
  138. "source_bbox": { "x": 252, "y": 134, "width": 140, "height": 40 },
  139. "scaled_bbox": { "x": 252, "y": 134, "width": 140, "height": 40 },
  140. "font_size": 32,
  141. "font_weight": 700,
  142. "color": "#07162A",
  143. "z_index": 20
  144. }
  145. ]
  146. ```
  147. ### 高清切图与透明 PNG
  148. 切图的原则是“高清文件、固定显示、透明背景、不裁边”:
  149. - `asset_scale_factor` 默认至少 `2`。
  150. - 小于 `64px` 的图标、源图压缩明显、边缘脏、抠底困难或页面里发糊时用 `3` 或 `4`。
  151. - `asset_pixel_width = css_display_width * asset_scale_factor`。
  152. - `asset_pixel_height = css_display_height * asset_scale_factor`。
  153. - 代码里的 `<img>` 或背景图必须按 `css_display_width/css_display_height` 显示,不能因为 PNG 是 3x 就撑大布局。
  154. - 背景抠除应在高清画布里完成,不能先低清抠图失败后直接放大。
  155. - PNG 不能自动 trim,不能按可见主体缩边,必须保留透明留白和半透明边缘。
  156. - `assets/icons/` 和 `assets/illustrations/` 默认都要求透明背景,除非 manifest 明确说明它是照片、截图或完整矩形背景素材。
  157. 推荐命令:
  158. ```bash
  159. scripts/extract_png_asset.py source.png assets/icons/icon-home-01.png \
  160. --x 120 --y 88 --width 32 --height 32 \
  161. --scale-factor 3 \
  162. --css-width 32 --css-height 32 \
  163. --remove-bg floodfill \
  164. --manifest layers.manifest.json \
  165. --id icon-home-01
  166. ```
  167. 审计 PNG:
  168. ```bash
  169. scripts/audit_png_assets.py assets/icons assets/illustrations assets/images \
  170. --require-transparent-bg \
  171. --manifest layers.manifest.json
  172. ```
  173. 如果审计发现 `has_alpha_channel=false`、`transparent_bg_ok=false`、四角 alpha 不透明、或非透明像素贴边,应扩大 bbox、重新抠图或提升 `asset_scale_factor` 后重出资源。
  174. ### Figma 可编辑图层导入
  175. Figma 输出不是把整页截图导入成一张图。正确做法是在代码和 QA 完成后,基于同一份 `layers.manifest.json`、完成代码的 computed styles、CSS tokens 和 PNG assets 生成可编辑图层规格。
  176. 推荐输出:
  177. ```text
  178. figma-code-import/
  179. ├── manifest.json
  180. ├── code.js
  181. ├── FIGMA_IMPORT_REPORT.json
  182. └── README.md
  183. ```
  184. 图层映射规则:
  185. - Frame:创建 `750 x baseline_height` frame,并保持背景、裁切和层级。
  186. - Text:创建 Figma text node,保留真实文字、字体、字号、行高、字间距、颜色、透明度和位置。
  187. - Simple vector:矩形、圆、线、按钮、卡片、标签、分割线等创建 Figma 原生 shape。
  188. - Bitmap:图标、头像、插画、复杂图表和产品图创建独立 image fill,显示尺寸等于 manifest 的 `css_display_width/height`。
  189. - Reference:可以加入隐藏且锁定的 750px QA render 作为参考层,但它不能替代生产图层。
  190. 导入方式优先级:
  191. 1. 如果当前环境有 Figma MCP/API/浏览器写入权限,并且用户提供目标 Figma 文件链接,可以直接写入目标文件。
  192. 2. 没有直接写入权限时,生成本地 Figma development plugin importer 或 `figma_layer_spec.json`。
  193. 3. 不因为缺少 Figma token 或远端权限就放弃;至少交付本地 importer 或 layer spec。
  194. Figma 报告应包含 frame 名称、文本/矢量/PNG 图层数量、替代字体、不可编辑限制、hidden reference layer 状态,以及本地 importer 路径或 Figma 文件链接。
  195. ### 验收标准
  196. - 最终生产页面有自适应外层,不能只交付固定 750px 页面。
  197. - 750px 基准画板可用作精确 QA,宽度为 `750px`,高度按源图比例计算。
  198. - 375px 及至少一个其他手机宽度下没有横向滚动,`scrollWidth` 不应明显超过视口宽度。
  199. - 所有关键元素位置、大小、层级和样式可追溯到 manifest。
  200. - PNG 文件真实像素尺寸符合 `asset_scale_factor`,页面显示尺寸符合 `css_display_width/height`。
  201. - 透明 PNG 有 alpha 通道,无白底、灰底、页面底色矩形和明显脏边。
  202. - 文本保持可编辑;简单图形使用代码或 Figma 原生 shape;复杂图形使用独立 PNG。
  203. - 如果导出 Figma,文本节点、shape、image fill 和 z-index 顺序都应与 manifest 一致。
  204. ## English Guide
  205. ### Project Purpose
  206. This repository packages a Codex skill for strict image-to-code reconstruction. The final deliverable is not merely a fixed 750px page. The expected production output is an adaptive implementation backed by a locked 750px QA baseline, high-density sliced assets, and optional editable Figma layer export.
  207. Primary outputs:
  208. - Adaptive frontend code with a 750px locked artboard scaled by an outer fit wrapper.
  209. - Independent transparent PNG assets exported at 2x, 3x, or 4x density while keeping CSS display sizes fixed.
  210. - `layers.manifest.json` as the source of truth for layout, slicing, QA, and Figma export.
  211. - bbox previews, PNG transparency audits, mobile screenshots, and image comparison QA.
  212. - Optional Figma layer spec or local importer that creates editable text, shapes, and image fills.
  213. ### Installation
  214. Place the repository directory in your Codex skills folder:
  215. ```text
  216. ~/.codex/skills/image-to-code
  217. ```
  218. Install dependencies:
  219. ```bash
  220. python3 -m pip install -r requirements.txt
  221. ```
  222. The helper scripts use Pillow and NumPy.
  223. ### How to Use It
  224. Trigger the skill explicitly:
  225. ```text
  226. Use $image-to-code to convert the selected UI image into adaptive code and transparent PNG assets.
  227. ```
  228. Natural-language example:
  229. ```text
  230. Convert this mobile UI screenshot into responsive HTML/CSS, export the icons and illustrations as 2x/3x transparent PNGs, and keep the output ready for a later Figma import.
  231. ```
  232. ### 750px Baseline vs Adaptive Output
  233. The `750px` canvas is the measurement and QA coordinate system:
  234. ```text
  235. scale = 750 / source_width
  236. baseline_width = 750
  237. baseline_height = round(source_height * scale)
  238. ```
  239. All layer coordinates, sizes, radii, strokes, shadows, gradients, and typography measurements use the same scale. The production page then wraps this locked artboard in a fit layer:
  240. - The `.artboard` stays `width: 750px`.
  241. - Children keep manifest coordinates and do not reflow.
  242. - The outer wrapper computes `scale = min(1, availableWidth / 750)`.
  243. - The wrapper's occupied width and height scale with the visual output.
  244. - Mobile QA should include 375px and at least one other common width.
  245. ### Workflow
  246. 1. Inspect the source image, framework, output needs, editable text, bitmap layers, responsive constraints, and Figma requirements.
  247. 2. Normalize the source to a 750px baseline canvas.
  248. 3. Create `layers.manifest.json` before coding.
  249. 4. Preview bbox overlays on the source image.
  250. 5. Export high-density transparent PNG assets at 2x/3x/4x.
  251. 6. Build the locked 750px artboard using manifest coordinates.
  252. 7. Add the adaptive fit wrapper.
  253. 8. QA text, vector/shape, and bitmap/icon layers separately.
  254. 9. Capture and compare the 750px render, then verify 375px and another mobile width.
  255. 10. If requested, generate an editable Figma layer spec or local importer from the same manifest/code/assets.
  256. ### High-Density PNG Slicing
  257. The PNG file resolution can be higher than the on-page display size:
  258. - Use `asset_scale_factor: 2` by default.
  259. - Use `3` or `4` for small icons, compressed sources, blurry results, or difficult background removal.
  260. - `asset_pixel_width = css_display_width * asset_scale_factor`.
  261. - `asset_pixel_height = css_display_height * asset_scale_factor`.
  262. - CSS display dimensions remain equal to the manifest layer bbox.
  263. - Do not trim the PNG after background removal.
  264. - Keep transparent padding, antialiasing, shadows, and semi-transparent edges.
  265. Example:
  266. ```bash
  267. scripts/extract_png_asset.py source.png assets/icons/icon-home-01.png \
  268. --x 120 --y 88 --width 32 --height 32 \
  269. --scale-factor 3 \
  270. --css-width 32 --css-height 32 \
  271. --remove-bg floodfill \
  272. --manifest layers.manifest.json \
  273. --id icon-home-01
  274. ```
  275. Audit assets:
  276. ```bash
  277. scripts/audit_png_assets.py assets/icons assets/illustrations assets/images \
  278. --require-transparent-bg \
  279. --manifest layers.manifest.json
  280. ```
  281. ### Figma Editable Export
  282. Figma output should be created from `layers.manifest.json`, computed styles, CSS tokens, and PNG assets. Do not import the final page as a single screenshot.
  283. Recommended local output:
  284. ```text
  285. figma-code-import/
  286. ├── manifest.json
  287. ├── code.js
  288. ├── FIGMA_IMPORT_REPORT.json
  289. └── README.md
  290. ```
  291. Layer mapping:
  292. - Frame: `750 x baseline_height`.
  293. - Text: editable Figma text nodes.
  294. - Simple vectors: native Figma rectangles, ellipses, lines, buttons, dividers, and cards.
  295. - Bitmaps: independent image fills displayed at `css_display_width/height`.
  296. - Reference: optional hidden locked 750px render for QA only.
  297. If Figma API/MCP/browser write access is available and the user provides a target file, the same layer spec can be written directly. Otherwise, the skill should still deliver a local Figma importer or `figma_layer_spec.json`.
  298. ### Acceptance Criteria
  299. - The production output includes responsive scaling, not only a fixed 750px page.
  300. - The 750px baseline remains available for exact QA.
  301. - 375px and at least one other mobile width render without horizontal overflow.
  302. - Layer coordinates, dimensions, stacking, and styles trace back to the manifest.
  303. - PNG real pixel sizes match `asset_scale_factor`; CSS display sizes match the layer bbox.
  304. - Transparent PNGs have alpha, clean edges, no white/gray/page-background rectangle, and no clipping.
  305. - Figma exports use editable text nodes, native shapes where possible, independent image fills, and correct z-index order.
  306. ## Repository Structure
  307. ```text
  308. image-to-code/
  309. ├── SKILL.md
  310. ├── README.md
  311. ├── LICENSE
  312. ├── requirements.txt
  313. ├── agents/
  314. │ └── openai.yaml
  315. ├── references/
  316. │ ├── figma-editable-export.md
  317. │ └── slicing.md
  318. └── scripts/
  319. ├── audit_png_assets.py
  320. ├── compare_images.py
  321. ├── extract_png_asset.py
  322. └── preview_bboxes.py
  323. ```
  324. Key files:
  325. - `SKILL.md`: the full workflow Codex loads when this skill is triggered.
  326. - `references/slicing.md`: detailed bbox, high-density PNG, transparency, and anti-clipping rules.
  327. - `references/figma-editable-export.md`: Figma layer spec and importer guidance.
  328. - `scripts/preview_bboxes.py`: draws bbox overlays on the source image.
  329. - `scripts/extract_png_asset.py`: exports exact-bbox PNG assets at 2x/3x/4x density.
  330. - `scripts/audit_png_assets.py`: audits PNG alpha, transparent backgrounds, edge clipping, and manifest dimensions.
  331. - `scripts/compare_images.py`: compares a rendered screenshot with the reference.
  332. ## 鸣谢
  333. 学AI, 上L站![LINUX DO](https://linux.do/)
  334. ## License
  335. This project is released under the MIT License. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.