--- title: 功能介绍 description: 当前项目已实现的主要功能 --- # 功能介绍 本文档记录当前项目已经实现的主要功能。 ## 画布项目 - 支持创建多个画布项目。 - 支持项目重命名、删除、批量选择和批量删除。 - 支持单个画布项目导出为 JSON，也支持从 JSON 导入画布。 - 画布项目保存在浏览器本地，登录账号后暂不会自动同步到服务器。 ## 无限画布 - 支持拖动画布、滚轮缩放、缩放滑杆和重置视图。 - 支持小地图定位，可开关小地图。 - 支持点阵、网格线、空白三种背景。 - 支持浅色和深色主题。 - 支持框选、多选、全选、取消选择、删除选中。 - 支持复制粘贴节点和节点之间的连线。 - 支持撤销和重做节点、连线、视口、背景和助手会话变化。 - 支持节点连线，并高亮当前节点相关的上下游节点和连线。 - 支持快捷键帮助，覆盖缩放、框选、全选、复制粘贴、撤销重做、删除、退出选择和拖入图片。 ## 节点 目前画布中有三类节点： - 图片节点：展示上传图片、生成图片或我的素材图片。 - 文本节点：保存提示词、说明文案、AI 文字回答等文本内容。 - 生成配置节点：汇总上游文本和图片，统一配置模型、比例、数量后批量生成图片或文本。 节点支持： - 拖拽移动。 - 四角缩放。 - 图片节点等比缩放或自由比例切换。 - 查看节点基础信息和 JSON。 - 删除、复制、粘贴。 - 通过左右连接点建立上下游关系。 ## 图片工作流 - 支持上传图片到新节点。 - 支持拖拽图片文件到画布。 - 支持替换已有图片节点内容。 - 支持下载图片节点。 - 支持把图片节点保存到“我的素材”。 - 支持图片裁剪，并把裁剪结果生成为新的图片节点。 - 支持本地多角度变换，并把结果生成为新的图片节点。 - 支持生成失败后重试。 - 批量生成多张图片时会先展示为图片组节点，支持叠卡预览、展开查看全部结果并设置主图。 ## AI 生成 项目默认使用前台直连：前端使用浏览器本地配置的 Base URL、API Key 和 Model 直接请求 OpenAI 兼容接口，不再通过项目服务端转发 AI 请求。 OpenAI 兼容图像和文本能力继续复用现有接口： - `/v1/images/generations`：文生图。 - `/v1/images/edits`：图生图/参考图编辑。 - `/v1/responses`：文本问答、带图问答和在线 Agent 工具调用。 - `/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。 - 默认模型。 - 图片质量。 - 图片比例。 - 生成数量。 - 视频模型。 - 视频比例、清晰度、时长、生成声音和水印。 - 自定义生图 / 视频接口的调用方式，灵活适配不同中转站与自建服务。 普通图片/文本节点可以直接输入提示词生成结果。生成配置节点可以读取上游节点内容，并按节点自己的配置批量生成多个图片或文本结果。生成配置节点支持预览当前提示词和参考图输入，并调整输入顺序。 节点下方对话框和组装提示词输入框都支持 `@` 引用已连接的图片、文本、视频、音频等资源；`@` 引用图片时，输入框内会直接显示该图片的真实缩略图，而不再是「图片1」这类文字编号，发送时会按当前连接自动编号交给模型理解。由于引用改在对话框内直接 `@`，画布节点右上角不再显示「图片1 / 文本1」资源角标。 视频生成可从文本节点读取 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 秒或智能时长。生成成功后会把视频插入画布为视频节点并使用原生播放器预览。参考视频和参考音频优先使用公网可访问 URL；本地素材会以前端可读取的数据传给兼容接口，是否支持取决于具体上游。 ## 画布助手 画布右侧助手面板支持： - 文本问答。 - 生图。 - 读取当前选中节点作为引用。 - 自动把选中节点的上游节点也纳入引用。 - 粘贴图片到助手输入框并插入画布。 - 历史会话。 - 删除单条或多条会话。 - 重试回答。 - 把助手生成的文本插入画布。 - 把助手生成的图片插入画布。 - 折叠和展开助手面板。 ## 节点插件系统 画布支持通过节点插件扩展新的节点类型，内置节点之外的能力都可以以插件形式加载： - 支持通过 URL 动态安装、启用、更新和卸载远程节点插件。 - 提供官方插件注册表，节点插件面板可从项目仓库读取官方插件列表并一键安装。 - 提供 TypeScript 插件开发 SDK，可自行开发画布节点插件，并使用 AI 生成、面板控制等扩展能力。 - 内置 Markdown、SVG、HTML、3D 全景、便利贴等示例插件。 - 插件面板会显示插件版本，并对可升级的插件给出提醒。 Codex App 插件的安装与使用见 [Codex App 插件](/docs/overview/codex-app-plugin)。 ## 提示词库 前台提示词库支持： - 按标题搜索。 - 按标签筛选。 - 按来源筛选。 - 查看提示词详情。 - 查看封面和结果图。 - 复制提示词。 - 把提示词加入“我的素材”。 提示词管理支持： - 查询提示词。 - 按分组和标签筛选。 - 查看远程提示词源。 - 触发读取内置远程提示词源。 当前内置远程源包括多个 GPT Image / GPT-4o / Nano Banana Pro 相关提示词仓库，由浏览器前端直连拉取并缓存到 IndexedDB。 ## 素材 “我的素材”是浏览器本地素材库，支持： - 新增文本素材和图片素材。 - 编辑素材标题、封面、标签、来源、备注和内容。 - 删除素材。 - 按关键词搜索。 - 按类型筛选。 - 分页浏览。 - 复制文本素材。 - 下载图片素材。 - 从提示词库和画布节点加入素材。 - 在画布中插入素材。 ## 配置和同步 - 当前版本不需要账号登录，也不再提供后台管理页面。 - 配置与用户偏好弹窗支持多个 OpenAI 兼容渠道、默认模型、生成偏好和 WebDAV 同步设置。 - 第三方提示词、WebDAV 和 AI 接口都由浏览器前端直连，不经过项目后端代理。 ## 当前限制 - 画布项目和“我的素材”目前只保存在浏览器本地，不会随账号同步。 - AI API Key 保存在浏览器本地，并由浏览器直接请求配置的 OpenAI 兼容接口；只适合个人或可信环境使用。 - Seedance 本地参考视频/音频更建议使用公网可访问 URL；上游是否接受前端传入的本地数据取决于具体兼容接口。 - Seedance 返回远程视频 URL 时，前端会尽量下载为本地 Blob 持久化；如果因 CORS 或网络限制无法下载，会保留远程 URL，后续是否可播放取决于上游 URL 的有效期。 - 画布更适合桌面端使用，移动端触控体验还未系统完善。