跳到正文
Hacker News (official RSS)(github.com)·· 10 天前精選品質評分82

ZigZag 推出 Rust 刺繡編輯器,支援 MCP 與多種機器檔案格式

Show HN: My $300 embroidery machine needed a subscription, so I built my own app

重點導讀

ZigZag 推出以 Rust 打造的視覺化刺繡編輯器,可將 SVG 圖稿轉成針跡、編輯設計,並匯出多種刺繡機器檔案。

  • AI 助理協作:內建 MCP 支援,可透過 Claude Code 或 Codex 編輯目前開啟的設計。

AI 伴隨問答

自備 Key 深度分析

針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:

推薦理由

ZigZag 將刺繡圖稿編輯、針法設定與機器檔案匯出整合在同一工作流程,也提供 MCP 介面讓 AI 助理協作編輯。

正文 · 中文翻譯

ZigZag dark mode app icon

造訪 zigzag.diy

ZigZag 是一款以 Rust 打造的視覺化刺繡編輯器,兼具高效能,並內建 MCP(Model Context Protocol) 支援,讓 AI 代理程式能與你一同建立及編輯設計。將 SVG 圖稿轉成針跡,在編輯器中微調,再匯出 PES、DST、EXP、JEF 或 VP3 格式,廣泛相容於各種刺繡機;也可透過 藍牙直接將設計傳送至 Brother Skitch (PP1)。

在 Illustrator 或 ZigZag 中繪圖,也可以讓代理程式代為繪製。Rust 引擎與 zigzag 命令列工具,讓你在編輯器外也能使用相同的工作流程。

看看 ZigZag 的實際操作

zigzag-demo.mp4

下載 Mac 版

下載 ZigZag.dmg

適用於 Apple Silicon 和 Intel Mac,需搭載 macOS 11 或更新版本。開啟 DMG,將 ZigZag 拖曳至「應用程式」資料夾即可。此版本已由 Apple 簽署並公證。 不需要安裝 Rust。

下載 Windows 版

下載 Windows 版 ZigZag — 最新版本中的 ZigZag-<version>-x86_64-windows.zip 資產。

適用於 64 位元 Windows 10(版本 1709 或更新版本)和 Windows 11。解壓縮後,按兩下 ZigZag.exe。首次執行沒有 Microsoft 信任簽章的應用程式時,Windows SmartScreen 會發出警告;請按一下 更多資訊 → 仍要執行。不需要安裝 Rust。

版本資訊與校驗碼 · 釋出版本

zigzag/
  src/svg.rs              SVG import (usvg): fill and stroke parts, transforms, text
  src/document/           editable document; settings saved back into SVG ids,
                          layout edits as SVG transforms, lettering
  src/params.rs           stitch settings tokens + fabric presets
  src/stitch/fill.rs      tatami fill (scanline sections, staggered rows)
  src/stitch/satin.rs     satin columns: two rails, auto-satin, underlays, short stitches
  src/stitch/stroke.rs    running / triple-run stitch
  src/boolean.rs          polygon booleans and offsets (i_overlay)
  src/design.rs           planner: overlap removal, cap order, routing, trims
  src/checks.rs           digitizing checks (sizes, widths, lettering, hoop)
  src/formats/            PES (+PEC), DST, EXP, JEF, VP3, Skitch PEN writers;
                          PES/PEC/DST/EXP/JEF readers; preview; worksheet
  src/machine/            Skitch Bluetooth protocol (+ btleplug client, `ble` feature)
  src/studio/             editor (egui on OpenGL via glow) + MCP server (`gui` feature)
  src/mcp_bridge.rs       stdio ↔ HTTP bridge for MCP clients that launch a command

建置

cargo build --release                        # CLI + MCP bridge, no system deps
cargo build --release --features gui,ble     # + the studio editor and Skitch upload

Linux 需要常見的 X11/Wayland 和 OpenGL 開發程式庫,才能使用 gui。libdbus 已隨 ble 一併提供。

針跡型別

型別 用途 適用物件
填針(席紋針) 交錯排列的行列,可設為任意角度,並支援底層針跡(邊緣繞行+行列)和拉伸補償 填滿的形狀
緞面針 在兩條導引線之間以之字形排列,可設定中心、輪廓或之字形底層針跡、拉伸補償,以及在窄曲線處使用短針;表面針跡可選一般、S 形或之字形;也可在針柱中使用多種線色(多色緞面針) 任意寬度的筆畫;採用 Ink/Stitch 風格、帶有橫檔的雙導引線路徑;填滿的形狀:圓環使用內外輪廓,條狀圖形/字母/新月形則從尖端分段(自動緞面針),或由 border 沿著輪廓排列
平針 單針或三重(豆針)平針 筆畫和輪廓
輪廓填針 沿著輪廓向內排列的行列,或從中心向外延伸的單一螺旋線(Ink/Stitch 的圓形填針) 填滿的形狀
毯邊針 E 形針跡:線上條上加上朝形狀內側延伸的短針 邊緣、貼布繡
貼布繡 定位線 → 停針 → 固定縫線 → 停針 → 緞面覆蓋針 填滿的形狀
手動針跡 路徑上的每個點都是一個針點 匯入的機器檔案、鋼筆工具
迴旋填針 以一條蜿蜒線穿過形狀,呈現絎縫風格:輕柔細緻 填滿的形狀
漣漪針 沿著輪廓排列的開放式平針行列,或單一螺旋線 填滿的形狀
十字繡 由 X 形針跡組成的格線,以半個十字來回縫製 填滿的形狀
格紋針 以多種線色織出條紋(可在面板中編輯映象排列),每種線色各自形成一個色塊 填滿的形狀

