Community图像github.com

图像转SVG

将栅格图像(海报、插画、天际线、徽标样式、信息图、剪影艺术)忠实地重建为干净、可编辑、适合打印的SVG,基于构造几何而非自动描摹。当用户想要转换、重绘、矢量化、重建或“转为SVG”图片/PNG/JPG,想要用于打印或Inkscape/Illustrator编辑的矢量版本,或抱怨描摹后的SVG看起来歪斜、不对称或杂乱时使用此技能。尤其适用于建筑、地标、天际线、机器和其他人造结构——其中直线、对称和透视至关重要。

图像转SVG 是什么?

该技能专门用于将栅格图像(如海报、建筑物、徽标等)高质量地转换为SVG格式。它的核心优势在于完全摒弃了传统自动描摹(auto-tracing)方法,因为自动描摹会将原始图像的缺陷(如边缘锯齿、不对称、微小凹陷)复制到矢量结果中。相反,该技能采用测量和几何构造的方法:首先分析图像中的直线、对称、透视和重复元素,然后使用Python脚本构建由基本几何图形(多边形、圆弧、椭圆等)精确组合而成的矢量图形。这种方法确保了最终SVG具有完美的直线、真实的对称性、一致的重复元素和正确的透视关系,是设计师手绘级别的高质量结果。该技能支持在Inkscape、Illustrator等平台中编辑,并包含完整的验证流程(对称性检查、布局一致性、无栅格图像过滤等),确保输出是干净、可编辑、适合打印的SVG文件。工作流程分为多个阶段,包括需求确认、最佳参考获取、分析并提出方案、测量、几何构造、版式与颜色、逐部分验证以及交付与迭代,每个阶段都有明确的检查点和用户确认环节。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/davidpastorvicente/image-to-svg-skill/tree/HEAD

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

图像 → SVG(构造的、可编辑的、适合打印的)

将栅格参考图像转换为设计师手绘风格的SVG: 直线的地方真正直线,真正的圆形和圆弧,真实的对称, 一致的重复元素,正确的透视,一致居中布局,可编辑文本,合理的 图层——并在视觉上忠实于原始图像。

此技能背后的核心教训:自动描摹栅格图像会以矢量形式保留 栅格图像的缺陷(边缘锯齿、不对称的穹顶、凹痕、 微孔、略微不同的“相同”窗户)。用户会立即注意到。 描摹适用于首次测量或真正有机形状, 但人造结构应从测量的基本图形中重建。

工作流程

分阶段进行,并在标记为 ✋ 的检查点获得用户的确认。 使用用户的语言进行沟通;保持报告简短并链接到文件。

1. 需求收集 ✋

仅询问那些会改变结果的问题(跳过用户已提供的信息):

  • 忠实再现 vs. 忠实且清理(默认:忠实,优化不规则)。
  • 背景:无/透明(常见于白色打印)、纯色或纹理。
  • 文本:可编辑 <text>(需安装字体) vs. 轮廓化路径。
  • 预期用途和尺寸(打印尺寸 → 页面 width/height 毫米;保持 源宽高比,例如 2:3 → 30×45 厘米)。

2. 获取最佳参考

使用可用的最高质量副本(磁盘上的PNG优于聊天附件中的JPEG ——询问用户是否有原始文件)。将其复制到 项目目录中(reference/original.png),绝不修改用户的原始文件。 如果只有聊天附件,它可能可以从工作区的会话存储中恢复; 在深入应用数据库前先询问。

3. 分析并提出方案 ✋

在绘制任何内容之前,查看放大的裁剪区域并向用户描述:

  • 整体构图和网格(边距、交替、对齐);
  • 每个图形:它是什么、它的组成部分、哪些部分是对称的、重复的 元素(窗户、柱子、舱室)、透视(后退立面);
  • 字体候选;颜色;
  • 等价类和网格:具有相同功能且必须相同的对象 (背景形状、文本角色、强调条、分隔线、成对规则、 重复块)、共同边距、居中项目和垂直节奏。 参考图像在此处往往不一致(半径为 154/128/144,三种标题 大小);建议统一,仅询问可能存在差异的地方。 参见 references/layout.md。 然后提议对象结构(图层/组、命名)。将每个 插图分组为一个类似文件夹的组(例如“建筑剪影”),包含其 作为独立命名子元素的组件。等待确认。

4. 测量

测量,而非目测。使用 scripts/measure.py(网格裁剪、顶部轮廓、 开口、线/圆拟合、颜色采样),并参见 references/measuring.md 了解技术。按组件记录数字: 轮廓坐标、对称轴、窗口框、圆心/半径。

5. 构造几何

