
开发者因刺绣机订阅限制自建开源应用ZigZag
来源标题:Show HN: My $300 embroidery machine needed a subscription, so I built my own app
开发者因价值300美元的刺绣机被订阅制限制,用Rust自建可视化刺绣编辑器ZigZag。该应用支持将SVG转为针脚,内置MCP协议让AI代理参与设计,可导出PES、DST等多种格式,并通过蓝牙直连Brother Skitch(PP1)。目前已提供Mac和Windows版本下载。
以下正文由 AI 翻译自 Hacker News(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
ZigZag 是一款用 Rust 构建的视觉化刺绣编辑器,性能出色,内置 MCP(Model Context Protocol)支持,让 AI agent 可以和你一起创建和编辑设计。把 SVG 图形转换成针迹,在编辑器中精细调整,然后导出 PES、DST、EXP、JEF 或 VP3,以广泛兼容各类刺绣机——也可以通过蓝牙把设计直接发送到 Brother Skitch(PP1)。在 Illustrator 里画、在 ZigZag 里画,或者让 agent 来画。Rust 引擎和 zigzag 命令行工具在编辑器之外驱动同样的工作流。zigzag-demo.mp4
下载 Mac 版
下载 ZigZag.dmg
适用于 Apple Silicon 和 Intel Mac,要求 macOS 11 或更高版本。打开 DMG,然后把 ZigZag 拖进 Applications。该版本已由 Apple 签名并公证。无需安装 Rust。
下载 Windows 版 ZigZag
——即最新 release 中的 ZigZag-<version>-x86_64-windows.zip 资源。适用于 64 位 Windows 10(版本 1709 或更高)和 Windows 11。解压后双击 ZigZag.exe。对于没有 Microsoft 受信签名的应用,Windows SmartScreen 会在首次运行时发出警告;点击“更多信息”→“仍要运行”。无需安装 Rust。
发布说明与校验和
· 发布一个版本
zigzag/
src/svg.rs SVG 导入(usvg):填充和描边部分、变换、文字
src/document/ 可编辑文档;设置会写回 SVG id,布局编辑保存为 SVG 变换,还有文字排版
src/params.rs 针迹设置 token + 面料预设
src/stitch/fill.rs tatami 填充(扫描线分段、交错行)
src/stitch/satin.rs 缎面针迹列:两条轨道、自动缎面、衬底针、短针迹
src/stitch/stroke.rs 平针 / 三重平针
src/boolean.rs 多边形布尔运算和偏移(i_overlay)
src/design.rs 规划器:重叠去除、封顶顺序、路径规划、剪线
src/checks.rs 制版检查(尺寸、宽度、文字、绣花框)
src/formats/ PES(+PEC)、DST、EXP、JEF、VP3、Skitch PEN 写入器; PES/PEC/DST/EXP/JEF 读取器;预览;工作表
src/machine/ Skitch 蓝牙协议(+ btleplug 客户端,ble feature)
src/studio/ 编辑器(基于 egui,通过 glow 使用 OpenGL)+ MCP 服务器(gui feature)
src/mcp_bridge.rs 为会启动命令的 MCP 客户端提供 stdio ↔ HTTP 桥接
构建
cargo build --release # CLI + MCP 桥接,无系统依赖
cargo build --release --features gui,ble # + studio 编辑器和 Skitch 上传
在 Linux 上,gui 需要常规的 X11/Wayland 和 OpenGL 开发库。ble 所用的 libdbus 已随项目内置。
类型
作用
适用对象
填充(tatami)
交错行,任意角度,带衬底(边缘走线 + 行)和拉伸补偿
填充形状
缎面
两条轨道之间的 Z 字形列,带中心/轮廓/Z 字形衬底、拉伸补偿,在急弯处使用短针迹;平针、S 形针迹或 Z 字形面线;可跨列使用多根线(多色缎面)
描边(任意宽度);Ink/Stitch 风格的双轨路径带横档;填充形状:圆环使用内/外轮廓,条状/字母/月牙在其端点处分段(自动缎面),或边框跟随轮廓
平针
平针针迹,单重或三重(bean)
描边和轮廓
轮廓
向内跟随轮廓的行,或从中心向外的一根螺旋(Ink/Stitch 的圆形填充)
填充形状
毛毯
E 字针迹:一条线,带伸入形状的齿
边缘、贴布绣
贴布绣
定位线 → 停 → 固定 → 停 → 缎面覆盖
填充形状
手动
每个路径点都是针点
导入的机器文件、钢笔工具
蜿蜒
穿过形状的一条游走线,绗缝风格:轻盈柔软
填充形状
波纹
跟随轮廓的开放平针行,或一根螺旋
填充形状
十字绣
由 X 组成的网格,按半十字行去程、回程缝制
填充形状
格子
多根线织成的条纹(在面板中编辑一个镜像的 set),每根线各占一个色块
填充形状
宽度超过 7 mm 的缎面会自动拆分(更短、交错的针迹),并使用自动间距(窄列更疏,宽列更密)。
在装有 Rust 和 Xcode 命令行工具(xcode-select --install)的 Mac 上:
packaging/macos/make-app.sh --install # 构建 ZigZag.app 并复制到 /Applications
packaging/macos/make-app.sh --dmg # 同时生成 dist/ZigZag-<version>.dmg 用于分享
packaging/macos/make-app.sh --universal # 生成一个同时适用于 Apple Silicon 和 Intel Mac 的 app
packaging/macos/make-app.sh --release # 用于发布的 DMG:universal、已签名、已公证
--release 会用你的 Developer ID 签名,并由 Apple 对 app 和 DMG 进行公证,这样它能在任何 Mac 上打开而不会出现警告。事先需要做一次:添加 Developer ID Application 证书(Xcode › Settings › Accounts › Manage Certificates › +),在 account.apple.com 生成一个 app 专用密码,并把公证凭据保存到你的 keychain:
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 只做 ad hoc 签名,不做公证。它在构建它的那台 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 使用浅色图标。studio 运行时,其 Dock 图标跟随 app 的浅色/深色主题,包括 ZIGZAG_THEME=light|dark 覆盖设置。
zigzag-studio [design.svg|logo.png] [--mcp-port 7878 | --no-mcp | --mcp-stdio]
布局像 Illustrator,风格像 Mac app:
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。