寬度超過 7 mm 的緞面針會自動拆分(改用較短、交錯排列的針跡),並採用自動間距(窄針柱的間距較疏,寬針柱的間距較密)。

規劃工具:

  • 移除重疊部分:後續物件覆蓋的填針區域不會縫製(保留 0.5 mm 的重疊)。
  • 排序帽狀物件:由中心向外、由下往上,依顏色分組,同時遵循圖層順序。
  • 路徑:移動針跡會留在形狀內:直線可留在形狀內時就直線穿過,否則沿著輪廓內側繞行(Ink/Stitch 的底層路徑),因此帶有鏤空區域的填色只需極少剪線,甚至不必剪線。只有在兩種方式都不可行時才剪線(移動距離最多 50 mm)。
  • 每個物件的縫製控制:設定起點和終點(線從哪裡進入、離開,讓下一個物件的位置更近)、縫完後剪線、縫完後停止(以便墊入泡棉或修剪貼布)。檔案也可以將相距 N mm 以內的物件以平針連線,而不用剪線。
  • 布料預設值:標準、薄棉布帽、結構帽、針織布。
  • 檢查專案:狹窄填色、寬/窄緞面針跡、小字、微小間隙、完全覆蓋的物件、是否符合繡框範圍。
  • 群組顏色:重新排序以減少換線次數,同時維持圖層順序。

Mac App

在裝有 Rust 和 Xcode 命令列工具的 Mac 上 (xcode-select --install):

packaging/macos/make-app.sh --install    # builds ZigZag.app and copies it to /Applications
packaging/macos/make-app.sh --dmg        # also makes dist/ZigZag-<version>.dmg to share
packaging/macos/make-app.sh --universal  # one app for Apple Silicon and Intel Macs
packaging/macos/make-app.sh --release    # the DMG to publish: universal, signed, notarized

--release會使用你的 Developer ID 簽署 App,並請 Apple 對 App 和 DMG 進行公證,讓它能在任何 Mac 上開啟而不會出現警告。事前只需設定一次:新增 Developer ID Application 憑證(Xcode › 設定 › 帳號 › 管理 憑證 › +),在 account.apple.com 建立 App 專用密碼,並將公證憑證 儲存到鑰匙圈:

xcrun notarytool store-credentials zigzag-notary --apple-id YOUR_APPLE_ID --team-id YOUR_TEAM_ID

App 內含 studio、zigzag命令列工具和 MCP 橋接程式。若要從任何位置使用命令列: ln -s /Applications/ZigZag.app/Contents/MacOS/zigzag /usr/local/bin/zigzag。 若要搭配 Claude Desktop 使用,請將 MCP 設定指向 /Applications/ZigZag.app/Contents/MacOS/zigzag-mcp。

若沒有 --release,App 會以臨時方式簽署,不會經過公證。在建置它的 Mac 上可以正常開啟。在其他 Mac 上,macOS 第一次會封鎖它:開啟「系統設定」›「隱私權與安全性」,然後按一下「仍要開啟」(在 macOS 14 及更早版本中,請以滑鼠右鍵按一下 App,並選擇「開啟」)。第一次傳送到 Skitch 時,macOS 會詢問是否允許使用藍牙。

工作室

核准使用的刺繡圖示位於 packaging/macos/AppIcon.png(淺色) 和 packaging/macos/AppIcon-dark.png(深色)。Mac 版本會重新產生兩個 多解析度 .icns 檔案;執行 bash packaging/macos/make-icons.sh 可 分別重新產生。Finder 和尚未開啟的 App 使用淺色圖示。 工作室執行期間,Dock 圖示會配合 App 的淺色/深色主題, 也會遵循 ZIGZAG_THEME=light|dark 覆寫設定。

ZigZag

zigzag-studio [design.svg|logo.png] [--mcp-port 7878 | --no-mcp | --mcp-stdio]

