From 0a93b2416e4136ae0c19955009783a5123a23da1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?ACT=E4=B8=B6=E6=B5=81=E6=98=9F=E9=9B=A8?=
<1340145680@qq.com>
Date: Fri, 30 Jan 2026 14:34:09 +0800
Subject: [PATCH] no message
---
README.md | 240 +++++++++++++++++++++++--
docs/README.en.md | 343 ++++++++++++++++++++++++++++-------
docs/chat6QR.jpg | Bin 0 -> 314001 bytes
docs/sponsored/sophnet.png | Bin 0 -> 758 bytes
docs/videoCover.png | Bin 0 -> 103125 bytes
docs/videoQR.png | Bin 0 -> 4964 bytes
package.json | 2 +-
scripts/web/index.html | 358 +++++++++++++++++++------------------
8 files changed, 679 insertions(+), 264 deletions(-)
create mode 100644 docs/chat6QR.jpg
create mode 100644 docs/sponsored/sophnet.png
create mode 100644 docs/videoCover.png
create mode 100644 docs/videoQR.png
diff --git a/README.md b/README.md
index a362dfb..55d3ae1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,13 @@
+
+
+ 
+
+ |
+
+ 
+
+
+
中文 |
English
@@ -60,7 +70,23 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
---
-# 🚀 安装与使用指南
+# 🔰 使用指南
+
+## 📺 视频教程
+
+https://www.bilibili.com/video/BV1na6wB6Ea2
+[](https://www.bilibili.com/video/BV1na6wB6Ea2)
+
+**Toonflow 8 分钟快速上手 AI 视频**
+👉 [点击观看](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e)
+
+📱 手机微信扫码观看
+
+
+
+---
+
+# 🚀 安装
## 前置条件
@@ -74,11 +100,11 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
### 1. 下载与安装
-| 操作系统 | 下载链接 | 说明 |
-| :------: | :------------------------------------------------------- | :----------------------- |
-| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | 官方发布安装包，点击下载 |
-| Linux | ⚙️ 敬请期待 | 即将发布，请持续关注 |
-| macOS | ⚙️ 敬请期待 | 即将发布，请持续关注 |
+| 操作系统 | GitHub 下载 | Gitee 下载（国内推荐） | 说明 |
+| :------: | :----------------------------------------------------------- | :---------------------------------------------------------- | :------------- |
+| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitee.com/HBAI-Ltd/Toonflow-app/releases) | 官方发布安装包 |
+| Linux | ⚙️ 敬请期待 | ⚙️ 敬请期待 | 即将发布 |
+| macOS | ⚙️ 敬请期待 | ⚙️ 敬请期待 | 即将发布 |
> 注意：目前仅支持 Windows 版本，其他系统将陆续开放。
@@ -86,9 +112,106 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
安装完成后，启动程序即可开始使用本服务。
+> ⚠️ **首次登录**
+> 账号：`admin`
+> 密码：`admin123`
+
## 云端部署
-云端安装及部署教程正在整理中，敬请期待。
+### 一、服务器环境要求
+
+- **系统**：Ubuntu 20.04+ / CentOS 7+
+- **Node.js**：23.11.1+
+- **内存**：1GB+
+
+### 二、服务器部署
+
+#### 1. 安装环境
+
+```bash
+# 安装 Node.js
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+source ~/.bashrc
+nvm install 24
+# 安装 Yarn 和 PM2
+npm install -g yarn pm2
+```
+
+#### 2. 部署项目
+
+**从 GitHub 克隆：**
+
+```bash
+cd /opt
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+**从 Gitee 克隆（国内推荐）：**
+
+```bash
+cd /opt
+git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+#### 3. 配置 PM2
+
+创建 `pm2.json` 文件：
+
+```json
+{
+ "name": "toonflow-app",
+ "script": "build/app.js",
+ "instances": "max",
+ "exec_mode": "cluster",
+ "env": {
+ "NODE_ENV": "prod",
+ "PORT": 60000,
+ "OSSURL": "http://127.0.0.1:60000/"
+ }
+}
+```
+
+**环境变量说明：**
+
+| 变量 | 说明 |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | 运行环境，`prod` 表示生产环境 |
+| `PORT` | 服务监听端口 |
+| `OSSURL` | 文件存储访问地址，用于静态资源访问 |
+
+---
+
+#### 4. 启动服务
+
+```bash
+pm2 start pm2.json
+pm2 startup
+pm2 save
+```
+
+#### 5. 常用命令
+
+```bash
+pm2 list # 查看进程
+pm2 logs toonflow-app # 查看日志
+pm2 restart all # 重启服务
+pm2 monit # 监控面板
+```
+
+#### 6. 部署前端网站
+
+如需单独部署或定制前端界面，请参考前端仓库：
+
+- **GitHub**：[Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**：[Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+> 💡 **说明**：本仓库已内置编译好的前端资源，普通用户无需单独部署前端。前端仓库仅供需要二次开发的开发者使用。
---
@@ -101,7 +224,23 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
## 快速启动项目
-1. **安装依赖**
+1. **克隆项目**
+
+ **从 GitHub 克隆：**
+
+ ```bash
+ git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+ **从 Gitee 克隆（国内推荐）：**
+
+ ```bash
+ git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+2. **安装依赖**
请先在项目根目录下执行以下命令以安装依赖项：
@@ -109,7 +248,7 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
yarn install
```
-2. **启动开发环境**
+3. **启动开发环境**
- 使用 Node.js 运行开发服务：
@@ -123,7 +262,7 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
yarn bun:dev #端口60000
```
-3. **项目打包**
+4. **项目打包**
- 编译并生成 TypeScript 文件：
@@ -137,7 +276,7 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
yarn dist:win
```
-4. **代码质量检查**
+5. **代码质量检查**
- 进行全局语法和规范检查：
@@ -145,11 +284,21 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
yarn lint
```
+## 前端开发
+
+如需修改前端界面，请前往前端仓库进行开发：
+
+- **GitHub**：[Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**：[Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+前端构建后，将 `dist` 目录内容复制到本项目的 `scripts/web` 目录即可集成。
+
## 项目结构
```
📂 docs/ # 文档资源
📂 scripts/ # 构建脚本与静态资源
+│ └─ 📂 web/ # 前端编译产物（内置）
📂 src/
├─ 📂 agents/ # AI Agent 模块
├─ 📂 lib/ # 公共库（数据库初始化、响应格式）
@@ -186,6 +335,17 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
---
+# 🔗 相关仓库
+
+| 仓库 | 说明 | GitHub | Gitee |
+| ---------------- | ---------------------------------- | -------------------------------------------------- | ------------------------------------------------ |
+| **Toonflow-app** | 完整客户端（本仓库，推荐普通用户） | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) |
+| **Toonflow-web** | 前端源代码（适合前端开发者） | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) |
+
+> 💡 **提示**：如果您只是想使用 Toonflow，直接下载本仓库的客户端即可。前端仓库仅供需要二次开发或定制前端界面的开发者使用。
+
+---
+
# 📝 开发计划
我们正持续优化产品，以下为近期开发重点：
@@ -207,6 +367,31 @@ Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧
---
+# 👨👩👧👦 微信交流群
+
+~~交流群 1~~
+
+~~交流群 2~~
+
+~~交流群 3~~
+
+~~交流群 4~~
+
+~~交流群 5~~
+
+交流群 6:
+
+
+
使用微信扫码添加，二维码过期可提交 Issues 提醒更新
+
+---
+
+# 💌 联系我们
+
+📧 邮箱：[ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow咨询)
+
+---
+
# 📜 许可证
Toonflow 基于 AGPL-3.0 协议开源发布，许可证详情：https://www.gnu.org/licenses/agpl-3.0.html
@@ -217,16 +402,37 @@ Toonflow 基于 AGPL-3.0 协议开源发布，许可证详情：https://www.gnu.
---
-# 💌 联系我们
+# ⭐️ 星标历史
-📧 邮箱：[ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow咨询)
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=date&legend=top-left)
---
-# ⭐️ 星标历史
+# 🙏 致谢
-[](https://star-history.com/#HBAI-Ltd/Toonflow-app&Date)
+感谢以下开源项目为 Toonflow 提供强大支持：
-# 第三方依赖清单
+- [Express](https://expressjs.com/) - 快速、开放、极简的 Node.js Web 框架
+- [LangChain](https://js.langchain.com/) - 构建 LLM 应用的开发框架
+- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - 高性能 SQLite3 绑定库
+- [Sharp](https://sharp.pixelplumbing.com/) - 高性能 Node.js 图像处理库
+- [Axios](https://axios-http.com/) - 基于 Promise 的 HTTP 客户端
+- [Zod](https://zod.dev/) - TypeScript 优先的模式验证库
+- [Aigne](https://github.com/aigne-com/aigne) - LLM API 统一管理与接入中间件
+- [Electron](https://www.electronjs.org/) - 跨平台桌面应用开发框架
-请查阅`NOTICES.txt`
+感谢以下组织/单位/个人为 Toonflow 提供支持：
+
+
+
+
+ 
+ |
+
+ 算能云 提供算力赞助
+ [官网]
+ |
+
+
+
+完整的第三方依赖清单请查阅 `NOTICES.txt`
diff --git a/docs/README.en.md b/docs/README.en.md
index 87420ae..ddc867a 100644
--- a/docs/README.en.md
+++ b/docs/README.en.md
@@ -1,3 +1,13 @@
+
+
+
+
+ |
+
+
+
+
+
中文 |
English
@@ -13,9 +23,9 @@
AI Short Drama Factory
- Turn novels into episodes with just a tap!
+ Turn novels into episodes with a tap!
- AI Script × AI Visuals × Rapid Generation 🔥
+ AI Script × AI Imagery × Lightning-fast Generation 🔥
@@ -30,100 +40,229 @@
- > 🚀 **One-stop Short Drama Production**: From text to characters, from storyboards to videos, zero-barrier full-process AI automation, boosting creative efficiency by 10x+!
+ > 🚀 **One-stop Short Drama Workflow**: From text to character, storyboard to video, a full AI-powered process with zero threshold, boosting creative efficiency by 10x+!
---
# 🌟 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.
+Toonflow is an AI tool that leverages AI technology to automatically turn novels into scripts, then uses AI to generate images and videos for efficient short drama production. With Toonflow, you can easily accomplish the entire workflow from text to visuals, making short drama creation more intelligent and 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.
+ Automatically analyzes the original novel text, intelligently recognizes and generates character profiles, including appearance, personality, identity, etc., providing a reliable foundation for subsequent script and image 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.
+ Based on selected events and chapters, the system automatically generates structured scripts, covering dialogue, scene descriptions, and plot direction, enabling an efficient transition from literary text to screenplay.
+- ✅ **Storyboard Creation**
+ According to the script content, it intelligently generates storyboard prompts and visual designs, detailing foreground, middle ground, background, character movements, props, and scene layouts. Automatically produces storyboards from the script, providing a comprehensive 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.
+ Integrates AI image and video techniques, supporting generation of video clips via AI. With built-in online editing, supports personalized adjustments and outputs, making filmmaking highly collaborative and efficient.
---
# 📦 Application Scenarios
-- Short video content creation
-- Novel-to-film experimentation
+- Short video content production
+- Novel-to-film experiments
- AI Literary Adaptation Tools
- Script development and rapid prototyping
- Video material generation
---
-# 🚀 Installation and Usage Guide
+# 🔰 User Guide
+
+## 📺 Video Tutorial
+
+https://www.bilibili.com/video/BV1na6wB6Ea2
+[](https://www.bilibili.com/video/BV1na6wB6Ea2)
+
+**Toonflow 8-Minute Quick Start AI Video**
+👉 [Click to watch](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e)
+
+📱 Watch via WeChat QR scan
+
+
+
+---
+
+# 🚀 Installation
## 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
+- ✅ Large Language Model AI service endpoint.
+- ✅ Sora or Doubao video service endpoint
+- ✅ Nano Banana Pro image generation model service endpoint
## Local Installation
-### 1. Download and Install
+### 1. Download & 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 |
+| Operating System | GitHub Download | Gitee Download (Recommended for China) | Note |
+| :--------------: | :------------------------------------------------------ | :---------------------------------------------------------- | :----------------- |
+| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitee.com/HBAI-Ltd/Toonflow-app/releases) | Official installer |
+| Linux | ⚙️ Coming soon | ⚙️ Coming soon | To be released |
+| macOS | ⚙️ Coming soon | ⚙️ Coming soon | To be released |
-> Note: Currently only Windows version is supported, other systems will be available soon.
+> Note: Currently, only Windows is supported. Other systems will be gradually supported.
-### 2. Start Service
+### 2. Launch the Service
-After installation, launch the program to start using the service.
+After installation, start the program to use the service.
+
+> ⚠️ **First login**
+> Account: `admin`
+> Password: `admin123`
## Cloud Deployment
-Cloud installation and deployment tutorials are being prepared, stay tuned.
+### I. Server Requirements
+
+- **OS**: Ubuntu 20.04+ / CentOS 7+
+- **Node.js**: 23.11.1+
+- **RAM**: 1GB+
+
+### II. Server Deployment
+
+#### 1. Install the Environment
+
+```bash
+# Install Node.js
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+source ~/.bashrc
+nvm install 24
+# Install Yarn & PM2
+npm install -g yarn pm2
+```
+
+#### 2. Deploy the Project
+
+**Clone from GitHub:**
+
+```bash
+cd /opt
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+**Clone from Gitee (recommended in China):**
+
+```bash
+cd /opt
+git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+#### 3. Configure PM2
+
+Create a `pm2.json` file:
+
+```json
+{
+ "name": "toonflow-app",
+ "script": "build/app.js",
+ "instances": "max",
+ "exec_mode": "cluster",
+ "env": {
+ "NODE_ENV": "prod",
+ "PORT": 60000,
+ "OSSURL": "http://127.0.0.1:60000/"
+ }
+}
+```
+
+**Environment Variable Description:**
+
+| Variable | Description |
+| ------------ | ------------------------------------------- |
+| `NODE_ENV` | Runtime environment, `prod` means production|
+| `PORT` | Service listening port |
+| `OSSURL` | File storage access address for static files|
---
-# 🔧 Development Process Guide
+#### 4. Start the Service
-## Development Environment Setup
+```bash
+pm2 start pm2.json
+pm2 startup
+pm2 save
+```
-- **Node.js**: Version 23.11.1 or above required
-- **Yarn**: Recommended as the project package manager
+#### 5. Common Commands
-## Quick Start
+```bash
+pm2 list # List processes
+pm2 logs toonflow-app # View logs
+pm2 restart all # Restart all services
+pm2 monit # Monitoring panel
+```
-1. **Install Dependencies**
+#### 6. Deploy the Frontend Website
- Please first run the following command in the project root directory to install dependencies:
+To deploy or customize the frontend separately, refer to the frontend repo:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+> 💡 **Note**: This repo includes pre-compiled frontend assets; regular users don’t need to deploy frontend separately. The frontend repo is for developers needing secondary development.
+
+---
+
+# 🔧 Development Workflow Guide
+
+## Development Environment Preparation
+
+- **Node.js**: Version 23.11.1+
+- **Yarn**: Recommended package manager
+
+## Quick Project Startup
+
+1. **Clone the project**
+
+ **From GitHub:**
+
+ ```bash
+ git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+ **From Gitee (china):**
+
+ ```bash
+ git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+2. **Install Dependencies**
+
+ Run the following in the root directory:
```bash
yarn install
```
-2. **Start Development Environment**
+3. **Start Development Server**
- - Run development service with Node.js:
+ - Launch dev server with Node.js:
```bash
yarn dev #port 60000
```
- - Run development service quickly with Bun:
+ - Use Bun to quickly start dev server:
```bash
yarn bun:dev #port 60000
```
-3. **Project Build**
+4. **Build the Project**
- Compile and generate TypeScript files:
@@ -131,32 +270,42 @@ Cloud installation and deployment tutorials are being prepared, stay tuned.
yarn build
```
- - Package as Windows platform executable:
+ - Package as a Windows executable:
```bash
yarn dist:win
```
-4. **Code Quality Check**
+5. **Code Quality Check**
- - Perform global syntax and standard checks:
+ - Lint globally for syntax and style:
```bash
yarn lint
```
+## Frontend Development
+
+To modify the frontend, go to the frontend repo:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+After building the frontend, copy the contents of the `dist` folder into this project’s `scripts/web` directory for integration.
+
## Project Structure
```
-📂 docs/ # Documentation resources
+📂 docs/ # Documentation
📂 scripts/ # Build scripts and static resources
+│ └─ 📂 web/ # Embedded frontend build output
📂 src/
├─ 📂 agents/ # AI Agent modules
-├─ 📂 lib/ # Common libraries (database initialization, response format)
+├─ 📂 lib/ # Shared libs (DB init, response format)
├─ 📂 middleware/ # Middleware
-├─ 📂 routes/ # Route modules
+├─ 📂 routes/ # Routing modules
│ ├─ 📂 assets/ # Asset management
-│ ├─ 📂 index/ # Homepage
+│ ├─ 📂 index/ # Home page
│ ├─ 📂 novel/ # Novel management
│ ├─ 📂 other/ # Other features
│ ├─ 📂 outline/ # Outline management
@@ -170,63 +319,121 @@ Cloud installation and deployment tutorials are being prepared, stay tuned.
│ └─ 📂 video/ # Video generation
├─ 📂 types/ # TypeScript type declarations
├─ 📂 utils/ # Utility functions
-├─ 📄 app.ts # Application entry
-├─ 📄 core.ts # Route core
-├─ 📄 env.ts # Environment variable handling
+├─ 📄 app.ts # App entry point
+├─ 📄 core.ts # Routing core
+├─ 📄 env.ts # Env variable handling
├─ 📄 err.ts # Error handling
├─ 📄 router.ts # Route registration
-└─ 📄 utils.ts # General utilities
-📂 uploads/ # Upload file directory
+└─ 📄 utils.ts # Common tools
+📂 uploads/ # Uploads
📄 LICENSE # License
-📄 NOTICES.txt # Third-party dependency declarations
-📄 package.json # Project configuration
+📄 NOTICES.txt # 3rd-party notices
+📄 package.json # Project config
📄 README.md # Project description
-📄 tsconfig.json # TypeScript configuration
+📄 tsconfig.json # TypeScript config
```
---
+# 🔗 Related Repos
+
+| Repository | Description | GitHub | Gitee |
+| ----------------- | ------------------------------------- | -------------------------------------------------- | ------------------------------------------------ |
+| **Toonflow-app** | Full client (this repo, for users) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) |
+| **Toonflow-web** | Frontend source (for devs) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) |
+
+> 💡 **Tip**: If you just want to use Toonflow, download the client from this repo. The web repo is only for frontend customization/development.
+
+---
+
# 📝 Development Roadmap
-We are continuously optimizing the product. Here are the recent development priorities:
+We continue to optimize the product. Key focuses for the near future:
-1. Core Feature Upgrades
+1. Core Function 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
+- `🧩 Prompt Refinement Agent` AI-enhanced prompt generation for videos, auto-parsing storyboards, intelligent multi-shot fusion and smooth transitions
+- `📄 Multi-format Text Support` Extending to scripts, manga scripts, game dialogue text, and more formats beyond novels
-2. Production Workflow Optimization
+2. Production Flow 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
+- `👗 Character Costume & Props Management` Improved consistency for costumes, makeup, props across long content, support for multi-episode memory and auto costume generation
+- `📦 Batch Processing/Task Queues` Process multiple chapters at once, backend task management, real-time monitoring and resume-on-interrupt
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
+- `🎭 Multi-style Template Library` Bundled visual style packs, one-click style swap, user-defined style saving
+- `⏱️ Intelligent Rhythm Analysis/Optimization` Analyze plot emotional arcs, auto-suggest climaxes and pace changes, optimized storyboard workflow
---
-# 📜 License
+# 👨👩👧👦 WeChat Discussion Groups
-Toonflow is open-sourced under the AGPL-3.0 license. License details: https://www.gnu.org/licenses/agpl-3.0.html
+~~Group 1~~
-You may use Toonflow for various purposes including commercial use, in compliance with the terms and conditions of AGPL-3.0.
+~~Group 2~~
-For proprietary commercial licenses exempt from AGPL-3.0 restrictions, please contact us via email.
+~~Group 3~~
+
+~~Group 4~~
+
+~~Group 5~~
+
+Group 6:
+
+
+Scan with WeChat to join. If the QR expires, open an issue to request an update.
---
# 💌 Contact Us
-📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow Inquiry)
+📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow%20Inquiry)
+
+---
+
+# 📜 License
+
+Toonflow is open source under the AGPL-3.0 license. Details: https://www.gnu.org/licenses/agpl-3.0.html
+
+You may use Toonflow for any purpose, including commercial, as long as you adhere to the AGPL-3.0 terms and conditions.
+
+For proprietary/commercial licensing exempt from AGPL-3.0, please contact us by email.
---
# ⭐️ Star History
-[](https://star-history.com/#HBAI-Ltd/Toonflow-app&Date)
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=date&legend=top-left)
-# Third-party Dependency List
+---
+
+# 🙏 Special Thanks
+
+Thanks to the following open-source projects for empowering Toonflow:
+
+- [Express](https://expressjs.com/) – Fast, open, minimal Node.js web framework
+- [LangChain](https://js.langchain.com/) – Framework for building LLM apps
+- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) – High-performance SQLite3 bindings
+- [Sharp](https://sharp.pixelplumbing.com/) – High-performance Node.js image processing
+- [Axios](https://axios-http.com/) – Promise-based HTTP client
+- [Zod](https://zod.dev/) – TypeScript-first schema validation
+- [Aigne](https://github.com/aigne-com/aigne) – Unified LLM API middleware
+- [Electron](https://www.electronjs.org/) – Cross-platform desktop app framework
+
+Thanks to the following organizations/individuals for supporting Toonflow:
+
+
+
+
+ 
+ |
+
+ Sophnet Cloud provided compute sponsorship
+ [Official Site]
+ |
+
+
+
+For the full list of third-party dependencies, see `NOTICES.txt`
-Please refer to `NOTICES.txt`
\ No newline at end of file
diff --git a/docs/chat6QR.jpg b/docs/chat6QR.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..be531c3d4d14171071e1fe307d0662bcabd9327b
GIT binary patch
literal 314001
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