storytold/vectorcraft · 上手攻略

仓库：storytold/vectorcraft
链接：https://github.com/storytold/vectorcraft
分类：创意工具 · 矢量图形
作者：Tom
更新：2026-10-06

这是什么

VectorCraft 是一个用纯 Rust 从零实现的 Adobe Illustrator 替代品，由 ArtCraft 团队开发。团队称之为"清洁室实现"（clean-room）——完全独立重写，不依赖 Adobe 任何代码。它的目标不是简单复刻 UI，而是完整还原 Illustrator 的工作流程和渲染能力，同时让 AI Agent 可以像人一样驱动这个工具。

核心定位是矢量图形编辑器 + AI Agent 原生工具：既可以作为桌面应用让人手动绘图，也可以通过 MCP（Model Context Protocol）服务器让 Claude 等 Agent 以编程方式执行绘图操作、导出文件。

⚠️ 当前版本（2026-10-05 自评）功能覆盖率约 68–74%，"专业用户无法分辨"程度约 40–55%。日常矢量绘图基本可用，但尚不支持 3D、Photoshop 风格滤镜、CJK 竖排文字、脚本变量和 Windows/Linux 打包。

解决什么问题

Illustrator 闭源依赖：专业矢量工具长期被 Adobe 垄断，VectorCraft 提供了第一个开源可自托管的完整方案。
AI Agent 矢量操作缺口：现有 AI 绘图工具（Midjourney、DALL-E 等）输出位图，无法完成"精确布尔运算""渐变网格""文字样式"这类需要精确控制的工作。VectorCraft 的 MCP 接口让 Agent 能像人一样操控矢量工具链。
跨平台矢量渲染：一份代码跑 macOS / Windows / Linux + WebAssembly，无需虚拟机或交叉编译。
精确渲染性能：SIMD 多线程光栅化，20,000 个图形在 Retina 分辨率下约 27ms 渲染完，界面保持 120fps（⚠️ 数据来自 README 实验室测试，实机表现待验证）。

快速安装

环境要求

Rust 工具链（rustup 最新版）
macOS（当前主要测试平台）
对于 MCP CLI 部分：需要 cargo run --release -p vectorcraft-cli

从源码构建

# 克隆仓库
git clone https://github.com/storytold/vectorcraft.git
cd vectorcraft

# 桌面应用
cargo run --release -p vectorcraft

# MCP 服务器（stdio 模式，供 Agent 调用）
cargo run --release -p vectorcraft-cli -- mcp

# 批量导出（无需 GUI）
cargo run --release -p vectorcraft-cli -- run --in examples/ribbons.vectorcraft --export out.pdf

# 性能基准测试
cargo run --release -p vectorcraft-cli -- bench examples/neon-drive.vectorcraft

# 构建 macOS 应用包
cargo xtask bundle

⚠️ 编译约需 10–20 分钟（冷编译），M 系列芯片和 x86 平台均支持但需确认对应目标三元组。

WebAssembly 版本

cd apps/vectorcraft-web && trunk build --release
# 产出在 dist/web，可部署到任意静态托管

⚠️ WebAssembly 版本功能与桌面版一致，但性能受浏览器沙箱限制，大文件操作可能更慢。

注册 MCP 服务器到 Claude Code

claude mcp add vectorcraft -- /path/to/vectorcraft-cli mcp

⚠️ 路径需替换为实际编译产物位置，默认在 target/release/vectorcraft-cli（Linux/macOS）或 target/release/vectorcraft-cli.exe（Windows）。

核心用法

桌面应用操作

启动后获得与 Illustrator 相似的界面： - 钢笔工具（Pen）：完整贝塞尔曲线，支持直接选择锚点和手柄 - 路径查找器（Pathfinder）：精确布尔运算（合并、相减、交集等），无"无法执行操作"报错 - 渐变与渐变网格（Gradient Mesh）：线性/径向渐变 + 多节点渐变网格 - 实时混合（Live Blends）：可编辑混合步数和颜色 - 封套扭曲（Envelope Distort）：文字和图形沿路径变形 - 多画板支持：同一文档多个画板，适合 UI 设计稿

AI Agent 调用（MCP 协议）

