AI导哈

Illustrator插件与自动化工具包

IllTool是一款针对Adobe Illustrator的macOS原生插件与Python MCP管道工具包，提供绘图、绑定、故事板和自动化功能，适用于插画制作到生产的全流程工作。

  • by rydersd
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 rydersd/ill-tool

使用说明

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.

这是什么

一个仓库中有两个项目：

  1. plugin/ --Illustrator插件 macOS Illustrator 2026原生插件（C++Objective-C面板）。Illustrator内部有13个以任务为中心的模块：主题剪切、透视自动匹配、对称性校正、跟踪、形状清理、智能图层等。发送本地HTTP网桥(127.0.0.1:8787)所以外部工具可以驱动它。

  2. 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/.

剪切工作流程（示例）

  1. 在Illustrator中打开参考图像
  2. 跟踪面板→ 主题剪辑→ 预览 --视觉找到主体，显示绿色覆盖
  3. 按住Shift键并单击以添加区域，单击选项以减去（遮罩约束的洪水填充）
  4. 剪下 --在新图层上创建矢量切割线，并嵌入透明背景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.

相关 MCP