Community影像github.com

image-to-svg

將點陣圖像(如海報、插圖、天際線、標誌風格藝術、資訊圖表、剪影藝術)忠實重建成乾淨、可編輯、適合印刷的 SVG,使用建構式幾何而非自動描繪。

image-to-svg 是什麼?

此技能專注於將點陣圖像(如 PNG/JPG)轉換為高品質的向量 SVG,特別適合建築、地標、機械等人造結構,其中直線、對稱和透視至關重要。與傳統自動描繪不同,此技能透過測量原始圖像中的幾何形狀(如直線、圓弧、矩形)並使用腳本建構每個元素,從而產生更清晰、更對稱、更可編輯的結果。它支援多種平台,包括 Claude Code、Cursor 和 Codex,並提供完整的工具鏈,包括測量腳本(measure.py)、幾何建構(svgkit.py)、字型比對(font_match.py)和驗證腳本(validate.py)。工作流程包括攝入、分析、測量、建構、排版、色彩匹配和逐節驗證,確保與原始圖像視覺上忠實,同時修復常見的描繪缺陷(如鋸齒邊緣、不對稱、微小孔洞)。最後輸出可編輯的 SVG,適合在 Inkscape 或 Illustrator 中進一步編輯並用於印刷。

相容平台~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 單位 mm;保持 來源長寬比,例如 2:3 → 30×45 cm)。

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 定量比對字型;保持文字可編輯,使用一個 x 軸位置和一個由相同角色的每個文字共享的字距,根據參考的墨水寬度校準。從平坦的內部區域取樣顏色(中位數,而非單一像素)。詳見 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 依賴(使用一次性虛擬環境,例如在臨時目錄中執行 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 將其包裝用於有機形狀或初步測量描繪。

檔案

  • 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 的最佳化輪廓,用於有機形狀。

相關技能