+ 中文 | + English +
+ +
+
+
+
+# Toonflow
+
+
+
+---
+
+# 🌟 主要功能
+
+Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧本，并结合 AI 生成的图片和视频，实现高效的短剧创作。借助 Toonflow，可以轻松完成从文字到影像的全流程，让短剧制作变得更加智能与便捷。
+
+- ✅ **角色生成**
+ 自动分析原始小说文本，智能识别并生成角色设定，包括外貌、性格、身份等详细信息，为后续剧本与画面创作提供可靠基础。
+- ✅ **剧本生成**
+ 基于选定事件和章节，系统自动生成结构化剧本，涵盖对白、场景描述、剧情走向，实现从文学文本到影视剧本的高效转换。
+- ✅ **分镜制作**
+ 根据剧本内容，智能生成分镜提示词与画面设计，细化前中后景、角色动态、道具设定和场景布局，自动根据剧本生成分镜，为视频制作提供完整路线蓝图。
+- ✅ **视频合成**
+ 集成 AI 图像与视频技术，可使用 AI 生成视频片段。整合在线编辑，支持个性化调整输出，让影视创作高效协同、快捷落地。
+
+---
+
+# 📦 应用场景
+
+- 短视频内容创作
+- 小说影视化实验
+- AI 文学 Adaptation 工具（改编工具）
+- 剧本开发与快速原型
+- 视频素材生成
+
+---
+
+# 🚀 安装与使用指南
+
+## 前置条件
+
+在安装和使用本软件之前，请准备以下内容：
+
+- ✅ 大语言模型 AI 服务接口地址。
+- ✅ Sora 或豆包视频服务接口地址
+- ✅ Nano Banana Pro 图片生成模型服务接口
+
+## 本机安装
+
+### 1. 下载与安装
+
+| 操作系统 | 下载链接 | 说明 |
+| :------: | :------------------------------------------------------- | :----------------------- |
+| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | 官方发布安装包，点击下载 |
+| Linux | ⚙️ 敬请期待 | 即将发布，请持续关注 |
+| macOS | ⚙️ 敬请期待 | 即将发布，请持续关注 |
+
+> 注意：目前仅支持 Windows 版本，其他系统将陆续开放。
+
+### 2. 启动服务
+
+安装完成后，启动程序即可开始使用本服务。
+
+## 云端部署
+
+云端安装及部署教程正在整理中，敬请期待。
+
+---
+
+# 🔧 开发流程指南
+
+## 开发环境准备
+
+- **Node.js**：版本要求 23.11.1 及以上
+- **Yarn**：推荐作为项目包管理器
+
+## 快速启动项目
+
+1. **安装依赖**
+
+ 请先在项目根目录下执行以下命令以安装依赖项：
+
+ ```bash
+ yarn install
+ ```
+
+2. **启动开发环境**
+
+ - 使用 Node.js 运行开发服务：
+
+ ```bash
+ yarn dev #端口60000
+ ```
+
+ - 使用 Bun 快速运行开发服务：
+
+ ```bash
+ yarn bun:dev #端口60000
+ ```
+
+3. **项目打包**
+
+ - 编译并生成 TypeScript 文件：
+
+ ```bash
+ yarn build
+ ```
+
+ - 打包为 Windows 平台可执行程序：
+
+ ```bash
+ yarn dist:win
+ ```
+
+4. **代码质量检查**
+
+ - 进行全局语法和规范检查：
+
+ ```bash
+ yarn lint
+ ```
+
+## 项目结构
+
+```
+📂 docs/ # 文档资源
+📂 scripts/ # 构建脚本与静态资源
+📂 src/
+├─ 📂 agents/ # AI Agent 模块
+├─ 📂 lib/ # 公共库（数据库初始化、响应格式）
+├─ 📂 middleware/ # 中间件
+├─ 📂 routes/ # 路由模块
+│ ├─ 📂 assets/ # 素材管理
+│ ├─ 📂 index/ # 首页
+│ ├─ 📂 novel/ # 小说管理
+│ ├─ 📂 other/ # 其他功能
+│ ├─ 📂 outline/ # 大纲管理
+│ ├─ 📂 project/ # 项目管理
+│ ├─ 📂 prompt/ # 提示词管理
+│ ├─ 📂 script/ # 剧本生成
+│ ├─ 📂 setting/ # 系统设置
+│ ├─ 📂 storyboard/ # 分镜管理
+│ ├─ 📂 task/ # 任务管理
+│ ├─ 📂 user/ # 用户管理
+│ └─ 📂 video/ # 视频生成
+├─ 📂 types/ # TypeScript 类型声明
+├─ 📂 utils/ # 工具函数
+├─ 📄 app.ts # 应用入口
+├─ 📄 core.ts # 路由核心
+├─ 📄 env.ts # 环境变量处理
+├─ 📄 err.ts # 错误处理
+├─ 📄 router.ts # 路由注册
+└─ 📄 utils.ts # 通用工具
+📂 uploads/ # 上传文件目录
+📄 LICENSE # 许可证
+📄 NOTICES.txt # 第三方依赖声明
+📄 package.json # 项目配置
+📄 README.md # 项目说明
+📄 tsconfig.json # TypeScript 配置
+```
+
+---
+
+# 📝 开发计划
+
+我们正持续优化产品，以下为近期开发重点：
+
+1. 核心功能升级
+
+- `🧩 提示词润色生成 Agent` 基于 AI 智能润色视频提示词，自动拆解生成分镜脚本，支持多镜头智能融合与平滑过渡
+- `📄 多格式文本支持` 扩展小说以外的剧本、漫画脚本、游戏对话文本等多种格式的智能解析
+
+2. 生产流程优化
+
+- `👗 角色服化道管理` 强化长篇内容中角色的服装、化妆、道具一致性，支持多剧集关联记忆和着装自动生成
+- `📦 批量处理/任务队列` 支持多章节同时处理，后台任务管理，进度实时监控和中断恢复
+
+3. 视觉生成增强
+
+- `🎭 多风格模板库` 内置多种视觉风格包，支持一键风格转换和用户自定义风格保存
+- `⏱️ 智能节奏分析/优化` 分析剧情情绪曲线，自动建议高潮点和节奏变化，优化分镜安排生产流程优化
+
+---
+
+# 📜 许可证
+
+Toonflow 基于 AGPL-3.0 协议开源发布，许可证详情：https://www.gnu.org/licenses/agpl-3.0.html
+
+您可以在遵循 AGPL-3.0 相关条款与条件的情况下，将 Toonflow 用于包括商业目的在内的各类用途。
+
+如需获得免于 AGPL-3.0 限制的专有商业许可，请通过邮箱与我们联系。
+
+---
+
+# 💌 联系我们
+
+📧 邮箱：[ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow咨询)
+
+---
+
+# ⭐️ 星标历史
+
+[](https://star-history.com/#HBAI-Ltd/Toonflow-app&Date)
+
+# 第三方依赖清单
+
+请查阅`NOTICES.txt`
diff --git a/docs/README.en.md b/docs/README.en.md
new file mode 100644
index 0000000..87420ae
--- /dev/null
+++ b/docs/README.en.md
@@ -0,0 +1,232 @@
+
+
+# Toonflow
+
+
+
+ AI短剧工厂
+
+ 动动手指，小说秒变剧集！
+
+ AI剧本 × AI影像 × 极速生成 🔥
+
+
+ 
+ 
+ + 中文 | + English +
+ +
+
+
+
+# Toonflow
+
+
+
+---
+
+# 🌟 Main Features
+
+Toonflow is an AI tool that leverages AI technology to automatically convert novels into scripts, combined with AI-generated images and videos for efficient short drama creation. With Toonflow, you can easily complete the entire workflow from text to visuals, making short drama production smarter and more convenient.
+
+- ✅ **Character Generation**
+ Automatically analyzes original novel text, intelligently identifies and generates character settings including appearance, personality, identity, and other detailed information, providing a reliable foundation for subsequent script and visual creation.
+- ✅ **Script Generation**
+ Based on selected events and chapters, the system automatically generates structured scripts covering dialogue, scene descriptions, and plot progression, achieving efficient conversion from literary text to film scripts.
+- ✅ **Storyboard Production**
+ Based on script content, intelligently generates storyboard prompts and visual designs, detailing foreground, midground, background, character dynamics, prop settings, and scene layouts. Automatically generates storyboards from scripts, providing a complete blueprint for video production.
+- ✅ **Video Synthesis**
+ Integrates AI image and video technology, enabling AI-generated video clips. Incorporates online editing with support for personalized output adjustments, making film production efficient and streamlined.
+
+---
+
+# 📦 Application Scenarios
+
+- Short video content creation
+- Novel-to-film experimentation
+- AI Literary Adaptation Tools
+- Script development and rapid prototyping
+- Video material generation
+
+---
+
+# 🚀 Installation and Usage Guide
+
+## Prerequisites
+
+Before installing and using this software, please prepare the following:
+
+- ✅ Large Language Model AI service API endpoint.
+- ✅ Sora or Doubao video service API endpoint
+- ✅ Nano Banana Pro image generation model service API endpoint
+
+## Local Installation
+
+### 1. Download and Install
+
+| Operating System | Download Link | Description |
+| :--------------: | :------------------------------------------------------------ | :------------------------------ |
+| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | Official release package, click to download |
+| Linux | ⚙️ Coming Soon | Coming soon, stay tuned |
+| macOS | ⚙️ Coming Soon | Coming soon, stay tuned |
+
+> Note: Currently only Windows version is supported, other systems will be available soon.
+
+### 2. Start Service
+
+After installation, launch the program to start using the service.
+
+## Cloud Deployment
+
+Cloud installation and deployment tutorials are being prepared, stay tuned.
+
+---
+
+# 🔧 Development Process Guide
+
+## Development Environment Setup
+
+- **Node.js**: Version 23.11.1 or above required
+- **Yarn**: Recommended as the project package manager
+
+## Quick Start
+
+1. **Install Dependencies**
+
+ Please first run the following command in the project root directory to install dependencies:
+
+ ```bash
+ yarn install
+ ```
+
+2. **Start Development Environment**
+
+ - Run development service with Node.js:
+
+ ```bash
+ yarn dev #port 60000
+ ```
+
+ - Run development service quickly with Bun:
+
+ ```bash
+ yarn bun:dev #port 60000
+ ```
+
+3. **Project Build**
+
+ - Compile and generate TypeScript files:
+
+ ```bash
+ yarn build
+ ```
+
+ - Package as Windows platform executable:
+
+ ```bash
+ yarn dist:win
+ ```
+
+4. **Code Quality Check**
+
+ - Perform global syntax and standard checks:
+
+ ```bash
+ yarn lint
+ ```
+
+## Project Structure
+
+```
+📂 docs/ # Documentation resources
+📂 scripts/ # Build scripts and static resources
+📂 src/
+├─ 📂 agents/ # AI Agent modules
+├─ 📂 lib/ # Common libraries (database initialization, response format)
+├─ 📂 middleware/ # Middleware
+├─ 📂 routes/ # Route modules
+│ ├─ 📂 assets/ # Asset management
+│ ├─ 📂 index/ # Homepage
+│ ├─ 📂 novel/ # Novel management
+│ ├─ 📂 other/ # Other features
+│ ├─ 📂 outline/ # Outline management
+│ ├─ 📂 project/ # Project management
+│ ├─ 📂 prompt/ # Prompt management
+│ ├─ 📂 script/ # Script generation
+│ ├─ 📂 setting/ # System settings
+│ ├─ 📂 storyboard/ # Storyboard management
+│ ├─ 📂 task/ # Task management
+│ ├─ 📂 user/ # User management
+│ └─ 📂 video/ # Video generation
+├─ 📂 types/ # TypeScript type declarations
+├─ 📂 utils/ # Utility functions
+├─ 📄 app.ts # Application entry
+├─ 📄 core.ts # Route core
+├─ 📄 env.ts # Environment variable handling
+├─ 📄 err.ts # Error handling
+├─ 📄 router.ts # Route registration
+└─ 📄 utils.ts # General utilities
+📂 uploads/ # Upload file directory
+📄 LICENSE # License
+📄 NOTICES.txt # Third-party dependency declarations
+📄 package.json # Project configuration
+📄 README.md # Project description
+📄 tsconfig.json # TypeScript configuration
+```
+
+---
+
+# 📝 Development Roadmap
+
+We are continuously optimizing the product. Here are the recent development priorities:
+
+1. Core Feature Upgrades
+
+- `🧩 Prompt Enhancement Generation Agent` AI-powered intelligent video prompt enhancement, automatic storyboard script decomposition, supporting multi-shot intelligent fusion and smooth transitions
+- `📄 Multi-format Text Support` Extending intelligent parsing beyond novels to scripts, comic scripts, game dialogue texts, and other formats
+
+2. Production Workflow Optimization
+
+- `👗 Character Costume and Props Management` Strengthen costume, makeup, and prop consistency for long-form content, supporting multi-episode associated memory and automatic outfit generation
+- `📦 Batch Processing/Task Queue` Support multi-chapter simultaneous processing, background task management, real-time progress monitoring, and interruption recovery
+
+3. Visual Generation Enhancement
+
+- `🎭 Multi-style Template Library` Built-in multiple visual style packages, supporting one-click style conversion and user-defined style saving
+- `⏱️ Intelligent Rhythm Analysis/Optimization` Analyze plot emotion curves, automatically suggest climax points and rhythm changes, optimize storyboard arrangement and production workflow
+
+---
+
+# 📜 License
+
+Toonflow is open-sourced under the AGPL-3.0 license. License details: https://www.gnu.org/licenses/agpl-3.0.html
+
+You may use Toonflow for various purposes including commercial use, in compliance with the terms and conditions of AGPL-3.0.
+
+For proprietary commercial licenses exempt from AGPL-3.0 restrictions, please contact us via email.
+
+---
+
+# 💌 Contact Us
+
+📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow Inquiry)
+
+---
+
+# ⭐️ Star History
+
+[](https://star-history.com/#HBAI-Ltd/Toonflow-app&Date)
+
+# Third-party Dependency List
+
+Please refer to `NOTICES.txt`
\ No newline at end of file
diff --git a/docs/logo.png b/docs/logo.png
new file mode 100644
index 0000000..c0248fa
Binary files /dev/null and b/docs/logo.png differ
diff --git a/electron-builder.yml b/electron-builder.yml
new file mode 100644
index 0000000..20b083a
--- /dev/null
+++ b/electron-builder.yml
@@ -0,0 +1,55 @@
+appId: net.toonflow.www
+productName: ToonFlow
+copyright: Copyright © 2026
+
+directories:
+ output: dist
+ buildResources: build
+
+files:
+ - build/**/*
+ - scripts/web/**/*
+ - package.json
+ - node_modules/**/*
+ - "!node_modules/**/*.{md,ts,map}"
+ - "!node_modules/**/LICENSE*"
+ - "!node_modules/**/{README,readme}*"
+ - "!**/*.d.ts"
+ - "!src/**/*"
+ - "!scripts/**/*.ts"
+
+asar: true
+
+win:
+ target:
+ - nsis
+ - portable
+ icon: ./scripts/logo.ico
+ artifactName: ${productName}-${version}-${os}-${arch}.${ext}
+
+nsis:
+ oneClick: false
+ allowToChangeInstallationDirectory: true
+ perMachine: true
+ shortcutName: ${productName}
+ artifactName: ${productName}-Setup-${version}.${ext}
+ installerIcon: './scripts/logo.ico'
+ uninstallerIcon: './scripts/logo.ico'
+
+mac:
+ target:
+ - dmg
+ - zip
+ icon: ./scripts/logo.icns
+ category: public.app-category.developer-tools
+ artifactName: ${productName}-${version}-${os}-${arch}.${ext}
+
+linux:
+ target:
+ - AppImage
+ - deb
+ icon: ./scripts/logo.png
+ category: Development
+ artifactName: ${productName}-${version}-${os}-${arch}.${ext}
+
+publish: null
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..291bfa8
--- /dev/null
+++ b/package.json
@@ -0,0 +1,64 @@
+{
+ "name": "toonflow-serve",
+ "version": "1.0.0",
+ "description": "ToonFlow Serve - Electron Application",
+ "main": "build/main.js",
+ "author": "ToonFlow Team",
+ "packageManager": "yarn@1.0.0",
+ "engines": {
+ "node": ">=1.0.0"
+ },
+ "scripts": {
+ "dev": "nodemon --inspect --exec tsx src/app.ts",
+ "dev:win": "chcp 65001 && electronmon -r tsx scripts/main.ts",
+ "lint": "tsc --noEmit",
+ "build": "tsx scripts/build.ts",
+ "pack": "electron-builder --dir",
+ "dist": "yarn build && electron-builder",
+ "dist:win": "yarn build && electron-builder --win",
+ "dist:mac": "yarn build && electron-builder --mac",
+ "dist:linux": "yarn build && electron-builder --linux",
+ "test": "node build/app.js",
+ "license": "bun run scripts/license.ts"
+ },
+ "dependencies": {
+ "@aigne/core": "^1.72.0",
+ "@aigne/openai": "^0.16.16",
+ "@langchain/core": "^1.1.15",
+ "@langchain/openai": "^1.2.1",
+ "@rmp135/sql-ts": "^2.2.0",
+ "axios": "^1.13.2",
+ "axios-retry": "^4.5.0",
+ "better-sqlite3": "^12.6.2",
+ "cors": "^2.8.5",
+ "dotenv": "^17.2.3",
+ "express": "^5.2.1",
+ "express-ws": "^5.0.2",
+ "fast-glob": "^3.3.3",
+ "form-data": "^4.0.5",
+ "is-path-inside": "^4.0.0",
+ "js-md5": "^0.8.3",
+ "jsonwebtoken": "^9.0.3",
+ "knex": "^3.1.0",
+ "langchain": "^1.2.10",
+ "morgan": "^1.10.1",
+ "sharp": "^0.34.5",
+ "sqlite3": "^5.1.7",
+ "zod": "^4.3.5"
+ },
+ "devDependencies": {
+ "@types/cors": "^2.8.19",
+ "@types/express": "^5.0.6",
+ "@types/express-ws": "^3.0.6",
+ "@types/jsonwebtoken": "^9.0.10",
+ "@types/license-checker": "^25.0.6",
+ "@types/morgan": "^1.9.10",
+ "electron": "^40.0.0",
+ "electron-builder": "^26.4.0",
+ "electronmon": "^2.0.4",
+ "license-checker": "^25.0.1",
+ "nodemon": "^3.1.11",
+ "tsx": "^4.21.0",
+ "typescript": "^5.9.3"
+ }
+}
diff --git a/scripts/build.ts b/scripts/build.ts
new file mode 100644
index 0000000..5f57955
--- /dev/null
+++ b/scripts/build.ts
@@ -0,0 +1,55 @@
+import esbuild from "esbuild";
+
+const external = ["electron", "sqlite3", "better-sqlite3", "mysql", "mysql2", "pg", "pg-query-stream", "oracledb", "tedious", "mssql"];
+
+// 后端服务打包配置
+const appBuildConfig: esbuild.BuildOptions = {
+ entryPoints: ["src/app.ts"],
+ bundle: true,
+ minify: false,
+ format: "cjs",
+ allowOverwrite: true,
+ outfile: `build/app.js`,
+ platform: "node",
+ target: "esnext",
+ tsconfig: "./tsconfig.json",
+ alias: {
+ "@": "./src",
+ },
+ sourcemap: false,
+ external,
+};
+
+// Electron 主进程打包配置
+const mainBuildConfig: esbuild.BuildOptions = {
+ entryPoints: ["scripts/main.ts"],
+ bundle: true,
+ minify: false,
+ format: "cjs",
+ outfile: `build/main.js`,
+ allowOverwrite: true,
+ platform: "node",
+ target: "esnext",
+ tsconfig: "./tsconfig.json",
+ alias: {
+ "@": "./src",
+ },
+ sourcemap: false,
+ external,
+};
+
+(async () => {
+ try {
+ console.log("🔨 开始构建...\n");
+
+ // 并行构建
+ await Promise.all([esbuild.build(appBuildConfig), esbuild.build(mainBuildConfig)]);
+
+ console.log("✅ 后端服务构建完成: build/app.js");
+ console.log("✅ Electron主进程构建完成: build/main.js");
+ console.log("\n🎉 所有构建任务完成!\n");
+ } catch (err) {
+ console.error("❌ 构建失败:", err);
+ process.exit(1);
+ }
+})();
diff --git a/scripts/license.ts b/scripts/license.ts
new file mode 100644
index 0000000..36d4ce1
--- /dev/null
+++ b/scripts/license.ts
@@ -0,0 +1,72 @@
+import * as fs from "fs";
+import * as path from "path";
+import checker from "license-checker";
+
+const excludeNames = ["toonflow-serve"];
+// const strictWhiteList = ["MIT", "BSD-2-Clause", "BSD-3-Clause", "BSD", "0BSD"];
+const strictWhiteList: string[] = [];
+
+// 检查是否在白名单协议
+function isStrictWhiteLicense(license: string): boolean {
+ const normalized = license.replace(/[\(\)]/g, "").trim();
+ const parts = normalized.split(/\s*(OR|AND|\/)\s*/i).map((part) => part.trim());
+ return parts.every((part) => strictWhiteList.some((wl) => part === wl || part.replace(/ with .*/i, "") === wl));
+}
+
+// 读取 package.json 里的直接依赖
+function getDirectDependencyNames(): string[] {
+ const pkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), "package.json"), "utf-8"));
+ const deps = Object.keys(pkg.dependencies ?? {});
+ const devDeps = Object.keys(pkg.devDependencies ?? {});
+ return [...deps, ...devDeps];
+}
+
+// 执行主逻辑
+checker.init({ start: process.cwd() }, (err: Error, packages: Record
+
+# Toonflow
+
+
+
+ AI Short Drama Factory
+
+ Turn novels into episodes with just a tap!
+
+ AI Script × AI Visuals × Rapid Generation 🔥
+
+