Toonflow-app

环境要求

• Windows / Linux / macOS 桌面系统之一
• Node.js 24（云服务器部署时通过 nvm 安装）
• Yarn 包管理器（npm install -g yarn）
• PM2（仅云服务器方式部署时需要）

安装与启动步骤

1. 1下载安装包

   前往 GitHub Release 页面，按 Windows/Linux/macOS 选择官方发布安装包下载；macOS 需在设置-隐私与安全性中放行。

2. 2源码运行（可选）

   需要自行编译时改用源码方式：克隆仓库、安装依赖并启动 Electron 桌面客户端，自带内置前端页面。

   git clone https://github.com/HBAI-Ltd/Toonflow-app.git
   cd Toonflow-app
   yarn install
   yarn dev:gui

   复制

3. 3启动并登录

   安装完成后启动程序即可使用。首次登录账号 admin、密码 admin123，建议登录后立即修改密码。

4. 4配置模型供应商

   在设置中心填入文本、图像、视频模型的 API 密钥与请求地址，保存后确认三个模型调用开关已开启。

5. 5新建项目导入原著

   新建项目并导入小说或剧本原著，执行章节事件提取，为后续剧本生成准备结构化素材。

6. 6生成结构化剧本

   进入 ScriptAgent，依次生成故事骨架、改编策略与结构化剧本。

7. 7分镜与视频导出

   切换到 ProductionAgent，在无限画布组织分镜、素材与视频节点，精调后回流工作台完成拼接与导出。

关键配置

如何确认成功

桌面端出现 Electron 窗口即可用；服务端访问 http://localhost:10588，能用 admin / admin123 成功登录即部署成功。

常见问题

注意事项

• 首次登录后请及时修改默认密码 admin123。
• 本仓库已内置编译好的前端资源，普通用户无需单独部署 Toonflow-web，前端仓库仅供二次开发使用。
• 安装包请从 GitHub Release 获取，Gitee 因环境限制及上传大小限制不提供 Release 下载。
• README 中 Docker 在线部署标注“待完善”，目前可用 yarn docker:local 本地构建启动。