Toonflow一款AI短剧创作工具将小说自动转化为剧本生成 AI 图片和视频的平台

• 用户名: admin
• 密码: admin123

可以无卡模式运行改项目0.15元每小时按秒计费

镜像简介

Toonflow是什么？

• Toonflow 是一款 AI 短剧漫剧工具，能够利用 AI 技术将小说自动转化为剧本，并结合 AI 生成的图片和视频，实现高效的短剧创作。借助 Toonflow，可以轻松完成从文字到影像的全流程，让短剧制作变得更加智能与便捷。

---

需要本地window或者mac电脑运行

• 这里下载客户端：https://github.com/HBAI-Ltd/Toonflow-app/releases/

本项目选择最低配置P40或者无卡模型运行即可

镜像使用视频教程

使用前看看视频教程【新手非常必要】：

https://www.bilibili.com/video/BV1EwFzzsEsQ/

该项目使用8分钟入门教程：

https://www.bilibili.com/video/BV1na6wB6Ea2

• 原项目地址：https://github.com/HBAI-Ltd/Toonflow-app
• 版权归作者所有©️

bug反馈可以加入科哥专属群交流➕ 广告勿进！​

​

科哥在UCloud镜像列表【不断更新中】：

• https://kege-aigc.feishu.cn/docx/L3FVdQl7kom8Ckx7QiicQj2VnEd

---

运行使用界面截图​

​

技术支持

【插入一个小广告 给需要做ai漫画ai短剧的朋友另一个选择】：

【好消息】sora在线生成注册免费体验2次！欢迎免费测试使用！ 1.api中转站【推荐】，全球最卷，有些比官网便宜90+%： https://ai.kegeai.top/register?aff=78Gs

• 工作流有sora，veo3，grok3等ai视频生成，谷歌香蕉修图等等。

• 注册帮助： https://kege-aigc.feishu.cn/docx/Gr5wddbYwogvkSxYfdxc7ou1nFb?from=from_copylink

• 技术微信：312088415

---

Toonflow 用户使用手册

一、系统概述

Toonflow 是一套 AI 动画视频生成平台，支持从剧本创作、分镜设计到 AI 视频生成的完整工作流程。

主要功能模块

1. 项目管理 - 创建和管理动画项目
2. 剧本管理 - 编写和编辑剧本
3. 分镜管理 - 创建和管理分镜图
4. 素材管理 - 管理和上传图片、视频、音频素材
5. 视频生成 - AI 视频生成（文生视频、图生视频）
6. 图片生成 - AI 图片生成
7. AI Agent - 智能助手辅助创作

---

二、启动系统

方式一：一键启动（推荐）

/root/Toonflow-app/start_app.sh

方式二：手动启动

# 启动后端
cd /root/Toonflow-app
pm2 start pm2.json

# 启动前端（Nginx）
nginx

访问地址

• 前端：http://localhost:7860
• 后端：http://localhost:10588

---

三、登录系统

默认账号

• 用户名：admin
• 密码：admin123

登录后可进入系统设置修改密码。

---

四、功能模块使用

1. 项目管理

进入系统后，首先需要创建项目：

1. 点击左上角「新建项目」按钮
2. 填写项目名称
3. 选择项目类型
4. 点击确定创建

2. 剧本管理

在项目内可以编写剧本：

1. 进入项目后，点击「剧本」标签
2. 支持手动输入或导入 TXT/Word 文档
3. 可以对剧本进行分段、编辑
4. 系统会自动进行事件分析和角色提取

3. 分镜管理

创建分镜图：

1. 进入项目后，点击「分镜」标签
2. 点击「新增分镜」添加新分镜
3. 上传分镜图片或使用 AI 生成
4. 可编辑分镜描述、镜头类型等信息

4. 素材管理

管理项目所需素材：

1. 点击「素材库」进入素材管理
2. 支持上传图片、视频、音频
3. 可批量上传和分类管理
4. 支持 AI 图片生成

5. 视频生成（核心功能）

AI 视频生成是核心功能，支持多种模式：

5.1 入口

进入项目后，点击「生成」标签

5.2 生成模式

• 文本生视频：输入提示词生成视频
• 单图生视频：参考单张图片生成视频
• 多图参考：参考多张图片生成视频
• 视频参考：参考视频生成视频

5.3 操作步骤

步骤一：选择分镜

• 在左侧选择要生成视频的分镜
• 或点击「添加轨道」创建新轨道

步骤二：设置参考

• 点击轨道上的「+」号
• 上传参考图片或选择素材库中的素材
• 支持混合多种参考类型

步骤三：输入提示词

• 在下方文本框输入画面描述
• 支持中英文
• 失焦时会自动保存到后端

步骤四：生成视频

• 点击「生成视频」按钮
• 等待 AI 处理生成
• 可同时对多个轨道生成

步骤五：预览和下载

• 生成完成后，点击视频预览
• 可下载单个视频或批量下载
• 历史记录会自动保存

5.4 高级功能

