跳转到使用指南
Image to UI作者 UIZZE

Image to UI Skill.

实现你已经看到的界面。Image to UI 将截图或设计稿视为视觉规范,沿用项目现有技术栈,并要求你的智能体在声称还原一致之前先渲染并对比。

  • 截图转代码
  • 参考图还原
  • 界面实现
来源审阅 · image-to-uiSKILL.md
任务 截图还原为界面 产出 • 现有项目中的界面代码 • 真实的文本和控件,而不是用一张截图代替界面 • 附带剩余差异的对比摘要 开始之前 请提供清晰可读的参考图、目标视口、项目访问权限和可用素材。需要浏览器渲染来验证视觉是否一致。无需 UIZZE 账号或 MCP 连接。
编辑摘要 · 来源审阅于 2026-10-12 · 非生成的示例

01 功能介绍

以参考图为实现依据

这个简短的技能专注于还原既定设计,而不是探索新的视觉方向。下方工作流基于源码整理,并非一次已完成的还原记录。

基于来源的工作流并非执行基准测试

工作方式

智能体先从实际图像入手:尺寸、可见文案、层级、比例和素材。它也会阅读目标项目,使实现贴合现有框架和页面。裁剪过的截图只界定可见区域,不代表可以随意臆造页面的其余部分。

实现时使用真实的布局、文本和控件。匹配参考视口后,智能体会检查其他要求的尺寸。最后一步是按参考图尺寸渲染,等待字体和图片加载完成,对比结果并修正可见差异。缺失的素材和未经验证的渲染情况必须明确说明。

预期交付物

  • 使用目标项目技术栈、并合理复用组件的可编辑界面代码
  • 将所需控件接入现有行为,而不虚构后端功能
  • 简要说明实际进行的视觉对比、剩余差异和缺失的素材
查看示例需求

从参考图到对比

  1. 01
    检查实际图像

    阅读图像本身,而不只是文件名或提取的文本。在修改代码之前,先确定其尺寸、可见区域、对齐方式、字体排印和素材。

  2. 02
    按参考尺寸构建

    在现有技术栈中匹配层级、换行、间距和裁剪。组件能够还原参考图时就复用它们,不要强行套用不相关的默认样式。

  3. 03
    渲染并修正

    在相同视口下截取运行中的页面。先对比整体布局和比例差异,再对比字体排印、颜色和细节;修改后再次渲染。

  4. 04
    检查所需的变体

    确定参考尺寸后,测试所要求的响应式尺寸和可用控件。如实报告剩余差异,而不是承诺像素级完美还原。

02 适用场景

适用场景

当视觉方向已经确定、需要忠实实现时,请选择 Image to UI。

适合的情况

  • 已批准的页面设计稿把提供的设计图变成现有应用中的页面,保留可见的层级和内容。
  • 基于截图的重建在没有原始设计文件时还原参考图,并明确指出缺失的字体或图片。
  • 针对性的视觉修正利用同视口截图和剩余差异清单,让实现更接近已知的参考图。

需要注意的限制

  • 截图无法定义隐藏的行为看不到的区域、后端响应和其他页面不在参考图范围内。请为它们提供需求,而不要指望该技能自行推断产品。
  • 可能缺少精确素材该技能要求披露缺失的字体、图标或图片。如果所需素材不可用,它无法确保视觉完全一致。
  • 还原度需要渲染证据看似合理的实现或构建成功,并不能证明相似。如果环境无法渲染页面,视觉一致性就仍未得到验证。

请准备这些输入

  • 清晰的参考图和视口附上实际图像并说明目标浏览器尺寸。请标明图像是否为裁剪图,以及需要实现哪个区域。
  • 现有项目和素材指明目标路由或组件、框架、字体、图标和图片文件。指出必须保留的现有组件或行为。
  • 交互和响应式要求列出需要接入的控件和需要支持的其他宽度。说明截图没有展示的内容,以及哪些内容不在本次实现范围内。

03 关键决策