Agent 可以通过 JSON 控制协议驱动所有菜单、工具和面板。以下是 MCP 服务器的核心用法模式：

# 启动带 JSON 控制通道的桌面应用（端口 7979）
cargo run --release -p vectorcraft -- --control 7979

# Agent 通过 WebSocket 或 HTTP 发送 JSON 指令操作画布

详细协议规范见 docs/control-protocol.md（⚠️ 需从仓库 docs 目录获取，GitHub raw 内容未 fetch 到）。

批量导出（CLI）

# SVG 导出
cargo run --release -p vectorcraft-cli -- run \
  --in examples/neon-drive.vectorcraft \
  --export out.svg

# PDF 导出（Illustrator 兼容）
cargo run --release -p vectorcraft-cli -- run \
  --in examples/feature-sheet.vectorcraft \
  --export out.pdf

# PNG 导出（Retina 分辨率）
cargo run --release -p vectorcraft-cli -- run \
  --in examples/dusk-poster.vectorcraft \
  --export out.png --scale 2

⚠️ --scale 参数需确认是否已实现（README 未明确列出，建议以实际 CLI 帮助输出为准）。

文件格式

.vectorcraft：原生格式，JSON 结构，完全透明
SVG：导入/导出均支持
PDF / .ai：导出 PDF 以及 PDF 兼容的 AI 格式（⚠️ PDF/X、EPS、DXF、EMF/WMF 等为导入支持，导出能力以实际测试为准）
位图：PNG、JPEG、WebP、GIF、TIFF、BMP

典型适用场景

场景	适合程度	说明
日常矢量插画绘制	★★★★	基础工具链完整，性能优秀
AI Agent 批量生成矢量素材	★★★★★	MCP 原生支持，竞品无此功能
SVG 批量转换 / 导出	★★★★	CLI 批处理可用
Web 原型矢量图	★★★	WebAssembly 版本可用，但生态尚薄
替换 Illustrator 工作流	★★	仍有 30% 功能缺口，不适合专业出版

坑与注意

功能尚不完整（最大坑）：3D 效果、Photoshop 滤镜、CJK 竖排文字、脚本变量均未实现。入手前先读 ROADMAP.md 的"honest assessment"章节，确认你的核心需求在支持范围内。
Windows / Linux 打包缺失：README 明确说明这两平台尚未提供打包好的安装程序，需从源码自行编译。
MCP 服务器注册路径问题：claude mcp add 需要填写绝对路径，编译产物位置因平台和 cargo 配置而异，新手容易踩坑。
控制协议文档未完全 fetch：README 链接到 docs/control-protocol.md，但该文档的原始内容本次未成功抓取，Agent 开发者需要自行 clone 仓库查阅。
自评数据仅供参考：68–74% / 40–55% 是团队自我评估，非第三方审计，实际体验可能与官方描述有偏差（⚠️）。
文件格式兼容风险：PDF 导出标榜"Illustrator 兼容"，但实测覆盖率未知，交给印前或正式出版流程前务必人工核对。
社区规模小：Discord 活跃度一般，遇到问题更多靠阅读源码解决，对开源新手不友好。

与同类对比

工具	语言	AI Agent 集成	平台	成熟度	许可证
VectorCraft	Rust	✅ MCP 原生	macOS/Linux/Web	0.68–0.74	⚠️ 待确认（README 无明确 License 段）
Inkscape	C++/Python	❌	全平台	高（20年+）	GPL
Affinity Designer	C++	❌	macOS/Win/iPad	高	商业买断
Illustrator	闭源	❌	全平台	极高	订阅制
Skribisto	Rust	❌	Linux/Web	低	AGPL

结论：VectorCraft 是目前唯一把 Rust 矢量引擎 + MCP 协议深度结合的项目，专为 AI 原生绘图工作流设计。如果你需要让 Agent 生成精确矢量图，这是目前的不二选择。如果只是日常手动绘图，Inkscape 或 Affinity Designer 更成熟稳定。

一句话推荐结论

VectorCraft 是 AI Agent 矢量绘图的唯一开源可行方案，适合需要让 AI 精确控制 SVG/PDF 输出的开发者；日常手动使用建议等待 1.0 版本。