Toonflow 部署实战指南:AI 短剧创作平台的桌面、Docker 与服务器安装全解析

发布时间:2026/10/3 1:45:25
Toonflow 部署实战指南:AI 短剧创作平台的桌面、Docker 与服务器安装全解析 人工智能AI 应用AI AgentRAGAI 写作后端桌面应用【免费下载链接】Toonflow-appToonflow 是一款 AI 短剧漫剧工具能够利用 AI 技术将小说自动转化为剧本并结合 AI 生成的图片和视频实现高效的短剧创作。借助 Toonflow可以轻松完成从文字到影像的全流程让短剧制作变得更加智能与便捷。项目地址https://gitcode.com/HBAI-Ltd/Toonflow-app点击查看免费下载本指南以 Toonflow 官方 README孟加拉语版 docs/readme/readmeBn.md为核心骨架系统讲解这款开源 AI 短剧创作平台的完整部署路径桌面端Windows/macOS、Docker 容器与 Linux 服务器三种安装方式以及端口访问、数据目录、备份迁移、模型网关等运维要点。读完本文你将掌握从零搭建 Toonflow 的全流程并理解其底层构建与数据组织方式可直接对照仓库源码排查与扩展。Toonflow 是什么Toonflow 是一个面向短剧短剧漫剧创作的开源 AI 平台将写剧本—整理素材—生成图片与视频的完整创作链条统一到一个无限画布上。开发者既可以用它直接完成从小说到影像的短剧制作也可以把它当作可扩展的 AI 工作流基础设施——通过节点、工具、插件与 Agent 体系自由组合能力。核心定位本地优先local-first。项目、素材与配置默认保存在你自己的设备或服务器上不依赖云端账号。七大核心特性特性说明本地部署支持桌面端、Docker 与服务器三种部署形态项目和素材存放于自有设备或服务器️无限画布在同一个画布上组织剧本、角色、场景与视频片段画布工具位于 apps/web/src/pages/workspace/panels/canvasMCP 支持通过 MCP 协议连接外部工具与服务服务端挂载于/mcp路径见 apps/server/src/app.ts插件市场从插件市场安装节点Node、工具Tool与创作类能力安装逻辑见 apps/server/src/utils/plugins/install.ts开放 Agent 体系通过 Prompt、工具与 A2AAgent-to-Agent协议调整 Agent 行为甚至与外部 Agent 协作相关实现见 apps/server/src/agent灵活模型接入可配置第三方 API也可接入本地自建的 ComfyUI 与 LLM官方还内置 TF-Router 网关多语言界面界面支持 21 种语言多语言并非宣传口号——在 packages/i18n/src/index.ts 的supportedLocales中确实定义了 21 个语言条目覆盖简体中文、繁体中文、English、日本語、বাংলা、اردو、தமிழ் 等其中孟加拉语bn的完整翻译目录位于 packages/i18n/src/locales/bn.json与服务端 i18n 中间件apps/server/src/lib/i18n.ts联动实现界面本地化。桌面端安装桌面端基于 Electrobun 构建根目录 electrobun.config.ts提供 Windows 与 macOS 两个平台的原生安装包。WindowsWebView2 自动检测Windows 安装器会在安装过程中自动检测并安装 WebView2 运行时。仓库中 apps/desktop/installer/checkWebView2.cs 实现了检测逻辑通过GetAvailableCoreWebView2BrowserVersionString读取系统已安装的 WebView2 版本并与最低要求版本对比检测到120.0.0.0 及以上版本 → 返回0安装继续版本过低 120→ 返回3提示 WebView2 过期未检测到 → 返回1触发自动安装流程。要求 WebView2 ≥ 120 并非随意设定注释明确说明URL.canParse需要 Chromium 120同时覆盖Map.groupBy与Promise.withResolvers等新 API。若安装后应用立刻闪退说明 WebView2 运行时缺失或版本过旧请从微软官方 WebView2 下载页手动下载并安装最新运行时然后重新打开应用。macOS安装与安全提示处理macOSApple Silicon下直接将 Toonflow 拖入 Applications 文件夹即可打开无需在终端执行任何命令。若系统弹出安全警告按以下顺序处理1. 在隐私与安全性中放行系统提示无法验证开发者或Apple 无法检查 App 是否包含恶意软件时先尝试直接打开 App随后进入 System Settings → Privacy Security找到 Toonflow 被阻止的提示点击Open Anyway并按指引确认。2. 移除隔离属性quarantine确认 App 来自官方发布页且位于 Applications 目录后在终端执行sudo xattr -rd com.apple.quarantine /Applications/toonflow.app若应用名或安装位置不同请相应调整路径。3. 最后手段临时允许任意来源若前两步无效且你信任应用来源可执行sudo spctl --master-disable然后在 System Settings → Privacy Security 中将允许从以下位置下载的应用改为 Anywhere 并确认。此操作会放开所有 App 的安全限制建议完成后恢复为App Store 和已标识的开发者。不同 macOS 版本对上述选项与命令的支持存在差异请以实际系统为准。Docker 部署Docker 是最快、最一致化的部署方式适合不想污染宿主机环境或需要快速试用的场景。仓库根目录已包含 Dockerfile、compose.yaml 与 .dockerignore。镜像构成从 Dockerfile 可以看到镜像的完整构成基础镜像oven/bun:1.3.14内置 Bun 1.3.14 运行时通过apt-get安装ca-certificates与FFmpeg视频处理依赖无需在宿主机另行安装bun install --frozen-lockfile按 lockfile 精确安装依赖bun run build:server构建服务端产物并预创建data/workspaces/myProject工作区环境变量TOONFLOW_DATA_DIR/app/data指定数据目录容器以非 root 用户bun运行暴露3000端口。启动步骤克隆源码并在仓库根目录执行git clone https://gitcode.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app docker compose up -d --build首次构建会安装依赖并打包 nodes、tools、Web 与 Server 产物。启动成功后打开http://127.0.0.1:3000。首次启动会初始化内置插件并提供名为myProject的可用工作目录。从 compose.yaml 可以看到端口被显式绑定为127.0.0.1:3000:3000——即只监听本机回环地址不对局域网暴露这是官方默认的安全姿势。常用运维命令docker compose logs -f toonflow # 查看日志 docker compose stop # 停止服务 docker compose start # 再次启动 docker compose down # 移除容器保留数据卷数据卷与备份设置、插件与项目文件保存在 Docker 数据卷toonflowData中挂载到容器内/app/data/实际卷名会带 Compose 项目名前缀。停止或重建容器都不会丢失数据。⚠️切勿执行docker compose down -v-v会连带删除数据卷造成数据彻底丢失。新增项目目录二选一在 Web 界面的选择服务器工作目录对话框中点击新建文件夹对话框同时支持重命名与删除文件夹服务运行期间直接用命令行创建docker compose exec toonflow mkdir -p /app/data/workspaces/newProject备份数据先停止服务拷贝数据再重启docker compose stop docker compose cp toonflow:/app/data ./toonflowBackup docker compose start服务器部署希望在 Linux 服务器上直接运行 Web 与 Server 时使用此方式。以下示例基于 Ubuntu/Debian 与 Bun 1.3.14。安装运行环境sudo apt-get update sudo apt-get install -y git curl unzip ffmpeg curl -fsSL https://bun.com/install | bash -s bun-v1.3.14 export PATH$HOME/.bun/bin:$PATH bun --version克隆源码并启动服务git clone https://gitcode.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app bun install --frozen-lockfile # 构建 bundled nodes、tools、Web 与 Server bun run build:server mkdir -p data/workspaces/myProject bun run start:serverbuild:server对应根目录 package.json 中的脚本bun apps/server/scripts/buildStandalone.ts——从源码看它遍历packages/nodes与packages/tools下每个子包执行生产构建再依次构建 Web 与 Server 应用apps/server/scripts/buildStandalone.ts最终产物输出到build/目录与 Dockerfile 中CMD [bun, build/server/index.js]的启动方式完全一致。start:server则对应bun run --cwd apps/server start。当控制台出现服务启动成功提示后在服务器本机打开http://127.0.0.1:3000。上述命令以前台方式运行按CtrlC即可停止。如需开机自启与进程守护可参考 Bun 官方 systemd 部署指南将仓库目录作为工作目录使用 Bun 完整路径如$HOME/.bun/bin/bun加上run start:server作为 ExecStart 命令并以对该目录有读写权限的用户运行。访问控制与数据管理无论采用哪种部署方式以下规则都适用固定端口 3000。Web 界面与 API 均无独立登录认证服务器部署时务必通过防火墙或安全组限制3000端口的外部访问若需公网访问应配置带认证的反向代理。远程私有访问在自己的电脑上执行ssh -N -L 3000:127.0.0.1:3000 usernameserver-address保持连接后访问http://127.0.0.1:3000无需将服务器 3000 端口暴露到公网。数据目录直装方式默认存放在仓库的data/目录Docker 方式存放在数据卷内的/app/data/迁移或备份时应保存整个目录。工作区打开页面后在服务器工作区中选择myProject额外项目在workspaces/下创建对应子目录。模型 API Key两种安装方式都内置了 FFmpeg但仍需在界面中为模型服务配置 API Key。服务端的数据目录统一由TOONFLOW_DATA_DIR环境变量驱动apps/server/src/app.ts首次启动时会自动将内置的工具、节点、供应商与技能模板初始化到该目录此后用户编辑的供应商与技能不会被应用版本覆盖。TF-Router官方模型网关Toonflow 官方提供名为TF-Router的模型网关对应仓库 packages/providers/src/language/tfRouter.ts 与 packages/providers/src/media/tfRouter.ts 中的供应商实现服务端首次启动时即会将其列为自动安装的内置供应商之一见 apps/server/src/app.ts 的autoInstallProviders。TF-Router 的完整源代码同样开源可自行部署验证也可直接在 Toonflow 中配置其 API 地址与密钥使用。它解决了部分模型如视频生成模型官方申请门槛高、普通用户难以获得授权访问的问题官方在推广期内按接近成本价提供接入推广期后收取极小的服务费。实战一个示例创作工作流官方 README 记录了一个真实示例作品的构建明细项目记录值制作时间与成片时长约 2 分钟视频耗时约 2 小时视频模型Seedance 2.0图片模型GPT Image 2语言模型Claude Opus 4.6模型 API 成本约 ¥130 人民币语言约 ¥10、视频约 ¥120、图片不足 ¥1以上仅为该示例的文档记录成本仅作参考。实际花费取决于模型服务商、生成次数与所用参数。示例视频为压缩后的 480p 版本。该流程的典型形态是在无限画布中编排文本节点剧本/分镜、图片生成节点与视频生成节点借助角色参考图与多参考素材完成视频生成——对应仓库中的 imageGenerationNode、videoGenerationNode 等节点包以及 apps/web/src/pages/workspace/panels/canvas 的画布编排能力。开放生态插件、Agent 与 MCP除了开箱即用的功能Toonflow 的可扩展性是架构层面的设计插件系统节点、工具、技能Skill、团队Team与供应商Provider均以独立包形式存在于 packages/nodes、packages/tools、packages/skills、packages/teams 等目录并可通过界面中的插件市场在线安装服务端在启动时按目录规则动态加载apps/server/src/utils/plugins/initialize.ts。MCP服务端提供/mcp端点apps/server/src/app.ts使外部 MCP 客户端可以直接调用 Toonflow 内部能力配套的 packages/mcp 包还提供标准输入输出stdio模式可被本地 MCP 客户端直接拉起。Agent 与 A2AAgent 行为可通过 Prompt、工具集调整并能与外部 Agent 通过 A2A 协议协作apps/server/src/agent相关跨团队协作能力见 packages/teams/storyboardTeam。开源许可证Toonflow 以 MIT License 发布第三方依赖与资源遵循各自的开源协议。许可证附有非追溯条款使用 v1.0.8 之前版本的用户仍受 AGPL-3.0 约束v1.0.8 至 v1.1.8 版本的用户受 Apache-2.0 及其附加协议约束且不受本次许可证变更影响。这一条款在文档中明确声明引用或二次分发时需留意版本边界。赞分享人工智能AI 应用AI AgentRAGAI 写作后端桌面应用【免费下载链接】Toonflow-appToonflow 是一款 AI 短剧漫剧工具能够利用 AI 技术将小说自动转化为剧本并结合 AI 生成的图片和视频实现高效的短剧创作。借助 Toonflow可以轻松完成从文字到影像的全流程让短剧制作变得更加智能与便捷。项目地址https://gitcode.com/HBAI-Ltd/Toonflow-app点击查看免费下载相关推荐pgai Vectorizer 结合 LiteLLM 评估多个 Embedding 模型的完整实践pgai Vectorizer 结合 LiteLLM 评估多个 Embedding 模型的完整实践 本文基于 pgai 仓库中的示例 examples/eval人工智能AI 应用AI AgentRAGAI 写作后端桌面应用Agent SpecAgent Spec Overview 描述 Agent 的目的及其工作方式。 Example Use Cases 具体的用例含预期输入与输出。 Tools人工智能AI 应用AI AgentRAGAI 写作后端桌面应用gogcli 表格行操作实战用 gog docs table-row 增删、固定表头与定制 Google Docs 原生表格行gogcli 表格行操作实战用 gog docs table row 增删、固定表头与定制 Google Docs 原生表格行 导读 Google Docs人工智能AI 应用AI AgentRAGAI 写作后端桌面应用上一篇yuzu模拟器完全上手手册免费在电脑和手机上跑Switch游戏下一篇AutoTrain Advanced终极指南如何利用SHAP与Permutation Importance解析训练数据特征重要性创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考