关键决策

  1. 先匹配,再谈重新设计

    图像决定配色、构图和可见内容。添加装饰或采用不同的设计方向,需要另行提出。

  2. 重建界面,而非位图

    常规的 grid 和 flex 布局、真实文本和可用控件能保持界面可编辑。绝对定位仅用于真正的叠层,而不是整个页面。

  3. 在相同条件下对比

    视口尺寸一致且素材已加载,对比才有意义。文档规定的修正顺序是先处理比例和布局,再打磨细节。

04 从一个具体需求开始

从一个具体需求开始

下面的示例尚未执行。使用前请附上你的参考图,并调整项目细节。

检查设置

上游 README 记录了下面的安装命令。它安装的是 GitHub 原生的 Image to UI 包,而不是可选的 UIZZE MCP 服务。

文档记录的安装命令
npx skills add uizze/uizze --skill image-to-ui

请使用能够查看图像并编辑项目的智能体。在浏览器中运行项目以进行视觉验证。该技能本身不需要 UIZZE 账号或 MCP 连接;你的项目和智能体仍有各自的设置要求。

附上一个页面

首个任务应限定在一个可见页面或一块裁剪区域。请包含图像、精确素材以及应用已支持的交互。

示例需求
使用 image-to-ui 在现有应用中实现所附的账单页面参考图。先查看图像和项目,如果目标路由和参考视口不明确,请与我确认。匹配可见的文案、层级、间距、换行和图片裁剪,不要重新设计。使用提供的字体和素材;列出缺失的内容,而不是悄悄替换。保留现有的支付和发票行为,不要虚构 API 响应或看不到的区域。在参考视口下渲染,等待字体和图片加载完成,与提供的图像对比,并先修正最大的差异。然后检查 390 px 和 320 px 宽度,保持原有视觉风格。报告实际对比过的截图、检查过的控件和剩余差异。

查看渲染结果

先在相同视口下对比,再评估响应式变体。同时检查可见设计和所要求的控件。

  • 参考图与渲染截图使用相同视口,且字体和图片已加载。
  • 可见内容和比例与图像一致;缺失的素材或有意的差异均已说明。
  • 所要求的控件保留真实行为,指定的窄屏布局仍然可用。

OpenDesign 为编码智能体提供本地设计工作区。此列表并不意味着该技能已内置,也不意味着其外部工具、凭据和软件依赖已包含在内。

05 来源与许可证

来源与许可证

本页描述的是下方链接所指向的固定来源版本。上游的行为和要求可能会变化。

来源所有者
UIZZE
已审阅的快照
2026-10-12 · 146928eb50bc
编辑性来源摘要
Image to UI 是一个简短的截图还原工作流:查看图像和项目,在现有技术栈中实现可见界面,然后按参考视口渲染并修正差异。这是编辑撰写的摘要,并非报告的测试运行结果。

由 OpenDesign 根据所链接的来源撰写的原创摘要。MIT 许可证仅适用于该技能目录;仓库中的其他包可能有不同的声明。仓库 Star 数不是安装量。

06 开始之前的常见问题

开始之前的常见问题

Image to UI 需要付费的 UIZZE MCP 吗?

不需要。该技能和上游 README 都明确说明无需账号或 MCP 连接。仓库还提供一项可选的付费参考搜索服务,但这与实现你提供的图像是分开的。

它能根据裁剪过的截图构建页面的其余部分吗?

来源说明应复现可见区域,而不要臆造看不到的部分。对于裁剪范围之外的内容,请提供更多参考图或明确的需求。

它能保证像素级完美吗?

不能保证。该技能以忠实还原为目标,并要求通过渲染进行对比。必须报告缺失的素材和剩余差异;未渲染检查的结果不能声称已验证视觉还原度。

Image to UI

构建你已选定的页面

请提供清晰可读的参考图、目标项目及其素材。匹配原始视口,检查运行中的界面,并明确列出剩余差异。

文档记录的安装命令
npx skills add uizze/uizze --skill image-to-ui