中文 | English
Toonflow 前端应用
基于 Vue 3 + TypeScript + Vite 构建的现代化 Web 界面
AI短剧工厂的用户操作端 🎨
🎯 现代化前端架构:采用 Vue 3 组合式 API、TypeScript 类型安全、Vite 极速构建,打造流畅的用户体验!
本仓库仅包含前端源代码,适用于开发者进行二次开发或定制。
🎉 如果您是普通用户,想要直接使用 Toonflow,请前往主仓库下载完整客户端:
平台 链接 👉 github.com/HBAI-Ltd/Toonflow-app 👉 gitee.com/HBAI-Ltd/Toonflow-app 主仓库包含:
8000 blockquote>
- ✅ 完整的桌面客户端
- ✅ 后端服务
- ✅ 开箱即用的安装包
- ✅ 详细的使用教程
- 框架:Vue 3.5+ (组合式 API)
- 构建工具:Vite 5.4+
- 语言:TypeScript 5.6+
- 状态管理:Pinia 2.2+ (支持持久化)
- 路由:Vue Router 4.4+
- UI 组件库:
- Ant Design Vue 4.2+
- Element Plus 2.13+
- VXE Table 4.17+
- 工具库:
- Axios - HTTP 请求
- VueUse - Vue 组合式工具集
- Day.js - 日期处理
- Mammoth - Word 文档解析
Toonflow Web 提供了完整的短剧创作前端界面,包含以下核心模块:
✅ 项目管理
创建、编辑和管理短剧项目,支持项目状态追踪和多项目并行开发。✅ 原始文本编辑
导入和编辑小说原文,支持 Word 文档解析,智能文本清洗和章节分割。✅ 角色素材库
管理角色设定、角色图片等素材,支持批量生成、手动上传和在线编辑。✅ 大纲管理
可视化编辑故事大纲和事件线,支持拖拽排序和智能生成。✅ 剧本编辑器
结构化剧本编辑界面,支持对话、场景、情绪等多维度标注。✅ 分镜设计
可视化分镜画布,支持拖拽布局、图像检测和 AI 对话式分镜生成。✅ 视频配置
配置视频生成参数,支持多家 AI 视频服务商切换和视频下载。✅ 任务监控
实时查看 AI 生成任务进度,支持任务队列管理和历史记录查询。✅ 系统设置
配置 AI 服务商、提示词模板、用户权限等系统级参数。
- 短剧内容创作的前端操作界面
- AI 辅助编剧工具的可视化平台
- 分镜设计与视频生成的工作台
- 多人协作的剧本管理系统
用户类型 推荐方案 GitHub Gitee 🎬 普通用户 - 想直接使用 Toonflow 创作短剧 下载完整客户端 Toonflow-app Toonflow-app 👨💻 开发者 - 想修改前端代码或二次开发 继续阅读本文档 本仓库 本仓库
在开发和运行本项目之前,请确保已安装:
- ✅ Node.js:23.11.1 或更高版本
- ✅ Yarn:1.22.0 或更高版本(推荐包管理器)
- ✅ 后端服务:确保 Toonflow 后端服务已启动并可访问(可从 GitHub 或 Gitee 获取)
GitHub:
git clone https://github.com/HBAI-Ltd/Toonflow-web.git cd Toonflow-webGitee(国内推荐):
git clone https://gitee.com/HBAI-Ltd/Toonflow-web.git cd Toonflow-webyarn installyarn dev开发服务器默认运行在
http://localhost:5173,支持热模块替换(HMR)。# 开发环境构建 yarn build:dev # 生产环境构建 yarn build:prod构建产物将输出到
dist目录。yarn preview
- 构建项目
yarn build:prod
- 部署到 Web 服务器
将
dist目录下的所有文件上传到 Nginx、Apache 或其他 Web 服务器的根目录。Nginx 配置示例:
server { listen 80; server_name your-domain.com; root /var/www/toonflow-web/dist; index index.html; location / { try_files $uri $uri/ /index.html; } # API 代理(可选) location /api/ { proxy_pass http://localhost:10588/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }将构建后的
dist目录内容复制到后端的静态资源目录scripts/web中。
- Node.js:版本要求 23.11.1 及以上
- Yarn:推荐作为项目包管理器
# 安装依赖 yarn install # 启动开发服务器(支持热更新) yarn dev # 类型检查 yarn type-check # 代码检查和自动修复 yarn lint # 代码格式化 yarn format # 构建开发版本 yarn build:dev # 构建生产版本 yarn build:prod # 预览生产构建 yarn preview # 生成第三方许可证清单 yarn license📂 Toonflow-web/ ├─ 📂 public/ # 静态资源 ├─ 📂 scripts/ # 构建脚本 │ └─ 📄 license.ts # 许可证生成脚本 ├─ 📂 src/ │ ├─ 📂 assets/ # 静态资源(样式、图片等) │ │ └─ 📄 main.css # 全局样式 │ ├─ 📂 components/ # 公共组件 │ │ ├─ 📄 sider.vue # 侧边栏组件 │ │ ├─ 📂 chat/ # 聊天组件 │ │ ├─ 📂 storyboardEditor/ # 分镜编辑器 │ │ └─ 📂 videoConfig/ # 视频配置组件 │ ├─ 📂 config/ # 配置文件 │ │ └─ 📄 manufacturerConfig.ts # 厂商配置 │ ├─ 📂 pages/ # 页面组件 │ │ ├─ 📂 error/ # 错误页面 │ │ ├─ 📂 login/ # 登录页面 │ │ └─ 📂 workbench/ # 工作台 │ ├─ 📂 router/ # 路由配置 │ │ └─ 📄 index.ts # 路由定义 │ ├─ 📂 stores/ # Pinia 状态管理 │ │ ├─ 📄 index.ts # Store 入口 │ │ ├─ 📄 loadingStore.ts # 加载状态 │ │ ├─ 📄 user.ts # 用户状态 │ │ └─ 📄 video.ts # 视频状态 │ ├─ 📂 types/ # TypeScript 类型定义 │ │ ├─ 📄 auto-imports.d.ts # 自动导入类型 │ │ ├─ 📄 components.d.ts # 组件类型 │ │ ├─ 📄 global.d.ts # 全局类型 │ │ ├─ 📄 manufacturer.ts # 厂商类型 │ │ └─ 📄 shims-vue.d.ts # Vue 模块声明 │ ├─ 📂 utils/ # 工具函数 │ │ ├─ 📄 axios.ts # HTTP 请求封装 │ │ ├─ 📄 combineImages.ts # 图片合成 │ │ ├─ 📄 8000 error.ts # 错误处理 │ │ ├─ 📄 parseNovel.ts # 小说解析 │ │ ├─ 📄 splitGraph.ts # 图像分割 │ │ ├─ 📄 throttle.ts # 节流防抖 │ │ └─ 📄 wsClient.ts # WebSocket 客户端 │ ├─ 📂 views/ # 视图页面 │ │ ├─ 📂 project/ # 项目管理 │ │ ├─ 📂 projectDetail/ # 项目详情 │ │ │ ├─ 📂 components/ │ │ │ │ ├─ 📂 assetsManager/ # 素材管理 │ │ │ │ ├─ 📂 originalText/ # 原始文本 │ │ │ │ ├─ 📂 outlineManager/ # 大纲管理 │ │ │ │ ├─ 📂 overview/ # 项目概览 │ │ │ │ └─ 📂 scriptManager/ # 剧本管理 │ │ ├─ 📂 setting/ # 系统设置 │ │ └─ 📂 taskList/ # 任务列表 │ ├─ 📄 App.vue # 根组件 │ └─ 📄 main.ts # 应用入口 ├─ 📄 components.d.ts # 全局组件类型 ├─ 📄 eslint.config.js # ESLint 配置 ├─ 📄 index.html # HTML 模板 ├─ 📄 package.json # 项目配置 ├─ 📄 tsconfig.json # TypeScript 配置 ├─ 📄 tsconfig.app.json # 应用 TS 配置 ├─ 📄 tsconfig.node.json # Node TS 配置 ├─ 📄 vite.config.ts # Vite 配置 ├─ 📄 LICENSE # 许可证 ├─ 📄 NOTICES.txt # 第三方依赖声明 └─ 📄 README.md # 项目说明
我们正持续优化前端体验,以下为近期开发重点:
UI/UX 优化
🎨 暗色主题支持提供优雅的暗色模式选项,保护用户视力📱 响应式布局优化移动端和平板设备的显示效果⌨️ 快捷键系统添加常用操作的快捷键,提升操作效率功能增强
📊 数据可视化增强项目数据统计和可视化图表展示🔄 实时协作支持多人同时编辑,实时同步状态💾 自动保存智能自动保存功能,防止数据丢失性能优化
⚡ 虚拟滚动大数据列表的性能优化🗜️ 资源压缩优化构建产物体积,提升加载速度🔌 懒加载优化进一步优化路由和组件的懒加载策略
A: 修改
vite.config.ts中的端口配置:export default defineConfig({ server: { port: 3000, // 修改为其他端口 }, });A: 在
.env.dev中配置后端地址:VITE_TYPE=dev VITE_BASE_URL=http://127.0.0.1:10588 VITE_WS_URL=ws://127.0.0.1:10588A: 请前往主仓库下载完整客户端:
- GitHub:👉 Toonflow-app
- Gitee:👉 Toonflow-app
仓库 说明 GitHub Gitee Toonflow-app 完整客户端(推荐普通用户) GitHub Gitee Toonflow-web 前端源代码(本仓库,适合开发者) GitHub Gitee
请到主仓库中查看
- GitHub:👉 Toonflow-app
- Gitee:👉 Toonflow-app
Toonflow 基于 Apache-2.0 协议开源发布,并附有补充商业协议。
许可证详情:https://www.apache.org/licenses/LICENSE-2.0
- 若将本软件以产品形式分发给 2 个及以上独立第三方使用,须取得 HBAI-Ltd 书面商业授权。
- ≤ 5 个法人联合运营内部使用,不对外提供服务的,视为内部使用,无需授权。
- 不得删除或修改 Toonflow 中的标识或版权信息。
- ✅ 用 Toonflow 制作内容并获得平台分账
- ✅ 二次开发供自己团队内部使用
- ✅ ≤ 5 个法人联合运营内部使用
- ✅ 个人学习、研究、非商业用途
阶段 年销售额 年费 🌱 扶持期 < ¥10 万 申请即可免费授权 🚀 初创期 ¥10–50 万 ¥5,000/年 📈 成长期 ¥50–150 万 ¥20,000/年 🏢 规模期 ¥150–500 万 ¥80,000/年 🌐 企业级 > ¥500 万 面议 不追溯条款:v1.0.8 发布前基于 AGPL-3.0 使用的用户,继续按 AGPL-3.0 执行,不受本协议变更约束。
完整协议详见 LICENSE 文件。
感谢以下开源项目为 Toonflow Web 提供强大支持:
- Vue.js - 渐进式 JavaScript 框架
- Vite - 下一代前端构建工具
- Ant Design Vue - 企业级 UI 组件库
- Element Plus - 基于 Vue 3 的组件库
- TDesign - 为设计师 & 开发者,打造工作美学
- Pinia - Vue 的直观状态管理库
感谢以下组织/单位/个人为 Toonflow 提供支持:
![]()
算能云 提供算力赞助 [官网] 完整的第三方依赖清单请查阅
NOTICES.txt