Image To Code
Codex skill for 750px image-to-code reconstruction and transparent PNG slicing
yuzhworkhard-wq · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add yuzhworkhard-wq/image-to-code技能说明
name: image-to-code description: 像素级 750px 图片转代码与高清切图工作流。当 Codex 需要把当前选中的 UI 图片、截图、App/Web 设计稿、Figma 图片导出稿或设计长图转换为代码,并输出独立透明 PNG 切图资源时使用。适用于严格 1:1 等比例还原、画板宽度精确 750px、高清放大切图、防模糊和背景抠除、必要时用 image2/imagegen 抠透明 PNG、文本可编辑、简单图形原生矢量/代码化,最终代码需要自适应适配,或需要把完成稿导出/导入 Figma 为可编辑图层的任务。
Image To Code
目标
把用户提供或当前选中的 UI 图片还原为代码,并导出必要的独立高清切图资源。
原图就是视觉合同。不要把它重新设计成“更合理”的界面,不要做排版优化,不要主观调整间距。必须先按 750px 宽度等比归一化,再按原图元素的位置、比例、层级、颜色、透明度和样式进行还原。
750px 是设计基准坐标,不是最终页面的唯一显示宽度。生产代码必须在保持 750px 基准稿不变的前提下提供自适应缩放;切图资源必须有足够像素密度,不能因为源 bbox 小而在页面里发糊。高清切图只提高 PNG 文件真实像素,不改变它在页面里的位置和显示大小。
最高优先级规则
当用户要求“严格等比例缩放至画板宽度精确 750px”时,这条规则高于所有常规前端、设计和响应式建议。
- 整体画板宽度必须精确为
750px。 - 画板高度必须根据原图宽高比自动计算,不能人为设定或优化。
- 所有元素必须使用同一个全局缩放比例。
- 保持所有元素的相对位置、相对大小、层级关系、堆叠顺序、颜色、透明度、阴影、渐变、圆角、描边和样式属性。
- 禁止自动调整任何元素的位置、大小、对齐、间距、排版或视觉层级。
- 禁止重新设计、优化布局、合并独立元素、拉伸素材、改变颜色或简化效果。
- 禁止把图标或位图强行转换为矢量路径。
- 禁止使用相似图标库、相似插画、AI 生成图、CSS 临摹图或占位素材替代原图中的图标/位图。
- 禁止自动创建 Figma/export 的 Slice 对象。只有在需要切图资源时,才按元素边界导出独立 PNG 文件。
- 如果代码优雅性和视觉还原发生冲突,视觉还原优先。
- 750px 基准稿必须可精确复核;生产页面必须同时提供按容器/视口等比缩放的自适应版本。
跨目录调用一致性
无论用户在哪个项目文件夹调用本 skill,都必须只以本次用户提供/选中的原图为视觉源。不要沿用其他会话、其他文件夹、旧示例或历史任务里的结构、素材、配色、页面区域和实现假设。
- 每次调用都必须重新读取当前源图尺寸。
- 每次调用都必须重新测量当前源图元素坐标。
- 每次调用都必须重新建立当前源图的图层分类表。
- 不得复用旧项目里的图标、插画、头像、卡片素材或布局参数,除非用户明确指定这些就是源素材。
- 不得因为当前项目已有组件或 CSS,就把原图自动改造成项目现有组件样式。
- 如果没有源图局部切图能力,宁可保留完整局部裁片作为临时素材并说明限制,也不要用“看起来差不多”的替代图重画。
执行流程
- 检查输入图片和项目约束。
- 把原图等比归一化到 750px 宽度。
- 建立
layers.manifest.json:记录每个图层的原图 bbox、缩放后 bbox、类型、z-index、导出文件名。 - 为每个 bitmap/icon 资源确定
asset_scale_factor,默认2,小图标、低分辨率源图或抠边脏时用3或4。 - 先按 manifest 导出高清切图资源,再写代码。禁止先凭感觉写代码再补切图。
- 对所有 icon/illustration/复杂位图默认要求透明 PNG;本地背景抠除不干净、审计失败或棋盘格/黑底/白底预览仍有脏底时,必须使用 image2/imagegen 做透明 PNG 背景抠除兜底,并保持页面显示外框、构图和主体位置不变。
- 在 750px 基准画板中使用 manifest 的精确坐标实现代码。
- 完成 750px 基准代码后,进入自适应细化阶段:加外层 fit wrapper,按容器或视口整体缩放 750px 画板,不得对子元素重新排版。
- 分模块校验:矢量、文本、位图/图标切图分别验收。
- 做整页 750px 叠图复核,并做 375px 手机宽度和至少一个其他手机宽度的自适应截图。
- 根据具体错位、缺图、裁切、样式差异或手机端溢出继续迭代。
- 交付代码、高清切图资源、manifest 和简短还原报告。
- 代码和 QA 完成后,若用户要求 Figma 或需要继续交付,按同一份 manifest/code/assets 导出可编辑 Figma 图层规格或本地 Figma importer;只有需要直接写入远端 Figma 文件时,才索取 Figma 链接和写入权限。
输入检查
开始前先确认:
- 原图尺寸和宽高比
- 目标类型:网页、移动端界面、组件、海报、邮件、游戏 UI 或静态 HTML
- 是否已有项目框架和技术栈
- 是否要求只输出代码、只输出切图,还是代码加切图
- 哪些文字必须变成可编辑文本
- 哪些复杂图形需要保留为透明 PNG
- 是否有明确的响应式断点、最大宽度、嵌入容器或移动端/桌面端展示要求
如果仓库已有框架,遵循现有框架。没有项目时,静态页面优先使用 HTML/CSS/JS;只有在组件结构或交互确实需要时才使用 React/Vite。
750px 等比归一化
假设原图尺寸为 source_width x source_height:
scale = 750 / source_width
final_width = 750
final_height = round(source_height * scale)
scaled_x = original_x * scale
scaled_y = original_y * scale
scaled_width = original_width * scale
scaled_height = original_height * scale
同一个 scale 必须应用到:
- 所有坐标
- 所有宽高
- 所有圆角
- 所有描边
- 所有阴影偏移和模糊
- 所有渐变位置
- 所有图标和位图外框
- 所有文字字号、行高和字间距
主交付物是锁定的 750px 定稿画板。响应式规则不能影响 750px 版本的坐标、比例和叠图复核。最终代码必须在 750px 基准外再提供自适应缩放层。
强制 Manifest
任何图片转代码 + 切图任务都必须先创建 manifest。manifest 是布局和切图的唯一数据源,不允许在代码里重新估算位置。
每个图层至少记录:
{
"id": "card-wallet-illustration",
"type": "bitmap",
"source_bbox": { "x": 338, "y": 520, "width": 116, "height": 122 },
"scaled_bbox": { "x": 338, "y": 520, "width": 116, "height": 122 },
"z_index": 24,
"asset": "assets/illustrations/card-wallet-illustration.png",
"asset_pixel_width": 232,
"asset_pixel_height": 244,
"asset_scale_factor": 2,
"css_display_width": 116,
"css_display_height": 122,
"transparent_required": true,
"notes": "从当前源图裁切,保持原图露出比例"
}
规则:
source_bbox必须来自当前源图测量,不得凭布局推算。scaled_bbox必须由同一个scale计算得到。- bitmap/icon 的
asset_pixel_width/height可以高于scaled_bbox.width/height,但代码里的css_display_width/height必须等于scaled_bbox尺寸。也就是文件分辨率 2x/3x,页面占位仍是原元素外框大小。 asset_scale_factor = asset_pixel_width / css_display_width。默认至少2;小于64px的图标、源图压缩明显、边缘脏或放入页面后发糊时使用3或4。- 代码中的每个图片层、文本层、矢量层都必须能追溯到 manifest。
- 如果实现截图和原图不一致,先修 manifest 坐标,再修代码。
- 没有 manifest 的交付视为未完成。
assets/icons/、assets/illustrations/、卡片插画、导航图标、按钮图标、状态图标和不规则装饰图默认transparent_required: true。不得因为抠图困难、背景和卡片颜色接近、或本地脚本抠除失败就把它改成false。- 只有照片、真实产品图、截图、纹理背景、完整矩形 banner 或背景本身就是视觉内容的位图,才允许
transparent_required: false,并必须在notes里说明为什么保留矩形背景。 - 如果某个 PNG 的四角 alpha 不为 0、棋盘格上出现白/灰/页面底色矩形、或
audit_png_assets.py --require-transparent-bg失败,manifest 必须保持transparent_required: true,并重出资源;不能通过改 manifest 跳过验收。
Bbox 测量和预览
切图区域不能凭感觉。每个需要导出的资源必须先完成 bbox 预览校验,再导出 PNG。
流程:
- 在原图原始尺寸上测量
source_bbox,不要在浏览器缩放预览图上估算。 - bbox 必须覆盖完整元素外框,包括透明留白、浅色底形、阴影、半透明边缘和被遮挡但可见的外缘。
- 对边界不确定的资源,建立 2-3 个候选 bbox,选择能完整覆盖且不多带相邻元素的最大安全框。
- 使用
scripts/preview_bboxes.py或等效方式,把 manifest 中的 bbox 画到源图上生成预览图。 - 只有当预览框与原图元素完整外框对齐后,才允许切图。
- 如果预览框框到了相邻文字、相邻图标、卡片背景大块区域,必须修 bbox。
- 如果导出后发现缺失、贴边、白底、灰底,必须回到 bbox 预览步骤重测,不能只在 PNG 上修补。
- 如果源图 bbox 很小,预览通过后仍必须高清导出;不要把低像素裁片直接当生产素材。
交付报告必须包含 bbox 预览图路径或说明已做等效原图框选复核。
图层分类规则
实现前必须把每个可见元素归类:
- 文本图层:全部还原为可编辑文本或代码文本。匹配文字内容、字体、字号、字重、行高、字间距、颜色、透明度、对齐方式、换行和精确坐标。
- 简单矢量/规则图形:矩形、圆形、线条、边框、按钮背景、分割线、简单渐变和简单阴影,转为 CSS/Figma 原生形状或代码。
- 位图/图标切图:按钮图标、导航图标、功能图标、状态图标、头像、产品图、卡片插画、装饰图、背景素材、不规则复杂图形,全部从当前源图中提取为独立透明 PNG。不得用相似图标、相似插画、CSS 临摹、emoji、字体图标或生成图替代。
- 复杂图表/可视化:复杂图形整体保留为透明 PNG 图层;图表中的可读文字单独提取为可编辑文本,覆盖在对应位置。
每个独立图标和位图都必须保持独立图层和独立文件。不得合并、编组导出或做成 sprite,除非用户明确要求。
视觉规格提取
编码前先为自己写一份简短视觉提取记录:
- 画板尺寸、缩放比例和最终高度
- 页面网格、主要区域、对齐边缘和层级顺序
- 外边距、模块间距、卡片内边距和重复节奏
- 字体、字号、字重、行高、字间距、大小写
- 背景色、文字色、边框色、强调色、阴影色、渐变色
- 图片、图标、插画和背景素材的裁切方式
- 阴影、模糊、透明度、混合模式、圆角和描边
尽量使用测量工具、截图、图像采样和浏览器计算样式,不要只靠目测。无法获得原字体时,选择最接近的可用字体,并通过字号、字重、行高和间距微调到视觉一致。
布局锁定规则
布局不允许使用自动流式排版来“复刻大概结构”。必须用 750px 画板坐标系锁定。
- 根画板必须是
width: 750px,高度等于归一化高度。 - 画板内所有关键层必须使用 manifest 坐标定位。
- 页面预览时可以整体缩放画板,但不能对子元素重新排版。
- 禁止使用 flex/grid 的自动分布结果替代原图坐标;flex/grid 只能在数值完全等于 manifest 坐标时作为实现手段。
- 顶部头像区、数据区、会员条、四宫格卡片、更多服务、底部导航必须分别和原图同 x/y/width/height。
- 如果截图里出现内容整体上移、下移、卡片变宽、间距变大、头像被裁、底部导航位置变化,直接判定布局失败。
切图计划
不要把整张设计稿切成一张大图,除非用户明确要求静态位图。文字、按钮、卡片、边框、分割线等应尽量用代码实现。但复杂插画、头像和图标必须从当前源图裁切,不能重绘。
必须导出独立透明 PNG 的内容:
- 所有图标
- 头像、logo、状态栏图标、底部导航图标
- 产品图、截图、照片
- 卡片内的钱包、礼物、徽章、星星、勾选章、装饰块等复杂插画和不规则