无限画布 (infinite-canvas)

快速开始 · 功能介绍 · Render 部署 · Docker 部署 · 画布节点操作手册 · 画布快捷键 · 漏洞提交 · 待办事项 · 本地 Canvas Agent · Codex app 插件

无限画布是一款面向图片创作的开源工作台。它把画布编排、AI 图片生成、参考图编辑、3D 生成、对话助手、提示词库和素材沉淀放在同一个界面里，适合用来探索视觉方案并连续迭代生成结果。

Caution

项目目前处于开发阶段，不保证历史数据兼容。各种本地存储格式都可能直接调整，欢迎关注后续更新。

如果你需要稳定维护自己的分支，建议自行 fork 后独立开发。二次开发与 PR 请保留原作者信息和前端页面标识。

核心功能

• 无限画布：多画布项目、节点拖拽缩放、连线、小地图、撤销重做、导入导出。
• AI 创作：浏览器前台直连你配置的 OpenAI 兼容接口，支持文生图、图生图、参考图编辑、文本问答、音频和视频生成。
• 3D 生成：接入 Tripo，支持文生 3D、图生 3D、多视图生 3D，节点内可拖拽旋转查看模型，并提供一整套 3D 后处理操作。
• 本机 3D 软件联动：已生成的模型可直接导入本机 Blender，或唤起 Bambu Studio 打开 3MF。
• 画布助手：围绕选中节点和上游节点对话、生图，并把结果插回画布。
• 本地 Agent：通过本机 Canvas Agent 连接 Codex / Claude Code，让 Agent 通过 MCP 操作当前画布。
• Codex App 插件：提供 Codex app 插件，安装后会自动注册 MCP 并尝试拉起本地 Agent。
• 插件系统：支持通过 URL 动态安装 / 启用 / 更新 / 卸载远程节点插件，并提供 TypeScript SDK 自行开发画布节点插件。
• 自定义接口调用：可自定义生图 / 视频接口的调用方式，灵活适配各类中转站与自建服务。
• 提示词库：内置 7 个开源提示词来源并支持自定义标准 JSON 来源，由浏览器前端直连并缓存到 IndexedDB。

完整功能说明见 功能介绍。

3D 与 Tripo

3D 能力由 Tripo 提供，配置和使用要点如下，完整说明见 画布节点操作手册。

配置

• 在配置弹窗新增渠道，apiFormat 选择 Tripo，并填入该区域的 API Key。
• Tripo 分国内版（openapi.tripo3d.com）和海外版（openapi.tripo3d.ai）两个独立区域，选择 Tripo 后渠道编辑器会出现区域切换；两个区域是独立账号，需各自填写 Key。
• API Key 购买入口：国内版 · 海外版。
• 必须开启 本地代理：Tripo 的 /v3 接口不返回 CORS 头，浏览器无法直连。
• Tripo 渠道同时提供 3D 与图片生成能力，图片模型是它自己的一套（seedream、banana、chat_image 三个系列）。

生成

• 工具栏和连线创建菜单都可以新建 3D 节点，节点内使用可拖拽旋转、滚轮缩放的查看器展示 glb。
• 空 3D 节点输入提示词走文生 3D；连接 1 个图片节点走图生 3D；连接 2–4 个图片节点走多视图生 3D，节点左侧的四个视角接点（正面 / 左侧 / 背面 / 右侧）用来指定每张图的视角。
• 3D 设置包含贴图、PBR 材质、贴图质量和面数上限；面数上限留空为自动。
• Tripo 生成是异步任务：任务 ID 写入节点，刷新页面会自动继续查询。生成成功后 glb 和预览图会立即下载到浏览器本地存储，因为 Tripo 的签名地址一天后失效。

3D 操作

悬停已有模型的 3D 节点打开「3D 操作」：重新贴图、自动绑骨、套用动画、减面、分割部件、网格补全和转换格式。除转换写回原节点外，其余操作都会在右侧生成新的 3D 节点并连线。

• 自动绑骨会先跑 Tripo 免费的可绑骨检测，模型不可绑骨时直接提示，不消耗 credits。
• 套用动画只能接在本画布绑过骨的节点后面，网格补全只能接在本画布分割过的节点后面。
• 转换格式支持 FBX、GLTF、USDZ、OBJ、STL、3MF；产物留在原节点上，可从菜单下载。