• 批量生成：勾选多个轨道同时生成
• 历史版本：每个轨道保留生成历史
• 视频封面：自动截取视频首帧

6. 图片生成

生成 AI 图片：

1. 进入「素材库」
2. 点击「图片生成」
3. 选择图片模型
4. 输入提示词
5. 点击生成

7. 设置

点击右下角齿轮图标进入设置：

• 语言设置：切换界面语言（中文/英文/日文等）
• 主题设置：切换明暗主题
• 供应商配置：配置 AI 模型 API
• 登录配置：修改账号密码
• 模型映射：管理模型对应关系

---

五、常见问题 FAQ

Q1: 登录提示 Network Error

原因：前端 API 地址配置错误
解决：刷新页面（Ctrl+F5 强制刷新），确保 baseUrl 为 /api

Q2: 视频生成失败

检查：

1. 是否配置了有效的 AI 模型 API
2. 网络是否正常
3. 提示词是否符合模型要求

Q3: 素材上传失败

检查：

1. 文件大小是否超限
2. 文件格式是否支持
3. 网络连接是否正常

Q4: 前端页面显示异常

解决：

# 重新构建前端
/root/Toonflow-app/start_app.sh --rebuild

Q5: 后端服务启动失败

解决：

# 查看后端日志
pm2 logs toonflow

# 重启后端
pm2 restart toonflow

Q6: 如何修改端口

1. 修改 /root/Toonflow-app/start_app.sh 中的 FRONTEND_PORT
2. 重新运行启动脚本

---

六、快捷操作

常用命令

# 启动服务
/root/Toonflow-app/start_app.sh

# 重启服务（重新构建前端）
/root/Toonflow-app/start_app.sh --rebuild

# 查看后端状态
pm2 status

# 查看后端日志
pm2 logs toonflow

# 重启后端
pm2 restart toonflow

# 停止后端
pm2 stop toonflow

---

七、界面预览

主界面布局

• 顶部：项目名称、导航栏
• 左侧：功能菜单（项目/剧本/分镜/素材/生成）
• 中部：工作区
• 右侧：属性面板
• 底部：状态栏
• 右下角：设置按钮

---

如有其他问题，请查看 todo.md 或联系技术支持。

---

Toonflow 项目开发维护笔记

一、环境搭建问题

1. Node.js 版本问题

• 问题: Node.js 24 在 nvm 远程列表中不可用
• 解决: 使用 Node.js 22 LTS 或现有 Node.js 20.5.0

2. 依赖安装问题

• 问题1: sqlite3@6.0.1 要求 Node.js >= 20.17.0（当前 20.5.0 不满足）
• 解决: 使用 yarn install --ignore-engines --ignore-scripts
• 问题2: onnxruntime-node 尝试下载 CUDA 二进制文件失败
• 解决: 在 package.json 中添加 overrides 禁用 onnxruntime-node

"overrides": {
  "onnxruntime-node": false
}

3. better-sqlite3 编译问题

• 问题: 运行时报错找不到 better_sqlite3.node
• 解决: npm rebuild better-sqlite3 --build-from-source

二、前端部署问题

1. 编译报错

• 问题1: generate copy.vue 语法错误（多余的 )）

• 解决: 修复 computed 函数语法

• 问题2: tsconfig.app.json 中有废弃选项 ignoreDeprecations: "6.0"

• 解决: 删除该选项

• 问题3: @vitejs/plugin-vue 6.x 与 Node.js 20.5.0 不兼容

• 错误: crypto.hash is not a function

• 解决: 降级到 5.2.1 版本

• 问题4: vite.config.ts 中重复逗号

• 解决: 移除多余逗号

2. Nginx 配置

• 问题: 静态文件权限不足
• 解决: chmod -R o+rx /root/Toonflow-web/dist/

三、登录 API 问题

1. 字段名不匹配

• 问题: 前端发送 username，后端期望 name
• 解决: 后端自动处理，无需修改

2. Network Error

• 问题: 前端 baseUrl 配置错误
• 错误1: 使用 http://localhost:10588/api（直接连接后端）
• 错误2: 使用 http://localhost:7860/api（通过 Nginx 但非相对路径）
• 解决: 改为相对路径 /api，通过 Nginx 代理到后端

3. axios 错误处理

• 问题: error.status 报错
• 解决: 改为 error.response?.status

四、启动脚本

start_app.sh 功能

• 自动清理前后端端口占用
• 检查并构建前端（首次或带 --rebuild 参数）
• 启动后端服务 (PM2)
• 配置 Nginx 反向代理

使用方式

# 正常运行（跳过构建）
/root/Toonflow-app/start_app.sh

# 强制重新构建前端
/root/Toonflow-app/start_app.sh --rebuild
/root/Toonflow-app/start_app.sh -r

五、端口配置

• 前端: 7860
• 后端: 10588

六、默认账号

• 用户名: admin
• 密码: admin123

视频教程

详细使用教程请访问 B 站视频： https://www.bilibili.com/video/BV1na6wB6Ea2