版面配置像 Illustrator,風格則像 Mac App:

  • 左側工具列:選取 (V)、直接選取 (A)、手形 (H)、鋼筆 (P):點選建立角點,拖曳繪製曲線(Option 可分離控制把手,Shift 讓角度維持 45°,Space 可移動正在放置的點);繪圖時,按住 Option 可暫時使用錨點工具(拖曳線段可彎曲線段,拖曳控制把手可單獨移動把手,點選平滑點可將其轉為角點),按住 ⌘ 可暫時使用直接選取工具(拖曳點或控制把手後,繼續繪圖);選取路徑後,按住 Option 拖曳也可彎曲線段。Illustrator 的鋼筆工具群組藏在其中:新增錨點 (+) 可點選外框,在不改變形狀的情況下新增錨點;刪除錨點 (-) 可點選移除錨點(按住 Option 可在兩者間切換);錨點工具 (Shift+C) 可在平滑點與角點間轉換,並可單獨拖曳一個控制把手。按住鋼筆工具(或按右鍵)可開啟群組彈出選單,按住 Option 並點選可逐一切換群組工具,也可拖曳彈出選單邊緣的工具列,將群組撕下成為獨立工具列;形狀工具也能以相同方式操作。筆刷 (B),其群組內有 VectorCraft 的路徑清理工具:平滑工具(沿著路徑拖曳以消除抖動:減少錨點、讓曲線更平滑;可在上方工具列調整平滑度)、路徑橡皮擦(沿路徑拖曳以切除該段)和接合工具(在兩個開放端點之間來回塗刷以接合路徑,或接合開放路徑的兩端以封閉路徑)。形狀 (M 矩形、L 橢圓、\ 直線;按住或按右鍵可選取多邊形和星形)、填色角度 (G)、測量 (I)、文字 (T)。下方是選取專案的線色樣本:點選即可開啟線色選擇器。

  • 像在 Illustrator 一樣繪製曲線:使用鋼筆工具點選建立角點,按住並拖曳可繪製曲線(拖曳時按住 Option 可分離控制把手,形成銳角;Shift 讓點和控制把手維持 45°;按住 Space 可移動正在放置的點)。點選最後一個點可將它設為角點;也可以從該點拖曳,朝新的方向開始繪製下一段曲線。點選第一個點可封閉形狀;按 Enter、Esc、⌘-點選或切換至其他工具可結束線條並保留線條。選取路徑後,鋼筆工具可從開放端點繼續繪製、在外框上新增點、點選刪除錨點,也可按住 Option 並點選,將點在角點 ↔ 平滑點之間轉換(按住 Option 並拖曳可拉出新的控制把手)。繪圖時,點選另一條開放路徑的端點即可將兩條路徑接合為一條。遊標會顯示點選後的操作。直接選取工具可拖曳 SVG 中任何形狀的錨點和控制把手(圓形和矩形會轉為路徑);拖曳曲線可在遊標位置彎曲曲線(按住 Option 並拖曳可彎曲直線;直接拖曳則會移動曲線);Delete 可移除錨點,方向鍵可微移錨點。

  • 繪圖時使用智慧型參考線(檢視 › 智慧型參考線,⌘U):鋼筆工具的點、形狀角點和拖曳中的點,會對齊其他物件的錨點和中心、兩條外框的交叉處、外框、從上一個點延伸出的 45° 射線(水平和垂直的控制把手也適用),或與上述任一項對齊;洋紅色標籤會顯示對齊型別(「錨點」、「交叉點」、「路徑」、「對齊」等)。按住 Shift 時,點會維持 45° 角度,並滑動至與最近的目標對齊。

  • 圓角:使用直接選取工具時,每個尖角內側都會顯示一個小圓形;將它往內拖曳即可將角變圓(可套用至選取的點或所有點),每個角的圓弧大小都受其兩側邊長限制。「物件」›「路徑」›「圓角…」也能執行相同操作,並可設定半徑及選擇「圓角」、「反轉」或「斜角」,且會即時預覽。

  • 筆刷 (B),取自 Illustrator 的畫筆工具:徒手畫出線條,結果會平滑地以緞面繡柱縫製,寬度則是你設定的數值(或以平針縫製)。平滑功能會消除手繪的晃動,銳角仍會保持銳利;回到起點即可閉合線條。遊標是圓形,寬度與緞面繡柱相同。

  • 形狀工具,採用 Illustrator 的操作方式:矩形 (M)、橢圓形 (L)、多邊形、星形和線條 (\)。從角落拖曳;按住 Option 從中心繪製,按住 Shift 可建立正方形或圓形、讓多邊形或星形保持正向,以及讓線條呈 45°。拖曳多邊形或星形時,按 ↑/↓ 可增加或減少邊數或尖角數。點選而不拖曳即可輸入精確尺寸。畫布頂端的工具列可切換形狀,並設定圓角半徑、邊數、尖角數和星形內半徑。封閉形狀會以填色圖案建立,線條則會以連續針跡建立,兩者都使用目前的線色。

  • 路徑工具:物件 › 路徑管理員(聯集、減去上方物件、交集、排除;選取兩個以上物件時,也可使用「變形」面板中的按鈕),以及物件 › 路徑(位移路徑…、外框筆畫、簡化…、圓角…、清除…)。簡化…是 VectorCraft 的滑桿,可從最少節點調整到最接近原始形狀,並即時預覽;「自動簡化」會依選取範圍的大小挑選適當程度。清除…會移除多餘節點、小到無法繡製的物件(預設小於 1 mm),以及多餘節點(彼此重疊的節點、直線中間的節點),並先顯示找到的各類專案數量。結果會以平滑曲線及實際轉角呈現(使用最小平方法曲線擬合),而不是由許多邊組成的多邊形。

  • 從影像建立標誌(影像描圖):開啟、拖放或置入 PNG、JPEG、WebP、GIF、BMP 或 TIFF,接著「描圖影像」視窗會將影像描繪成平面色塊,並以帽子的顏色作為預覽背景。選擇色彩數量(或自動),設定寬度、細節和要保留的最小斑點;移除白色背景;將每種顏色對應到 Brother、Janome 或自訂色盤中的線色;也可將細線繡成單線。平面標誌會精確描圖(邊緣定位精確至不到一個畫素、還原轉角,並精確呈現圓形和直線);照片則會轉成色階海報效果。也可使用命令列描圖:zigzag convert logo.png -o logo.pes。

  • 情境工作列:位於選取範圍下方,顯示接下來可能會用到的操作:縫法、線色、編輯節點、圓角、簡化、聯集(兩個以上物件)和複製。檢視 › 情境工作列(或其 ••• 選單)可將其隱藏。

  • 詢問代理程式:Agent 面板(位於左側停駐區,佔滿整個高度;工具列底部的閃光圖示可開啟或關閉面板,而 ⌘K 或 Window › Ask Agent… 會開啟面板並準備好提示詞)會在背景執行 Claude Code 或 Codex,並連線到這個工作室的 MCP 伺服器,讓你觀看它建立設計。它只能使用設計工具(不能使用 shell,也不能編輯檔案)。逐字稿會顯示它說的內容和每個步驟,執行中的步驟旁會顯示載入動畫(只有這裡會顯示;收合面板後,標題會改為顯示步驟和時間)。在畫布上,代理程式正在處理的物件會出現動態外框、微光效果,以及描述目前動作的標籤(繪製、放置、重新調整樣式等);任何透過 MCP 連線的代理程式都適用,不限於面板中的代理程式。面板會以代理程式命名(Claude Code 或 Codex;可在 ≡ 選單中切換);標題列中的 + 會開始新的對話,Stop 會結束執行。使用你已登入的 claude 或 codex 命令。和其他面板一樣,它可以浮動、加入其他面板成為索引標籤,或停駐在右側;與其他面板共用停駐區時,它會位於底部,下方有一條可拖曳的分隔線,讓你調整面板空間。

  • 線色與調色盤:選色器會顯示最接近的 Brother/Janome 線色、可點選的調色盤(Brother、Janome 或自訂調色盤),以及小型自訂色彩欄位。你可以從頭建立調色盤、從設計建立,或使用擁有的線材套組建立(調色盤的 ≡ 選單 › New Palette from Thread Kit:Brother 的 12、40 和 22 色套組,或使用 40 + 22 色套組,涵蓋全部 61 色;接著使用 Match All,讓設計只採用你現有線材中的線色);按 + 可加入所選線色,按右鍵可移除。調色盤會在下次啟動時保留。

  • 線材面板:可依縫製順序檢視設計所用線材(每個色塊都會標示編號和針數;同一線材連續使用兩次時會標示「停止」),或依顏色檢視(每種線材只列一次,並顯示使用該線材的物件數量)。點選列可選取使用該線材縫製的內容;點選色票可更改該色塊的線材,若在依顏色檢視中,則會更改所有使用該線材的部分。色彩分組,以及顏色變更和剪線次數會顯示在清單下方。面板的 ≡ 選單中有 Match All,可將線色配對至所選調色盤;Show Palette 會在清單下方顯示可供點選的調色盤(預設為關閉,因為線材選色器也有相同的調色盤)。

  • 面板,採用 Illustrator 的操作方式:Agent 獨佔左側停駐區;Objects、Stitch、Transform、Lettering、Threads 和 Document 位於右側。設計中的問題會顯示在狀態列(右下角):有問題時會顯示警告符號和數量,沒有問題時則顯示勾號;點選圖示(或選取 Window › Issues)即可檢視清單,每個專案都連結到相應物件。拖曳面板標題列即可重新排序、移至另一側停駐區,或拖到畫布上使面板浮動(每個面板的 ≡ 選單中也有 Dock Left/Dock Right/Float)。將面板拖曳到另一個面板的標題列上,兩者便會共用空間並以索引標籤顯示;拖出索引標籤(或使用 ≡ 選單中的 Separate)即可將面板分開,拖曳標題列則可移動整組面板。停駐區頂端的 » 可將停駐區收合為圖示列,騰出更多畫布空間;點選圖示即可在圖示列旁展開面板(拖曳圖示可移動面板)。點選標題列可收合面板;Window › Reset Panels 可還原所有面板。面板配置會予以保留。

  • 每份檔案使用一個分頁(如 VectorCraft 和 Illustrator):開啟、拖放或按「新增」會在畫布上方的獨立分頁中開啟檔案(你一開始建立的空白檔案會讓位給第一個檔案);已開啟的檔案則會切換到前景。每個分頁都有自己的復原記錄、選取專案、縮放比例和針跡。按一下分頁即可切換,按 ⌃Tab / ⌃⇧Tab(或選擇「視窗 › 下一份檔案/上一份檔案」)可依序切換,拖曳即可重新排列,按滑鼠中鍵或分頁上的 ×(或選擇「檔案 › 關閉」、按 ⌘W)即可關閉;按 + 可開啟新檔案,按 » 可在分頁太多而無法全部顯示時列出所有分頁。× 位置顯示圓點代表有未儲存的變更,關閉該分頁時會詢問是否先儲存。以滑鼠右鍵按一下分頁,可選擇「關閉其他分頁」和「複製路徑」。結束程式時不會詢問:下次開啟時會還原所有分頁及各自未儲存的變更。

  • 選單列(檔案、編輯、物件、檢視、視窗),並提供常用的 ⌘ 快速鍵。在 Mac 上,這是 macOS 的實際選單列;在其他地方則會顯示於視窗中。

  • 每種工具都有專屬遊標:鋼筆工具顯示筆尖(並提示按一下會執行的操作),形狀、測量和填滿角度工具顯示十字線,直接選取工具顯示空心箭頭,旋轉角落則顯示彎曲箭頭。

  • 畫布和物件清單都提供滑鼠右鍵選單,樣式與工具彈出選單一致:先列出含圖示的針跡型別,再列出常用指令及其快速鍵。

  • 大型設計也能保持流暢:每次變更只規劃一次針跡,並重用未變更的所有物件(也包含重疊移除:移動一個物件時,只會重新處理與它重疊的物件);規劃設計若耗時超過 12 ms,就會在背景進行(狀態列會顯示「正在更新針跡…」,同時保留上一個規劃結果;放開移動中的物件後,在新規劃完成前,針跡會隨物件一起移動)。拖曳點或物件,以及輸入文字時,只會顯示預覽;放開後才會重新規劃。針跡由 GPU 處理:每個色塊的線段只會上傳一次,再交由著色器繪製(也包含線的陰影和針點),因此平移、縮放、拖曳和針跡播放器在 CPU 上不會增加任何逐針跡的負擔,無論設計有一千針還是五十萬針皆然。物件清單只會排列目前可見的列。若某個物件的針跡發生內部錯誤,系統會將它排除並在「問題」中顯示警告,不會因此中斷整體規劃。開發用途:TL_PROFILE=1會將每個影格的各個區段輸出至 stderr,TL_NO_GPU=1會改用繪圖器繪製針跡,cargo test --release --features gui --bin zigzag-studio perf_bench -- --ignored --nocapture --test-threads=1會測量在描摹標誌上輸入文字和拖曳的耗時(examples/bench-grid.svg是專為工作室設計、含有 213,000 針的設計)。

  • 介面會跟隨系統的淺色或深色外觀(ZIGZAG_THEME=light|dark可覆寫),並在 Mac 上使用 San Francisco 系統字型。

  • 為每個物件選擇針跡型別:使用大型按鈕、工作列、滑鼠右鍵,或按 F/S/R/C/X(可在「針跡」面板中選擇毯式針跡和手動針跡)。預覽會即時重新規劃。

  • Illustrator 風格的版面配置:拖曳即可移動(Shift:以 45° 為間隔;Option:拖曳複製)。控制點可自由調整大小(Shift 維持比例,Option 從中心調整大小,拖過另一側即可翻轉);在角落外側稍微拖曳即可旋轉(Shift:以 45° 為間隔)。智慧型參考線會將邊緣和中心對齊其他物件與繡框(View › Smart Guides,⌘U)。⌘D 是「再次變形」:按住 Option 拖曳複製,再按 ⌘D 即可依相同間距繼續複製。按住 Space 可使用任何工具平移畫布(點一下即可播放刺繡過程)。「變形」面板有 Illustrator 的參考點:X/Y 顯示所選參考點,W/H 會以該點為基準調整大小。也可旋轉、翻轉、在繡框中置中、符合繡框大小(開啟或置入大於繡框的圖稿時,會縮小至符合繡框;復原可還原完整大小)、⌘C/⌘V,以及使用方向鍵微移 0.5 mm(Shift 為 5 mm)。編輯內容會以 SVG 變形方式儲存。

  • 群組的操作方式與 Illustrator 相同:按一下或拖曳會選取整個群組;按兩下可進入群組(其他內容會變暗,並顯示階層導覽,指出目前位置),再按兩下可進入更深一層;按 Esc 或在空白畫布上按兩下即可返回上一層。按住 ⌘ 再按一下,可選取單一物件而不進入群組。圖層(Illustrator 的「Layer 1」、Inkscape 圖層、Figma 畫框)不是群組。複製、貼上和製作副本都會保留群組。

  • 文字(T),操作方式與 VectorCraft 和 Illustrator 相同:在文字要放置的位置按一下,直接在畫布上輸入(Enter 換行;完成後按 Esc 或在其他位置按一下);按一下文字或字母之間即可編輯,插入點會出現在點選的位置(也可以使用選取工具按兩下文字;這會選取文字方框中任何位置的文字,並以方框而非字母的節點顯示;刪除所有字母並完成編輯後,文字就會移除)(←/→、↑/↓、Home/End 和 ⌘←/→ 可移動插入點;Backspace 和 Delete 可刪除插入點任一側的內容;搭配 Shift 使用上述按鍵、拖曳、按兩下選取單字、按三下或按 ⌘A 可選取文字,輸入內容會取代所選文字,而 ⌘C/⌘X/⌘V 可複製、剪下和貼上);按一下已選取的路徑,即可沿路徑排列文字。「字樣」面板是精簡版的「字元」面板(帽子上的文字不會太長):字型(含搜尋)、粗體/斜體、字高、字距、字偶距(選取字偶,或在輸入時按 Option+←/→,即可調整插入點處字偶的字距)、水平與垂直縮放、大小寫(依輸入內容、大寫、小寫、標題式大小寫)、對齊方式與雙行文字的行距、基線(直線、上弧、下弧,或沿路徑排列並可設定偏移與翻轉),以及刺繡型別。「文字」選單包含「沿路徑排列文字」、「變更大小寫」、「對齊」和「建立外框」(⇧⌘O)。文字和其他形狀一樣:直接選取、「圓角」、「簡化」、「探路者」和「清理」都適用於文字(首次編輯節點時會在背景中轉換成一般路徑,並記為一步復原操作);在此之前,文字會以真正的 SVG 文字格式儲存。

  • 鋼筆(P):繪製實心形狀或線條,可使用尖角和曲線,也可逐一放置手動針跡。顯示格線時會貼齊格線,否則會貼齊智慧型參考線。

  • 形狀(M、L、\):矩形(含圓角)、橢圓形、多邊形、星形和線條。

  • 測量、mm 格線、針點、第一針/最後一針、群組顏色。

  • 開啟機器檔案(PES、PEC、DST、EXP、JEF),即可檢視、調整大小並重新匯出;也可開啟圖片進行描圖。

  • 各型別的設定:填針角度(使用拖曳設定的角度工具,A)、間距、長度、拉伸補償、底層針。緞面針選項:柱狀或邊框、針法(緞面針、S 形針、鋸齒針)、柱狀內的橫向針數、寬度、底層針道數、短針。輪廓針和波紋針:環形或螺旋。十字繡:格子大小。格紋:條紋(各自的顏色和寬度,並映象排列)、角度、列距。走針選項:單針或三重針。

  • 縫製列(Stitch 面板):起點和終點(點選外框;可拖曳綠色和紅色標記)、物件完成後修剪線和停止。Edit › Copy / Paste Stitch Settings 可將一個物件的針法型別和設定套用到其他物件(各物件仍保留自己的線色和起點/終點);Edit › Select Same Stitch Type;Object › Path › Reverse Direction 會從另一端開始縫製路徑。

  • 測試色樣(Object › Test Swatches…):將所選專案複製排列成網格,讓單一設定(間距、長度、拉伸補償、緞面針寬度、填針角度)從一個數值逐步變化到另一個數值,每個色樣都標上數值,方便在實際布料上試縫比較。

  • View › Density Map 會以色彩標示針跡密集處(每平方毫米 2.5 針起呈黃色,4 針呈紅色),View › Sewing Order 則會在畫布上為物件編號。

  • 布料預設、繡框、移除重疊和封口順序位於 Document 面板。使用帽子的顏色預覽。

  • 問題清單(狀態列):點選問題即可連到對應物件。緞面針會在畫布上顯示其導軌。

  • 縫製順序:提前/延後。針跡播放器(Space)。所有操作皆可復原/重做。

  • 儲存(Ctrl/⌘ S)會將設定寫入 SVG;匯出為 PES/DST/EXP/JEF/VP3/PEC/PEN 或工作表(HTML:圖片、尺寸、時間,以及每個換色點對應最接近的 Brother 和 Janome 線色);傳送至 Skitch。

  • 測量與單位。測量工具(I)的操作方式與 VectorCraft 相同:在兩點之間拖曳,即可讀取距離、角度、寬度和高度。端點會吸附至點、邊緣和繡框(開啟格線時也會吸附至格線);按住 Shift 可將線條限制為 45°;讀數會保留,直到再次拖曳(按 Escape 清除)。View › Units 或狀態列中的單位選單,可將尺寸、位置、距離和格線顯示為毫米、公分、英吋、點或畫素(讀取檔案時以 SVG 畫素為準,1/96 英吋);設定會在下次啟動時保留。任何長度欄位也接受輸入單位或加總式(1/4 in、25.4mm、10+5)。格線(⌘')會依所選單位調整;英吋可切分為二分之一,最細至 1/32;格線主要線條的標籤會沿畫布上緣和左緣排列,並以繡框中心為基準。針跡設定(間距、密度、拉伸補償)一律使用毫米。

  • 從上次離開的地方接著使用。結束(或當機)後重新開啟:相同的檔案會恢復,每個有未儲存變更的分頁、縮放和選取狀態,以及最前面的分頁都會保留。變更會在工作時儲存(session.json,每個分頁各有一個復原檔,recovery.svg、recovery-2.svg……,存放在 ZigZag 的設定資料夾(~/Library/Application Support/ZigZag),每次寫入都會完整完成或完全不寫入),在你儲存之前絕不寫入原始檔案。開啟應用程式時若有指定檔案,則不會恢復工作階段。如果應用程式在還原檔案時關閉,下次啟動時會將該檔案另存為 recovery-crashed.svg,不再嘗試還原(無法讀取的檔案則另存為 recovery-unreadable.svg),並在狀態列中告知。Skitch 上的工作也會恢復:最後傳送的設計會保留(sent.json),如果 Skitch 視窗原本開著,就會重新開啟並重新連線;機器回報該設計後,進度也會再次顯示在設計上(機器會保留設計和針的位置;按下 Stop 會在兩邊結束工作)。

代理程式(MCP)

工作室會在 http://127.0.0.1:7878/mcp 上執行 MCP 伺服器(Streamable HTTP,僅限 localhost,會檢查 Origin)。代理程式會編輯你目前正在檢視的即時檔案(最前面的分頁),每次呼叫都是一個復原步驟。

狀態列(右下角,Skitch 旁)的 MCP 會顯示代理程式是否能連線到工作室:等待時顯示灰點,有使用者端連線後轉為綠色,收到呼叫時會呈藍色並閃爍,伺服器無法啟動時則為紅色。點選即可檢視位址、連線 Claude Code 和 Claude Desktop 的指令(附有 Copy 按鈕)、已連線的使用者端、最近的工具呼叫(失敗的呼叫會以紅色標示,將遊標停留其上可檢視錯誤),以及可用工具。

Claude Code:

claude mcp add --transport http zigzag http://127.0.0.1:7878/mcp

Claude Desktop / stdio 使用者端(claude_desktop_config.json):

{ "mcpServers": { "zigzag": { "command": "/path/to/zigzag-mcp" } } }

zigzag-mcp 會轉送至正在執行的工作室。若有變更,請使用 --port N。 搭配 "args": ["--headless"] 時,即使應用程式未開啟也能運作:使用相同工具編輯沒有人正在檢視的檔案(zigzag-studio --mcp-stdio),只有代理程式儲存或匯出時才會保留。

工具:

  • get_design、add_svg(以 mm 放置/縮放圖稿)、set_object、delete_object、move_object
  • transform_objects(調整大小、縮放、旋轉、鏡射、移動)、duplicate_objects
  • add_text、edit_text、list_fonts
  • set_document(布料、繡框、重疊、帽子順序、預覽顏色)、group_colors
  • render_preview(傳回針跡的 PNG)、check_design、get_svg、select
  • open_file(SVG、機器檔案或影像,置於獨立分頁)、list_documents、switch_document、new_document、undo、save、export(機器格式或 html 工作表)、send_to_skitch、machine_status
  • trace_image(PNG/JPEG 標誌 → 形狀,並將顏色對應至線材色卡)、round_corners、simplify(VectorCraft 的 0–100 等級,或 Auto)、clean_up
  • batch:一次執行多個呼叫,全部成功才生效,且只算一個復原步驟;後續步驟可以使用先前的結果("$0.added.0.name")

工具不接受的引數會被拒絕,並列出可接受的引數(拼錯的 widht_mm 不會被默默忽略);每個工具也會說明自己是否只會讀取資料。

可以試著這樣問:「為我的薄棉布帽畫一個直徑 50 mm、帶有山脈和太陽的圓形徽章,檢查設計,並顯示預覽。」

CLI

zigzag convert logo.svg -o logo.pes -o logo.jef -o preview.png -o sheet.html [--fabric thin-cap] [--hat]
zigzag convert old.dst -o old.pes             # machine files convert too
zigzag convert logo.png -o logo.pes           # PNG/JPEG logos are traced first
zigzag info logo.svg                     # stats + checks
zigzag fabrics                           # list presets
zigzag skitch info | status              # needs --features ble
zigzag skitch send logo.svg --trace

Illustrator 工作流程

使用 File → Export → Export As → SVG 匯出(Styling:Presentation Attributes,Object IDs:Layer Names)。請將文字建立外框,否則會改用系統字型。 在 Illustrator 中重新開啟 ZigZag 儲存的 SVG,圖層名稱中的設定仍會保留。

為圖層或物件命名即可設定其刺繡方式。Illustrator 的 _x3D_ 樣式跳脫字元會解碼,群組設定會套用至群組內的所有專案。

程式碼 意義
fill satin run skip 針跡型別
a=45 填滿角度(度)
s=0.3 列/鋸齒間距(mm)
l=3 最大針跡長度(mm)
pc=0.2 拉伸補償(每側 mm)
w=3 緞面寬度(mm)
border 沿著填滿形狀的外框刺繡緞面針跡,而非橫跨形狀
u=0 關閉底布針跡
ul=center+contour+zigzag 緞面底布針跡次數(ul=none)
ss=0 關閉短針跡
r=3 平針次數(3 = 豆針)
contour blanket applique manual 其他針跡型別
split=7 緞面自動分段長度(mm);split=0關閉
t=e8a33c 線色覆寫
o=2 縫製順序
stroke.… 僅套用至同時有填色的物件外框,例如 stroke.run

圖層名稱範例:logo fill a=45 s=0.35、title satin、outline stroke.satin stroke.w=1.5。

透過 Bluetooth 使用 Skitch

Skitch 視窗(工具列的「傳送」按鈕或「檔案」›「傳送至 Skitch…」)會執行整個工作流程,就像切片軟體的裝置頁面會在列印期間顯示狀態:左側是設計,右側是操作專案,頂端則列出各步驟(連線 · 歸位 · 傳送 · 試走 · 縫製 · 完成)。

  • 連線並配對。視窗會掃描 Skitch。首次使用時,按住 Skitch 的 Bluetooth 按鈕直到它發出嗶聲,然後按一下「連線」(或「再試一次」);如果電腦要求配對,請接受。在 Mac 上,Skitch 不會出現在「系統設定」›「Bluetooth」中(它是 Bluetooth LE 裝置):ZigZag 連線時就會完成配對。如果 macOS 詢問,請允許 ZigZag 使用 Bluetooth(「隱私權與安全性」›「Bluetooth」)。請先關閉 Artspira:Skitch 同一時間只能與一個 App 通訊。
  • 歸位。剛開機的機器會要求歸位(關閉機框、按一下「接受」、再開啟機框);視窗會顯示步驟,完成後自動進入下一步。
  • 傳送:選擇要縫製設計的繡框位置:「依目前位置」(依照設計在工作區繡框中的位置,因此可以將設計放在帽子較高處)或「置中」;確認縫製所需的線材,並依縫製順序列出 Brother Embroidery 名稱和編號;檢視「縫製前」檢查清單;然後按一下「傳送設計」。
  • 試走(Brother 對此功能的稱呼;傳送後預設開啟):按下機器上的「接受」,機針會沿著設計外框移動,但不會縫製,讓你確認外框不會碰到機框磁鐵、接縫和帽簷。每次重新裝框後,都可以再次試走。
  • 縫製:按一下「開始」,接著按下機器上的「開始」。圖片會顯示已縫製的部分;尚未縫製的部分會淡化,並標示目前的機針位置和線材。圖片下方有線材時間軸,顯示機針目前的位置。側邊會顯示進度、剩餘時間、目前和下一條線材;每次換線時,也會明確指出要更換的線材。畫布和狀態列也會同步更新。
  • 開始/暫停/停止。按一下「開始」(或「繼續」或「重新縫製」)即可讓機器準備就緒;「暫停」使用 Skitch 本身的「開始/停止」按鈕(透過 Bluetooth 無法暫停);「停止」則會結束工作,並將設計從機器中移除。暫停時,可以沿時間軸拖曳,或讓機針前進 1、10 或 100 針,也可以退回目前線材的起點,然後按一下「繼續」。
  • 錯誤會說明錯誤內容和處理方式(斷線、梭芯、針板、機框)。斷線後,機針會退回斷線處(面線退回 6 針,梭芯線退回 2 針,與 Artspira 相同)。
  • 按一下「最小化」(–),即可在縫製時繼續工作:畫布會回到設計畫面,狀態列右側的機器圖示會顯示機器目前的狀態和進度,並附有小型進度列(按一下即可重新開啟視窗)。機器需要你操作時,視窗會自動重新開啟,例如需要換線、發生錯誤或工作完成時。
  • ••• 選單也連結至Brother 的 Skitch 操作教學影片(穿線、梭芯、機框、斷線、張力、清潔)。
  • 視窗中的 ••• 選單可以連線至模擬機器,由模擬機器自動執行機器上的每個步驟,讓你在沒有 Skitch 的情況下試用整個流程。

代理程式可以 send_to_skitch,並透過 machine_status 同步操作。此通訊協定是透過逆向工程還原的(請參閱 NOTICE),因此請避免更新韌體。

研究未公開的指令

Skitch 上的線張力不是 Bluetooth 設定,而是機器上的張力旋鈕。速度固定(每分鐘約 400 針)。機器會回報一組設定,Artspira 也有設定畫面,因此可以用這兩種工具來確認它還能做什麼:

  • 設定位元組(在 Skitch 視窗的機器詳細資料下方):讀取機器回報的設定區塊。讀取後中斷連線,在 Artspira 中變更一項設定,關閉 Artspira,重新連線並再次讀取:變更過的位元組會以標記顯示。每次讀取都會儲存在 skitch-settings.log,位於面板配置旁邊。命令列操作方式:zigzag skitch settings --label "what changed" --log settings.log。
  • zigzag capture FILE lists the Skitch conversation in a Bluetooth recording of Artspira, by command name, with changed settings bytes in [brackets] (--all for the upload and polling too, --raw for every ATT operation). It reads both:
    • iPhone:在手機上安裝 Apple 的 Bluetooth 記錄設定描述檔(developer.apple.com › Bug Reporting › Profiles and Logs),重新啟動手機,將它接上 Mac,然後在 PacketLogger(Apple 的 Additional Tools for Xcode)中選擇 File › New iOS Trace;儲存追蹤記錄(.pklg)。
    • Android:依序前往「開發人員選項」›「啟用 Bluetooth HCI snoop 記錄」,接著 adb bugreport,並從中取得 btsnoop_hci.log。

在確認配置已知,且機器原有設定未經變更寫回後能讀回相同內容之前,ZigZag 不會加入設定寫入功能。

與 Ink/Stitch 的功能對照

參照 Ink/Stitch 的功能與工具檔案核對:

Ink/Stitch ZigZag
Running、bean、手動針跡;緞面柱(兩條導軌加上橫檔)、E 形針跡;tatami、輪廓、圓形(螺旋)填針 ✓
波浪、迂迴、十字繡與格紋填針;S 形針跡、鋸齒與多色緞面針跡 ✓
每個物件的引數與依布料設定的預設值;起始/結束指令;剪線與停止指令 ✓(Stitch 面板的 Sewing 列)
自動規劃路徑(在填針區域內移動,沿輪廓使用底層路徑),從針跡跳至線條 ✓(檔案的 Connect gaps)
模擬器、針跡計畫預覽、密度圖、堆疊順序標籤 ✓
文字排版(系統字型、弧形、沿路徑排列文字、多行、大小寫、縮放)、線色盤、全部比對、線材套組 ✓(Brother 和 Janome 色表)
複製引數、依型別選取、翻轉緞面方向、測試色樣、清理、疑難排解(Issues) ✓
匯入針跡檔案並逐針編輯;PES/DST/EXP/JEF/VP3/PEC ✓
漸層填針、引導式填針;redwork、鏤空繡;預先數位化字型;60+ 個線材品牌;PDF 列印 尚未支援

與 Hatch 的功能對照

參照 Wilcom Hatch 的核心功能集核對:

Hatch ZigZag
Tatami、緞面針跡、平針/三重平針、輪廓填針、毯式針跡、貼布繡、手動針跡 ✓
自動底針、拉伸補償、自動間距、緞面自動分割、短針 ✓
可設定密度與補償的布料設定 ✓(4 種預設)
使用 TrueType 字型排字,基線可設為直線、弧形或路徑 ✓(系統字型)
選取、移動、調整大小、旋轉、鏡射、複製、剪下/貼上、對齊繡框 ✓
手動數位化圖形與針跡 ✓(筆工具)
移除重疊、排列線色順序、重新排序物件 ✓
針跡播放器、顯示針點、格線、測量 ✓
開啟與儲存 PES、DST、EXP、JEF、VP3 ✓(僅能寫入 VP3)
生產工作表 ✓(HTML)
點陣圖自動數位化 ✓(Image Trace:平面標誌、色調分離照片、中心線)
內建刺繡字型、字母組合刺繡、多繡框、圖樣/紋理填針、3D 泡棉 尚未支援

狀態

已驗證:

  • 136 個程式庫測試、153 個編輯器/MCP 測試(使用 egui_kittest 進行 UI 互動、完整代理工作流程、實際 HTTP JSON-RPC 工作階段、原子批次、使用模擬機器測試 Skitch 流程),涵蓋內建與未內建 Bluetooth 的情況,另外還有 vendored Image Trace 的 222 個測試。
  • 所有寫入器(PES、DST、EXP、JEF、VP3)寫出的檔案經 pyembroidery 讀回後,針跡位置完全相同;我們的讀取器也能讀取由 pyembroidery 寫出的檔案。
  • PEN 輸出已與手動計算的序列比對。
  • Studio 在 Mesa OpenGL 上執行,並透過 MCP 由代理程式操作。

尚未在實際的 Skitch 上執行。

螢幕截圖與影片

使用 ZIGZAG_CAPTURE=<folder> 啟動工作室,按下 ⌃⌥⌘S 可將視窗儲存為全解析度 PNG;按下 ⌃⌥⌘R 可開始或停止錄製。 packaging/media/encode.sh <folder>/take-001 demo 可將錄影轉換成 demo.mp4 和 demo.gif(需要 ffmpeg)。

致謝

ZigZag 使用的程式庫授權請參閱 NOTICE 和 THIRD-PARTY-NOTICES.md(變更相依套件後,使用 packaging/licenses/generate.sh 重新產生)。PES/PEC/DST 格式配置和 Brother 調色盤取自 pyembroidery(MIT 授權)。影像描圖功能取自 VectorCraft(MIT 或 Apache-2.0 授權);其曲線擬合、即時圓角、吸附目標和色差功能也已移植(請參閱 vendor/README.md)。 Tatami、緞面針法和短針的實作方式參考 Ink/Stitch。

讀者討論

理性交流 · 即時討論