导入本机软件

• 导入 Blender：经 Tripo Bridge 插件的 ws://127.0.0.1:60600 把已存文件发给本机 Blender。需要用 http://localhost 打开画布，HTTPS 页面不允许连接本机 ws；3MF 不会发给 Blender。
• 打开 Bambu Studio：用 bambustudio://open?file= 唤起本机 Bambu Studio 打开 3MF。节点还不是 3MF 时会自动转换并写回（消耗 credits）；转换时记下的 Tripo 地址仍有效就直接用它，否则由本机 Canvas Agent 临时托管该文件。

多选或选中含 3D 的组可以一起操作。这两项都是画布 UI 操作，MCP 没有对应工具。

Agent 生成 3D

Canvas Agent 把 3D 注册为一等生成工具 canvas_generate_model3d：仅有提示词走文生 3D，带上已有图片节点 ID 则走图生 3D 或多视图生 3D。

快速开始

AI API Key、Base URL、画布、素材和生成记录默认保存在浏览器本地。

让 AI 帮你安装、启动和连接

下载 AI 启动连接说明，把文件发给 Codex、Claude Code 等 AI，并附上：

请按照这份说明，帮我检查依赖、启动 Infinite Canvas 并连接到当前 AI。能直接执行的步骤请直接执行，最后读取真实画布状态确认连接成功。本地项目目录是：<你的项目目录>。

AI 会按说明启动或复用前端、转发代理和 Canvas Agent，打开画布，并通过 MCP 或鉴权 HTTP 验证连接。需要安装依赖或修改 MCP 配置时，请按客户端提示授权；不要把连接 token 发到聊天中。

也可以使用 setup-canvas Skill：在支持的客户端安装或加载后调用；已有 Codex 插件的用户可使用 $open-canvas 并明确要求启动本地项目。

需要 AI 具备你本机的终端权限。 纯聊天 AI 或仅有云端终端的 AI 无法直接启动你的电脑，只能提供操作指导。API Key 配置与 Blender 连接需另行完成。

让 AI 帮你安装 Blender MCP 与导入桥接

把 Blender MCP 与 Tripo Bridge 安装连接说明 发给有本机终端权限的 AI，并说：

请按这份说明帮我安装并连接 Blender MCP 和画布需要的 Tripo DCC Bridge，只配置我正在使用的 AI 客户端，保留已有配置。先读取真实场景验证 MCP，再经我确认用一个现有模型验证导入，不要清空场景或渲染。

上游项目 提供自动配置命令（需先安装 uv）：

uvx mcp-for-blender setup

按提示选择客户端。AI 终端不支持交互时，可由用户运行此命令，或按说明分步安装。Blender MCP 能执行 Python，请先保存工作并确认安装权限；它使用的默认 9876 连接与画布导入模型所需的 60600 Tripo Bridge 是两套独立配置。

本地开发

git clone git@github.com:basketikun/infinite-canvas.git
cd infinite-canvas
cd web && bun install && cd ..
node scripts/dev.mjs          # 一键启动前端 :3000 + 转发代理 :23210
node scripts/dev.mjs --agent  # 同时启动本地 Canvas Agent

一键启动会让前端默认走本地转发代理（Tripo 必需），Ctrl+C 一起退出；23210 已有代理在跑时直接复用。只想启动前端可在 web 目录执行 bun run dev。

Docker 运行

git clone git@github.com:basketikun/infinite-canvas.git
cd infinite-canvas
docker compose up -d

运行后默认端口3000，可访问 http://localhost:3000。

首次打开后进入右上角配置，填入自己的 OpenAI 兼容 Base URL 和 API Key；需要 3D 时按上面的说明添加 Tripo 渠道。

如果默认的OpenAI接口调用方式与您的API不同，可自定义生图/视频脚本调用。

效果展示

原项目与开源协议

本项目源自 basketikun/infinite-canvas。

本项目使用 MIT License。任何人都可以免费使用、复制、修改、分发、再授权和商业使用本项目，也可以用于闭源产品。