面向 AI 影视、漫剧与多模态内容生产的 Agent 原生无限画布
TapCanvas 把创意、脚本、角色与场景资产、分镜、图像、视频和最终成片放进同一个可追溯的画布工作流。它不是单次模型调用器：Agents 会读取真实项目与画布状态，自主选择 Skills 和工具，执行多步生产，并以节点、资产和运行记录交付结果。在线网站核心功能及样式与当前项目完全一致。
版本边界： 本仓库是 TapCanvas 社区版，在线商业版是独立产品，功能、服务与条款均不相同。社区版不提供短信验证码与在线支付；模型渠道由使用者自行配置。
- 无限画布：用强类型节点、端口和连线组织文档、角色、分镜、图像、视频、音频、字幕与工作流。
- Agent 原生执行：
POST /public/agents/chat统一进入 DeepSeek Harness Bridge，由 Agents 负责语义理解、规划、Skills、子代理与最终交付自检。 - 成片生产底座（需编排）：支持章节上下文、角色/场景资产、结构化分镜、连续镜头、首尾帧承接、视频生成与合成；固定的一键成片入口尚未上线。
- 多模型网关：文本、图像、视频和音频模型由鲁班 API（
apps/new-api）统一接入、计量和动态下发，前端不写死模型列表。 - 项目化资产：素材库、版本、生成历史、任务状态、交付证据与项目本地元数据持续沉淀，生成成功的资产不会被后处理丢弃。
- 工作流与协作：支持可复用 DAG、异步 Worker、失败恢复、分享/发布、团队作用域与实时画布状态。
默认展示最新 10 条，较早记录展开查看。
- 2026-09-23 · 导演台升级：同步 TapCanvasPro 的独立导演台，基于 DirectorDesk 提供三维场景搭建、角色走位与摄影机预演；接入 TapCanvas AI 对话、工具中继和参考视频导出回画布，替换旧内嵌实现，并补充 MIT 许可鸣谢。Web 开发和构建会自动构建导演台，本地首次使用需安装其独立依赖。
- 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：更新一键成片相关实现与配套技能。
更早更新记录（4 条）
- 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 接入说明。
主链路是 无限画布 → Agents Bridge → 生产工作流内核 → 任务与媒体 Workers → 可验证交付。Agents 根据真实项目状态按需调用 Skills、MCP、子代理与工作流；图片、视频和音频任务经鲁班 API 进入 AIGC 模型，再由任务账本、队列、租约、幂等、重试与 reconcile，以及真实资产 URL 和 delivery evidence，保证长链路生产可恢复、可追溯、可验收。
一键成片边界： 底层 AIGC、工作流编排、异步执行与交付验收能力已经具备，但固定的一键成片产品入口尚未上线，当前需要自行编排工作流。点击架构图可打开带导览与节点说明的交互版本。
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 启动只需要 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 # 停止服务，不删除数据卷TapCanvas 根项目及未另行声明的代码按 MIT License 发布。apps/new-api 是独立上游衍生组件，继续适用其目录中的 GNU AGPL-3.0 License 与原始归属声明；其他第三方组件分别适用各自许可证。在线商业版不适用本仓库协议。
感谢以下平台与开源项目，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（李碧强） · 邮箱：beq.li@qq.com
Bug、功能建议与贡献请通过 Issues 或 Pull Request 提交。