image-to-code
像素级 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.
Badge for your README
Markdown
[](/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
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)
- ---
- 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,就把原图自动改造成项目现有组件样式。
- - 如果没有源图局部切图能力,宁可保留完整局部裁片作为临时素材并说明限制,也不要用“看起来差不多”的替代图重画。
- ## 执行流程
- 1. 检查输入图片和项目约束。
- 2. 把原图等比归一化到 750px 宽度。
- 3. 建立 `layers.manifest.json`:记录每个图层的原图 bbox、缩放后 bbox、类型、z-index、导出文件名。
- 4. 为每个 bitmap/icon 资源确定 `asset_scale_factor`,默认 `2`,小图标、低分辨率源图或抠边脏时用 `3` 或 `4`。
- 5. 先按 manifest 导出高清切图资源,再写代码。禁止先凭感觉写代码再补切图。
- 6. 对所有 icon/illustration/复杂位图默认要求透明 PNG;本地背景抠除不干净、审计失败或棋盘格/黑底/白底预览仍有脏底时,必须使用 image2/imagegen 做透明 PNG 背景抠除兜底,并保持页面显示外框、构图和主体位置不变。
- 7. 在 750px 基准画板中使用 manifest 的精确坐标实现代码。
- 8. 完成 750px 基准代码后,进入自适应细化阶段:加外层 fit wrapper,按容器或视口整体缩放 750px 画板,不得对子元素重新排版。
- 9. 分模块校验:矢量、文本、位图/图标切图分别验收。
- 10. 做整页 750px 叠图复核,并做 375px 手机宽度和至少一个其他手机宽度的自适应截图。
- 11. 根据具体错位、缺图、裁切、样式差异或手机端溢出继续迭代。
- 12. 交付代码、高清切图资源、manifest 和简短还原报告。
- 13. 代码和 QA 完成后,若用户要求 Figma 或需要继续交付,按同一份 manifest/code/assets 导出可编辑 Figma 图层规格或本地 Figma importer;只有需要直接写入远端 Figma 文件时,才索取 Figma 链接和写入权限。
- ## 输入检查
- 开始前先确认:
- - 原图尺寸和宽高比
- - 目标类型:网页、移动端界面、组件、海报、邮件、游戏 UI 或静态 HTML
- - 是否已有项目框架和技术栈
- - 是否要求只输出代码、只输出切图,还是代码加切图
- - 哪些文字必须变成可编辑文本
- - 哪些复杂图形需要保留为透明 PNG
- - 是否有明确的响应式断点、最大宽度、嵌入容器或移动端/桌面端展示要求
- 如果仓库已有框架,遵循现有框架。没有项目时,静态页面优先使用 HTML/CSS/JS;只有在组件结构或交互确实需要时才使用 React/Vite。
- ## 750px 等比归一化
- 假设原图尺寸为 `source_width x source_height`:
- ```text
- 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 是布局和切图的唯一数据源,不允许在代码里重新估算位置。
- 每个图层至少记录:
- ```json
- {
- "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。
- 流程:
- 1. 在原图原始尺寸上测量 `source_bbox`,不要在浏览器缩放预览图上估算。
- 2. bbox 必须覆盖完整元素外框,包括透明留白、浅色底形、阴影、半透明边缘和被遮挡但可见的外缘。
- 3. 对边界不确定的资源,建立 2-3 个候选 bbox,选择能完整覆盖且不多带相邻元素的最大安全框。
- 4. 使用 `scripts/preview_bboxes.py` 或等效方式,把 manifest 中的 bbox 画到源图上生成预览图。
- 5. 只有当预览框与原图元素完整外框对齐后,才允许切图。
- 6. 如果预览框框到了相邻文字、相邻图标、卡片背景大块区域,必须修 bbox。
- 7. 如果导出后发现缺失、贴边、白底、灰底,必须回到 bbox 预览步骤重测,不能只在 PNG 上修补。
- 8. 如果源图 bbox 很小,预览通过后仍必须高清导出;不要把低像素裁片直接当生产素材。
- 交付报告必须包含 bbox 预览图路径或说明已做等效原图框选复核。
- ## 图层分类规则
- 实现前必须把每个可见元素归类:
- - **文本图层**:全部还原为可编辑文本或代码文本。匹配文字内容、字体、字号、字重、行高、字间距、颜色、透明度、对齐方式、换行和精确坐标。
- - **简单矢量/规则图形**:矩形、圆形、线条、边框、按钮背景、分割线、简单渐变和简单阴影,转为 CSS/Figma 原生形状或代码。
- - **位图/图标切图**:按钮图标、导航图标、功能图标、状态图标、头像、产品图、卡片插画、装饰图、背景素材、不规则复杂图形,全部从当前源图中提取为独立透明 PNG。不得用相似图标、相似插画、CSS 临摹、emoji、字体图标或生成图替代。
- - **复杂图表/可视化**:复杂图形整体保留为透明 PNG 图层;图表中的可读文字单独提取为可编辑文本,覆盖在对应位置。
- 每个独立图标和位图都必须保持独立图层和独立文件。不得合并、编组导出或做成 sprite,除非用户明确要求。
- ## 视觉规格提取
- 编码前先为自己写一份简短视觉提取记录:
- - 画板尺寸、缩放比例和最终高度
- - 页面网格、主要区域、对齐边缘和层级顺序
- - 外边距、模块间距、卡片内边距和重复节奏
- - 字体、字号、字重、行高、字间距、大小写
- - 背景色、文字色、边框色、强调色、阴影色、渐变色
- - 图片、图标、插画和背景素材的裁切方式
- - 阴影、模糊、透明度、混合模式、圆角和描边
- 尽量使用测量工具、截图、图像采样和浏览器计算样式,不要只靠目测。无法获得原字体时,选择最接近的可用字体,并通过字号、字重、行高和间距微调到视觉一致。
- ## 布局锁定规则
- 布局不允许使用自动流式排版来“复刻大概结构”。必须用 750px 画板坐标系锁定。
- - 根画板必须是 `width: 750px`,高度等于归一化高度。
- - 画板内所有关键层必须使用 manifest 坐标定位。
- - 页面预览时可以整体缩放画板,但不能对子元素重新排版。
- - 禁止使用 flex/grid 的自动分布结果替代原图坐标;flex/grid 只能在数值完全等于 manifest 坐标时作为实现手段。
- - 顶部头像区、数据区、会员条、四宫格卡片、更多服务、底部导航必须分别和原图同 x/y/width/height。
- - 如果截图里出现内容整体上移、下移、卡片变宽、间距变大、头像被裁、底部导航位置变化,直接判定布局失败。
- ## 切图计划
- 不要把整张设计稿切成一张大图,除非用户明确要求静态位图。文字、按钮、卡片、边框、分割线等应尽量用代码实现。但复杂插画、头像和图标必须从当前源图裁切,不能重绘。
- 必须导出独立透明 PNG 的内容:
- - 所有图标
- - 头像、logo、状态栏图标、底部导航图标
- - 产品图、截图、照片
- - 卡片内的钱包、礼物、徽章、星星、勾选章、装饰块等复杂插画和不规则装饰图
- - 复杂图表、数据可视化和手绘元素
- - 纹理、遮罩、复杂阴影或无法稳定用 CSS 复现的图形
- - 无法从现有图标库准确还原的 logo 或品牌标识
- 不要为这些内容导出切图:
- - 普通文字
- - 简单按钮、卡片、边框、分割线、标签、输入框
- - 简单 CSS 渐变、阴影、圆角矩形或网格背景
- - 只有在与原图形状、比例、线宽、端点、圆角和视觉重量完全一致时,才允许用项目现有图标系统复现;否则必须从原图提取 PNG。
- 涉及切图时必须阅读 `references/slicing.md`,按其中的命名、格式、透明背景和禁止裁边规则执行。
- 优先使用或等效执行 `scripts/extract_png_asset.py` 从源图按 bbox 导出高清 PNG。该脚本不会自动 trim,输出 PNG 文件像素画布等于 `bbox * asset_scale_factor`,页面显示外框仍等于 `scaled_bbox`,可在高清像素画布内移除纯色背景并保留 alpha。
- 推荐命令:
- ```bash
- scripts/extract_png_asset.py source.png assets/icons/icon-home-01.png \
- --x 120 --y 88 --width 32 --height 32 \
- --scale-factor 3 \
- --css-width 32 --css-height 32 \
- --remove-bg floodfill \
- --manifest layers.manifest.json \
- --id icon-home-01
- ```
- 导出规则:
- - 默认 `--scale-factor 2`;小图标、低分辨率源图、边缘脏或放入页面后发糊时用 `3` 或 `4`。
- - 背景抠除必须发生在高清像素画布里,不能先把低清图抠干净失败后再直接放大。
- - manifest 必须记录 PNG 文件真实像素尺寸和 CSS 显示尺寸;代码显示尺寸必须等于 `scaled_bbox`,不能因为 PNG 是 2x/3x 就把页面位置撑大。
- 导出前必须先用 `scripts/preview_bboxes.py` 检查 bbox 区域。没有 bbox 预览校验的切图结果不可信。
- ## 禁止近似重绘
- 下列行为全部视为失败,即使页面看起来“更规整”或“更清晰”:
- - 把原图的小图标换成 lucide、Material Icons、SF Symbols 或其他相似图标。
- - 把原图卡片里的钱包、礼盒、徽章、星星、人物头像、状态栏图标重新画成另一套风格。
- - 把原图中靠左/靠右/局部露出的插画改成居中、放大、缩小或重新裁切。
- - 把四宫格、服务宫格、会员条、底部导航重新排版成更均匀的布局。
- - 为了适配代码组件,把原图卡片高度、圆角、间距、文字位置、图片比例改掉。
- - 把原图的小装饰图放大成主视觉,或把原图的大图缩小成装饰。
- - 用渐变、阴影或 CSS 图形模拟复杂位图,导致形状和原图不一致。
- 如果无法精准矢量化或代码化某个复杂元素,必须把该元素从源图按完整外框提取为 PNG,而不是近似重绘。
- ## 透明背景硬规则
- 凡是 manifest 中 `transparent_required: true` 的资源,最终 PNG 必须有 alpha 通道,并且目标背景必须透明。
- - 图标、按钮符号、导航符号、卡片插画、金币/礼物/钱包/人物/装饰图等不规则资源默认都属于 `transparent_required: true`,即使它们原来放在彩色卡片、渐变区或浅色底上。
- - PNG 不能带白底、灰底、页面底色或卡片底色,除非该底色是元素本身的一部分。
- - 从截图裁切出的白/灰/纯色背景必须抠除,但页面显示画布和构图不能改变;高清 PNG 的文件像素尺寸仍按 `asset_scale_factor` 保留。
- - 切图 bbox 必须先覆盖完整元素并额外外扩安全留白,再做背景抠除;不得先抠除再按主体重新裁边。
- - 抠除背景后不得 trim,不得重新计算 bbox,不得让主体贴边。
- - 本地 `remove-bg corners/floodfill` 或等效抠图仍有白边、灰边、脏底、缺角时,必须使用 image2/imagegen 的图片编辑能力做透明 PNG 背景抠除兜底。
- - 使用 image2/imagegen 时必须把当前高清裁片作为编辑目标,只允许移除背景为透明 alpha;禁止重新生成相似图标、相似头像、相似插画或改变主体形状、颜色、比例、角度、阴影、边缘和画布尺寸。
- - 交付前必须在棋盘格、黑底、白底上检查透明边缘。只在原页面背景上看不出脏底不算通过。
- - 必须运行 `scripts/audit_png_assets.py --require-transparent-bg` 或等效审计检查所有 `transparent_required: true` 的 PNG;如果默认 Python 缺 Pillow/numpy,必须换用可用运行时、安装依赖或用等效脚本重跑,不能跳过。
- - 审计中出现 `transparent_bg_ok=false`、`corner_alpha_max` 高于阈值、`has_alpha_channel=false`、或 `touches_edge` 未解释清楚时,必须重出 PNG。典型失败是插画文件四角 alpha 为 255,说明仍带完整矩形背景。
- - 如果无法可靠抠除背景,必须说明并保留完整局部裁片作为临时失败态,不能谎称透明切图完成。
- ## 防裁切硬规则
- 切图宁可画布偏大并保留透明留白,也绝不能裁掉任何一段内容。任何“只截到一段”“边缘缺一块”“阴影/浅色底被削掉”“图标贴边”的结果都判定为失败。
- - 切图边界必须来自原图中该元素的完整视觉外框,而不是来自抠图后的深色主体外框。
- - 图标包含浅色圆形/八边形底、阴影、光晕、渐变底时,底形属于完整视觉范围,不能被忽略。
- - 如果图标主体和浅色底需要拆层,浅色底必须用代码/矢量单独复现,图标 PNG 仍必须保留完整主体和必要透明留白。
- - 如果无法稳定判断真实边界,必须向四周扩展安全留白,默认至少 `4px-12px`,而不是缩小裁切框。
- - 导出的 PNG 中,任何非透明像素触碰画布四边都必须判定为疑似裁切,必须扩大画布重出。
- - 有阴影、模糊、发光、抗锯齿边缘的资源,必须保留完整半透明像素,不能只保留不透明主体。
- - 服务宫格、底部导航、功能入口这类图标,必须逐个图标整件导出,不能从图标中间截取局部,也不能只截一个角、一条边或一个内部符号。
- - 切图尺寸校验不只看视觉是否像,还必须检查页面显示尺寸是否覆盖原元素完整外框、PNG 文件像素尺寸是否符合 `asset_scale_factor`。
- ## 自适应细化硬规则
- 750px 基准画板写完后,必须单独做一轮手机端适配;没有 375px 验证的交付视为未完成。
- - 750px 坐标系保持锁定:`.artboard` 或等效根画板仍是 `width: 750px`,高度仍是归一化高度。
- - 自适应只发生在外层:`scale = min(1, availableWidth / 750)`,其中 `availableWidth` 是容器宽度或视口宽度。
- - 手机 App/移动端界面默认全宽适配:在 `320px-430px` 视口内默认 `availableWidth = 100vw`,不要自动减 `16px/32px` 外边距;只有原图本身有外部留白、用户要求嵌入容器,或网页场景需要页面 gutter 时才加 gutter。
- - 外层占位尺寸必须同步缩放:wrapper 的实际宽高应等于 `750 * scale` 和 `final_height * scale`,不能让未缩放的 750px 画板撑开页面。
- - 禁止用 `min-width: 750px`、固定 `body` 宽度、横向滚动、浏览器缩放、截图缩放或只改 `zoom` 来冒充手机端适配。
- - 禁止为了适配 375px 重新排版子元素、改字号、改间距、改坐标或改图层尺寸;子元素仍追溯 manifest 坐标。
- - 如果用户明确要求桌面网页式响应式重排,必须先完成 750px 像素版和整体缩放版,再把重排作为额外版本,并在交付说明中标明偏离原图的位置。
- - 375px 全宽演示时,渲染宽度应接近 `375px`,缩放比例应接近 `0.5`;如有 gutter,必须在报告里说明实际可用宽度和比例。
- ## 代码实现规则
- - 首先匹配原图,不做主观优化。
- - 在 750px 基准画板中优先使用精确像素坐标和固定尺寸。
- - 可以使用绝对定位实现锁定画板,只要更有利于还原。
- - 使用 CSS 变量保存提取出的颜色、圆角、间距、字体和阴影 token。
- - 保留真实内容层级,不要用说明文字或占位文案替代原内容。
- - 不要增加原图不存在的外层卡片、装饰容器或嵌套结构。
- - 字间距默认按原图提取;原图没有明显 tracking 时保持 `0`。
- - 不要用视口宽度直接缩放字体。
- - 交付代码必须有自适应外层,不能只写死 750px。自适应外层只负责整体等比缩放或在更大容器中居中显示,不得对子元素重新排版。
- 推荐结构:
- ```html
- <main class="fit-shell">
- <div class="fit-box">
- <section class="artboard">...</section>
- </div>
- </main>
- ```
- ```css
- :root {
- --board-w: 750;
- --board-h: 1624;
- --fit-gutter: 0px;
- --board-scale: min(1, calc((100vw - var(--fit-gutter) * 2) / (var(--board-w) * 1px)));
- }
- .fit-shell {
- width: 100%;
- display: grid;
- place-items: start center;
- overflow-x: clip;
- }
- @media (min-width: 751px) {
- .fit-shell {
- --fit-gutter: 24px;
- }
- }
- .fit-box {
- width: calc(var(--board-w) * 1px * var(--board-scale));
- height: calc(var(--board-h) * 1px * var(--board-scale));
- overflow: hidden;
- }
- .artboard {
- position: relative;
- width: calc(var(--board-w) * 1px);
- height: calc(var(--board-h) * 1px);
- transform: scale(var(--board-scale));
- transform-origin: top left;
- }
- ```
- 如果需要按父容器而不是视口适配,使用 `ResizeObserver` 或项目现有容器测量方式设置 `--board-scale = containerWidth / 750`。无论哪种方式,750px QA 截图时必须让 `--board-scale: 1`。
- 如果 CSS 除法在目标浏览器或项目构建链中不稳定,使用一小段 JS 设置缩放变量:
- ```js
- const root = document.documentElement;
- const fitShell = document.querySelector(".fit-shell");
- const fit = () => {
- const availableWidth = fitShell.getBoundingClientRect().width;
- root.style.setProperty("--board-scale", String(Math.min(1, availableWidth / 750)));
- };
- new ResizeObserver(fit).observe(fitShell);
- window.addEventListener("resize", fit);
- fit();
- ```
- ## Figma 可编辑图层导入
- 涉及把完成稿导出/导入 Figma 为可编辑图层时,必须阅读 `references/figma-editable-export.md`。这里的“可编辑”指文本是 Figma text node,简单形状是 Figma shape,复杂位图是独立 image fill;禁止把整页截图当作唯一生产图层。
- 代码完成并通过 750px/手机端 QA 后,如果用户要求 Figma,必须生成可编辑 Figma 导出物。不要在代码实现前打断用户索取 Figma 链接,除非用户一开始就明确要求直接写入某个 Figma 文件。
- 询问模板:
- ```text
- 代码和切图已经完成。我可以继续导出一个可编辑 Figma 图层版本:优先生成本地 Figma importer;如果你要我直接写入某个 Figma 文件,请提供文件链接并确认我有写入权限。
- ```
- 执行规则:
- 1. 使用 `layers.manifest.json`、完成代码的 computed styles、CSS tokens 和 PNG assets 生成 `figma_layer_spec.json` 或等效 layer spec;不要从最终网页截图重新猜图层。
- 2. 默认生成独立本地 Figma importer(例如 `figma-code-import/manifest.json` + `code.js`),把 manifest、样式和 PNG assets 嵌入或打包进去。这个 importer 不依赖任何特定本地插件或本机路径。
- 3. 如果当前环境有 Figma MCP/API/token/浏览器权限,并且用户提供目标文件链接,可以用同一份 layer spec 直接写入 Figma。
- 4. 如果没有直接写入权限,仍必须交付本地 importer 或 layer spec;不得简单回答“导入不了”。
- 5. 在 Figma 中创建 `750px x final_height` frame,按 `z_index` 从低到高创建图层,并保持每个图层的 `id` 或可读名称。
- 6. 文本图层创建为 Figma text node;简单矢量/规则图形创建为 Figma shape;位图/图标/头像/复杂插画使用独立高清 PNG image fill,显示尺寸等于 manifest 的 `css_display_width/height`。
- 7. 可用整页 QA render 作为隐藏且 locked 的 reference layer,但必须标明不是生产图层,不能覆盖真实可编辑层。
- 8. 导入或生成 importer 后检查 frame 尺寸、图层数量、z-index、文本可编辑性、PNG 清晰度和透明边缘。
- Figma 导出报告必须包含:Figma 文件链接或本地 importer 路径、目标页面/frame 名称、导入的文本/矢量/PNG 图层数量、替代字体或不可编辑图层限制、是否有 hidden locked reference layer。
- ## 验收与复核
- 只要能渲染浏览器页面,就必须截图验证:
- 1. 启动本地页面或开发服务器。
- 2. 截取 750px 画板截图。
- 3. 与 750px 归一化原图进行叠图对比。
- 4. 分别校验矢量图层、文本图层、位图/图标切图模块。
- 5. 将浏览器视口切到 `375px` 宽,截取手机端截图,检查画板是否按比例缩放到可用宽度、没有横向滚动、没有未缩放 750px 内容撑开页面。
- 6. 再检查至少一个其他手机宽度,优先 `320px`、`390px`、`414px` 或 `430px` 中最接近用户演示设备的尺寸。
- 7. 先修正最大差异:画板尺寸、层级顺序、坐标、宽高、背景、字体大小、手机端缩放比例和横向溢出,再修细节效果。
- 8. 重复截图和对比,直到剩余差异都有明确原因。
- 必须保留一个 QA 对照方式:可以是半透明底图 overlay、单独对比截图、或差异图。最终生产层不能依赖整页底图,但开发验收必须能证明实现层和源图对齐。
- 可以使用 `scripts/compare_images.py` 做快速图片差异指标检查。像素指标只是辅助判断;字体抗锯齿、系统字体替换和浏览器渲染差异可能导致可接受的少量差异。
- 切图资源交付前必须运行或等效执行 `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、安装依赖或写等效审计;依赖失败不能作为跳过透明检查的理由。
- 还必须检查透明度:透明 PNG 如果 `has_alpha_channel=false`、背景区域 alpha 不为 0、或在棋盘格上出现白/灰色矩形底,判定失败。
- ## 验收标准
- - 整体画板宽度必须精确为 `750px`。
- - 在 `375px` 手机视口中,页面不得出现横向滚动;`document.documentElement.scrollWidth` 必须小于等于视口宽度加 `1px` 容差。
- - 在 `320px-430px` 常见手机宽度中,fit wrapper 必须按可用宽度等比缩放整张 750px 画板,不能露出未缩放的 750px 固定宽内容。
- - 矢量形状的坐标、宽高、圆角、描边、渐变、颜色和透明度必须对齐 750px 原图,主观允许误差为 `0px`。
- - 文本内容、坐标、字号、字重、行高、字间距、颜色、对齐方式和换行必须对齐原图。
- - 每个图标/位图 PNG 的真实像素尺寸必须等于 manifest 的 `asset_pixel_width/height`,页面显示尺寸必须等于对应元素外框 `css_display_width/height`。
- - `assets/icons/` 和 `assets/illustrations/` 中的 PNG 除非被明确记录为照片/截图/矩形背景素材,否则必须通过透明背景审计;带完整白底、灰底、页面底色或卡片底色矩形视为失败。
- - 放入页面后任一高清 PNG 仍明显发糊,判定失败,必须提高 `asset_scale_factor` 或重新获取更高清源素材。
- - 位图/图标必须保留完整透明留白和边缘像素,禁止自动裁边、智能缩边、内容自适应裁剪。
- - 位图/图标 PNG 中如有非透明像素贴到画布边缘,默认视为裁切失败,必须扩大边界重出图,除非原图元素本身明确被父容器裁切。
- - 任一图标、头像、插画、状态栏、导航图标不是来自当前源图,且与原图形状/比例/风格不完全一致,判定失败。
- - 任一卡片插画的位置、大小、露出区域、裁切方式与原图不一致,判定失败。
- - 任一模块因为自动排版导致整体坐标、间距、宽高和原图不一致,判定失败。
- - 最终页面由切图、矢量和文本拼装后,必须与 750px 原图全覆盖复核,无缺图、无裁切、无错位、无层级错误。
- ## 交付说明
- 完成后只需要简短说明:
- - 修改或新增的代码文件
- - 切图资源目录
- - 750px 画板尺寸
- - `layers.manifest.json`
- - bbox 预览图或等效框选复核说明
- - 做过哪些截图和模块校验
- - 做过哪些手机端宽度校验,尤其是 375px 的实际渲染宽度、缩放比例和横向溢出检查
- - `audit_png_assets.py` 或等效 PNG 边缘/尺寸审计结果
- - 是否已导出 Figma 可编辑 layer spec/importer;如已直接写入 Figma,提供 Figma 导入报告
- - 已知限制,例如缺少原字体、源图像素不足、部分元素被遮挡
- 不要写冗长解释。真正的交付证明是代码、切图资源和复核截图。
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)
- # Image to Code
- `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.
- `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.
- `image-to-code` 是一个用于 Codex 的图片转代码 skill:它把选中的 UI 图片、截图或 Figma 导出稿还原为最终可自适应展示的代码,同时导出 2x/3x/4x 高清透明 PNG 切图资源,并可在后续拆分为可编辑 Figma 图层。
- `750px` 是测量、定位和复核用的基准坐标系,不是最终页面唯一显示宽度。最终生产代码必须在保持 750px 基准稿可精确复核的前提下,通过外层 fit wrapper 按手机视口或容器宽度整体等比缩放。
- ## Contents
- - [中文说明](#中文说明)
- - [English Guide](#english-guide)
- - [Repository Structure](#repository-structure)
- - [License](#license)
- ## 中文说明
- ### 核心定位
- 这个项目不是普通前端模板,也不是“重新设计”工具。它是一套 Codex skill 工作流,用来约束图片转代码任务中的测量、切图、代码、响应式适配、QA 和 Figma 后续导入。
- 核心产出包括:
- - 自适应前端代码:以 750px 锁定画板为基准,外层整体缩放适配 `320px-430px` 手机宽度、375px 演示宽度或指定容器宽度。
- - 独立高清 PNG 资源:图标、头像、插画、复杂装饰、产品图等从当前源图切出,默认 2x,必要时 3x 或 4x。
- - `layers.manifest.json`:记录每个图层的源图 bbox、750px 基准 bbox、z-index、资源路径、PNG 像素尺寸和 CSS 显示尺寸。
- - 透明背景与防裁切 QA:bbox 预览、PNG alpha 审计、棋盘格/黑底/白底检查、整页截图差异对比。
- - 可选 Figma 输出:代码与 QA 完成后,可按同一份 manifest/code/assets 拆成 Figma text node、shape、image fill 和本地 importer。
- ### 安装方式
- 把整个目录放到 Codex 的 skills 目录:
- ```text
- ~/.codex/skills/image-to-code
- ```
- 安装脚本依赖:
- ```bash
- python3 -m pip install -r requirements.txt
- ```
- 当前脚本依赖 Pillow 和 NumPy。
- ### 如何触发
- 在 Codex 中点名 skill:
- ```text
- 使用 $image-to-code 将当前选中的 UI 图片转换为自适应代码,并导出透明 PNG 切图资源。
- ```
- 也可以自然描述:
- ```text
- 把这张移动端设计图还原成 HTML/CSS,最终页面要自适应手机宽度,图标和插画请按 2x/3x 单独切成透明 PNG,后面还要能导入 Figma。
- ```
- ### 750px 基准与自适应最终产物
- `750px` 的作用是建立稳定的设计坐标系:
- ```text
- scale = 750 / source_width
- baseline_width = 750
- baseline_height = round(source_height * scale)
- scaled_x = source_x * scale
- scaled_y = source_y * scale
- scaled_width = source_width_of_layer * scale
- scaled_height = source_height_of_layer * scale
- ```
- 同一个缩放比例应用到坐标、宽高、圆角、描边、阴影、字体和渐变位置。这个 750px 版本用于精确复核和截图对比。
- 最终页面还必须提供自适应外层:
- - `.artboard` 或等效根画板保持 `width: 750px` 和归一化高度。
- - 所有子图层继续使用 manifest 中的 750px 基准坐标,不重新排版。
- - 外层 wrapper 根据容器或视口计算 `scale = min(1, availableWidth / 750)`。
- - wrapper 的实际占位宽高同步缩放,避免未缩放的 750px 内容撑开页面。
- - 375px 手机演示时,常见缩放比例约为 `0.5`;还需要检查至少一个其他手机宽度。
- 推荐结构:
- ```html
- <main class="fit-shell">
- <div class="fit-box">
- <section class="artboard">...</section>
- </div>
- </main>
- ```
- ```css
- :root {
- --board-w: 750;
- --board-h: 1624;
- --board-scale: min(1, calc(100vw / (var(--board-w) * 1px)));
- }
- .fit-shell {
- width: 100%;
- display: grid;
- place-items: start center;
- overflow-x: clip;
- }
- .fit-box {
- width: calc(var(--board-w) * 1px * var(--board-scale));
- height: calc(var(--board-h) * 1px * var(--board-scale));
- overflow: hidden;
- }
- .artboard {
- position: relative;
- width: calc(var(--board-w) * 1px);
- height: calc(var(--board-h) * 1px);
- transform: scale(var(--board-scale));
- transform-origin: top left;
- }
- ```
- 如果需要按父容器而不是视口适配,可以用 `ResizeObserver` 设置 `--board-scale`。无论哪种方式,750px QA 截图时都应能让缩放比例回到 `1`。
- ### 标准工作流程
- 1. **检查输入图和项目约束**
- 确认源图尺寸、目标技术栈、是否需要代码加切图、哪些文字要可编辑、哪些复杂图形要保留为 PNG、最终展示宽度和是否需要 Figma 输出。
- 2. **归一化到 750px 基准画板**
- 计算统一缩放比例,建立 `750px x baseline_height` 的 QA 坐标系。
- 3. **建立 `layers.manifest.json`**
- manifest 是布局、切图、代码和 Figma 导出的共同数据源。不要先写近似页面再补图。
- 4. **预览 bbox**
- 切图前先在源图上画出每个资源 bbox:
- ```bash
- scripts/preview_bboxes.py source.png layers.manifest.json qa/bbox-preview.png --only-type bitmap
- ```
- 5. **按 2x/3x/4x 导出高清 PNG**
- 使用 `asset_scale_factor` 放大文件真实像素,同时保持页面 CSS 显示尺寸等于原元素外框。
- 6. **实现 750px 锁定画板**
- 文本和简单图形尽量代码化,复杂图标/插画/头像/产品图使用独立 PNG 图层。每个关键图层都应能追溯到 manifest。
- 7. **增加自适应 fit wrapper**
- 在完成 750px 基准稿后单独做手机端适配。适配只发生在外层整体缩放,不改变子元素坐标、字号、间距或尺寸。
- 8. **分模块 QA**
- 分别检查文本层、矢量/规则图形、PNG 位图/图标资源。
- 9. **截图复核**
- 截 750px 基准图,与归一化原图对比;再截 375px 和至少一个其他手机宽度,检查无横向滚动、无溢出、无未缩放 750px 内容撑开页面。
- 10. **可选导出 Figma**
- 代码和 QA 完成后,如果用户要求 Figma,基于 manifest/code/assets 生成可编辑 Figma 图层规格或本地 importer。
- ### Manifest 示例
- `asset_pixel_width/height` 是 PNG 文件真实像素尺寸;`css_display_width/height` 是页面和 Figma 中显示的尺寸。2x/3x/4x 不会改变布局占位。
- ```json
- [
- {
- "id": "icon-home-01",
- "type": "bitmap",
- "source_bbox": { "x": 120, "y": 88, "width": 32, "height": 32 },
- "scaled_bbox": { "x": 120, "y": 88, "width": 32, "height": 32 },
- "z_index": 12,
- "asset": "assets/icons/icon-home-01.png",
- "asset_pixel_width": 96,
- "asset_pixel_height": 96,
- "asset_scale_factor": 3,
- "css_display_width": 32,
- "css_display_height": 32,
- "transparent_required": true,
- "notes": "3x 高清导出,页面仍按 32x32 显示"
- },
- {
- "id": "title-name",
- "type": "text",
- "text": "橘子果酱",
- "source_bbox": { "x": 252, "y": 134, "width": 140, "height": 40 },
- "scaled_bbox": { "x": 252, "y": 134, "width": 140, "height": 40 },
- "font_size": 32,
- "font_weight": 700,
- "color": "#07162A",
- "z_index": 20
- }
- ]
- ```
- ### 高清切图与透明 PNG
- 切图的原则是“高清文件、固定显示、透明背景、不裁边”:
- - `asset_scale_factor` 默认至少 `2`。
- - 小于 `64px` 的图标、源图压缩明显、边缘脏、抠底困难或页面里发糊时用 `3` 或 `4`。
- - `asset_pixel_width = css_display_width * asset_scale_factor`。
- - `asset_pixel_height = css_display_height * asset_scale_factor`。
- - 代码里的 `<img>` 或背景图必须按 `css_display_width/css_display_height` 显示,不能因为 PNG 是 3x 就撑大布局。
- - 背景抠除应在高清画布里完成,不能先低清抠图失败后直接放大。
- - PNG 不能自动 trim,不能按可见主体缩边,必须保留透明留白和半透明边缘。
- - `assets/icons/` 和 `assets/illustrations/` 默认都要求透明背景,除非 manifest 明确说明它是照片、截图或完整矩形背景素材。
- 推荐命令:
- ```bash
- scripts/extract_png_asset.py source.png assets/icons/icon-home-01.png \
- --x 120 --y 88 --width 32 --height 32 \
- --scale-factor 3 \
- --css-width 32 --css-height 32 \
- --remove-bg floodfill \
- --manifest layers.manifest.json \
- --id icon-home-01
- ```
- 审计 PNG:
- ```bash
- scripts/audit_png_assets.py assets/icons assets/illustrations assets/images \
- --require-transparent-bg \
- --manifest layers.manifest.json
- ```
- 如果审计发现 `has_alpha_channel=false`、`transparent_bg_ok=false`、四角 alpha 不透明、或非透明像素贴边,应扩大 bbox、重新抠图或提升 `asset_scale_factor` 后重出资源。
- ### Figma 可编辑图层导入
- Figma 输出不是把整页截图导入成一张图。正确做法是在代码和 QA 完成后,基于同一份 `layers.manifest.json`、完成代码的 computed styles、CSS tokens 和 PNG assets 生成可编辑图层规格。
- 推荐输出:
- ```text
- figma-code-import/
- ├── manifest.json
- ├── code.js
- ├── FIGMA_IMPORT_REPORT.json
- └── README.md
- ```
- 图层映射规则:
- - Frame:创建 `750 x baseline_height` frame,并保持背景、裁切和层级。
- - Text:创建 Figma text node,保留真实文字、字体、字号、行高、字间距、颜色、透明度和位置。
- - Simple vector:矩形、圆、线、按钮、卡片、标签、分割线等创建 Figma 原生 shape。
- - Bitmap:图标、头像、插画、复杂图表和产品图创建独立 image fill,显示尺寸等于 manifest 的 `css_display_width/height`。
- - Reference:可以加入隐藏且锁定的 750px QA render 作为参考层,但它不能替代生产图层。
- 导入方式优先级:
- 1. 如果当前环境有 Figma MCP/API/浏览器写入权限,并且用户提供目标 Figma 文件链接,可以直接写入目标文件。
- 2. 没有直接写入权限时,生成本地 Figma development plugin importer 或 `figma_layer_spec.json`。
- 3. 不因为缺少 Figma token 或远端权限就放弃;至少交付本地 importer 或 layer spec。
- Figma 报告应包含 frame 名称、文本/矢量/PNG 图层数量、替代字体、不可编辑限制、hidden reference layer 状态,以及本地 importer 路径或 Figma 文件链接。
- ### 验收标准
- - 最终生产页面有自适应外层,不能只交付固定 750px 页面。
- - 750px 基准画板可用作精确 QA,宽度为 `750px`,高度按源图比例计算。
- - 375px 及至少一个其他手机宽度下没有横向滚动,`scrollWidth` 不应明显超过视口宽度。
- - 所有关键元素位置、大小、层级和样式可追溯到 manifest。
- - PNG 文件真实像素尺寸符合 `asset_scale_factor`,页面显示尺寸符合 `css_display_width/height`。
- - 透明 PNG 有 alpha 通道,无白底、灰底、页面底色矩形和明显脏边。
- - 文本保持可编辑;简单图形使用代码或 Figma 原生 shape;复杂图形使用独立 PNG。
- - 如果导出 Figma,文本节点、shape、image fill 和 z-index 顺序都应与 manifest 一致。
- ## English Guide
- ### Project Purpose
- 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.
- Primary outputs:
- - Adaptive frontend code with a 750px locked artboard scaled by an outer fit wrapper.
- - Independent transparent PNG assets exported at 2x, 3x, or 4x density while keeping CSS display sizes fixed.
- - `layers.manifest.json` as the source of truth for layout, slicing, QA, and Figma export.
- - bbox previews, PNG transparency audits, mobile screenshots, and image comparison QA.
- - Optional Figma layer spec or local importer that creates editable text, shapes, and image fills.
- ### Installation
- Place the repository directory in your Codex skills folder:
- ```text
- ~/.codex/skills/image-to-code
- ```
- Install dependencies:
- ```bash
- python3 -m pip install -r requirements.txt
- ```
- The helper scripts use Pillow and NumPy.
- ### How to Use It
- Trigger the skill explicitly:
- ```text
- Use $image-to-code to convert the selected UI image into adaptive code and transparent PNG assets.
- ```
- Natural-language example:
- ```text
- 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.
- ```
- ### 750px Baseline vs Adaptive Output
- The `750px` canvas is the measurement and QA coordinate system:
- ```text
- scale = 750 / source_width
- baseline_width = 750
- baseline_height = round(source_height * scale)
- ```
- 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:
- - The `.artboard` stays `width: 750px`.
- - Children keep manifest coordinates and do not reflow.
- - The outer wrapper computes `scale = min(1, availableWidth / 750)`.
- - The wrapper's occupied width and height scale with the visual output.
- - Mobile QA should include 375px and at least one other common width.
- ### Workflow
- 1. Inspect the source image, framework, output needs, editable text, bitmap layers, responsive constraints, and Figma requirements.
- 2. Normalize the source to a 750px baseline canvas.
- 3. Create `layers.manifest.json` before coding.
- 4. Preview bbox overlays on the source image.
- 5. Export high-density transparent PNG assets at 2x/3x/4x.
- 6. Build the locked 750px artboard using manifest coordinates.
- 7. Add the adaptive fit wrapper.
- 8. QA text, vector/shape, and bitmap/icon layers separately.
- 9. Capture and compare the 750px render, then verify 375px and another mobile width.
- 10. If requested, generate an editable Figma layer spec or local importer from the same manifest/code/assets.
- ### High-Density PNG Slicing
- The PNG file resolution can be higher than the on-page display size:
- - Use `asset_scale_factor: 2` by default.
- - Use `3` or `4` for small icons, compressed sources, blurry results, or difficult background removal.
- - `asset_pixel_width = css_display_width * asset_scale_factor`.
- - `asset_pixel_height = css_display_height * asset_scale_factor`.
- - CSS display dimensions remain equal to the manifest layer bbox.
- - Do not trim the PNG after background removal.
- - Keep transparent padding, antialiasing, shadows, and semi-transparent edges.
- Example:
- ```bash
- scripts/extract_png_asset.py source.png assets/icons/icon-home-01.png \
- --x 120 --y 88 --width 32 --height 32 \
- --scale-factor 3 \
- --css-width 32 --css-height 32 \
- --remove-bg floodfill \
- --manifest layers.manifest.json \
- --id icon-home-01
- ```
- Audit assets:
- ```bash
- scripts/audit_png_assets.py assets/icons assets/illustrations assets/images \
- --require-transparent-bg \
- --manifest layers.manifest.json
- ```
- ### Figma Editable Export
- 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.
- Recommended local output:
- ```text
- figma-code-import/
- ├── manifest.json
- ├── code.js
- ├── FIGMA_IMPORT_REPORT.json
- └── README.md
- ```
- Layer mapping:
- - Frame: `750 x baseline_height`.
- - Text: editable Figma text nodes.
- - Simple vectors: native Figma rectangles, ellipses, lines, buttons, dividers, and cards.
- - Bitmaps: independent image fills displayed at `css_display_width/height`.
- - Reference: optional hidden locked 750px render for QA only.
- 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`.
- ### Acceptance Criteria
- - The production output includes responsive scaling, not only a fixed 750px page.
- - The 750px baseline remains available for exact QA.
- - 375px and at least one other mobile width render without horizontal overflow.
- - Layer coordinates, dimensions, stacking, and styles trace back to the manifest.
- - PNG real pixel sizes match `asset_scale_factor`; CSS display sizes match the layer bbox.
- - Transparent PNGs have alpha, clean edges, no white/gray/page-background rectangle, and no clipping.
- - Figma exports use editable text nodes, native shapes where possible, independent image fills, and correct z-index order.
- ## Repository Structure
- ```text
- image-to-code/
- ├── SKILL.md
- ├── README.md
- ├── LICENSE
- ├── requirements.txt
- ├── agents/
- │ └── openai.yaml
- ├── references/
- │ ├── figma-editable-export.md
- │ └── slicing.md
- └── scripts/
- ├── audit_png_assets.py
- ├── compare_images.py
- ├── extract_png_asset.py
- └── preview_bboxes.py
- ```
- Key files:
- - `SKILL.md`: the full workflow Codex loads when this skill is triggered.
- - `references/slicing.md`: detailed bbox, high-density PNG, transparency, and anti-clipping rules.
- - `references/figma-editable-export.md`: Figma layer spec and importer guidance.
- - `scripts/preview_bboxes.py`: draws bbox overlays on the source image.
- - `scripts/extract_png_asset.py`: exports exact-bbox PNG assets at 2x/3x/4x density.
- - `scripts/audit_png_assets.py`: audits PNG alpha, transparent backgrounds, edge clipping, and manifest dimensions.
- - `scripts/compare_images.py`: compares a rendered screenshot with the reference.
- ## 鸣谢
- 学AI, 上L站
- ## License
- This project is released under the MIT License. See [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.