IllTool
Illustration-to-production toolkit for Adobe Illustrator on macOS
A native plugin (C++/Objective-C) plus a Python MCP pipeline for drawing, rigging, storyboarding, and automation.
______________________________________________________________________
这是什么
一个仓库中有两个项目：
plugin/--Illustrator插件
macOS Illustrator 2026原生插件（C++Objective-C面板）。Illustrator内部有13个以任务为中心的模块：主题剪切、透视自动匹配、对称性校正、跟踪、形状清理、智能图层等。发送本地HTTP网桥(127.0.0.1:8787)所以外部工具可以驱动它。
src/ill_tool/--Python MCP管道
用于从插图到生产工作的模型上下文协议服务器。跨Adobe CC应用程序编排绘图、装配、动画和故事板工作流（包装兄弟应用程序 plugins/adobe-mcp-* PS、AI、AE服务器）。
你可以独立使用其中的一半。插件是日常绘图界面；MCP服务器是代理工作流的批处理/编排层。
______________________________________________________________________
插件：IllTool（macOS）
模块
| # | 模块 | 它的作用 |
|---|---|---|
| 1 | 选择 | 按形状/颜色/表面标识进行智能选择 |
| 2 | 清理 | 平均接近重复点，简化形状，清理痕迹 |
| 3 | 视角 | 自动匹配参考图像中的VP（自适应Canny、Hough、ML法线、可选三点）；手动网格，捕捉到透视图，每行颜色图例 |
| 4 | 合并 | 焊接端点、连接路径 |
| 5 | 分组 | 按曲面标识（法线簇）、图层颜色预设分组 |
| 6 | 混合 | 使用可编辑的缓和曲线+可保存的预设在两条路径之间进行插值 |
| 7 | 着色 | 色调填充/阴影与光方向控件+颜色采样 |
| 8 | 分解 | 打破化合物，自动分解复杂艺术 |
| 9 | 变换 | 带有实时预览的相对/绝对变换 |
| 10 | 追踪 | 图片→ 具有多个后端的矢量：vtracer、OpenCV轮廓、StarVector（ML）、CartoonSeg、Apple轮廓（Vision）。加上正常参考、形状边缘提取、深度层、对象裁剪、对称性校正、DiffVG校正、分析参考、姿态检测 |
| 11 | 表面 | 法线贴图驱动的曲面提取+分组 |
| 12 | 笔 | 使用实时预览、智能捕捉、图层模式绘图 |
| 13 | 层 | 带有预设和活动手风琴的智能层面板 |
视觉智能
跨平台机器学习视觉后端包装：
- Apple Vision框架 --主题分割(
VNGenerateForegroundInstanceMaskRequest)、轮廓检测、身体/面部/手部姿势 - ONNX 运行时 --与Apple Silicon上的CoreML执行提供商合作
- Metric3D v2 （ViT-S ONNX）--单个图像的度量深度+曲面法线
- 深度任意V2 --分层深度分解
中的所有模型文件 plugin/models/.
剪切工作流程（示例）
- 在Illustrator中打开参考图像
- 跟踪面板→ 主题剪辑→ 预览 --视觉找到主体，显示绿色覆盖
- 按住Shift键并单击以添加区域，单击选项以减去（遮罩约束的洪水填充）
- 剪下 --在新图层上创建矢量切割线，并嵌入透明背景PNG以替换原始光栅
构建/部署
# Requires: Xcode, Adobe Illustrator 2026 SDK 30.2, Developer ID certificate
bash plugin/tools/deploy.sh该脚本根据SDK编译，与Apple Developer ID进行代码签名，提交公证，装订并安装到 ~/Developer/ai-plugins/IllTool.aip。重新启动Illustrator以加载。
建筑
Illustrator (plugin loads on startup)
│
├── 13 modules ◄──┐
├── Panels (Objective-C, per module)
├── Annotator (draw overlays)
├── Timer op queue (10 Hz SDK context)
└── HTTP bridge :8787
│
└── external clients (Python MCP, curl, Claude)plugin/Source/*.cpp--核心插件（启动、路由、桥接）plugin/Source/modules/*.cpp--每个功能模块实现plugin/Source/panels/*.mm--Objective-C++面板（Cocoa NSViews）plugin/Source/VisionEngine.cpp,VisionIntelligence.cpp,OnnxVisionBridge.cpp--ML后端plugin/models/--ONNX权重（Metric3D等）plugin/Resources/en.lproj/Localizable.strings--i18n基础设施（213个字符串）
______________________________________________________________________
Python MCP管道(ill-tool)
安装
pip install ill-tool
# or from source:
pip install -e .跑
python -m ill_tool注册为MCP服务器。指向Claude Code、Claude Desktop、Codex CLI或Gemini CLI plugins/adobe-mcp-ai, adobe-mcp-ps, adobe-mcp-ae 提供直接的应用程序自动化； ill_tool 将更高层次的插图编排到生产流程中（故事板→ rig → 使有生气→ 出口）。
看 plugins/*/README.md 适用于每个应用程序的MCP服务器。
______________________________________________________________________
回购布局
ill_tool/
├── plugin/ # IllTool Illustrator plugin (C++/Obj-C)
│ ├── Source/ # Modules, panels, bridge, vision engine
│ ├── Resources/ # Localized strings, cursors
│ ├── models/ # ONNX weights
│ ├── blender/ # Blender render pass exporter
│ └── tools/deploy.sh # Build + sign + notarize + install
├── src/ill_tool/ # Python MCP pipeline
├── plugins/
│ ├── adobe-mcp-ai/ # Illustrator MCP server
│ ├── adobe-mcp-ps/ # Photoshop MCP server
│ └── adobe-mcp-ae/ # After Effects MCP server
├── cep/ # Legacy CEP extension (pre-plugin)
├── wiki/ # Project knowledge base
├── thoughts/ # Handoffs, plans, research
└── docs/ # Reference documentation______________________________________________________________________
需求
- macOS （推荐使用Apple Silicon；插件为
arm64) - Adobe Illustrator 2026 （SDK 30.2）用于插件
- 项目 +要构建的Adobe开发人员ID证书
- Python 3.10+ 对于MCP管道
- ONNX型号 --下载引用于
plugin/models/THIRD_PARTY_NOTICES.md
______________________________________________________________________
状态
积极发展。分行： fix/pen-tool-and-polish最近的工作包括视觉智能后端、对称性校正、透视自动匹配增强、具有掩模约束的泛光填充的主题裁剪、定位基础设施和Layer智能面板。
看 thoughts/shared/handoffs/ 关于会议历史和 wiki/index.md 项目知识库。
______________________________________________________________________
许可证
麻省理工学院——见 许可证.
第三方模型许可证：见 plugin/models/THIRD_PARTY_NOTICES.md.