feat(docs): reorganize documentation structure and update navigation links

2026-08-05 00:34:22 +08:00 · 2026-06-01 17:50:53 +08:00
parent 5f59b4bed3
commit b16251c1ed
65 changed files with 2491 additions and 281 deletions
@@ -0,0 +1,24 @@
+---
+title: 接口响应约定
+description: 业务接口统一响应结构与前端处理约定
+---
+
+# 接口响应约定
+
+后端业务接口统一返回 JSON：
+
+```json
+{
+  "code": 0,
+  "data": {},
+  "msg": "ok"
+}
+```
+
+- `code`: 业务状态码，`0` 表示成功，非 `0` 表示失败。
+- `data`: 业务数据。失败时通常为 `null`。
+- `msg`: 响应消息。成功默认为 `ok`，失败时放错误原因。
+
+前端请求逻辑以 `code` 判断业务是否成功。当前后端业务失败也会返回 HTTP 200，前端不要只依赖 HTTP 状态码判断结果。
+
+接口连接失败、服务不可达、返回体不是约定 JSON 时，前端按网络或接口异常处理。
@@ -0,0 +1,200 @@
+---
+title: 数据库说明
+description: 当前后端主要数据表与字段说明
+---
+
+# 数据库说明
+
+本文档只记录后端当前已经使用的主要数据表。
+
+## 数据库
+
+后端使用 GORM 管理数据库连接和表结构迁移。
+
+支持的存储驱动：
+
+- `sqlite`
+- `mysql`
+- `postgresql`
+
+当前启动时执行 `AutoMigrate`，自动维护以下表：
+
+- `users`
+- `credit_logs`
+- `prompts`
+- `assets`
+- `settings`
+
+后续新增表时再同步补充本文档，未实际使用的规划表不提前写入。
+
+### users
+
+系统用户表。用户基础信息、角色、算力点余额和第三方登录标识放在该表中。
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | string | 主键 |
+| `username` | string | 用户名，唯一索引 |
+| `password` | string | 密码哈希 |
+| `email` | string | 邮箱 |
+| `display_name` | string | 昵称 |
+| `avatar_url` | string | 头像地址 |
+| `role` | string | 角色：`user`、`admin` |
+| `credits` | number | 算力点余额 |
+| `aff_code` | string | 用户自己的邀请码，唯一索引 |
+| `aff_count` | number | 已邀请用户数量，冗余统计字段 |
+| `inviter_id` | string | 邀请人用户 ID |
+| `github_id` | string | GitHub 用户 ID |
+| `linux_do_id` | string | Linux.do 用户 ID |
+| `wechat_id` | string | 微信用户 ID |
+| `status` | string | 用户状态：`active`、`ban` |
+| `last_login_at` | string | 最近登录时间 |
+| `extra` | json | 扩展信息，第三方资料按平台命名空间保存，如 `linuxDo` |
+| `created_at` | string | 创建时间 |
+| `updated_at` | string | 更新时间 |
+
+### prompts
+
+提示词表。用于保存公开提示词、内置 GitHub 系统提示词、分类和预览内容。
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | string | 主键 |
+| `title` | string | 标题 |
+| `cover_url` | string | 封面图 |
+| `prompt` | string | 提示词内容 |
+| `tags` | json | 标签列表 |
+| `category` | string | 分类标识 |
+| `preview` | text | Markdown 展示内容，可包含文本、图片、视频链接等 |
+| `created_at` | string | 创建时间 |
+| `updated_at` | string | 更新时间 |
+
+`github_url` 仅用于接口返回，不写入数据库。
+
+### assets
+
+素材表。当前用于后台素材库。
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | string | 主键 |
+| `title` | string | 标题 |
+| `type` | string | 素材类型：`text`、`image`、`video` 等 |
+| `cover_url` | string | 封面图 |
+| `tags` | json | 标签列表 |
+| `category` | string | 分类标识 |
+| `description` | string | 描述 |
+| `content` | text | 文本或 Markdown 内容 |
+| `url` | string | 图片、视频等媒体地址 |
+| `created_at` | string | 创建时间 |
+| `updated_at` | string | 更新时间 |
+
+### settings
+
+系统配置表，只保存两行数据：`public` 放前端可读取的公开配置，`private` 放仅后端和管理员可读取的私有配置，配置值都用 JSON。
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `key` | string | 主键：`public`、`private` |
+| `value` | json | 配置内容 |
+| `created_at` | string | 创建时间 |
+| `updated_at` | string | 更新时间 |
+
+`public.value` 常放前端展示和可公开读取的配置，例如模型列表、登录开关等。  
+`private.value` 常放渠道密钥、登录密钥、后台内部开关等。
+
+当前系统设置接口会按后端结构体序列化和反序列化已知字段；数据库 JSON 中额外存在的旧字段会被忽略。
+
+`public.value` 当前字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `modelChannel` | object | 模型渠道公开配置组 |
+| `auth` | object | 公开登录配置 |
+
+`modelChannel` 当前字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `availableModels` | string[] | 系统可用模型列表 |
+| `modelCosts` | object[] | 模型算力点配置 |
+| `defaultModel` | string | 默认模型 |
+| `defaultImageModel` | string | 默认图片模型 |
+| `defaultVideoModel` | string | 默认视频模型 |
+| `defaultTextModel` | string | 默认文本模型 |
+| `systemPrompt` | string | 系统提示词 |
+| `allowCustomChannel` | bool | 是否允许用户自定义渠道，默认允许，关闭后前端只提供走后端渠道的模式 |
+
+`modelCosts` 每项字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `model` | string | 模型名称 |
+| `credits` | number | 每次后端模型接口调用前预扣的算力点，未配置默认不扣除 |
+
+`auth.linuxDo` 当前字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `enabled` | bool | 是否开启 Linux.do 登录 |
+
+`private.value` 当前字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `channels` | object[] | 模型渠道配置列表 |
+| `promptSync` | object | GitHub 远程提示词定时同步配置 |
+| `auth` | object | 私有登录配置 |
+
+`channels` 每项字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `protocol` | string | 协议，当前支持 `openai` |
+| `name` | string | 渠道名称 |
+| `baseUrl` | string | 渠道接口地址 |
+| `apiKey` | string | 渠道密钥 |
+| `models` | string[] | 渠道可用模型列表 |
+| `weight` | number | 渠道权重，同一模型命中多个渠道时按权重随机 |
+| `enabled` | bool | 是否启用 |
+| `remark` | string | 备注 |
+
+`promptSync` 字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `enabled` | bool | 是否开启定时同步，默认开启 |
+| `cron` | string | Cron 表达式，默认每 5 分钟 |
+
+`auth.linuxDo` 当前字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `clientId` | string | Linux.do OAuth App Client ID |
+| `clientSecret` | string | Linux.do OAuth App Client Secret，后台返回时隐藏 |
+
+后端请求模型时，先按模型名筛选启用且包含该模型的渠道，再按 `weight` 加权随机选择一个渠道。
+
+### credit_logs
+
+用户算力点变更流水表。当前记录后台手动调整、模型调用预扣和模型调用失败返还。
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | string | 主键 |
+| `user_id` | string | 关联用户 ID |
+| `type` | string | 类型：`admin_adjust`、`ai_consume`、`ai_refund` |
+| `amount` | number | 本次变动数量，增加为正，扣减为负 |
+| `balance` | number | 变动后的用户算力点余额 |
+| `related_id` | string | 关联业务 ID，可为空 |
+| `remark` | string | 备注 |
+| `extra` | json | 扩展信息 |
+| `created_at` | string | 创建时间 |
+
+`type` 当前取值：
+
+| 值 | 说明 |
+| --- | --- |
+| `admin_adjust` | 后台手动调整 |
+| `ai_consume` | 调用后端模型接口消费 |
+| `ai_refund` | 后端模型接口调用失败返还 |
@@ -0,0 +1,224 @@
+---
+title: 画布数据结构
+description: 画布本地存储、节点结构、媒体文件与清理机制
+---
+
+# 画布数据结构
+
+本文档说明当前画布在前端本地保存的数据结构、图片文件的存储和清理方式，以及后续接入后端存储时建议保持的兼容边界。
+
+## 当前存储位置
+
+当前画布项目主要保存在浏览器本地：
+
+- 画布项目 JSON：`localForage`，数据库名 `infinite-canvas`，storeName `app_state`，key 为 `infinite-canvas:canvas_store`。
+- 我的素材 JSON：`localForage`，数据库名 `infinite-canvas`，storeName `app_state`，key 为 `infinite-canvas:asset_store`。
+- 图片 Blob：单独存到 `localForage` 实例，数据库名 `infinite-canvas`，storeName `image_files`。
+- 视频等媒体 Blob：单独存到 `localForage` 实例，数据库名 `infinite-canvas`，storeName `media_files`。
+
+画布 JSON 不直接长期保存大体积 base64 图片或视频。图片节点、视频节点、助手图片和素材媒体只保存展示 URL、`storageKey` 和元信息，真实 Blob 通过 `storageKey` 读取。
+
+## 画布项目结构
+
+每个画布项目是一个 `CanvasProject`：
+
+```ts
+type CanvasProject = {
+  id: string;
+  title: string;
+  createdAt: string;
+  updatedAt: string;
+  nodes: CanvasNodeData[];
+  connections: CanvasConnection[];
+  chatSessions: CanvasAssistantSession[];
+  activeChatId: string | null;
+  backgroundMode: "lines" | "dots" | "blank";
+  viewport: { x: number; y: number; k: number };
+};
+```
+
+字段说明：
+
+- `id`：画布项目 ID，当前前端生成。
+- `title`：画布名称。
+- `createdAt` / `updatedAt`：ISO 字符串。
+- `nodes`：画布节点列表。
+- `connections`：节点连线列表。
+- `chatSessions`：右侧画布助手会话。
+- `activeChatId`：当前选中的助手会话 ID。
+- `backgroundMode`：画布背景模式。
+- `viewport`：视口变换，`x/y` 是屏幕平移，`k` 是缩放比例。
+
+## 节点结构
+
+每个节点是一个 `CanvasNodeData`：
+
+```ts
+type CanvasNodeData = {
+  id: string;
+  type: "image" | "text" | "config" | "video";
+  title: string;
+  position: { x: number; y: number };
+  width: number;
+  height: number;
+  metadata?: CanvasNodeMetadata;
+};
+```
+
+通用字段：
+
+- `id`：节点 ID。
+- `type`：节点类型，当前有图片、文本、生成配置、视频四类。
+- `title`：节点标题。
+- `position`：画布世界坐标，不是屏幕坐标。
+- `width` / `height`：画布世界坐标下的节点尺寸。
+- `metadata`：节点内容和业务状态。
+
+`metadata` 当前常用字段：
+
+```ts
+type CanvasNodeMetadata = {
+  content?: string;
+  prompt?: string;
+  status?: "idle" | "success" | "loading" | "error";
+  errorDetails?: string;
+  fontSize?: number;
+  generationMode?: "text" | "image" | "video";
+  model?: string;
+  size?: string;
+  count?: number;
+  naturalWidth?: number;
+  naturalHeight?: number;
+  freeResize?: boolean;
+  isBatchRoot?: boolean;
+  batchRootId?: string;
+  batchChildIds?: string[];
+  primaryImageId?: string;
+  imageBatchExpanded?: boolean;
+  inputOrder?: string[];
+  storageKey?: string;
+  mimeType?: string;
+  bytes?: number;
+};
+```
+
+不同节点的使用方式：
+
+- 图片节点：`content` 是当前可展示的图片 URL，通常是 `blob:` URL；`storageKey` 指向本地图片 Blob；`naturalWidth/naturalHeight/bytes/mimeType` 保存原图信息。
+- 视频节点：`content` 是当前可播放的视频 URL，通常是 `blob:` URL；`storageKey` 指向本地视频 Blob；`bytes/mimeType` 保存文件信息。
+- 文本节点：`content` 保存文本内容；`fontSize` 保存字体大小；`prompt/status/errorDetails` 保存生成状态。
+- 生成配置节点：`generationMode/model/size/count/inputOrder` 保存生成配置；`generationMode` 可选择文本、图片或视频；上游输入通过 `connections` 计算。
+- 图片组节点：根节点用 `isBatchRoot/batchChildIds/primaryImageId/imageBatchExpanded` 记录批量生成结果；子图节点用 `batchRootId` 指回根节点。
+
+## 连线结构
+
+每条连线是一个 `CanvasConnection`：
+
+```ts
+type CanvasConnection = {
+  id: string;
+  fromNodeId: string;
+  toNodeId: string;
+};
+```
+
+连线只保存节点 ID，不保存端口坐标。渲染时根据节点位置和尺寸计算路径。
+
+删除节点时会同步删除以该节点为起点或终点的连线。删除图片组根节点时，会把对应子节点一起删除。
+
+## 助手会话结构
+
+助手会话保存在画布项目内：
+
+```ts
+type CanvasAssistantSession = {
+  id: string;
+  title: string;
+  messages: CanvasAssistantMessage[];
+  createdAt: string;
+  updatedAt: string;
+};
+```
+
+消息结构：
+
+```ts
+type CanvasAssistantMessage = {
+  id: string;
+  role: "user" | "assistant";
+  mode: "ask" | "image";
+  text: string;
+  isLoading?: boolean;
+  references?: CanvasAssistantReference[];
+  images?: CanvasAssistantImage[];
+};
+```
+
+图片引用和助手生成图片也遵循同一套图片存储规则：
+
+- `dataUrl` 字段当前可能是 `blob:` URL，也可能是旧数据中的 `data:image/...`。
+- `storageKey` 存在时，以 `storageKey` 为准读取图片 Blob。
+- 发送到 AI 接口前，如果接口需要 base64，会通过 `imageToDataUrl` 临时把 Blob URL 转成 data URL。
+
+## 图片写入流程
+
+所有新增图片应通过 `uploadImage(input)` 写入：
+
+1. 传入 `Blob` 或 data URL。
+2. 内部转成 `Blob`。
+3. 生成 `storageKey`，格式为 `image:<id>`。
+4. 把 Blob 写入 `image_files`。
+5. 创建 `blob:` URL，并缓存在内存 `objectUrls`。
+6. 读取图片宽高，返回：
+
+```ts
+type UploadedImage = {
+  url: string;
+  storageKey: string;
+  width: number;
+  height: number;
+  bytes: number;
+  mimeType: string;
+};
+```
+
+图片节点会通过 `imageMetadata(image)` 写入：
+
+```ts
+{
+  content: image.url,
+  storageKey: image.storageKey,
+  status: "success",
+  naturalWidth: image.width,
+  naturalHeight: image.height,
+  bytes: image.bytes,
+  mimeType: image.mimeType
+}
+```
+
+因此，`content` 只适合当前浏览器会话展示，不能作为长期文件标识；长期标识是 `storageKey`。
+
+## 图片读取和旧数据迁移
+
+打开画布时会执行图片补水：
+
+- 如果图片节点有 `storageKey`，通过 `resolveImageUrl(storageKey, fallback)` 读取 Blob 并生成新的 `blob:` URL。
+- 如果图片节点没有 `storageKey`，但 `content` 是旧的 `data:image/...`，会调用 `uploadImage(content)` 迁移到 `image_files`，并补上 `storageKey`。
+- 助手消息里的引用图和生成图也会执行同类逻辑。
+
+我的素材读取时也会做迁移：
+
+- 有 `storageKey`：恢复 `coverUrl` 和 `data.dataUrl` 的可展示 URL。
+- 无 `storageKey` 且保存了 base64：写入 `image_files`，然后更新素材里的 `storageKey`。
+
+## 图片移除和清理
+
+图片不是在删除节点时立即按节点逐张删除，而是做引用清理：
+
+1. 删除节点、清空画布、删除画布、删除素材、删除助手会话时，会触发 `cleanupImages`。
+2. `cleanupImages` 会收集当前仍被画布项目、素材和额外传入数据引用的所有 `storageKey`。
+3. `cleanupUnusedImages` 遍历 `image_files` 中的全部图片。
+4. 不在引用集合里的图片会被删除。
+5. 删除时会同时 `URL.revokeObjectURL`，并从内存缓存 `objectUrls` 移除。
+
+这套方式可以避免同一张图片被画布、素材或助手同时引用时误删。
@@ -0,0 +1,64 @@
+---
+title: 本地开发
+description: 前后端分开启动时的本地开发方式
+---
+
+# 本地开发
+
+如果你需要改代码，建议前后端分开启动。
+
+## 1. 准备环境变量
+
+```bash
+cp .env.example .env
+```
+
+默认配置下：
+
+- 后端端口是 `8080`
+- 前端端口是 `3000`
+- SQLite 数据库是 `data/infinite-canvas.db`
+
+## 2. 启动后端
+
+在仓库根目录执行：
+
+```bash
+go run .
+```
+
+后端会读取根目录 `.env`，并监听：
+
+```text
+http://127.0.0.1:8080
+```
+
+## 3. 启动前端
+
+在 `web` 目录执行：
+
+```bash
+bun run dev
+```
+
+前端默认访问：
+
+```text
+http://localhost:3000
+```
+
+开发代理默认转发到 `http://127.0.0.1:8080`。如果你的后端端口不同，启动前设置 `API_BASE_URL`。
+
+## 4. 启动文档站
+
+如果需要单独调整文档站，在 `docs` 目录执行：
+
+```bash
+bun run dev
+```
+
+## 常见场景
+
+- 改画布、页面和交互：主要看 `web/`
+- 改接口、业务逻辑和数据库：主要看仓库根目录下的 Go 代码
+- 改文档站内容：主要看 `docs/content/docs/`
@@ -0,0 +1,12 @@
+{
+  "title": "开发文档",
+  "root": true,
+  "defaultOpen": true,
+  "pages": [
+    "local-development",
+    "api-response",
+    "system-settings",
+    "backend-database",
+    "canvas-data-structure"
+  ]
+}
@@ -0,0 +1,127 @@
+---
+title: 系统配置数据结构
+description: settings 表中 public 和 private 配置结构说明
+---
+
+# 系统配置数据结构
+
+系统配置保存在 `settings` 表中，目前只使用两行：
+
+| key | 说明 |
+| --- | --- |
+| `public` | 公开配置，前端可以读取 |
+| `private` | 私有配置，只给后端和管理员使用 |
+
+## public.value
+
+```json
+{
+  "modelChannel": {
+    "availableModels": ["gpt-5.5", "gpt-image-2"],
+    "modelCosts": [
+      { "model": "gpt-5.5", "credits": 1 },
+      { "model": "gpt-image-2", "credits": 10 }
+    ],
+    "defaultModel": "gpt-image-2",
+    "defaultImageModel": "gpt-image-2",
+    "defaultTextModel": "gpt-5.5",
+    "systemPrompt": "",
+    "allowCustomChannel": true
+  },
+  "auth": {
+    "allowRegister": true,
+    "linuxDo": {
+      "enabled": false
+    }
+  }
+}
+```
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `modelChannel` | object | 模型渠道公开配置组 |
+| `auth` | object | 认证相关公开配置 |
+
+`modelChannel` 字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `availableModels` | string[] | 系统可用模型；保存设置时会自动合并所有已启用私有渠道的模型 |
+| `modelCosts` | object[] | 模型算力点配置，后端模型接口调用前按模型预扣，上游失败时返还；未配置默认不扣除 |
+| `defaultModel` | string | 默认模型，从 `availableModels` 中选择；为空或失效时优先选择文本模型 |
+| `defaultImageModel` | string | 默认图片模型，从 `availableModels` 中选择；为空或失效时优先选择 `seedream`、`image`、`gpt-image` 模型 |
+| `defaultVideoModel` | string | 默认视频模型，从 `availableModels` 中选择；为空或失效时优先选择 `seedance`、`video` 模型 |
+| `defaultTextModel` | string | 默认文本模型，从 `availableModels` 中选择；为空或失效时优先选择非图片/视频模型 |
+| `systemPrompt` | string | 系统提示词 |
+| `allowCustomChannel` | boolean | 是否允许用户在配置弹窗中切换为本地直连渠道，默认允许 |
+
+`modelCosts` 每项字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `model` | string | 模型名称 |
+| `credits` | number | 每次后端模型接口调用前预扣的算力点 |
+
+用户侧请求模式：
+
+| 模式 | 说明 |
+| --- | --- |
+| 云端渠道 | 使用后端 `/api/v1/*` 代理接口，请求会按模型名匹配 `private.value.channels` 中的可用渠道 |
+| 本地直连 | 默认可选；`allowCustomChannel` 关闭后不可选，用户在浏览器本地配置 `baseUrl`、`apiKey` 和模型列表后直接请求模型接口 |
+
+`auth` 字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `allowRegister` | boolean | 是否允许用户注册，默认允许；关闭后注册入口隐藏，注册接口拒绝新用户创建 |
+| `linuxDo.enabled` | boolean | 是否开启 Linux.do 登录 |
+
+## private.value
+
+```json
+{
+  "channels": [
+    {
+      "protocol": "openai",
+      "name": "默认渠道",
+      "baseUrl": "https://api.example.com",
+      "apiKey": "sk-xxx",
+      "models": ["gpt-5.5", "gpt-image-2"],
+      "weight": 1,
+      "enabled": true,
+      "remark": ""
+    }
+  ],
+  "promptSync": {
+    "enabled": true,
+    "cron": "*/5 * * * *"
+  }
+}
+```
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `channels` | object[] | 模型渠道列表 |
+| `promptSync` | object | GitHub 远程提示词定时同步配置 |
+
+`channels` 每项字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `protocol` | string | 协议，当前为 `openai` |
+| `name` | string | 渠道名称 |
+| `baseUrl` | string | OpenAI 兼容接口地址 |
+| `apiKey` | string | 渠道密钥 |
+| `models` | string[] | 该渠道可用模型 |
+| `weight` | number | 渠道权重；同一模型有多个可用渠道时按权重随机 |
+| `enabled` | boolean | 是否启用 |
+| `remark` | string | 备注 |
+
+后端调用模型时，会从已启用、已配置 `baseUrl` 和 `apiKey`、且 `models` 包含目标模型的渠道中选择一个。
+
+`promptSync` 字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `enabled` | boolean | 是否开启定时同步，默认开启 |
+| `cron` | string | Cron 表达式，默认每 5 分钟 |
@@ -0,0 +1,29 @@
+---
+title: 商务合作
+description: 商务合作、定制开发和项目接入说明
+---
+
+# 商务合作
+
+如果你希望围绕无限画布做商业合作、私有化部署、二次开发或模型渠道接入，可以直接通过邮箱联系项目维护者。
+
+## 适合沟通的方向
+
+- 私有化部署、内网部署和团队版落地。
+- 定制画布节点、生成流程、素材管理或后台能力。
+- 接入自有 OpenAI 兼容接口、模型渠道或提示词仓库。
+- 围绕 AI 图片、视频、文本生成工作流做联合方案。
+- 商业授权、技术支持、交付咨询或联合方案评估。
+
+## 建议提供的信息
+
+- 你的业务场景和预期用户规模。
+- 需要部署的环境、数据保存方式和安全要求。
+- 需要接入的模型、渠道、支付或账号体系。
+- 期望的交付范围、时间和预算区间。
+
+## 联系方式
+
+请直接发送邮件至 [1844025705@qq.com](mailto:1844025705@qq.com)，并在邮件标题中注明“商务合作”。
+
+如果涉及商业授权或私有化交付，请在邮件中说明计划使用方式和预期交付范围。
@@ -0,0 +1,36 @@
+---
+title: 开源协议
+description: 无限画布开源协议和使用边界说明
+---
+
+# 开源协议
+
+无限画布采用 GNU Affero General Public License v3.0（AGPL-3.0）开源协议。你可以在遵守协议要求的前提下自由使用、复制、修改和分发本项目。
+
+## 项目初衷
+
+无限画布保持开源，希望让更多人可以查看和修改代码，不被固定 API 渠道限制，接入自己的 API 与模型渠道，用画布组织提示词、参考图、素材和生成结果，搭建适合自己的 AI 创作工作流。
+
+
+## 使用建议
+
+如果你只是本地学习、研究或自用，可以直接按开源协议使用。
+
+如果你计划将项目用于商业产品、私有化交付、SaaS 服务或长期团队内部系统，建议先确认自己的使用方式是否满足 AGPL-3.0 的开源要求。
+
+如果你的使用场景无法继续开源修改后的代码，或需要闭源交付、商业授权、私有化部署支持、定制开发服务，请查看[商务合作](/docs/business/business)。
+
+
+
+## 什么是 AGPL-3.0
+
+AGPL-3.0 的核心要求可以通俗理解为：
+
+- 开源义务：如果你使用了无限画布的 AGPL 代码，无论你或你的下游如何使用、修改、二次开发或分发，都必须把基于本项目形成的最终代码完整公开出来，不只是公开修改的部分，也不是换个框架重写一遍就能和原始代码脱离关系。
+- 延续协议：基于本项目形成的衍生代码需要继续以 AGPL-3.0 协议开源，不能更换为其他协议，也不能把这部分代码改成闭源授权。
+- 网络服务也要开源：即使你只是把基于本项目修改后的版本做成网站、SaaS 或其他网络服务，只要别人可以通过网络使用这个服务，也需要向这些用户提供对应源代码，并继续遵守 AGPL-3.0。
+- 保留版权声明：不能删除原项目作者信息、版权声明、许可证声明和来源说明，需要让使用者知道代码从哪里来、遵循什么协议。
+- 不能加额外限制：不能给基于本项目形成的 AGPL 代码增加额外限制，例如禁止别人再分发代码，或要求别人购买授权、服务、产品后才能使用这部分开源代码。
+- 免责声明：项目按现状提供，作者不保证代码没有 bug，也不对使用本项目产生的结果、损失或风险负责。
+
+本项目禁止闭源商用。如果你希望将无限画布用于商业项目，请尊重开源，严格遵循 AGPL-3.0 协议，继续开源对应代码，回馈开源社区。
@@ -0,0 +1,9 @@
+{
+  "title": "商务合作",
+  "root": true,
+  "defaultOpen": true,
+  "pages": [
+    "license",
+    "business"
+  ]
+}
@@ -0,0 +1,65 @@
+---
+title: 画布节点操作手册
+description: 当前画布节点的主要用途与操作流程
+---
+
+# 画布节点操作手册
+
+本文档记录画布节点的主要用途和操作流程，方便使用和后续开发维护。当前先介绍文本节点。
+
+## 文本节点
+
+文本节点用于保存提示词、草稿、说明文案和 AI 生成的文字结果。它既可以作为独立文本内容，也可以作为下游生成配置节点的输入。
+
+### 编辑文本内容
+
+- 双击文本节点内容区域，直接编辑节点里的文字。
+- 选中文本节点后，点击顶部工具栏的“编辑文字”，进入文字编辑状态。
+- 顶部工具栏的“缩小”和“放大”用于调整文本节点字号。
+
+### 用下方对话框生成或修改文本
+
+- 选中文本节点后，点击顶部工具栏的“编辑”，打开节点下方对话框。
+- 文本节点下方对话框只用于生成或改写文本，不承担生图功能。
+- 当文本节点为空时，输入框用于填写想生成的文本内容；点击发送后，结果会回填到当前文本节点。
+- 当文本节点已有内容时，输入框用于填写想把本段文本修改成什么；点击发送后，会在右侧生成新的文本节点，并自动连接原节点和新节点。
+- 输入内容可以手写，也可以从提示词库选择。
+- 对话框里的模型下拉来自全局配置里已拉取的模型列表；选择结果只作用于当前节点，不会修改其它节点或全局默认模型。
+- 如果下拉中没有模型，需要先打开配置弹窗拉取模型列表，并设置默认生图模型和默认文本模型。火山方舟 Agent Plan 若提示不支持 `/models`，请手动填写模型名。
+
+### 用文本节点生成图片
+
+- 先在文本节点中准备好要用于生图的文本内容。
+- 点击文本节点顶部工具栏的“生图”按钮。
+- 系统会在文本节点右侧自动创建一个生成配置节点，并连接文本节点到生成配置节点。
+- 生成配置节点会读取上游文本内容作为生图提示词，并立即开始生成图片。
+- 后续需要调整模型、比例、数量时，可以在生成配置节点里修改后再次生成。
+
+### 用图片节点继续生成图片
+
+- 选中空图片节点后点击“生成”，会直接在当前节点里生成结果，不再额外保留一个空框。
+- 当数量为 `1` 时，生成结果会直接回填到当前图片节点。
+- 当数量大于 `1` 时，当前图片节点会作为主图节点，右侧继续生成对应数量的子图节点。
+- 如果图片节点本身已经有内容，则会沿用已有图片作为参考图，再生成新的图片批次。
+- 每个生成出来的图片节点都会在自身 `metadata` 下记录提示词、生成类型、模型、尺寸、质量、数量和参考图引用，方便后续重试。
+- 如果重试时参考图已经丢失或无法恢复，系统会直接提示，避免误发空的图生图请求。
+
+### 视频节点
+
+- 工具栏可以新建视频节点，也可以拖入或上传本地视频文件。
+- 视频节点使用原生播放器展示内容，可在节点内直接播放、暂停和拖动进度。
+- 空视频节点下方对话框可输入提示词生成视频，结果会回填到当前节点。
+- 从文本、图片或配置节点创建视频生成时，会在右侧生成新的视频节点并自动连接。
+- 生成配置节点的视频模式会读取上游文本作为 prompt，读取上游图片作为参考图，读取上游视频作为参考视频，并在输入预览里显示参考视频。
+- 视频生成接口支持 OpenAI 风格的 `POST /v1/videos`、`GET /v1/videos/{id}` 和 `GET /v1/videos/{id}/content`。
+- 使用火山方舟 Agent Plan / Seedance 2.0 时，Base URL 配置为 `https://ark.cn-beijing.volces.com/api/plan/v3`，模型名使用 Seedance 2.0 对应模型；系统会改用 `POST /contents/generations/tasks` 创建异步任务，并轮询 `GET /contents/generations/tasks/{id}`。
+- Agent Plan 专属 `/api/plan/v3` 当前未提供 OpenAI `/models` 模型列表接口，后台不会伪造模型列表；请手动填写 `doubao-seedance-2.0` 或文档列出的其他可用模型。
+- Seedance 参考视频必须是公网可访问 URL，或由本项目后端在配置 `PUBLIC_BASE_URL` 后上传并暴露的参考素材 URL。本地/内网地址无法被火山服务器拉取。
+
+### 推荐流程
+
+1. 新建文本节点，写入图片创作想法。
+2. 打开文本节点下方对话框，让 AI 优化或扩写这段提示词。
+3. 改写结果会生成到新的文本节点，保留原始文本方便对比。
+4. 确认文本节点内容后，点击顶部工具栏“生图”。
+5. 在自动创建的生成配置节点中继续调整图片参数或重新生成。
@@ -0,0 +1,41 @@
+---
+title: 画布快捷键
+description: 画布常用鼠标与键盘操作说明
+---
+
+# 画布快捷键
+
+本文档记录画布里常用的鼠标和键盘操作。
+
+## 视图
+
+- 拖动画布空白处：平移视图。
+- 鼠标滚轮：缩放画布。
+- 缩放滑杆：精确调整缩放。
+- 重置视图按钮：回到默认缩放和居中位置。
+
+## 选择
+
+- `Ctrl / Cmd` + 拖动：框选多个节点。
+- `Shift / Ctrl / Cmd` + 点击节点：追加或取消选择节点。
+- `Ctrl / Cmd` + `A`：全选画布节点。
+- `Esc`：取消选择，并关闭当前浮层。
+
+## 编辑
+
+- `Ctrl / Cmd` + `C`：复制选中节点。
+- `Ctrl / Cmd` + `V`：粘贴节点。
+- `Delete / Backspace`：删除选中的节点或连线。
+- `Ctrl / Cmd` + `Z`：撤销。
+- `Ctrl / Cmd` + `Shift` + `Z`：重做。
+- `Ctrl / Cmd` + `Y`：重做。
+
+## 图片和素材
+
+- 拖入图片文件：上传图片到画布。
+- 导入图片按钮：从本地选择图片。
+- 素材库或我的素材：选择素材后插入画布。
+
+## 撤销和重做范围
+
+撤销和重做会记录画布节点、连线、视口、背景模式和助手会话变化。画布项目名称、账号状态、全局 AI 配置和“我的素材”保存操作不属于当前画布历史。
@@ -0,0 +1,9 @@
+{
+  "title": "操作手册",
+  "root": true,
+  "defaultOpen": true,
+  "pages": [
+    "canvas-node-manual",
+    "canvas-shortcuts"
+  ]
+}
@@ -0,0 +1,12 @@
+{
+  "title": "文档",
+  "root": true,
+  "pages": [
+    "overview",
+    "canvas",
+    "backend",
+    "progress",
+    "business",
+    "support"
+  ]
+}
@@ -0,0 +1,51 @@
+---
+title: Docker 部署
+description: 使用 Docker Compose 部署无限画布
+---
+
+# Docker 部署
+
+如果你希望在自己的机器或服务器上运行项目，可以直接使用 Docker Compose。
+
+## 使用发布镜像
+
+```bash
+git clone git@github.com:basketikun/infinite-canvas.git
+cd infinite-canvas
+cp .env.example .env
+docker compose up -d
+```
+
+启动后访问：
+
+```text
+http://localhost:3000
+```
+
+默认管理员账号：
+
+```text
+用户名：admin
+密码：.env 中的 ADMIN_PASSWORD
+```
+
+## 本地构建镜像
+
+如果需要基于当前源码构建镜像：
+
+```bash
+cp .env.example .env
+docker compose -f docker-compose.local.yml up -d --build
+```
+
+## 数据目录
+
+`docker-compose.yml` 会把本地 `./data` 挂载到容器内 `/app/data`，用于保存 SQLite 数据库、提示词数据和上传素材。
+
+Docker 部署时建议把 `.env` 中的 SQLite 路径设置为：
+
+```text
+DATABASE_DSN=/app/data/infinite-canvas.db
+```
+
+如果需要让火山方舟拉取本地上传的 Seedance 参考素材，还需要把 `PUBLIC_BASE_URL` 设置为公网可访问的站点地址。
@@ -0,0 +1,191 @@
+---
+title: 功能介绍
+description: 当前项目已实现的主要功能
+---
+
+# 功能介绍
+
+本文档记录当前项目已经实现的主要功能。
+
+## 画布项目
+
+- 支持创建多个画布项目。
+- 支持项目重命名、删除、批量选择和批量删除。
+- 支持单个画布项目导出为 JSON，也支持从 JSON 导入画布。
+- 画布项目保存在浏览器本地，登录账号后暂不会自动同步到服务器。
+
+## 无限画布
+
+- 支持拖动画布、滚轮缩放、缩放滑杆和重置视图。
+- 支持小地图定位，可开关小地图。
+- 支持点阵、网格线、空白三种背景。
+- 支持浅色和深色主题。
+- 支持框选、多选、全选、取消选择、删除选中。
+- 支持复制粘贴节点和节点之间的连线。
+- 支持撤销和重做节点、连线、视口、背景和助手会话变化。
+- 支持节点连线，并高亮当前节点相关的上下游节点和连线。
+- 支持快捷键帮助，覆盖缩放、框选、全选、复制粘贴、撤销重做、删除、退出选择和拖入图片。
+
+## 节点
+
+目前画布中有三类节点：
+
+- 图片节点：展示上传图片、生成图片或素材库图片。
+- 文本节点：保存提示词、说明文案、AI 文字回答等文本内容。
+- 生成配置节点：汇总上游文本和图片，统一配置模型、比例、数量后批量生成图片或文本。
+
+节点支持：
+
+- 拖拽移动。
+- 四角缩放。
+- 图片节点等比缩放或自由比例切换。
+- 查看节点基础信息和 JSON。
+- 删除、复制、粘贴。
+- 通过左右连接点建立上下游关系。
+
+## 图片工作流
+
+- 支持上传图片到新节点。
+- 支持拖拽图片文件到画布。
+- 支持替换已有图片节点内容。
+- 支持下载图片节点。
+- 支持把图片节点保存到“我的素材”。
+- 支持图片裁剪，并把裁剪结果生成为新的图片节点。
+- 支持本地多角度变换，并把结果生成为新的图片节点。
+- 支持生成失败后重试。
+- 批量生成多张图片时会先展示为图片组节点，支持叠卡预览、展开查看全部结果并设置主图。
+
+## AI 生成
+
+项目支持两种 AI 调用方式：
+
+- 本地直连：前端使用本地配置的 Base URL、API Key 和 Model 直接请求 OpenAI 兼容接口。
+- 后台渠道：前端请求本项目后端 `/api/v1/*` 代理接口，后端按模型选择管理后台配置的渠道。
+
+OpenAI 兼容图像和文本能力继续复用现有接口：
+
+- `/v1/images/generations`：文生图。
+- `/v1/images/edits`：图生图/参考图编辑。
+- `/v1/chat/completions`：文本问答和带图问答。
+- `/v1/models`：读取模型列表；火山方舟 Agent Plan 专属 `/api/plan/v3` 当前未提供 OpenAI `/models` 模型列表接口，需要手动填写模型名。
+
+视频能力支持两类接口：
+
+- OpenAI 风格视频：`POST /v1/videos`、`GET /v1/videos/{id}`、`GET /v1/videos/{id}/content`。
+- 火山方舟 Agent Plan / Seedance 2.0：Base URL 使用 `https://ark.cn-beijing.volces.com/api/plan/v3`，创建任务为 `POST /contents/generations/tasks`，查询任务为 `GET /contents/generations/tasks/{id}`，成功结果读取 `content.video_url`。
+
+Base URL 如果已经以 `/v1`、`/api/v3` 或 `/api/plan/v3` 结尾，系统不会再追加 `/v1`。因此 cpa 反代或火山方舟 Agent Plan 可以继续通过现有 Base URL + API Key + Model 方式配置，不需要新增火山生图 Provider。
+
+后台“拉取模型列表”会尝试真实请求 OpenAI `/models`，不会为 Agent Plan 伪造模型结果。如果火山方舟 Agent Plan 返回 404，请手动增加 `doubao-seedance-2.0` 或文档列出的其他模型名。
+
+可配置项：
+
+- Base URL。
+- API Key。
+- 默认模型。
+- 图片质量。
+- 图片比例。
+- 生成数量。
+- 视频模型。
+- 视频比例、清晰度、时长、生成声音和水印。
+
+普通图片/文本节点可以直接输入提示词生成结果。生成配置节点可以读取上游节点内容，并按节点自己的配置批量生成多个图片或文本结果。生成配置节点支持预览当前提示词和参考图输入，并调整输入顺序。
+
+视频生成可从文本节点读取 prompt，从图片节点读取参考图，从视频节点读取参考视频，从音频节点读取参考音频。Seedance 2.0 支持最多 9 张参考图、3 个参考视频、3 个参考音频；分辨率支持 `480p`、`720p`、`1080p`（fast 模型不支持 `1080p`），比例支持 `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`，时长支持 4-15 秒或智能时长。生成成功后会把视频插入画布为视频节点并使用原生播放器预览。Seedance 参考视频和参考音频需要公网可访问 URL；本地上传素材会先通过 `/api/v1/media/references` 保存到服务端，再由 `PUBLIC_BASE_URL` 生成可供火山服务器拉取的公开链接。
+
+## 画布助手
+
+画布右侧助手面板支持：
+
+- 文本问答。
+- 生图。
+- 读取当前选中节点作为引用。
+- 自动把选中节点的上游节点也纳入引用。
+- 粘贴图片到助手输入框并插入画布。
+- 历史会话。
+- 删除单条或多条会话。
+- 重试回答。
+- 把助手生成的文本插入画布。
+- 把助手生成的图片插入画布。
+- 折叠和展开助手面板。
+
+## 提示词库
+
+前台提示词库支持：
+
+- 按标题搜索。
+- 按标签筛选。
+- 按来源筛选。
+- 查看提示词详情。
+- 查看封面和结果图。
+- 复制提示词。
+- 把提示词加入“我的素材”。
+
+后台提示词管理支持：
+
+- 查询提示词。
+- 新增、编辑、删除提示词。
+- 按分组和标签筛选。
+- 查看远程提示词源。
+- 同步内置远程提示词源。
+
+当前内置远程源包括多个 GPT Image / GPT-4o / Nano Banana Pro 相关提示词仓库。
+
+## 素材
+
+“我的素材”是浏览器本地素材库，支持：
+
+- 新增文本素材和图片素材。
+- 编辑素材标题、封面、标签、来源、备注和内容。
+- 删除素材。
+- 按关键词搜索。
+- 按类型筛选。
+- 分页浏览。
+- 复制文本素材。
+- 下载图片素材。
+- 从提示词库、画布节点和服务器素材库加入素材。
+- 在画布中插入素材。
+
+“素材库”是服务器素材库，支持：
+
+- 按标题搜索。
+- 按类型筛选。
+- 按标签筛选。
+- 查看素材详情。
+- 复制文本或图片链接。
+- 加入“我的素材”。
+- 在画布中插入素材。
+
+后台素材库管理支持：
+
+- 查询素材。
+- 新增、编辑、删除素材。
+- 按类型和标签筛选。
+
+## 账号和后台
+
+- 注册功能暂时关闭。
+- 仅允许管理员账号登录。
+- 支持 JWT 会话。
+- `/api/auth/me` 可读取当前用户，未登录时返回访客用户。
+- 首次启动时可根据环境变量创建默认管理员。
+- 管理员后台目前包含提示词管理和素材库管理。
+- 后端已有用户管理接口，但前端暂未实现用户管理页面。
+
+## 后端能力
+
+- Gin 提供 API 服务。
+- Docker 运行时由 Next.js 提供页面入口，`/api/*` 请求代理到内部 Go 服务。
+- GORM 管理数据库连接和自动迁移。
+- 支持 SQLite、MySQL、PostgreSQL。
+- 数据库保存用户、提示词分组、提示词和服务器素材。
+- 业务接口统一返回 `{ code, data, msg }`。
+
+## 当前限制
+
+- 画布项目和“我的素材”目前只保存在浏览器本地，不会随账号同步。
+- 本地直连模式下，AI API Key 保存在浏览器本地，并由浏览器直接请求配置的 OpenAI 兼容接口；只适合本地或个人使用，公网多人使用不安全。公网部署推荐使用后台渠道，把真实密钥保存在服务端配置中。
+- 服务器素材库目前主要保存 URL 或文本，暂未提供文件上传接口。
+- Seedance 本地参考图/视频上传依赖 `PUBLIC_BASE_URL`，如果服务部署在 localhost、内网或不可被火山访问的地址，火山无法拉取参考素材。
+- Seedance 返回远程视频 URL 时，前端会尽量下载为本地 Blob 持久化；如果因 CORS 或网络限制无法下载，会保留远程 URL，后续是否可播放取决于上游 URL 的有效期。
+- 画布更适合桌面端使用，移动端触控体验还未系统完善。
@@ -0,0 +1,13 @@
+{
+  "title": "项目介绍",
+  "root": true,
+  "defaultOpen": true,
+  "pages": [
+    "quick-start",
+    "features",
+    "render",
+    "docker",
+    "third-party-prompt-repositories",
+    "[在线体验](https://infinite-canvas-cpco.onrender.com/)"
+  ]
+}
@@ -0,0 +1,50 @@
+---
+title: 快速开始
+description: 用最少步骤把无限画布跑起来
+---
+
+# 快速开始
+
+如果你只是想先把项目跑起来，优先使用 Docker。
+
+## Docker 启动
+
+```bash
+git clone git@github.com:basketikun/infinite-canvas.git
+cd infinite-canvas
+cp .env.example .env
+docker compose up -d
+```
+
+启动后访问：
+
+```text
+http://localhost:3000
+```
+
+默认管理员账号：
+
+```text
+用户名：admin
+密码：.env 中的 ADMIN_PASSWORD
+```
+
+## 本地构建镜像启动
+
+如果你需要基于当前源码本地构建镜像：
+
+```bash
+cp .env.example .env
+docker compose -f docker-compose.local.yml up -d --build
+```
+
+## 首次使用建议
+
+- 先打开右上角配置弹窗，填入自己的 `Base URL`、`API Key` 和模型名。
+- 如果使用后台渠道模式，再去管理后台补充系统模型与渠道配置。
+- 如果需要提示词仓库内容，可进入 `/admin/prompts` 拉取或同步。
+
+## 说明
+
+- 当前画布项目和“我的素材”主要保存在浏览器本地，不支持云同步。
+- 本地直连模式下，AI API Key 保存在浏览器本地，并由前端直接请求 OpenAI 兼容接口。
@@ -0,0 +1,38 @@
+---
+title: Render 部署
+description: 使用 Render 部署无限画布
+---
+
+# Render 部署
+
+点击下面链接即可部署到 Render：
+
+[部署到 Render](https://render.com/deploy?repo=https://github.com/basketikun/infinite-canvas)
+
+## 部署步骤
+
+1. 点击 `Deploy to Render`。
+2. 登录 Render，并按页面提示连接 GitHub。
+3. 填写 `ADMIN_PASSWORD`，然后点击确认部署。
+
+部署完成后，打开 Render 分配的 `.onrender.com` 域名即可访问。
+
+## 免费版说明
+
+默认使用 Render 免费 Web Service：
+
+- 空闲约 15 分钟后会休眠，下次访问会自动唤醒。
+- 免费版本地文件不是持久化存储，SQLite 数据可能在重启、重新部署后丢失。
+- 适合体验和演示，不适合长期保存正式数据。
+
+如果要长期使用，建议升级 Render 付费实例并挂载 Persistent Disk，或改用 PostgreSQL。
+
+## 管理员账号
+
+默认管理员用户名：
+
+```text
+admin
+```
+
+管理员密码是在 Render 部署页面里填写的 `ADMIN_PASSWORD`。
@@ -0,0 +1,15 @@
+---
+title: 第三方 GitHub 提示词仓库
+description: 当前已接入同步逻辑的第三方提示词仓库
+---
+
+# 第三方 GitHub 提示词仓库
+
+| 地址 | 状态 |
+| --- | --- |
+| https://github.com/EvoLinkAI/awesome-gpt-image-2-API-and-Prompts | 已实现同步逻辑 |
+| https://github.com/ZeroLu/awesome-gpt-image | 已实现同步逻辑 |
+| https://github.com/ImgEdify/Awesome-GPT4o-Image-Prompts | 已实现同步逻辑 |
+| https://github.com/YouMind-OpenLab/awesome-gpt-image-2 | 已实现同步逻辑 |
+| https://github.com/YouMind-OpenLab/awesome-nano-banana-pro-prompts | 已实现同步逻辑 |
+| https://github.com/davidwuw0811-boop/awesome-gpt-image2-prompts | 已实现同步逻辑 |
@@ -0,0 +1,10 @@
+{
+  "title": "项目进度",
+  "root": true,
+  "defaultOpen": true,
+  "pages": [
+    "[更新日志](/docs/progress/changelog)",
+    "pending-test",
+    "todo"
+  ]
+}
@@ -0,0 +1,41 @@
+---
+title: 待测试
+description: 当前版本已实现但仍需人工验证的变更项
+---
+
+# 待测试
+
+- 外部软件可通过 URL 查询参数 `baseUrl`/`baseurl` 和 `apiKey`/`apikey` 跳转到前端；读取后会从地址栏移除这些参数，后台允许自定义渠道时会自动切到自定义渠道、填入配置并打开配置弹窗，未允许时会打开配置弹窗并提示无法导入。
+- 生图工作台和画布生图会把参考图按当前顺序显示为 `图片1`、`图片2` 等编号，并在图生图请求的实际提示词中注入编号说明；需要验证 `/image` 参考图排序、画布配置节点输入顺序和画布助手参考图编号一致。
+- GPT Image 生图请求会在前端把 `9:16`、`16:9` 等比例转换成合法 `WIDTHxHEIGHT` 尺寸，并在非法尺寸时直接显示中文错误，避免上游返回 `invalid_value Invalid size`。
+- Docker 部署时，`DATABASE_DSN=data/infinite-canvas.db` 会在存在 `/app/data` 挂载目录时自动归一到 `/app/data/infinite-canvas.db`，需要验证后台模型配置不会再因为工作目录变为 `/app/web` 而读到空库。
+- Seedance 参考视频被火山判定包含真人或隐私信息时，前端错误摘要会提示改用不含真人的视频、官方允许的模型产物或已授权的 `asset://` 素材；参考素材上传目录改为跟随 SQLite 数据目录，并补充公开素材的 HEAD 访问。
+- Seedance 参考素材失败原因排查：后端会把火山上游错误摘要返回给前端；`/video` 和画布视频生成会按 `图片1/视频1/音频1` 自动编号参考素材，并在实际请求提示词中注入编号说明；参考视频会在请求前校验大小、时长、宽高、宽高比和像素总量。
+- 画布项目导出改为下载 `.zip` 压缩包，包内包含 `projects.json` 和当前画布引用到的本地图片、视频文件，避免只导出 JSON 时丢失媒体内容。
+- 画布库支持多选后一键导出多个画布项目，导出的压缩包可一次恢复多个项目。
+- 画布项目导入改为读取新版 `.zip` 压缩包，会先按 `projects.json` 中的文件映射恢复图片、视频到本地存储，再插入画布项目，导入成功后仍停留在画布库。
+- 修复删除画布图片节点或清空画布后撤销时，节点信息恢复但本地图片数据已被清理导致图片丢失的问题。
+- “我的素材”类型筛选区右侧新增文本样式的导出素材和导入素材入口，可将全部素材导出为包含 `assets.json` 与图片、视频文件的压缩包，并从压缩包恢复素材。
+- 未登录状态下，画布右上角不再显示用户头像菜单、用户名称、算力点余额和退出登录入口，改为显示登录入口；快捷键入口仍可直接打开。
+- 生图工作台的图片参数区复用画布里的紧凑版图像设置面板，尺寸、质量、生成张数的交互保持一致；工作台仍保留独立的模型选择。
+- 生图工作台新增生成记录配置持久化：每次生成会保存提示词、参考图、模型、质量、尺寸和张数，结果图写入本地图片存储后记录只保存 `storageKey`；点击历史记录会回填本次生成配置并预览结果。
+- 视频设置抽成画布和视频创作台共用的紧凑面板，清晰度、尺寸、秒数按固定网格选择并支持手动输入；尺寸选择 `auto` 时请求不传 `size`。
+- 修复画布和生图工作台选择图片尺寸后，请求图片生成/编辑接口未携带 `size` 参数的问题；`auto` 不传，其余比例或像素尺寸会随请求发送。
+- 修复生图工作台和画布生图请求中 `quality` 参数可能传入上游不支持值导致 400 的问题；请求前会归一化质量枚举，`auto` 或异常值不再发送给上游。
+- 管理后台新增/编辑渠道时，渠道可用模型支持通过弹窗按“新获取、已有”分组选择，并可在弹窗内手动增加模型或拉取模型列表后再写回表单。
+- 管理后台编辑渠道时，API Key 留空不再触发必填校验，表示沿用已保存的密钥；新增渠道仍要求填写 API Key。
+- 管理后台公开配置里的系统可用模型候选项改为由已启用渠道中选择的模型合并去重生成，最终开放哪些模型仍由公开配置里手动勾选。
+- 视频生成请求参数对齐 `grok-imagine-video` 接口：使用 `resolution_name`、`preset=normal`、`input_reference[]`，支持清晰度、尺寸、秒数快捷选择和手动输入，并支持最多 7 张参考图。
+- 画布视频设置浮层改为挂载到页面根层级并使用自建浮层交互，避免被节点悬浮工具栏遮挡或点击面板内容时关闭。
+- 画布生成配置节点的生图参数改为复用图像设置浮层，支持在同一个入口里调整质量、尺寸和生成张数。
+- 视频清晰度输入框改为只输入数字，提交请求时再拼接 `p` 单位。
+- 视频生成前端会识别后端 `{ code, msg }` 错误响应，创建失败不再继续轮询 `undefined`。
+- 新增 `/video` 视频创作台页面，参考生图工作台布局，支持提示词、参考图、视频参数、生成结果、保存素材、下载和本地生成记录；清晰度和秒数均支持常用值选择与手动输入，生成记录只保存媒体 `storageKey` 并可回填本次提示词、参考图和参数。
+- 视频创作台生成前会把模型、尺寸、秒数、清晰度归一化为视频接口支持的参数，并展示后端返回的错误信息，避免页面侧残留的生图参数影响视频请求。
+- 火山方舟 Agent Plan / Seedance 2.0 视频生成需要在真实账号下验证：`/contents/generations/tasks` 创建任务、轮询状态、`content.video_url` 回填画布，以及 401/403/429/超时错误提示。
+- 管理后台保存私有渠道后，需要验证所有已启用渠道里的模型会自动出现在公开 `availableModels`，并且 `defaultVideoModel`、`defaultImageModel`、`defaultTextModel` 在为空或失效时会自动修复，前台不再显示旧的 `grok` 默认值。
+- `/video` 和画布视频设置已按 Seedance 2.0 增加分辨率、比例、4-15 秒/智能时长、生成声音和水印参数；需要在真实浏览器里验证参数回填、生成记录和画布节点配置都能保持一致。
+- `/video` 支持最多 9 张参考图、3 个参考视频、3 个参考音频；需要验证格式、大小、音频时长提示和生成请求中的 `reference_image`、`reference_video`、`reference_audio` 组装。
+- 画布新增音频节点，支持上传、拖入、播放、移动、缩放、删除，并可作为上游参考音频参与 Seedance 视频生成；需要验证刷新后本地音频 URL 能恢复。
+- `PUBLIC_BASE_URL` 已配置公网域名时，需要验证本地上传参考视频和参考音频能被火山拉取；未配置或配置为内网地址时，需要验证前端能给出明确提示。
+- Seedance 返回远程视频 URL 但浏览器无法下载为 Blob 时，需要验证视频节点刷新后仍保留远程 URL，并确认上游 URL 有效期限制。
@@ -0,0 +1,8 @@
+---
+title: TODO
+description: 当前项目后续值得处理的事项
+---
+
+# TODO
+
+本文档用来记录当前项目后续比较值得处理的事项。
@@ -0,0 +1,18 @@
+---
+title: 打赏支持
+description: 支持无限画布项目继续维护
+---
+
+# 打赏支持
+
+如果本项目对你有帮助，欢迎通过打赏、Star、提供AI订阅账号等方式支持项目继续维护。
+
+项目开发大量依赖 Codex、Claude 等 AI 编程工具辅助写代码、排查问题和整理文档，这些工具需要持续付费。你的打赏会优先用于购买 AI 开发工具、模型服务和项目维护相关资源，帮助项目继续迭代。
+
+## 支持方式
+
+支持方式包括但不限于：
+
+- 给 GitHub 仓库点 Star，帮助项目被更多人看到。
+- 金额打赏，用于支持 AI 工具订阅、模型服务和项目维护成本。
+- Codex、Claude 等 AI 编程工具订阅账号支持，帮助维护者持续使用 AI 辅助开发。
@@ -0,0 +1,9 @@
+{
+  "title": "赞助支持",
+  "root": true,
+  "defaultOpen": true,
+  "pages": [
+    "donate",
+    "sponsor"
+  ]
+}
@@ -0,0 +1,27 @@
+---
+title: 广告赞助
+description: 广告赞助、项目露出和社区推广说明
+---
+
+# 广告赞助
+
+如果你希望在项目文档、README 或相关页面获得赞助露出，可以直接通过邮箱联系项目维护者沟通位置、周期和展示形式。
+
+## 适合的赞助内容
+
+- AI 工具、模型服务、API 服务或开发者工具。
+- 与图片、视频、文本生成工作流相关的产品。
+- 适合开源项目用户和 AI 创作者使用的服务。
+
+## 建议提供的信息
+
+- 品牌或产品名称。
+- 希望展示的位置和周期。
+- 需要展示的链接、文案和素材。
+- 预算区间和合作方式。
+
+## 联系方式
+
+请直接发送邮件至 [1844025705@qq.com](mailto:1844025705@qq.com)，并在邮件标题中注明“广告赞助”。
+
+如果已经有展示素材或投放计划，可以在邮件中一并说明。