面向 AI 影视、漫剧与多模态内容生产的 Agent 原生无限画布
TapCanvas 把创意、脚本、角色与场景资产、分镜、图像、视频和最终成片放进同一个可追溯的画布工作流。它不是单次模型调用器：Agents 会读取真实项目与画布状态，自主选择 Skills 和工具，执行多步生产，并以节点、资产和运行记录交付结果。在线网站核心功能及样式与当前项目完全一致。
版本边界： 本仓库是 TapCanvas 社区版，在线商业版是独立产品，功能、服务与条款均不相同。社区版不提供短信验证码与在线支付；模型渠道由使用者自行配置。
TapCanvas × Infistar.cc 无限星河｜一站式全球大模型 API 服务平台
感谢 Infistar.cc 无限星河 对 TapCanvas 的赞助支持！
- 🔌 官方接入，满血保真：按平台说明，通过官方渠道接入模型，多线路负载均衡，保持长链路生产的稳定性。
- 💰 价格低至官方 0.1 折：具体折扣、可用模型与计费规则以 无限星河官网 页面为准。
- 🧩 接入方式：社区版的文本、图片、视频模型统一经鲁班 API（
apps/new-api）下发。在 无限星河 注册并获取 Key 后，在鲁班 API 管理台新增渠道并填入自己的 Key 与所需模型即可使用；仓库不预置任何私人凭据。
TapCanvas × 即刻AI｜官渠视频模型，最低可达官价 5 折
感谢 即刻AI 对 TapCanvas 的赞助支持！
- 🎬 主打官渠视频：按平台说明，视频生成模型通过官方渠道接入。
- 💰 最低可达官价 5 折：具体折扣、可用模型与计费规则以 即刻AI 官网 页面为准。
- 🧩 接入方式：在 即刻AI 注册并获取 Key 后，在鲁班 API（
apps/new-api）管理台新增渠道并填入自己的 Key 与所需视频模型即可使用；仓库不预置任何私人凭据。
赞助方不参与项目的代码与路线图决策；上述链接为推广链接，注册与消费行为以对应平台条款为准。
从小说章节出发，把角色、场景、分镜与视频生成串联在同一张画布中。下面的 About 页面演示以两个章节的真实画布为例，展示角色与场景资产如何跨章节复用、同一人物的不同造型和受伤等状态如何分别管理，以及一键成片工作流如何组织从章节内容到视频的生产过程。
视频录制于在线版；社区版的工作流入口与模型配置要求见下方当前架构。
- 无限画布：用强类型节点、端口和连线组织文档、角色、分镜、图像、视频、音频、字幕与工作流。
- 流水线 / 画布双视图：同一项目可在节点画布与创作流水线之间切换；流水线按故事剧本、角色与场景、分镜设计、视频片段、最终成片组织已有内容，查看素材、预览结果并生成未完成素材，画布保留节点与依赖关系编辑。
- Agent 原生执行：
POST /public/agents/chat统一进入 DeepSeek Harness Bridge，由 Agents 负责语义理解、规划、Skills、子代理与最终交付自检。 - 一键成片：选择章节或正文来源后，从流水线入口提交创作要求，复用正文节点的生产链路；支持章节上下文、角色/场景资产、结构化分镜、连续镜头、首尾帧承接、视频生成与合成，运行前需配置可用模型与工作流。
- 多模型网关：文本、图像、视频和音频模型由鲁班 API（
apps/new-api）统一接入、计量和动态下发，前端不写死模型列表。 - 项目化资产：素材库、版本、生成历史、任务状态、交付证据与项目本地元数据持续沉淀，生成成功的资产不会被后处理丢弃。
- 工作流与协作：支持可复用 DAG、异步 Worker、失败恢复、分享/发布、团队作用域与实时画布状态。
以下作品基于当前 TapCanvas 项目制作，点击封面观看，后续案例将持续补充。
| 预览 | 作品 | 规格 | 制作 |
|---|---|---|---|
 |
开局相亲女神捕，获独孤九剑 · 第一章 原著：今日问道，第一章「独孤九剑」3,826 字 |
4 分 41 秒 · 1280×720 · 24 fps 80 条字幕 |
一键成片 v135 + HyperFrames 剪辑 创作：claude-sonnet-5-5 元数据 · 2026-10-09 |
 |
