Inkbolt vector and raster editor

Inkbolt

为 AI Agent 提供本地矢量与栅格编辑。

Inkbolt 为 Agent 提供可编辑的图形工作区，用于处理图表、插画、布局和图像素材。创建或导入作品，进行有针对性的修改，查看预览并导出结果，同时保留源文件和修订历史记录。

它可通过 基于 stdio 的 MCP、JSON 命令行界面或 Rust 库在本地运行。无需账户或网络服务，也不会收集遥测数据，且不要求使用特定 AI 模型。

安装并连接 · 试用示例 · 下载发行版

可以做什么

• 组合图形，使用矢量形状、文本、图像、图层和画板。
• 导入作品，支持 SVG、PNG、JPEG 和 TIFF。受支持的 SVG 内容可保持可编辑，包括样式、可复用符号、置入图像和定位文本。
• 选择和蒙版图像区域，支持羽化边缘或前景／背景种子。保持蒙版可编辑，并保留原始图像采样。
• 编辑和修复图像，使用画笔、调整、修补、区域填充、内容感知移动和引导式边缘校正。原生存储支持高精度采样，并可在编辑间共享未更改的数据。
• 查看修订，使用预览、比较、已保存的会话和撤销／重做。
• 交付素材，在受支持的工作流中导出为 PNG、JPEG、TIFF、SVG 或 PDF。预检会在发布前报告输出大小和转换损失；文件交付会保留源文件，并拒绝覆盖现有输出文件。

Agent 会在工作过程中发现工具并请求各项操作的架构。遇到不支持的功能时会明确报错；声明的近似处理和转换损失也会一并报告。

Agent 如何使用 Inkbolt

1. 发现相关工具并创建或导入文档。
2. 进行有针对性的编辑，预览结果并比较修订。
3. 保存可编辑会话，检查预期导出内容，然后发布到新文件。

已保存的会话可让 Agent 稍后继续处理文档及其修订历史记录。

开始使用

本 README 介绍的是 main。 下载发行版以获取打包版本，或从源代码构建以使用下文介绍的较新功能。请根据你的系统和 MCP 客户端，参阅安装指南。

版本	预期内容
v0.82.0 发行版	提供 Windows x64、Linux x64 和 macOS Apple 芯片架构的压缩包，以及 Windows 桌面扩展包。发行说明会介绍所包含的功能。
从 main 构建	增加了更大型图像编辑、原生 JPEG 导入、引导式选区和蒙版、修补、可编辑的分层导入，以及更低内存占用的导出。下文介绍的大图像工作流需要使用这个较新的源码构建版本。

对于 MCP 客户端，请在启动命令中指定你想要进行操作的现有文件夹路径：

inkbolt --workspace PATH_TO_EXISTING_FOLDER mcp --tools core

核心工具目录可让初次发现工具的过程保持精简。Agent 可在需要时请求更多操作及其架构。

文档

入门指南	详情
示例	可运行的图形和图像工作流
Agent 接口 和 工具发现	命令、MCP 工具和架构
工作区和会话	本地资源、已保存的工作和修订版本引用
SVG 导入、图像导入 和 分层导入	可编辑输入、源精度和转换限制
选区、蒙版 和 图像修复	图像编辑工作流和操作限制
大型图像工作流	24 MP 导入、50 MP 编辑、A2 交付和 8192 x 8192 渲染；画笔和修饰范围
图像导出	PNG/JPEG/TIFF 文件输出、预检和内存限制
功能和限制	已验证的行为以及功能规范链接
平台支持 和 基准测试结果	已测试的系统、Agent 评估和现存差距
工作负载测量	可复现的运行时和内存检查，包括 Linux 命令行和 MCP 会话

如需了解其他工具的背景信息，请参阅 面向 AI Agent 的 SVG 和矢量编辑 MCP 服务：9 款对比。 本次对比于 2026 年 10 月 18 日核查：Inkbolt 通过 MCP 进行了测量；其他服务则根据其代码和文档进行了评审。

项目状态

Inkbolt 正在积极开发中。核心引擎、CLI/MCP、已保存的会话和文件交付回执已在 Windows、Linux 和 macOS 上通过测试。目前，后台导出任务仅支持 Windows。平台指南记录了经过测试的版本和各平台的覆盖范围。

以下大图像工作流已在 Windows 和 Linux 上通过独立输出检查：

工作流	检查尺寸
基线和渐进式 JPEG 导入	24 MP
16 位图像编辑：克隆修补、选区画笔、修复、羽化蒙版、撤销/重做和 TIFF 导出	50 MP
将 A2 页面交付为 PDF 和 PNG	300 ppi
渲染并导出 PNG，包含不透明、半透明和透明区域	8192 x 8192

这些检查使用固定的原始素材，并保留源文件和修订历史。Windows 回归预算使用五次基线重复测试和单独的五次重复检查。每项操作都有各自的尺寸、精度和工作量限制；跨平台性能验收仍在进行中。

图像引导的选区支持直接分析限定区域，也提供可选的全图模式。后者会使用缩略图像，并在全分辨率下细化边界；可能会漏掉较小的特征。两种模式都会保留原始图像采样。

可编辑的 RGB8分层导入也已在 Windows 和 Linux 上通过 8192 x 8192 尺寸的检查。更大的画布需要显式指定导入选项。本机路径会以受限分块的方式读取更大的编码文件；其契约分别列出文件、元数据和内容限制。

正在进行的工作包括扩展分层文件互操作、扩展曲线组合、可编辑格式互操作、提升 Agent 易用性，以及跨平台性能验收。

主要计划跟踪开发优先事项。 基准测试结果单独记录 Agent 评估及其局限，与引擎功能覆盖情况分开。

贡献者可以从开发指南、架构和源代码要求开始。 常规验证目标为 2-3 分钟，并在里程碑阶段执行完整检查。

许可证

Inkbolt 使用 MIT 许可证。依赖项各自保留其许可证； 请参阅第三方声明。