使用 scripts/svgkit.py(带自动环绕的多边形、拱形窗、透视拱门、穹顶、 椭圆、尖刺、镜像、以及一个用于收集实体/开口/挖空的 Part)从基本图形构建每个对象。 阅读 references/construction.md —— 其中包含关键规则: 直边、围绕测量轴镜像实现对称、通过消失线实现透视、 将属于一起的部分合并、填充微孔、去除凹痕、避免接缝。

将构建过程编写为脚本(例如 build_svg.py + architecture.py),以便每次 更改都是重新运行,而非手动编辑XML。

5b. 布局系统

将所有内容放置在一个定义为常量的网格上(边距关于页面中心对称, 每类背景形状一个半径,每个文本角色一种样式, 每个重复块一个垂直节奏,相等/镜像的规则)。 使用 inkscape --query-all 按实际墨迹对齐文本,然后将整个 艺术品在页面上居中并将平移嵌入坐标。阅读 references/layout.md。

6. 排版与颜色

使用 scripts/font_match.py 定量匹配字体;保持文本可编辑, 使用一个字号 + 由同一角色的每个文本共享的字间距, 从参考墨迹宽度校准。从平坦内部区域采样 颜色(中位数,而非单个像素)。详见 references/typography-and-colour.md。

7. 逐部分验证

每次构建后:

  1. 使用 Inkscape 渲染(scripts/compare.py 完成此操作)并逐节 与参考图像进行并排比较,加上红/蓝差异叠加。
  2. 使用 scripts/symmetry.py 检查对称图形(关于轴镜像; 残差应约为 0.1% —— 其余为抗锯齿或故意 不对称细节,如时钟指针)。
  3. 在打印分辨率(300 dpi 裁剪)下检查接缝、细线、间隙、 残留凹痕。
  4. 使用 scripts/consistency.py 审计布局一致性(相等半径、 每种角色的文本样式、条、规则宽度、边距、垂直节奏、 节间距、颜色对关系、居中)。每个发现要么被修复,要么被确认为有意为之。
  5. 使用 scripts/validate.py 验证文件(无栅格图像/滤镜、 唯一id、可解析的 url(#…)、文本对象存在、页面尺寸)。 在报告之前自行查看图像。重叠分数是诊断工具, 而非目标 —— 高质量的重建自然会与模糊、不规则的源图像有所不同。

8. 交付与迭代

简要报告:构建了什么、与参考图像的故意偏差 (例如,使某部分对称、统一窗户数量)、字体依赖、指向 SVG的链接、预览PNG以及比较图像。预期有针对性的反馈 轮次(“这个穹顶不对称”、“让窗户遵循透视”、“匹配这个吊车头”)—— 在高缩放下重新测量特定区域,重建,并显示与参考图像相邻的 前后裁剪对比。当请求不明确时 (例如,使用哪种透视模型),将选项渲染为快速示意图, 让用户选择而非猜测。将备选方案 (字体、颜色、间距)显示为对比表:原始 | 当前 | 选项。 内容更改(新坐标、名称)保持样式冻结,并是经过验证的事实 ——参见 references/typography-and-colour.md。

环境说明

  • Python 依赖(在临时目录中使用一次性 venv,例如 uv venv): pillow numpy scipy opencv-python-headless fonttools lxml。
  • Inkscape CLI 可靠渲染:inkscape in.svg --export-type=png --export-filename=out.png --export-width=4096 --export-background=white --export-background-opacity=1。图像查看器可能缓存—— 为后续预览使用新文件名。
  • Potrace 内置于 Inkscape(libpotrace);scripts/contour.py 包装了 Potrace 用于有机形状或首次测量描摹。

文件

  • references/construction.md —— 建筑/结构几何规则、透视、对称、SVG填充/孔洞/接缝。构建前阅读。
  • references/measuring.md —— 如何从栅格图像提取可靠数字。
  • references/layout.md —— 等价类、网格/边距、垂直节奏、墨迹对齐、共享字间距、艺术品居中。
  • references/typography-and-colour.md —— 字体匹配、可编辑文本、颜色。
  • references/svg-structure.md —— Inkscape的图层/组、背景挖空、打印设置、交付清单。
  • scripts/svgkit.py —— 几何基本图形和 Part(从你的构建脚本中导入)。
  • scripts/measure.py —— CLI:grid、profile、holes、color、fit-circle、fit-line。
  • scripts/font_match.py —— 对文本裁剪区域对已安装/候选字体进行排序。
  • scripts/compare.py —— 渲染 + 并排比较 + 每区域叠加。
  • scripts/symmetry.py —— 每个图形的镜像对称残差。
  • scripts/consistency.py —— 布局审计:相等对象、对齐、边距、节奏、居中。
  • scripts/validate.py —— 最终SVG的结构检查。
  • scripts/contour.py —— 基于potrace的有机形状优化轮廓。

相关技能