完整剧情 · 清晰字幕版 完整剧情成片，含清晰字幕 |
1 分 0 秒 · 1280×720 · 24 fps MP4 9.36 MB |
2026-10-08 |
tapcanvas-project-history-small.mp4
默认展示最新 10 条，较早记录展开查看。
-
2026-10-28 · 可编辑字幕时间轴：将只读字幕条升级为可编辑字幕轨，支持整段拖动、左右边缘调整起止时间、重叠分行、点击定位和键盘微调，选中轨道同步定位字幕内容。字幕对时随节点保存，重复视频实例分别编辑，预览与本地导出同时显示重叠字幕；修正分割片段导出的源时间偏移。保留现有字幕识别与样式，操作和验证边界见 交付记录。
-
2026-10-27 · 字幕样式：视频合成编辑器新增字体、字号、粗体、文字与描边颜色、描边宽度、背景颜色与透明度，以及位置、对齐和上下边距设置；样式随节点保存，重开编辑器继续编辑。编辑器预览与浏览器本地导出共用字幕绘制逻辑。当日同步 F02 的样式子项；时间轴随后于 10 月 28 日同步；实现与验证边界见 交付记录。
-
2026-10-26 · 应用内更新日志：同步 Pro 的轻量日志弹窗，在门户顶部点击「更新日志」图标查看社区版已实现功能与更新日期。有新条目时显示未读标记，内容打开后记录本地已读，可随时关闭、重开；存储失败会显示原因。内容依据本仓库 README 与交付记录维护，不包含 Pro 专属发布记录。来源与验证边界见 同步说明。
-
2026-10-26 · 手动去噪、MCP 助手接入与剧本导出：同步三项独立功能，保留社区版 DSH Harness。手动去噪改为轻度修复或清晰度增强，保留原图材质，隔离项目画风，移除强加渲染风格与 8K 承诺；MCP 页面可签发专用密钥并复制 AI 助手接入提示词，关闭弹窗清除内存凭据；流水线支持选择多个已有提示词的章节，按章节和片段顺序导出 TXT，不生成或改写剧本。
审查补全：导出与项目章节列表共用来源章序排序；新增去噪执行与 MCP 路由鉴权回归，96 项定向测试及 Web 类型检查通过。API 全量类型检查仍有其他文件错误；未提交真实生成任务或完成外部客户端端到端验收。
以下为 lluban.cn 的 Pro 实际界面参考截图，不是社区版部署验收；截图未签发密钥或提交生成任务，周边 Pro 会员与批量成片能力不在本次同步范围。去噪入口在线上新版工具栏暂不可达，因此不提供伪造截图。实现与验证见 交付记录。
MCP 助手接入（Pro 实际界面）
多章节剧本导出（Pro 实际界面） -
2026-10-21 · 创作流水线与画布双视图：新增创作流水线，可与同一项目的节点画布切换。按故事剧本、角色与场景、分镜设计、视频片段、最终成片五个阶段查看已有内容、生成状态与异常；分镜和视频片段按场景组织，支持素材筛选和媒体预览。流水线内可选择章节或正文来源并进入「一键成片」，也可单项生成或批量生成当前阶段的未完成素材，复用画布执行与前置资产链路。
截图来自 TapCanvasPro 同一项目；点击缩略图查看原图。社区版当前按单章成片，Pro 弹窗中的会员档位、多章 / 整本批量成片及新增规格选择尚未同步。 最终成片截图为待生成状态。
章节选择（Pro 参考）
成片选项（Pro 参考）
故事剧本
角色与场景
分镜设计
视频片段
最终成片（待生成）
节点画布 -
2026-10-20 · 图片对比节点：新增画布图片对比节点，支持并排、滑动分割、叠加透明度、按住切换四种模式。可从添加节点面板或右键菜单新建；框选两张图片后点「图片对比」，会自动创建节点并连线。对比内容跟随上游图片实时更新，模式、分割位置、透明度与尺寸随节点保存。
-
2026-10-11 · Factory / Droid 号池管理：移植 TapCanvasPro 的 Droid 渠道与账号管理，支持批量追加 Key、账号启停与测试、Standard / Core 额度窗口和订阅信息展示，以及额度不足时同池换号重试。新增部署 patch SQL，自动预置停用的空号池；管理员配置自己的 Key、模型协议与价格后启用。详见 Droid 接入说明。
-
2026-10-07 · 一键成片 v135：同步全章剧情与时间线规划、分项资产创作、逐 Clip 提示词与媒体生产，以及最新创作 Skills；编辑器与执行器共用工作流定义，继续使用社区版 DeepSeek Harness Bridge。新增 v135 系统工作流发布文件，保留历史执行和生成资产。
-
2026-10-07 · 画布修复：复制节点和分组时保留素材与提示词、隔离执行身份并重映射引用；修复分组下载遗漏视觉组内素材的问题。
-
2026-09-23 · 导演台升级：同步 TapCanvasPro 的独立导演台，基于 DirectorDesk 提供三维场景搭建、角色走位与摄影机预演；接入 TapCanvas AI 对话、工具中继和参考视频导出回画布，替换旧内嵌实现，并补充 MIT 许可鸣谢。Web 开发和构建会自动构建导演台，本地首次使用需安装其独立依赖。
更早更新记录（13 条）
-
2026-09-21 · Agent 配置更新：已添加工作流支持一键“更新并覆盖”，检查通过后直接更新当前装配，无需再次逐项确认；沿用原作用范围与已确认的替换、并列关系，保留历史版本、执行记录和生成资产。
-
2026-09-21 · 冲突判定修正：工作流共用工具或输出格式仅展示为提示，不再直接要求二选一；职责冲突仍由 Agent 分析，阻断错误与版本竞态明确报出。
-
2026-09-21 · 配置列表修复：补齐工作流更新时间与首次装载时间的前后端契约，修复 Agent 配置列表因缺少时间字段而加载失败的问题；配置更新相关前后端测试共 94 项通过。
-
2026-09-21：整理项目说明，移除过期截止日期与能力完成度待办章节。
-
2026-09-20：同步 v90 视频生产工作流并适配 DeepSeek Harness 运行时；画布生成操作统一接入主 AI 对话，修复章节资产与设计操作的模型传递及本地登录会话问题。
-
2026-09-16：补充 AtomGit 徽章、项目鸣谢与贡献者说明。
-
2026-09-11：扩展 HeyRoute 渠道与模型配置，补充文本、图片和视频的渠道独立计价。
-
2026-09-10：接入 HeyRoute 渠道，新增推广注册链接与 API Key 申请入口。
-
2026-09-08：更新一键成片相关实现与配套技能。
-
2026-09-06：恢复 Agent 运行结果预览。
-
2026-09-05：接入 Agnes 图片与视频渠道，完善模型参数契约和 GPT Image 2 请求校验，修复视频时长范围计价与参考图免费额度计算。
-
2026-09-04：按官方接口契约修正 Agnes 视频生成请求格式。
-
2026-09-03：完善 Docker 部署与依赖构建，支持容器内构建 Web 和模型管理台，并自动初始化本地配置与密钥。
通过 HeyRoute 推广链接注册可领取 $15 额度，可使用 Codex、Claude、Gemini 对话及平台提供的生图能力（具体领取条件与可用模型以 HeyRoute 页面为准）。
社区版内置 7 个 HeyRoute 渠道，共 31 个模型：15 个对话模型（Claude、GPT、Grok、Gemini、Kimi）、5 个图片模型和 11 个视频模型。新增视频包括 Grok、MiniMax H3 与 Seedance 系列，文本、图片和视频均支持渠道独立计价。首次部署后，在鲁班 API（new-api）管理台的渠道列表或编辑窗口点击 申请 API Key，通过上述链接注册，填写自己的 Key 并启用所需渠道。新增渠道默认停用且 Key 为空，不包含维护者私人凭据；升级保留已有 Key 和启用状态。初始化配置见 004-expand-heyroute-channels.sql，详细说明见 HeyRoute 接入说明。
社区版内置 Factory / Droid 渠道和账号会话管理，支持 Key 追加与去重、账号启停、单号测试、额度刷新、订阅与有效期展示。部署补丁自动创建空号池，默认停用；在鲁班 API 管理台添加自己的 Factory Key，从动态模型目录选择模型、配置明确的 Droid 协议绑定与价格后启用。补丁重复执行保留已有账号和配置，不预置未经确认的模型授权或价格。配置步骤和协议说明见 Droid 接入说明。
主链路是 无限画布 → Agents Bridge → 生产工作流内核 → 任务与媒体 Workers → 可验证交付。Agents 根据真实项目状态按需调用 Skills、MCP、子代理与工作流；图片、视频和音频任务经鲁班 API 进入 AIGC 模型，再由任务账本、队列、租约、幂等、重试与 reconcile，以及真实资产 URL 和 delivery evidence，保证长链路生产可恢复、可追溯、可验收。
一键成片边界： 流水线提供章节 / 正文来源选择与「一键成片」入口，复用正文节点的规格配置和 AI 对话生产链路；社区版提供 v135 系统工作流与管理员画布模板入口，运行前需自行配置可用的 Agent、图片与视频模型渠道及装配工作流。仅生成视频节点和完整成片共用同一份章节计划，媒体生成依赖真实上游资产。点击架构图可打开带导览与节点说明的交互版本。
Monorepo 的职责边界：apps/web 负责交互与确定性画布执行，apps/hono-api 负责协议、权限、任务与事实证据，apps/agents-cli 是 DeepSeek Harness 的 TapCanvas Bridge，apps/new-api 负责模型网关，packages/schemas 保存前后端共享契约。AI 对话架构细节见 apps/hono-api/README.md，Bridge 说明见 apps/agents-cli/README.md。
一条命令完成部署，无需预先安装任何东西：缺少 Docker 时脚本会自动安装（macOS 安装 Docker Desktop，Linux 安装 Docker Engine，Windows 安装 WSL2 + Docker Desktop），然后获取源码、生成私有配置与默认管理员账号、拉取预构建镜像（拉取失败的服务自动改为本地构建）并启动全部服务。
macOS / Linux（终端中执行）：
curl -fsSL https://raw.githubusercontent.com/anymouschina/TapCanvas/main/deploy.sh -o deploy.sh && bash deploy.shWindows 10 / 11（PowerShell 或 cmd 中执行）：
powershell -NoProfile -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol='Tls12'; iwr -useb https://raw.githubusercontent.com/anymouschina/TapCanvas/main/deploy.ps1 -OutFile deploy.ps1; .\deploy.ps1"源码会放在当前目录下的 TapCanvas/（可用环境变量 TAPCANVAS_DIR 指定）。已经 clone 了仓库的话，直接在仓库根目录运行 bash deploy.sh，Windows 双击 deploy.cmd 即可。Windows 首次安装 WSL2 需要重启电脑，重启并登录后脚本会自动继续部署。
部署完成后终端会打印访问地址和默认账号，并自动打开浏览器：
| 入口 | 地址 | 默认账号 |
|---|---|---|
| Web 画布 | http://localhost:5175 | admin / 首次部署随机生成的密码 |
| 鲁班 API 管理台 | http://localhost:4455 | admin / 首次部署随机生成的密码 |
忘记密码时运行 bash deploy.sh info（Windows：.\deploy.ps1 info）重新显示。想在首次部署时指定密码，可以设置环境变量，例如 TAPCANVAS_ADMIN_PASSWORD=your-pass bash deploy.sh。端口被占用时脚本会自动顺延并在输出中显示实际端口。鲁班渠道（lluban-recommended）已内置并默认启用，登录 Web 即可开始创作；需要其他模型时，在鲁班 API 管理台「渠道」中添加自己的 Key。
bash deploy.sh status # 查看服务状态
bash deploy.sh logs api # 查看某个服务的日志
bash deploy.sh update # 更新源码与镜像后重启
bash deploy.sh stop # 停止服务（保留数据）
bash deploy.sh info # 显示访问地址与账号Windows 下把 bash deploy.sh 换成 .\deploy.ps1 或 deploy.cmd。建议给 Docker 分配 8GB 以上内存，并预留 20GB 以上磁盘空间。网络受限时可以设置 DOCKERHUB_REGISTRY 指定 Docker Hub 镜像代理；TAPCANVAS_DEPLOY_MODE=build 会改为全部从源码本地构建。
从源码构建只需要 Docker、Docker Compose 和 OpenSSL；不要求宿主机安装 Node.js、pnpm、Bun 或 Go。
git clone https://github.com/anymouschina/TapCanvas.git
cd TapCanvas
./scripts/dev.sh docker这条命令会识别 docker compose 或 docker-compose，为全新安装生成一次性的强随机本地密钥，随后从已提交的源码和锁文件逐个构建 Web、API、鲁班 API、Agents Bridge 与 Workers，避免冷构建并发耗尽 Docker 内存。密钥只写入被 Git 和 Docker 构建上下文排除的 apps/hono-api/.env，不会打印；如果该文件已经存在，脚本只追加缺失的启动项，不覆盖任何现有值，因此已有的 lluban 或其他模型渠道配置会保留。
打开 Web http://localhost:5175，API 位于 http://localhost:8788，鲁班 API 管理台位于 http://localhost:4455。首次生成的两个管理员密码保存在私有 .env 文件中，不会显示在终端。冷构建可能需要较长时间，可通过容器状态与日志查看真实进度。
需要完全忽略已有构建缓存并重新拉取基础镜像时运行：
./scripts/dev.sh docker --fresh-build本地源码开发仍可使用 Node.js ^22.19.0 或 >=24 与 pnpm 10.8.1：
corepack enable
pnpm -w install --frozen-lockfile
npm --prefix apps/director-desk ci
pnpm dev:web本地浏览器入口统一使用 http://localhost:5175。通过 127.0.0.1 或 [::1] 打开 Web 时，应用启动前会跳转到 localhost，保留协议、端口、路径、查询参数与 hash；源码开发、预览和 Docker 静态构建使用同一入口规则。浏览器不会在这些主机名之间共享 Cookie 或 localStorage，统一入口可避免登录态割裂和跨站 Cookie 丢失。GitHub OAuth 本地回调也应配置为 http://localhost:5175/oauth/github。
README 不复制整份配置，避免与代码漂移；API 模板 和 Web 模板 是唯一入口。首次启动只需确认以下分组：
| 分组 | 关键变量 |
|---|---|
| 数据库 | POSTGRES_DB、POSTGRES_USER、POSTGRES_PASSWORD、DATABASE_URL_DOCKER |
| 服务鉴权 | JWT_SECRET、INTERNAL_WORKER_TOKEN、AGENTS_BRIDGE_TOKEN；首次 Docker 启动自动生成 |
| 模型网关 | NEW_API_INTERNAL_TOKEN、NEW_API_SESSION_SECRET、NEW_API_CRYPTO_SECRET、NEW_API_USD_EXCHANGE_RATE |
| Web | Docker 镜像默认同源访问 /api；GitHub OAuth 与对象存储可按模板启用 |
模型供应商凭据在鲁班 API 管理台配置；不要把真实密钥提交到 Git。缺失关键配置会显式失败，不会自动选择默认模型或静默降级。
pnpm build # Web + API + Agents
pnpm test # 全量测试
docker-compose --env-file apps/hono-api/.env ps # 当前主机使用 standalone Compose
./scripts/dev.sh docker-down # 停止服务，不删除数据卷| 文档 | 内容 |
|---|---|
| 文档中心 | 所有文档索引与推荐阅读顺序 |
| 开发指南 | 本地开发、构建与测试流程 |
| Docker 部署 | 一键全栈部署与常见问题 |
| 项目索引 | 目录结构与模块职责速查 |
| Public API | 对外接口契约，含 /public/agents/chat |
| API 与 AI 对话架构 | Hono API、任务与 AI 对话链路 |
| Agents Bridge | DeepSeek Harness Bridge 说明 |
| 交付记录 | 各次功能同步的实现与验证边界 |
| 同步 TODO | Pro 到社区版的功能同步清单 |
计划从 TapCanvas Pro 同步到社区版的功能：
本轮梳理了 16 项不涉及 Pro Agent 内核的功能，已同步 F04、F06、F09、F10、F13，以及 F02 的字幕样式与可编辑时间轴，编号、源码依据、社区版已有能力与适配边界见 同步 TODO。以下原有路线图保留；视频复刻暂不纳入本轮筛选。
- 图片对比节点：并排、滑块、叠加、切换四种模式，图片从上游节点实时读取
- 视频复刻：粘贴抖音等分享链接或上传视频，一键复刻
- 新版创作输入框：支持 @ 引用素材、附件、画布引用、按账号记住模型偏好
- 视频合成 + AI 字幕转写：字幕样式、可编辑时间轴及本地导出已同步；转场与 Pro 服务端转写仍待同步
- 媒体诊断接口：排查媒体链路问题
- 更新日志弹窗（F13）：门户顶部手动打开，展示社区版更新，支持未读提示与本地已读记录
- 产品介绍与 SEO 页：公开产品页与页面 metadata
- parse-video 服务：独立的 Go 服务，解析多平台视频链接
- TapOps 运维面板：多节点主机监控、日志与数据库清单
补充同步项（已完成项标记如下，其余待选）：
- F04 保材质手动去噪：去除强加渲染风格与未经证实的 8K 承诺，补齐忙碌反馈
- F05 角色立绘编辑：外观/年龄变体、独立版本与加入画布
- F06 AI 助手接入 MCP：签发专用密钥并生成可复制的接入提示词
- F07 CLI / Skill 安装入口：独立平台命令、API 调用、上传与订阅，不迁入 Pro host worker
- F08 灵光一现：首页创意方向、换一批与回填
- F09 多章节剧本导出：选择章节，将已保存的逐 Clip 提示词导出 TXT
- F10 画布保存协调：项目画布的自动/手动/提交前保存串行执行，自动保存按内容修订调度
- F11 动态模型规格：能力字段、参考图上限和尺寸规范
TapCanvas 根项目及未另行声明的代码按 MIT License 发布。apps/new-api 是独立上游衍生组件，继续适用其目录中的 GNU AGPL-3.0 License 与原始归属声明；其他第三方组件分别适用各自许可证。在线商业版不适用本仓库协议。
感谢以下平台与开源项目，TapCanvas 的托管、推广与实现都建立在它们之上。
- Infistar.cc 无限星河：赞助 TapCanvas，并提供一站式全球大模型 API 服务，详见赞助与支持。
- 即刻AI：赞助 TapCanvas，主打官渠视频模型，详见赞助与支持。
- AtomGit / GitCode：提供代码托管、开源社区推广与 Badge 数据服务，上述链接即本项目在 AtomGit 的项目入口。
上游开源项目：
| 项目 | 在本仓库中的职责 |
|---|---|
| new-api（上游为 One API） | apps/new-api 模型网关的来源实现，负责渠道接入、计量与模型下发 |
| DirectorDesk | apps/director-desk 导演台的三维预演、场景搭建、走位与摄影机工具；本目录按 MIT 许可集成 |
| DeepSeek Harness | apps/agents-cli Bridge 的官方运行时、主代理循环与工具能力 |
React Flow（@xyflow/react） |
无限画布的节点、端口与连线内核 |
| Mantine | Web 端 UI 组件与主题 |
| Hono | apps/hono-api 的 Worker 路由与 OpenAPI 层 |
| Prisma | 数据模型与数据库访问 |
| Vite / Vitest | Web 构建与测试 |
| AI SDK、Zustand、Tabler Icons | 模型调用、前端状态管理与图标 |
具体依赖版本以 apps/*/package.json 与 pnpm-lock.yaml 为准；第三方组件各自适用其上游许可证，见许可证。
感谢每一位通过代码、文档、Issue、评审、测试与使用反馈帮助 TapCanvas 持续完善的贡献者。
每一次贡献都在帮助社区版变得更统一、更稳定，也让多模态内容生产工作流能够服务更多创作者。欢迎阅读现有 Issues、提交修复或分享你的工作流实践。
作者：Beq（李碧强） · 邮箱：[email protected]
Bug、功能建议与贡献请通过 Issues 或 Pull Request 提交。
