GPT Image Canvas 是一款基于知名开源白板工具 tldraw 构建的本地优先专业级 AI 图像创建工作区。与传统的聊天框式 AI 绘图工具不同，它将强大的 AI 生成能力与无限画板的自由交互完美结合。平台在底层整合了 Hono 框架与 SQLite 数据库，确保了极致的本地运行性能与数据隐私安全。通过这款工具，用户不仅可以通过简单的文本提示词直接在画板上生成和排版图像，还能选中现有图像无缝切换至参考图（图生图）模式。其最具创新性的“Agent（智能体）”模块，允许用户使用自然语言描述复杂的多图生成任务，AI 会自动拆解任务并生成基于 DAG（有向无环图）的执行计划节点，从而实现自动化的高级创作。此外，工具内建了完善的画廊管理与可选的多云端存储（如腾讯云 COS、Cloudflare R2）备份机制，是专业创作者、设计师以及注重隐私的团队构建视觉数字资产的首选利器。
機能一覧
- Agent多步任务规划（特色功能）：内置智能 Agent，只需输入复杂的多图生成需求描述，系统即可自动拆解并生成 DAG（有向无环图）任务规划节点。用户在执行前可预览整个工作流逻辑，实现自动化的批量创作。
- 无缝集成的 tldraw 无限画板：打破传统线性对话的限制，用户可以在无限尺寸的二维空间中自由生成、拖拽、缩放和排版 AI 图像，支持手绘批注与思维导图式的工作流整理。
- 智能感应的生成模式切换：右侧操作面板支持“手动模式”。在未选中任何元素时，默认为“文生图”；当用户在画板上选中某张图像时，系统会自动识别并无缝切换为“参考图（图生图）”模式。
- 本地优先的数据与隐私保护：采用本地 SQLite 数据库，用户的项目状态、每一次生成历史记录以及产生的所有图片素材均默认保存在本地硬盘，确保敏感数据绝不外泄。
- 全功能的本地资产画廊：内置强大的 Gallery（图库）浏览器，支持检索本地输出内容，并提供“重新运行生成”、“定位到画板对应位置”、“一键下载”以及“查看云端上传状态”等高阶管理功能。
- 灵活的 AI 接口配置：支持多种方式配置底层 AI 生图提供商。开发者可通过
.env环境变量文件进行全局配置，普通用户也可在应用内的弹窗界面手动填入 API Key，或通过 Codex 登录进行授权。 - 企业级多云存储备份支持：提供可选的云同步功能。用户可将本地生成的优质图像一键或自动备份至腾讯云 COS、Cloudflare R2 或是任何兼容 S3 协议的云存储桶中，确保资产永不丢失。
ヘルプの使用
欢迎使用 GPT Image Canvas。作为一款专业的本地化 AI 生图画板工具，它强大的功能需要通过合理的安装部署与流程化操作才能完全发挥。为了让您能够零基础快速上手并熟练掌握这一创作利器，请仔细阅读以下详细的使用与操作指南。
一、 环境准备与本地安装流程
由于 GPT Image Canvas 是一个高度定制化的本地开源项目，首次使用需要您具备基础的 Node.js 运行环境。
- 安装前置环境：请确保您的电脑已安装 Node.js（建议版本 v18 或更高）以及包管理工具（如 npm、Yarn 或 pnpm）。同时由于项目集成了本地 SQLite 数据库，大部分依赖在安装时会自动配置，无需单独安装数据库软件。
- プロジェクトコードを取得する：打开您的终端（Terminal）或命令行工具，使用 Git 克隆项目代码到本地：
git clone https://github.com/mrslimslim/gpt-image-canvas.git - プロジェクトの依存関係をインストールする：进入项目根目录，运行依赖安装命令：
cd gpt-image-canvas
npm install（或使用yarn install） - 環境変数の設定：在项目根目录下找到
.env.example文件，将其重命名为.env。打开该文件，根据其中的注释填入您的 AI 生图服务提供商的 API 密钥（如 OpenAI API Key 或其他兼容接口）。您也可以在此处配置可选的 S3 云存储密钥。 - ローカルサービスの開始：配置完成后，在终端运行启动命令：
npm run dev
终端会输出一个本地访问地址（通常为http://localhost:3000或http://localhost:5173），在现代浏览器中打开该地址即可进入画板工作区。
二、 工作区界面概览
进入系统后，您将看到一个极为干净、专业的创作环境。界面主要由三个核心区域构成：
- 中央无限画板区：由 tldraw 强力驱动，您可以在这里使用鼠标中键或触控板无限漫游，使用左侧工具栏的画笔、图形工具进行草图绘制或排版整理。
- 右侧控制面板：这是控制 AI 生成的核心中枢，分为
Manual（手动模式）和Agent（智能体模式）两个核心选项卡。 - 顶部/底部状态栏：用于管理项目文件、访问图库（Gallery）、查看本地数据库状态及配置云端同步状态。
三、 核心功能操作详解
1. 手动模式：基础文生图 (Text-to-Image)
这是最常用、最直接的创作方式。
- 手続き：确保画板上未选中任何元素。在右侧面板选择
Manual选项卡。在提示词输入框中输入您想要生成的画面描述（例如：“一只穿着宇航服在火星表面漫步的柴犬，赛博朋克风格，高清晰度”）。 - パラメタリゼーション：在下方的参数设置区，选择您期望的图像尺寸（如 1:1, 16:9, 9:16 等）、图像质量（标准、高清）以及导出格式（如 PNG, WebP）。
- 実行生成：点击“Generate”按钮。系统会在右侧面板显示生成进度，完成后，生成的图像会自动被放置在画板的合适位置。您可以随意拖拽、放大缩小以进行排版。
2. 画板交互：参考图/图生图模式 (Image-to-Image)
GPT Image Canvas 将图生图逻辑做到了极致的无缝化体验。
- トリガメソッド：在中央画板中，用鼠标单击选中一张已经存在（或您刚才生成）的图像。
- 自動切り替え：此时请注意观察右侧的
Manual面板，系统会自动将您的流程切换至“参考图像生成（Reference-image generation）”模式，并将选中的图片作为垫图载入。 - 重绘调整：在提示词框中输入新的修改指令（例如：“将狗的宇航服改成红色”），调整相似度/权重参数后点击生成，新的变体图像即刻呈现在画板上。
3. 高阶创作：Agent 多步智能任务规划
这是本工具区别于普通生图工具的“杀手锏”功能，适合有连贯性要求或复杂工作流的重度创作者。
- 进入 Agent 模式：在右侧面板切换至
Agentタブ - 输入全局任务：在任务描述框中，输入一个复杂的宏大需求。例如：“设计一个完整的游戏角色概念设定集，包含角色的正面全身像、三种不同的武器配件设计，以及一个角色在森林场景中的战斗背影”。
- 关联上下文（可选）：为了让 Agent 更好地理解风格，您可以在画板上最多选中 3 张现有图像作为该任务的风格参考。
- 生成规划节点（DAG）：点击“Generate Plan”。此时 AI 并不会立即开始作图，而是会分析您的需求，生成一个类似于节点树的执行计划（DAG）。您可以清晰地看到它拆解出的步骤：步骤1生出正面像，步骤2基于步骤1的风格生成武器，步骤3生成场景。
- 审核与执行：如果您对生成的规划节点满意，点击“Execute（执行）”按钮。系统将自动按顺序或并行处理这些批处理任务，并将所有成果有条不紊地铺陈在画板上。
四、 资产管理与云端同步
- 使用本地图库 (Gallery)：点击界面上的 Gallery 图标，将弹出一个悬浮窗口。这里以网格形式展示了您生成过的所有图片。每张图片都支持“Rerun（使用相同参数重新生成）”、“Locate（快速将视角平移到画板上该图的位置）”和“Download（保存到本地系统）”功能。
- 云端备份配置：如果您不希望占用太多本地存储，或者需要多设备协同。可以在设置或
.env文件中配置您的腾讯云 COS 密钥或 Cloudflare R2（S3兼容）参数。开启同步后，Gallery 中会显示每张图片的上传状态（绿色对勾表示已备份），有效防止电脑故障导致的资产丢失。
通过以上步骤，您已经完整掌握了 GPT Image Canvas 的所有强大功能。无论是日常的灵感速写，还是专业的项目批量生产，这个本地化的工作站都将是您最得心应手的 AI 助手。
アプリケーションシナリオ
- 游戏/影视概念美术开发
在前期概念设计阶段，美术师可以在画板上随意拖拽草图，利用“文生图”快速发散灵感，随后选中满意的草稿通过“参考图”模式不断细化。同时，借助无限画板，可以将不同版本的设计图、情绪板（Moodboard）直观地并排对比排列，形成完整的设定工作流。 - 绘本与连环画自动化生成
绘本创作者通常需要保持角色和风格的一致性。通过调用“Agent 多步规划”功能，作者只需输入故事大纲，智能体即可自动规划出分镜节点，并依次参考前一张角色的特征生成后续情节画面，大幅减少重复性手动输入的工作量。 - 企业内部私有化视觉资产构建
针对对数据隐私有极高要求的广告公司或企业内部设计团队，由于工具所有数据（项目状态、记录、图像）均默认储存在本地 SQLite 中，避免了商业机密泄露的风险。结合企业自身的 S3 云存储，可以构建安全、可控的企业内部私有化素材中台。
QA
- GPT Image Canvas 支持哪些 AI 图像生成模型？
本项目作为一个控制中枢，支持通过配置 API Key 接入主流的 AI 图像生成服务（如 OpenAI 的 DALL-E 3、GPT Image 2 等兼容接口）。具体的模型支持取决于您在配置面板或.env文件中填写的提供商通道。 - 断网情况下我可以使用这个画板吗？
工具的 UI 界面、tldraw 画板、本地 SQLite 数据库以及图库管理系统完全在本地运行，断网状态下仍可正常进行画板排版和查看历史图片。但如果您的 AI 生成接口调用的是云端大模型 API（如 OpenAI），则生成新图像的过程需要网络连接。 - Agent 生成的任务规划出现偏差可以修改吗？
可以的。当 Agent 生成了基于 DAG 的多步规划节点后，系统会强制要求用户进行“Review（审核）”。在您确认执行（Execute）之前，若发现规划逻辑有误，可以随时取消、修改提示词并重新生成新的计划。 - 如果我清理了浏览器的缓存，我的图片会丢失吗？
不会。有别于仅依赖浏览器 LocalStorage 的普通前端工具，GPT Image Canvas 使用了后端结合本地 SQLite 数据库来持久化存储项目状态和生成资产。只要您不手动删除项目文件夹中的数据库文件，您的数据将永久安全保留。
