+
+
+
+# Toonflow
+
+
+
+ Nhà máy Phim ngắn AI
+
+ Chỉ với vài cú click, tiểu thuyết lập tức biến thành phim!
+
+ Kịch bản AI × Hình ảnh AI × Tạo siêu tốc 🔥
+
+
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+
+ 
+ 
+ 
+ 
+
+
+ 
+
+
+ 
+
+
+ > 🚀 **Dự án Phim ngắn All-in-One**: Từ văn bản đến nhân vật, từ storyboard đến video hoàn chỉnh. Tự động hóa toàn bộ quy trình bằng AI – không rào cản, tăng hiệu suất sáng tạo lên gấp 10 lần!
+
+
+
+ | Logo |
+ Tên |
+ Hình thức hỗ trợ |
+ Mô tả |
+ Website |
+
+
+
+
+  |
+ Sophnet |
+ 💻 Tài trợ điện toán |
+ Nền tảng API suy luận mô hình một cửa, nhanh hơn, ổn định hơn và tiết kiệm hơn |
+ Website |
+
+
+  |
+ Atlas Cloud |
+ 💻 Tài trợ điện toán |
+ Nền tảng suy luận đa phương thức đầu tiên trên thế giới. Chat, hình ảnh, video, âm thanh — tất cả qua một API thống nhất. 300+ mô hình, tương thích OpenAI. |
+ Website |
+
+
+  |
+ Tencent Hunyuan3D |
+ 🌐 Hỗ trợ kỹ thuật World Model |
+ Tencent Hunyuan3D AI Creation Engine dựa trên mô hình Tencent Hunyuan3D 2.5 — nền tảng tạo nội dung 3D AI tích hợp đầu tiên trong ngành. Hỗ trợ text-to-3D, image-to-3D, tạo hoạt hình 3D, tạo kết cấu, sketch-to-3D và tạo nhân vật 3D, với lợi thế trong tạo mô hình low-poly. |
+ Website |
+
+
+
+
+Vui lòng xem danh sách đầy đủ các thư viện phụ thuộc của bên thứ ba trong tệp `NOTICES.txt`.
+
+##### Copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/README.md b/README.md
index fe6d329..9dbcb3b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,5 @@
+
+
@@ -26,17 +28,8 @@
-# Toonflow
+[](https://git.io/typing-svg)
-
-
- AI短剧工厂
-
- 动动手指，小说秒变剧集！
-
- AI剧本 × AI影像 × 极速生成 🔥
-
-
@@ -48,10 +41,48 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
> 🚀 **一站式短剧工程**：从文本到角色，从分镜到视频，0门槛全流程AI化，创作效率提升10倍+！
+
+
+
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+如无法播放，请[点击下载视频](./docs/screenshot/demo.mp4)
+
+
+
+## Demo 信息
+
+| 项目 | 详情 |
+| :--- | :--- |
+| 制作周期 | 约 2 小时 |
+| 视频模型 | Seedance 2.0 |
+| 图片模型 | GPT Image 2 |
+| 语言模型 | Claude Opus 4.6 |
+| 成片总时长 | 约 2 分钟（原始素材 3 分钟，剪除废片约 1 分钟） |
+
+## 成本明细
+
+| 模型类型 | 费用 |
+| :--- | :--- |
+| 语言模型 | 约 ¥10 |
+| 视频模型（全量生成） | 约 ¥120 |
+| 图片模型 | 不足 ¥1 |
+| **合计** | **约 ¥130** |
+
+> **声明**：Demo 原始分辨率为 1080×1882，发布版本已压缩至 480p。如涉及版权问题，请通过 [ltlctools@outlook.com](mailto:ltlctools@outlook.com) 联系我们处理。
+
+---
+
# 🚀 安装
## 前置条件
@@ -571,10 +664,13 @@ Toonflow 基于 Apache-2.0 协议开源发布，并附有补充商业协议。
# ⭐️ 星标历史
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
---
+
# 🙏 致谢
感谢以下开源项目为 Toonflow 提供强大支持：
@@ -629,3 +725,7 @@ Toonflow 基于 Apache-2.0 协议开源发布，并附有补充商业协议。
完整的第三方依赖清单请查阅 `NOTICES.txt`
##### copyright © 北京爱阿科技有限公司
+
+
+
+
diff --git a/README.ru.md b/README.ru.md
new file mode 100644
index 0000000..dc51540
--- /dev/null
+++ b/README.ru.md
@@ -0,0 +1,709 @@
+
+
+
+
+
+
+ |
+
+ 
+
+ |
+
+ 
+
+
+
+
+ 简体中文 |
+ 繁體中文 |
+ English |
+ ไทย |
+ Tiếng Việt |
+ 日本語 |
+ Русский
+
+
+
+
+
+
+# Toonflow
+
+
+
+ Nhà máy Phim ngắn AI
+
+ Chỉ với vài cú click, tiểu thuyết lập tức biến thành phim!
+
+ Kịch bản AI × Hình ảnh AI × Tạo siêu tốc 🔥
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ > 🚀 **Dự án Phim ngắn All-in-One**: Từ văn bản đến nhân vật, từ storyboard đến video hoàn chỉnh. Tự động hóa toàn bộ quy trình bằng AI – không rào cản, tăng hiệu suất sáng tạo lên gấp 10 lần!
+
+
+
+
+---
+
+# Ảnh chụp màn hình & Video Demo
+
+Các ảnh chụp màn hình và video dưới đây được lấy từ Demo phim ngắn AI được tạo bằng Toonflow trong khoảng 2 giờ, bao gồm tạo kịch bản, sản xuất storyboard và dựng phim.
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## Thông tin Demo
+
+| Mục | Chi tiết |
+|-----|---------|
+| Thời gian sản xuất | ~2 giờ |
+| Mô hình video | Seedance 2.0 |
+| Mô hình hình ảnh | GPT Image 2 |
+| Mô hình ngôn ngữ | Claude Opus 4.6 |
+| Thời lượng | ~2 phút (tư liệu gốc 3 phút, cắt ~1 phút)|
+
+## Chi tiết Chi phí
+
+| Mục | Chi phí |
+|-----|---------|
+| Hình ảnh (270 ảnh × ¥0.04) | ¥10.8 |
+| Video (45 clip × ¥3.5) | ¥157.5 |
+| Tổng | **~¥168** |
+
+> 📌 Độ phân giải gốc của Demo là 1080×1882, phiên bản phát hành đã nén xuống 480p. Nếu có vấn đề bản quyền, vui lòng liên hệ [ltlctools@outlook.com](mailto:ltlctools@outlook.com).
+
+## Video Demo
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> Nếu video không phát được, [click để tải xuống](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9).
+
+---
+
+# 🚀 Cài đặt
+
+## Điều kiện tiên quyết
+
+Trước khi cài đặt và sử dụng phần mềm, vui lòng chuẩn bị:
+
+- ✅ Địa chỉ API của Mô hình ngôn ngữ lớn (LLM)
+- ✅ Địa chỉ API của dịch vụ video Sora hoặc Doubao
+- ✅ Địa chỉ API của dịch vụ tạo ảnh Nano Banana Pro
+
+## Cài đặt trên máy cá nhân (Local)
+
+### 1. Tải xuống & Cài đặt
+
+| Hệ điều hành | GitHub | Atomgit | Tải qua Quark Drive | Mô tả |
+| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
+| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+
+> [!CAUTION]
+> Với hệ điều hành MacOS, vui lòng vào "Cài đặt hệ thống" -> "Quyền riêng tư & Bảo mật" để cấp quyền mở ứng dụng, nếu không phần mềm có thể không mở được do vấn đề chứng chỉ.
+>
+> Tham khảo hướng dẫn Zhihu: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+
+> Do giới hạn môi trường Gitee OS và giới hạn kích thước tệp tải lên của Release, chúng tôi tạm thời không cung cấp link tải qua Gitee Release.
+
+### 2. Khởi chạy Dịch vụ
+
+Sau khi cài đặt xong, hãy mở chương trình để bắt đầu sử dụng.
+
+> ⚠️ **Đăng nhập lần đầu**
+> Tài khoản: `admin`
+> Mật khẩu: `admin123`
+
+## Triển khai bằng Docker
+
+### Điều kiện tiên quyết
+
+- Đã cài đặt [Docker](https://docs.docker.com/get-docker/) (Phiên bản 20.10+)
+
+### Cách 1: Triển khai trực tuyến
+
+Đang hoàn thiện, tạm thời sử dụng cách Build tại máy (Local build).
+
+### Cách 2: Build tại máy (Local build)
+
+Sử dụng mã nguồn có sẵn để build trực tiếp. Phù hợp với lập trình viên hoặc người dùng đã clone repository. (Yêu cầu cài đặt git trên máy):
+
+```shell
+# Clone dự án (Bỏ qua nếu đã clone)
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+
+# Sử dụng docker-compose để build và chạy
+yarn docker:local
+
+# Hoặc build thủ công
+docker build -t toonflow .
+docker run -d -p :10588 -v <Đường dẫn dữ liệu trên máy>:/app/data toonflow
+
+# Sau đó, truy cập giao diện qua đường dẫn /web/index.html bằng Port đã thiết lập
+# Ví dụ: http://localhost:10588/web/index.html
+```
+
+### Cấu hình Cổng dịch vụ (Port)
+
+| Cổng (Port) | Chức năng | Port Mapping |
+| ------- | -------- | ------------- |
+| `10588` | Giao diện phần mềm | `10588:10588` |
+
+**Giải thích Biến môi trường:**
+
+| Biến (Variable) | Giải thích |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | Môi trường chạy, `prod` là môi trường Product (sản xuất) |
+| `PORT` | Port lắng nghe của dịch vụ (Mặc định: 10588) |
+| `OSSURL` | Địa chỉ truy cập lưu trữ file, dùng cho các tài nguyên tĩnh (Static) |
+
+---
+
+## Triển khai trên Máy chủ Đám mây (Cloud)
+
+### 1. Yêu cầu Môi trường Máy chủ
+
+- **Hệ điều hành**: Ubuntu 20.04+ / CentOS 7+
+- **Node.js**: 24.x (Khuyên dùng, Tối thiểu 23.11.1+)
+- **RAM**: 2GB+
+
+### 2. Triển khai Máy chủ
+
+#### 1. Cài đặt Môi trường
+
+```bash
+# Cài đặt Node.js
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+source ~/.bashrc
+nvm install 24
+# Cài đặt Yarn và PM2
+npm install -g yarn pm2
+```
+
+#### 2. Triển khai Dự án
+
+**Clone từ GitHub:**
+
+```bash
+cd /opt
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+**Clone từ Gitee (Khuyên dùng tại TQ):**
+
+```bash
+cd /opt
+git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+#### 3. Cấu hình PM2
+
+Tạo tệp `pm2.json`:
+
+```json
+{
+ "name": "toonflow-app",
+ "script": "data/serve/app.js",
+ "instances": "max",
+ "exec_mode": "cluster",
+ "env": {
+ "NODE_ENV": "prod",
+ "PORT": 10588,
+ "OSSURL": "http://127.0.0.1:10588/"
+ }
+}
+```
+
+**Giải thích Biến môi trường:**
+
+| Biến (Variable) | Giải thích |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | Môi trường chạy, `prod` là môi trường Product |
+| `PORT` | Cổng lắng nghe của dịch vụ (Port) |
+| `OSSURL` | Địa chỉ truy cập lưu trữ file, dùng cho tài nguyên tĩnh |
+
+---
+
+#### 4. Khởi chạy Dịch vụ
+
+```bash
+pm2 start pm2.json
+pm2 startup
+pm2 save
+```
+
+#### 5. Các lệnh PM2 thường dùng
+
+```bash
+pm2 list # Xem danh sách tiến trình
+pm2 logs toonflow-app # Xem log (nhật ký)
+pm2 restart all # Khởi động lại dịch vụ
+pm2 monit # Mở bảng điều khiển giám sát
+```
+
+> ⚠️ **Đăng nhập lần đầu**
+> Tài khoản: `admin`
+> Mật khẩu: `admin123`
+
+#### 6. Triển khai trang web Frontend
+
+Nếu bạn cần triển khai riêng hoặc tùy chỉnh giao diện Frontend, vui lòng tham khảo Repository Frontend:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+> 💡 **Lưu ý**: Repository này đã được tích hợp sẵn tài nguyên Frontend đã build. Người dùng thông thường không cần tự triển khai Frontend riêng. Repository Frontend chỉ dành cho các nhà phát triển muốn tùy chỉnh chuyên sâu.
+
+---
+
+# 🔧 Hướng dẫn Quy trình Phát triển (Development Workflow)
+
+> [!CAUTION]
+> 🚧 **Quy định nộp PR (Pull Request)** 🚧
+>
+> ⛔ Nhánh `master` KHÔNG chấp nhận bất kỳ PR nào ｜ ✅ Vui lòng gửi PR vào nhánh `develop`
+>
+> Chào mừng các nhà phát triển tham gia đóng góp cho Toonflow. Nếu có hứng thú, vui lòng liên hệ với quản trị viên ACT trong nhóm giao lưu.
+
+## 🛠️ Công nghệ sử dụng (Tech Stack)
+
+| Phân loại | Công nghệ |
+| ---------- | ----------------------------------------------------------------------------------------- |
+| Môi trường | Node.js 23.11.1+ |
+| Ngôn ngữ | TypeScript 5.x |
+| Backend | Express 5 |
+| Cơ sở dữ liệu | SQLite (better-sqlite3 / knex) |
+| Tích hợp AI| Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Qwen / xAI) |
+| Suy luận Local| @huggingface/transformers (ONNX) |
+| Real-time | Socket.IO |
+| Ứng dụng Desktop | Electron 40 |
+| Xử lý ảnh | Sharp |
+| Container | Docker |
+
+## Chuẩn bị Môi trường Phát triển
+
+- **Node.js**: Yêu cầu phiên bản 23.11.1 trở lên
+- **Yarn**: Khuyến nghị sử dụng làm Package Manager
+
+## Khởi chạy Dự án nhanh
+
+1. **Clone dự án**
+
+ **Clone từ GitHub:**
+
+ ```bash
+ git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+ **Clone từ Gitee:**
+
+ ```bash
+ git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+2. **Cài đặt Dependencies**
+
+ Chạy lệnh sau tại thư mục gốc của dự án:
+
+ ```bash
+ yarn install
+ ```
+
+3. **Khởi chạy môi trường Dev**
+
+ Dự án bao gồm **Backend API** và **Trang Frontend**. Tùy nhu cầu mà chọn cách khởi chạy:
+
+ - **Cách 1: Chỉ chạy Backend API**
+
+ ```bash
+ yarn dev
+ ```
+
+ > ⚠️ Lệnh này chỉ khởi chạy Backend API (Port 10588), không bao gồm giao diện Frontend. Khi truy cập http://localhost:10588 chỉ có thể gọi API. Nếu muốn sử dụng giao diện, vui lòng chạy Frontend riêng hoặc dùng chế độ GUI bên dưới.
+
+ - **Cách 2: Khởi chạy Client Desktop Electron (Khuyên dùng)**
+
+ ```bash
+ yarn dev:gui
+ ```
+
+ > Lệnh này sẽ chạy đồng thời Backend và cửa sổ Desktop Electron với giao diện Frontend đã tích hợp sẵn. Mở lên là có thể sử dụng ngay mà không cần cấu hình thêm. Phù hợp nhất cho lập trình viên muốn trải nghiệm toàn bộ tính năng.
+
+ - **Cách 3: Chạy ở chế độ Product (Sản xuất)**
+
+ ```bash
+ yarn start
+ ```
+
+ > Chạy trực tiếp dịch vụ sau khi đã build (Cần chạy lệnh yarn build trước).
+
+4. **Đóng gói dự án (Build / Pack)**
+
+ - Biên dịch tệp TypeScript:
+
+ ```bash
+ yarn build
+ ```
+
+ - Đóng gói thành tệp thực thi cho Windows:
+
+ ```bash
+ yarn dist:win
+ ```
+
+ - Đóng gói thành tệp thực thi cho MacOS:
+
+ ```bash
+ yarn dist:mac
+ ```
+
+ - Đóng gói thành tệp thực thi cho Linux:
+
+ ```bash
+ yarn dist:linux
+ ```
+
+5. **Kiểm tra chất lượng mã (Lint)**
+
+ - Kiểm tra cú pháp và quy chuẩn toàn cục:
+
+ ```bash
+ yarn lint
+ ```
+
+6. **Bảng điều khiển Debug AI (Tùy chọn)**
+
+ Mở công cụ Debug trực quan của AI SDK để tiện theo dõi các lời gọi AI:
+
+ ```bash
+ yarn debug:ai
+ ```
+
+## Phát triển Frontend
+
+Nếu bạn cần chỉnh sửa giao diện Frontend, vui lòng chuyển sang kho lưu trữ Frontend riêng:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+Sau khi build Frontend xong, hãy copy toàn bộ thư mục dist vào thư mục data/web của dự án này để tích hợp.
+
+## Cấu trúc Dự án
+
+```
+📂 build/ # Sản phẩm sau khi build
+📂 data/ # Dữ liệu Runtime
+│ ├─ 📂 models/ # Mô hình suy luận Local (ONNX)
+│ ├─ 📂 oss/ # Lưu trữ Object (ảnh, nhân vật, cảnh)
+│ ├─ 📂 serve/ # Cổng vào môi trường Production
+│ ├─ 📂 skills/ # Prompt kỹ năng của Agent
+│ └─ 📂 web/ # Frontend đã build (tích hợp sẵn)
+📂 docs/ # Tài liệu và hình ảnh
+📂 env/ # Cấu hình môi trường
+📂 scripts/ # Script hỗ trợ và Build
+📂 src/
+├─ 📂 agents/ # Module AI Agent
+│ ├─ 📂 productionAgent/ # Agent Sản xuất (Production)
+│ └─ 📂 scriptAgent/ # Agent Kịch bản (Script)
+├─ 📂 lib/ # Thư viện chung (Khởi tạo Database, định dạng Response)
+├─ 📂 middleware/ # Middleware
+├─ 📂 routes/ # Các Module Routing
+│ ├─ 📂 agents/ # Quản lý bộ nhớ Agent
+│ ├─ 📂 artStyle/ # Quản lý phong cách nghệ thuật
+│ ├─ 📂 assets/ # Quản lý tài nguyên (Assets)
+│ ├─ 📂 assetsGenerate/ # Trình tạo tài nguyên
+│ ├─ 📂 cornerScape/ # Quản lý phân cảnh (Storyboard)
+│ ├─ 📂 general/ # API chung
+│ ├─ 📂 login/ # Xác thực đăng nhập
+│ ├─ 📂 migrate/ # Di chuyển dữ liệu (Migration)
+│ ├─ 📂 modelSelect/ # Chọn mô hình
+│ ├─ 📂 novel/ # Quản lý tiểu thuyết
+│ ├─ 📂 other/ # Các tính năng khác
+│ ├─ 📂 production/ # Quản lý sản xuất / dựng phim
+│ ├─ 📂 project/ # Quản lý dự án
+│ ├─ 📂 script/ # Tạo kịch bản
+│ ├─ 📂 scriptAgent/ # Interface của Agent kịch bản
+│ ├─ 📂 setting/ # Cài đặt hệ thống
+│ ├─ 📂 task/ # Quản lý tác vụ (Task)
+│ └─ 📂 test/ # API thử nghiệm (Test)
+├─ 📂 socket/ # Giao tiếp Real-time qua WebSocket
+├─ 📂 types/ # Khai báo Type của TypeScript
+├─ 📂 utils/ # Các hàm tiện ích
+├─ 📄 app.ts # Entry của ứng dụng
+├─ 📄 core.ts # Khởi tạo Core
+├─ 📄 env.ts # Xử lý biến môi trường
+├─ 📄 err.ts # Xử lý lỗi (Error handling)
+├─ 📄 logger.ts # Module ghi log (Logger)
+├─ 📄 router.ts # Đăng ký Router
+└─ 📄 utils.ts # Công cụ chung
+📄 Dockerfile # Tệp cấu hình Build Docker
+📄 electron-builder.yml # Cấu hình đóng gói Electron
+📄 skillList.json # Danh sách kỹ năng
+📄 LICENSE # Giấy phép (Apache-2.0)
+📄 NOTICES.txt # Khai báo thư viện bên thứ ba
+📄 package.json # Cấu hình dự án
+📄 tsconfig.json # Cấu hình TypeScript
+```
+
+---
+
+# 🔗 Các Kho lưu trữ Liên quan
+
+| Repository (Kho) | Mô tả | GitHub | Gitee |
+| ---------------- | ---------------------------------- | -------------------------------------------------- | ------------------------------------------------ |
+| **Toonflow-app** | Client hoàn chỉnh (Repo này, khuyến nghị cho người dùng) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) |
+| **Toonflow-web** | Mã nguồn Frontend (Dành cho lập trình viên Frontend) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) |
+
+> 💡 **Mẹo nhỏ**: Nếu bạn chỉ muốn sử dụng Toonflow, hãy tải Client hoàn chỉnh từ kho này là đủ. Kho Toonflow-web chỉ dành cho các nhà phát triển cần chỉnh sửa hoặc phát triển lại giao diện (secondary development).
+
+---
+
+# 👨👩👧👦 Nhóm Discord Cộng đồng
+
+Nhấn vào biểu tượng bên dưới để tham gia Discord:
+
+[](https://discord.gg/HEjKmpNpAZ)
+
+Hoặc click trực tiếp vào link: [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
+
+---
+
+# 💌 Liên hệ với chúng tôi
+
+📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow%20%C6%B0%C9%9B)
+
+---
+
+# 📜 Giấy phép (License)
+
+Toonflow được phát hành mã nguồn mở dưới giấy phép Apache-2.0, kèm theo Thỏa thuận thương mại bổ sung.
+
+Chi tiết giấy phép Apache-2.0: https://www.apache.org/licenses/LICENSE-2.0
+
+## Thỏa thuận bổ sung
+
+- Nếu phần mềm này được phân phối dưới dạng sản phẩm cho **2 hoặc nhiều bên thứ ba độc lập** sử dụng, bắt buộc phải có **giấy phép thương mại bằng văn bản** từ HBAI-Ltd.
+- Nếu **≤ 5 pháp nhân** hợp tác vận hành để sử dụng nội bộ và không cung cấp dịch vụ ra bên ngoài, thì được coi là sử dụng nội bộ và **không cần cấp phép**.
+- Không được phép xóa hoặc sửa đổi logo hoặc thông tin bản quyền trong Toonflow.
+
+## Các trường hợp Miễn phí Vĩnh viễn
+
+- ✅ Dùng Toonflow để sản xuất nội dung và nhận chia sẻ doanh thu từ các nền tảng video
+- ✅ Chỉnh sửa mã nguồn (Secondary development) để dùng cho nhóm nội bộ
+- ✅ ≤ 5 pháp nhân hợp tác vận hành để sử dụng nội bộ
+- ✅ Phục vụ học tập cá nhân, nghiên cứu và các mục đích phi thương mại
+
+## Bảng giá Cấp phép Thương mại
+
+| Giai đoạn | Doanh thu Hàng năm | Phí Hàng năm |
+|------|---------|------|
+| 🌱 Ươm mầm | < ¥100k (RMB) | **Miễn phí** |
+| 🚀 Khởi nghiệp | ¥100k – 500k (RMB) | ¥5,000 / Năm |
+| 📈 Tăng trưởng | ¥500k – 1.5M (RMB) | ¥20,000 / Năm |
+| 🏢 Quy mô | ¥1.5M – 5M (RMB) | ¥80,000 / Năm |
+| 🌐 Doanh nghiệp | > ¥5M (RMB) | Thương lượng |
+
+> **Điều khoản Không hồi tố**: Những người dùng đã sử dụng Toonflow dưới giấy phép AGPL-3.0 trước khi phát hành phiên bản v1.0.8 sẽ tiếp tục tuân theo AGPL-3.0 và không bị ràng buộc bởi sự thay đổi thỏa thuận này.
+
+Xem toàn bộ thỏa thuận tại tệp [LICENSE](./LICENSE).
+
+---
+
+# ⭐️ Lịch sử Thả sao (Star History)
+
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
+
+---
+
+
+# 🙏 Lời Cảm ơn
+
+Xin cảm ơn các dự án mã nguồn mở sau đây đã hỗ trợ đắc lực cho Toonflow:
+
+- [Express](https://expressjs.com/) - Web framework cho Node.js cực nhanh và tối giản
+- [AI SDK](https://ai-sdk.dev/) - Bộ công cụ AI dành cho TypeScript
+- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - Thư viện liên kết SQLite3 hiệu suất cao
+- [Sharp](https://sharp.pixelplumbing.com/) - Thư viện xử lý hình ảnh Node.js hiệu suất cao
+- [Axios](https://axios-http.com/) - HTTP client dựa trên Promise
+- [Zod](https://zod.dev/) - Thư viện xác thực Schema ưu tiên TypeScript
+- [Socket.IO](https://socket.io/) - Công cụ giao tiếp sự kiện hai chiều thời gian thực
+- [Electron](https://www.electronjs.org/) - Framework phát triển ứng dụng Desktop đa nền tảng
+- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - Thư viện suy luận Machine Learning tại Local
+
+Xin cảm ơn các tổ chức/đơn vị/cá nhân sau đây đã hỗ trợ cho Toonflow:
+
+
+
+
+ | Logo |
+ Tên |
+ Hình thức hỗ trợ |
+ Mô tả |
+ Website |
+
+
+
+
+ |
+ Sophnet |
+ 💻 Tài trợ điện toán |
+ Nền tảng API suy luận mô hình một cửa, nhanh hơn, ổn định hơn và tiết kiệm hơn |
+ Website |
+
+
+ |
+ Atlas Cloud |
+ 💻 Tài trợ điện toán |
+ Nền tảng suy luận đa phương thức đầu tiên trên thế giới. Chat, hình ảnh, video, âm thanh — tất cả qua một API thống nhất. 300+ mô hình, tương thích OpenAI. |
+ Website |
+
+
+ |
+ Tencent Hunyuan3D |
+ 🌐 Hỗ trợ kỹ thuật World Model |
+ Tencent Hunyuan3D AI Creation Engine dựa trên mô hình Tencent Hunyuan3D 2.5 — nền tảng tạo nội dung 3D AI tích hợp đầu tiên trong ngành. Hỗ trợ text-to-3D, image-to-3D, tạo hoạt hình 3D, tạo kết cấu, sketch-to-3D và tạo nhân vật 3D, với lợi thế trong tạo mô hình low-poly. |
+ Website |
+
+
+
+
+Vui lòng xem danh sách đầy đủ các thư viện phụ thuộc của bên thứ ba trong tệp `NOTICES.txt`.
+
+##### Copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/README.th.md b/README.th.md
new file mode 100644
index 0000000..dc51540
--- /dev/null
+++ b/README.th.md
@@ -0,0 +1,709 @@
+
+
+
+
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+
+ 简体中文 |
+ 繁體中文 |
+ English |
+ ไทย |
+ Tiếng Việt |
+ 日本語 |
+ Русский
+
+
+
+
+
+
+# Toonflow
+
+
+
+ Nhà máy Phim ngắn AI
+
+ Chỉ với vài cú click, tiểu thuyết lập tức biến thành phim!
+
+ Kịch bản AI × Hình ảnh AI × Tạo siêu tốc 🔥
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ > 🚀 **Dự án Phim ngắn All-in-One**: Từ văn bản đến nhân vật, từ storyboard đến video hoàn chỉnh. Tự động hóa toàn bộ quy trình bằng AI – không rào cản, tăng hiệu suất sáng tạo lên gấp 10 lần!
+
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## Thông tin Demo
+
+| Mục | Chi tiết |
+|-----|---------|
+| Thời gian sản xuất | ~2 giờ |
+| Mô hình video | Seedance 2.0 |
+| Mô hình hình ảnh | GPT Image 2 |
+| Mô hình ngôn ngữ | Claude Opus 4.6 |
+| Thời lượng | ~2 phút (tư liệu gốc 3 phút, cắt ~1 phút)|
+
+## Chi tiết Chi phí
+
+| Mục | Chi phí |
+|-----|---------|
+| Hình ảnh (270 ảnh × ¥0.04) | ¥10.8 |
+| Video (45 clip × ¥3.5) | ¥157.5 |
+| Tổng | **~¥168** |
+
+> 📌 Độ phân giải gốc của Demo là 1080×1882, phiên bản phát hành đã nén xuống 480p. Nếu có vấn đề bản quyền, vui lòng liên hệ [ltlctools@outlook.com](mailto:ltlctools@outlook.com).
+
+## Video Demo
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> Nếu video không phát được, [click để tải xuống](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9).
+
+---
+
+# 🚀 Cài đặt
+
+## Điều kiện tiên quyết
+
+Trước khi cài đặt và sử dụng phần mềm, vui lòng chuẩn bị:
+
+- ✅ Địa chỉ API của Mô hình ngôn ngữ lớn (LLM)
+- ✅ Địa chỉ API của dịch vụ video Sora hoặc Doubao
+- ✅ Địa chỉ API của dịch vụ tạo ảnh Nano Banana Pro
+
+## Cài đặt trên máy cá nhân (Local)
+
+### 1. Tải xuống & Cài đặt
+
+| Hệ điều hành | GitHub | Atomgit | Tải qua Quark Drive | Mô tả |
+| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
+| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+
+> [!CAUTION]
+> Với hệ điều hành MacOS, vui lòng vào "Cài đặt hệ thống" -> "Quyền riêng tư & Bảo mật" để cấp quyền mở ứng dụng, nếu không phần mềm có thể không mở được do vấn đề chứng chỉ.
+>
+> Tham khảo hướng dẫn Zhihu: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+
+> Do giới hạn môi trường Gitee OS và giới hạn kích thước tệp tải lên của Release, chúng tôi tạm thời không cung cấp link tải qua Gitee Release.
+
+### 2. Khởi chạy Dịch vụ
+
+Sau khi cài đặt xong, hãy mở chương trình để bắt đầu sử dụng.
+
+> ⚠️ **Đăng nhập lần đầu**
+> Tài khoản: `admin`
+> Mật khẩu: `admin123`
+
+## Triển khai bằng Docker
+
+### Điều kiện tiên quyết
+
+- Đã cài đặt [Docker](https://docs.docker.com/get-docker/) (Phiên bản 20.10+)
+
+### Cách 1: Triển khai trực tuyến
+
+Đang hoàn thiện, tạm thời sử dụng cách Build tại máy (Local build).
+
+### Cách 2: Build tại máy (Local build)
+
+Sử dụng mã nguồn có sẵn để build trực tiếp. Phù hợp với lập trình viên hoặc người dùng đã clone repository. (Yêu cầu cài đặt git trên máy):
+
+```shell
+# Clone dự án (Bỏ qua nếu đã clone)
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+
+# Sử dụng docker-compose để build và chạy
+yarn docker:local
+
+# Hoặc build thủ công
+docker build -t toonflow .
+docker run -d -p :10588 -v <Đường dẫn dữ liệu trên máy>:/app/data toonflow
+
+# Sau đó, truy cập giao diện qua đường dẫn /web/index.html bằng Port đã thiết lập
+# Ví dụ: http://localhost:10588/web/index.html
+```
+
+### Cấu hình Cổng dịch vụ (Port)
+
+| Cổng (Port) | Chức năng | Port Mapping |
+| ------- | -------- | ------------- |
+| `10588` | Giao diện phần mềm | `10588:10588` |
+
+**Giải thích Biến môi trường:**
+
+| Biến (Variable) | Giải thích |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | Môi trường chạy, `prod` là môi trường Product (sản xuất) |
+| `PORT` | Port lắng nghe của dịch vụ (Mặc định: 10588) |
+| `OSSURL` | Địa chỉ truy cập lưu trữ file, dùng cho các tài nguyên tĩnh (Static) |
+
+---
+
+## Triển khai trên Máy chủ Đám mây (Cloud)
+
+### 1. Yêu cầu Môi trường Máy chủ
+
+- **Hệ điều hành**: Ubuntu 20.04+ / CentOS 7+
+- **Node.js**: 24.x (Khuyên dùng, Tối thiểu 23.11.1+)
+- **RAM**: 2GB+
+
+### 2. Triển khai Máy chủ
+
+#### 1. Cài đặt Môi trường
+
+```bash
+# Cài đặt Node.js
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+source ~/.bashrc
+nvm install 24
+# Cài đặt Yarn và PM2
+npm install -g yarn pm2
+```
+
+#### 2. Triển khai Dự án
+
+**Clone từ GitHub:**
+
+```bash
+cd /opt
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+**Clone từ Gitee (Khuyên dùng tại TQ):**
+
+```bash
+cd /opt
+git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+#### 3. Cấu hình PM2
+
+Tạo tệp `pm2.json`:
+
+```json
+{
+ "name": "toonflow-app",
+ "script": "data/serve/app.js",
+ "instances": "max",
+ "exec_mode": "cluster",
+ "env": {
+ "NODE_ENV": "prod",
+ "PORT": 10588,
+ "OSSURL": "http://127.0.0.1:10588/"
+ }
+}
+```
+
+**Giải thích Biến môi trường:**
+
+| Biến (Variable) | Giải thích |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | Môi trường chạy, `prod` là môi trường Product |
+| `PORT` | Cổng lắng nghe của dịch vụ (Port) |
+| `OSSURL` | Địa chỉ truy cập lưu trữ file, dùng cho tài nguyên tĩnh |
+
+---
+
+#### 4. Khởi chạy Dịch vụ
+
+```bash
+pm2 start pm2.json
+pm2 startup
+pm2 save
+```
+
+#### 5. Các lệnh PM2 thường dùng
+
+```bash
+pm2 list # Xem danh sách tiến trình
+pm2 logs toonflow-app # Xem log (nhật ký)
+pm2 restart all # Khởi động lại dịch vụ
+pm2 monit # Mở bảng điều khiển giám sát
+```
+
+> ⚠️ **Đăng nhập lần đầu**
+> Tài khoản: `admin`
+> Mật khẩu: `admin123`
+
+#### 6. Triển khai trang web Frontend
+
+Nếu bạn cần triển khai riêng hoặc tùy chỉnh giao diện Frontend, vui lòng tham khảo Repository Frontend:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+> 💡 **Lưu ý**: Repository này đã được tích hợp sẵn tài nguyên Frontend đã build. Người dùng thông thường không cần tự triển khai Frontend riêng. Repository Frontend chỉ dành cho các nhà phát triển muốn tùy chỉnh chuyên sâu.
+
+---
+
+# 🔧 Hướng dẫn Quy trình Phát triển (Development Workflow)
+
+> [!CAUTION]
+> 🚧 **Quy định nộp PR (Pull Request)** 🚧
+>
+> ⛔ Nhánh `master` KHÔNG chấp nhận bất kỳ PR nào ｜ ✅ Vui lòng gửi PR vào nhánh `develop`
+>
+> Chào mừng các nhà phát triển tham gia đóng góp cho Toonflow. Nếu có hứng thú, vui lòng liên hệ với quản trị viên ACT trong nhóm giao lưu.
+
+## 🛠️ Công nghệ sử dụng (Tech Stack)
+
+| Phân loại | Công nghệ |
+| ---------- | ----------------------------------------------------------------------------------------- |
+| Môi trường | Node.js 23.11.1+ |
+| Ngôn ngữ | TypeScript 5.x |
+| Backend | Express 5 |
+| Cơ sở dữ liệu | SQLite (better-sqlite3 / knex) |
+| Tích hợp AI| Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Qwen / xAI) |
+| Suy luận Local| @huggingface/transformers (ONNX) |
+| Real-time | Socket.IO |
+| Ứng dụng Desktop | Electron 40 |
+| Xử lý ảnh | Sharp |
+| Container | Docker |
+
+## Chuẩn bị Môi trường Phát triển
+
+- **Node.js**: Yêu cầu phiên bản 23.11.1 trở lên
+- **Yarn**: Khuyến nghị sử dụng làm Package Manager
+
+## Khởi chạy Dự án nhanh
+
+1. **Clone dự án**
+
+ **Clone từ GitHub:**
+
+ ```bash
+ git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+ **Clone từ Gitee:**
+
+ ```bash
+ git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+2. **Cài đặt Dependencies**
+
+ Chạy lệnh sau tại thư mục gốc của dự án:
+
+ ```bash
+ yarn install
+ ```
+
+3. **Khởi chạy môi trường Dev**
+
+ Dự án bao gồm **Backend API** và **Trang Frontend**. Tùy nhu cầu mà chọn cách khởi chạy:
+
+ - **Cách 1: Chỉ chạy Backend API**
+
+ ```bash
+ yarn dev
+ ```
+
+ > ⚠️ Lệnh này chỉ khởi chạy Backend API (Port 10588), không bao gồm giao diện Frontend. Khi truy cập http://localhost:10588 chỉ có thể gọi API. Nếu muốn sử dụng giao diện, vui lòng chạy Frontend riêng hoặc dùng chế độ GUI bên dưới.
+
+ - **Cách 2: Khởi chạy Client Desktop Electron (Khuyên dùng)**
+
+ ```bash
+ yarn dev:gui
+ ```
+
+ > Lệnh này sẽ chạy đồng thời Backend và cửa sổ Desktop Electron với giao diện Frontend đã tích hợp sẵn. Mở lên là có thể sử dụng ngay mà không cần cấu hình thêm. Phù hợp nhất cho lập trình viên muốn trải nghiệm toàn bộ tính năng.
+
+ - **Cách 3: Chạy ở chế độ Product (Sản xuất)**
+
+ ```bash
+ yarn start
+ ```
+
+ > Chạy trực tiếp dịch vụ sau khi đã build (Cần chạy lệnh yarn build trước).
+
+4. **Đóng gói dự án (Build / Pack)**
+
+ - Biên dịch tệp TypeScript:
+
+ ```bash
+ yarn build
+ ```
+
+ - Đóng gói thành tệp thực thi cho Windows:
+
+ ```bash
+ yarn dist:win
+ ```
+
+ - Đóng gói thành tệp thực thi cho MacOS:
+
+ ```bash
+ yarn dist:mac
+ ```
+
+ - Đóng gói thành tệp thực thi cho Linux:
+
+ ```bash
+ yarn dist:linux
+ ```
+
+5. **Kiểm tra chất lượng mã (Lint)**
+
+ - Kiểm tra cú pháp và quy chuẩn toàn cục:
+
+ ```bash
+ yarn lint
+ ```
+
+6. **Bảng điều khiển Debug AI (Tùy chọn)**
+
+ Mở công cụ Debug trực quan của AI SDK để tiện theo dõi các lời gọi AI:
+
+ ```bash
+ yarn debug:ai
+ ```
+
+## Phát triển Frontend
+
+Nếu bạn cần chỉnh sửa giao diện Frontend, vui lòng chuyển sang kho lưu trữ Frontend riêng:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+Sau khi build Frontend xong, hãy copy toàn bộ thư mục dist vào thư mục data/web của dự án này để tích hợp.
+
+## Cấu trúc Dự án
+
+```
+📂 build/ # Sản phẩm sau khi build
+📂 data/ # Dữ liệu Runtime
+│ ├─ 📂 models/ # Mô hình suy luận Local (ONNX)
+│ ├─ 📂 oss/ # Lưu trữ Object (ảnh, nhân vật, cảnh)
+│ ├─ 📂 serve/ # Cổng vào môi trường Production
+│ ├─ 📂 skills/ # Prompt kỹ năng của Agent
+│ └─ 📂 web/ # Frontend đã build (tích hợp sẵn)
+📂 docs/ # Tài liệu và hình ảnh
+📂 env/ # Cấu hình môi trường
+📂 scripts/ # Script hỗ trợ và Build
+📂 src/
+├─ 📂 agents/ # Module AI Agent
+│ ├─ 📂 productionAgent/ # Agent Sản xuất (Production)
+│ └─ 📂 scriptAgent/ # Agent Kịch bản (Script)
+├─ 📂 lib/ # Thư viện chung (Khởi tạo Database, định dạng Response)
+├─ 📂 middleware/ # Middleware
+├─ 📂 routes/ # Các Module Routing
+│ ├─ 📂 agents/ # Quản lý bộ nhớ Agent
+│ ├─ 📂 artStyle/ # Quản lý phong cách nghệ thuật
+│ ├─ 📂 assets/ # Quản lý tài nguyên (Assets)
+│ ├─ 📂 assetsGenerate/ # Trình tạo tài nguyên
+│ ├─ 📂 cornerScape/ # Quản lý phân cảnh (Storyboard)
+│ ├─ 📂 general/ # API chung
+│ ├─ 📂 login/ # Xác thực đăng nhập
+│ ├─ 📂 migrate/ # Di chuyển dữ liệu (Migration)
+│ ├─ 📂 modelSelect/ # Chọn mô hình
+│ ├─ 📂 novel/ # Quản lý tiểu thuyết
+│ ├─ 📂 other/ # Các tính năng khác
+│ ├─ 📂 production/ # Quản lý sản xuất / dựng phim
+│ ├─ 📂 project/ # Quản lý dự án
+│ ├─ 📂 script/ # Tạo kịch bản
+│ ├─ 📂 scriptAgent/ # Interface của Agent kịch bản
+│ ├─ 📂 setting/ # Cài đặt hệ thống
+│ ├─ 📂 task/ # Quản lý tác vụ (Task)
+│ └─ 📂 test/ # API thử nghiệm (Test)
+├─ 📂 socket/ # Giao tiếp Real-time qua WebSocket
+├─ 📂 types/ # Khai báo Type của TypeScript
+├─ 📂 utils/ # Các hàm tiện ích
+├─ 📄 app.ts # Entry của ứng dụng
+├─ 📄 core.ts # Khởi tạo Core
+├─ 📄 env.ts # Xử lý biến môi trường
+├─ 📄 err.ts # Xử lý lỗi (Error handling)
+├─ 📄 logger.ts # Module ghi log (Logger)
+├─ 📄 router.ts # Đăng ký Router
+└─ 📄 utils.ts # Công cụ chung
+📄 Dockerfile # Tệp cấu hình Build Docker
+📄 electron-builder.yml # Cấu hình đóng gói Electron
+📄 skillList.json # Danh sách kỹ năng
+📄 LICENSE # Giấy phép (Apache-2.0)
+📄 NOTICES.txt # Khai báo thư viện bên thứ ba
+📄 package.json # Cấu hình dự án
+📄 tsconfig.json # Cấu hình TypeScript
+```
+
+---
+
+# 🔗 Các Kho lưu trữ Liên quan
+
+| Repository (Kho) | Mô tả | GitHub | Gitee |
+| ---------------- | ---------------------------------- | -------------------------------------------------- | ------------------------------------------------ |
+| **Toonflow-app** | Client hoàn chỉnh (Repo này, khuyến nghị cho người dùng) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) |
+| **Toonflow-web** | Mã nguồn Frontend (Dành cho lập trình viên Frontend) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) |
+
+> 💡 **Mẹo nhỏ**: Nếu bạn chỉ muốn sử dụng Toonflow, hãy tải Client hoàn chỉnh từ kho này là đủ. Kho Toonflow-web chỉ dành cho các nhà phát triển cần chỉnh sửa hoặc phát triển lại giao diện (secondary development).
+
+---
+
+# 👨👩👧👦 Nhóm Discord Cộng đồng
+
+Nhấn vào biểu tượng bên dưới để tham gia Discord:
+
+[](https://discord.gg/HEjKmpNpAZ)
+
+Hoặc click trực tiếp vào link: [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
+
+---
+
+# 💌 Liên hệ với chúng tôi
+
+📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow%20%C6%B0%C9%9B)
+
+---
+
+# 📜 Giấy phép (License)
+
+Toonflow được phát hành mã nguồn mở dưới giấy phép Apache-2.0, kèm theo Thỏa thuận thương mại bổ sung.
+
+Chi tiết giấy phép Apache-2.0: https://www.apache.org/licenses/LICENSE-2.0
+
+## Thỏa thuận bổ sung
+
+- Nếu phần mềm này được phân phối dưới dạng sản phẩm cho **2 hoặc nhiều bên thứ ba độc lập** sử dụng, bắt buộc phải có **giấy phép thương mại bằng văn bản** từ HBAI-Ltd.
+- Nếu **≤ 5 pháp nhân** hợp tác vận hành để sử dụng nội bộ và không cung cấp dịch vụ ra bên ngoài, thì được coi là sử dụng nội bộ và **không cần cấp phép**.
+- Không được phép xóa hoặc sửa đổi logo hoặc thông tin bản quyền trong Toonflow.
+
+## Các trường hợp Miễn phí Vĩnh viễn
+
+- ✅ Dùng Toonflow để sản xuất nội dung và nhận chia sẻ doanh thu từ các nền tảng video
+- ✅ Chỉnh sửa mã nguồn (Secondary development) để dùng cho nhóm nội bộ
+- ✅ ≤ 5 pháp nhân hợp tác vận hành để sử dụng nội bộ
+- ✅ Phục vụ học tập cá nhân, nghiên cứu và các mục đích phi thương mại
+
+## Bảng giá Cấp phép Thương mại
+
+| Giai đoạn | Doanh thu Hàng năm | Phí Hàng năm |
+|------|---------|------|
+| 🌱 Ươm mầm | < ¥100k (RMB) | **Miễn phí** |
+| 🚀 Khởi nghiệp | ¥100k – 500k (RMB) | ¥5,000 / Năm |
+| 📈 Tăng trưởng | ¥500k – 1.5M (RMB) | ¥20,000 / Năm |
+| 🏢 Quy mô | ¥1.5M – 5M (RMB) | ¥80,000 / Năm |
+| 🌐 Doanh nghiệp | > ¥5M (RMB) | Thương lượng |
+
+> **Điều khoản Không hồi tố**: Những người dùng đã sử dụng Toonflow dưới giấy phép AGPL-3.0 trước khi phát hành phiên bản v1.0.8 sẽ tiếp tục tuân theo AGPL-3.0 và không bị ràng buộc bởi sự thay đổi thỏa thuận này.
+
+Xem toàn bộ thỏa thuận tại tệp [LICENSE](./LICENSE).
+
+---
+
+# ⭐️ Lịch sử Thả sao (Star History)
+
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
+
+---
+
+
+# 🙏 Lời Cảm ơn
+
+Xin cảm ơn các dự án mã nguồn mở sau đây đã hỗ trợ đắc lực cho Toonflow:
+
+- [Express](https://expressjs.com/) - Web framework cho Node.js cực nhanh và tối giản
+- [AI SDK](https://ai-sdk.dev/) - Bộ công cụ AI dành cho TypeScript
+- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - Thư viện liên kết SQLite3 hiệu suất cao
+- [Sharp](https://sharp.pixelplumbing.com/) - Thư viện xử lý hình ảnh Node.js hiệu suất cao
+- [Axios](https://axios-http.com/) - HTTP client dựa trên Promise
+- [Zod](https://zod.dev/) - Thư viện xác thực Schema ưu tiên TypeScript
+- [Socket.IO](https://socket.io/) - Công cụ giao tiếp sự kiện hai chiều thời gian thực
+- [Electron](https://www.electronjs.org/) - Framework phát triển ứng dụng Desktop đa nền tảng
+- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - Thư viện suy luận Machine Learning tại Local
+
+Xin cảm ơn các tổ chức/đơn vị/cá nhân sau đây đã hỗ trợ cho Toonflow:
+
+
+
+
+ | Logo |
+ Tên |
+ Hình thức hỗ trợ |
+ Mô tả |
+ Website |
+
+
+
+
+ |
+ Sophnet |
+ 💻 Tài trợ điện toán |
+ Nền tảng API suy luận mô hình một cửa, nhanh hơn, ổn định hơn và tiết kiệm hơn |
+ Website |
+
+
+ |
+ Atlas Cloud |
+ 💻 Tài trợ điện toán |
+ Nền tảng suy luận đa phương thức đầu tiên trên thế giới. Chat, hình ảnh, video, âm thanh — tất cả qua một API thống nhất. 300+ mô hình, tương thích OpenAI. |
+ Website |
+
+
+ |
+ Tencent Hunyuan3D |
+ 🌐 Hỗ trợ kỹ thuật World Model |
+ Tencent Hunyuan3D AI Creation Engine dựa trên mô hình Tencent Hunyuan3D 2.5 — nền tảng tạo nội dung 3D AI tích hợp đầu tiên trong ngành. Hỗ trợ text-to-3D, image-to-3D, tạo hoạt hình 3D, tạo kết cấu, sketch-to-3D và tạo nhân vật 3D, với lợi thế trong tạo mô hình low-poly. |
+ Website |
+
+
+
+
+Vui lòng xem danh sách đầy đủ các thư viện phụ thuộc của bên thứ ba trong tệp `NOTICES.txt`.
+
+##### Copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/README.vi.md b/README.vi.md
new file mode 100644
index 0000000..fba0cb4
--- /dev/null
+++ b/README.vi.md
@@ -0,0 +1,709 @@
+
+
+
+
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+
+ 简体中文 |
+ 繁體中文 |
+ English |
+ ไทย |
+ Tiếng Việt |
+ 日本語 |
+ Русский
+
+
+
+
+
+
+# Toonflow
+
+
+
+ Nhà máy Phim ngắn AI
+
+ Chỉ với vài cú click, tiểu thuyết lập tức biến thành phim!
+
+ Kịch bản AI × Hình ảnh AI × Tạo siêu tốc 🔥
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ > 🚀 **Dự án Phim ngắn All-in-One**: Từ văn bản đến nhân vật, từ storyboard đến video hoàn chỉnh. Tự động hóa toàn bộ quy trình bằng AI – không rào cản, tăng hiệu suất sáng tạo lên gấp 10 lần!
+
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## Thông tin Demo
+
+| Mục | Chi tiết |
+|-----|---------|
+| Thời gian sản xuất | ~2 giờ |
+| Mô hình video | Seedance 2.0 |
+| Mô hình hình ảnh | GPT Image 2 |
+| Mô hình ngôn ngữ | Claude Opus 4.6 |
+| Thời lượng | ~2 phút (tư liệu gốc 3 phút, cắt ~1 phút)|
+
+## Chi tiết Chi phí
+
+| Mục | Chi phí |
+|-----|---------|
+| Hình ảnh (270 ảnh × ¥0.04) | ¥10.8 |
+| Video (45 clip × ¥3.5) | ¥157.5 |
+| Tổng | **~¥168** |
+
+> 📌 Độ phân giải gốc của Demo là 1080×1882, phiên bản phát hành đã nén xuống 480p. Nếu có vấn đề bản quyền, vui lòng liên hệ [ltlctools@outlook.com](mailto:ltlctools@outlook.com).
+
+## Video Demo
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> Nếu video không phát được, [click để tải xuống](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9).
+
+---
+
+# 🚀 Cài đặt
+
+## Điều kiện tiên quyết
+
+Trước khi cài đặt và sử dụng phần mềm, vui lòng chuẩn bị:
+
+- ✅ Địa chỉ API của Mô hình ngôn ngữ lớn (LLM)
+- ✅ Địa chỉ API của dịch vụ video Sora hoặc Doubao
+- ✅ Địa chỉ API của dịch vụ tạo ảnh Nano Banana Pro
+
+## Cài đặt trên máy cá nhân (Local)
+
+### 1. Tải xuống & Cài đặt
+
+| Hệ điều hành | GitHub | Atomgit | Tải qua Quark Drive | Mô tả |
+| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
+| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+
+> [!CAUTION]
+> Với hệ điều hành MacOS, vui lòng vào "Cài đặt hệ thống" -> "Quyền riêng tư & Bảo mật" để cấp quyền mở ứng dụng, nếu không phần mềm có thể không mở được do vấn đề chứng chỉ.
+>
+> Tham khảo hướng dẫn Zhihu: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+
+> Do giới hạn môi trường Gitee OS và giới hạn kích thước tệp tải lên của Release, chúng tôi tạm thời không cung cấp link tải qua Gitee Release.
+
+### 2. Khởi chạy Dịch vụ
+
+Sau khi cài đặt xong, hãy mở chương trình để bắt đầu sử dụng.
+
+> ⚠️ **Đăng nhập lần đầu**
+> Tài khoản: `admin`
+> Mật khẩu: `admin123`
+
+## Triển khai bằng Docker
+
+### Điều kiện tiên quyết
+
+- Đã cài đặt [Docker](https://docs.docker.com/get-docker/) (Phiên bản 20.10+)
+
+### Cách 1: Triển khai trực tuyến
+
+Đang hoàn thiện, tạm thời sử dụng cách Build tại máy (Local build).
+
+### Cách 2: Build tại máy (Local build)
+
+Sử dụng mã nguồn có sẵn để build trực tiếp. Phù hợp với lập trình viên hoặc người dùng đã clone repository. (Yêu cầu cài đặt git trên máy):
+
+```shell
+# Clone dự án (Bỏ qua nếu đã clone)
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+
+# Sử dụng docker-compose để build và chạy
+yarn docker:local
+
+# Hoặc build thủ công
+docker build -t toonflow .
+docker run -d -p :10588 -v <Đường dẫn dữ liệu trên máy>:/app/data toonflow
+
+# Sau đó, truy cập giao diện qua đường dẫn /web/index.html bằng Port đã thiết lập
+# Ví dụ: http://localhost:10588/web/index.html
+```
+
+### Cấu hình Cổng dịch vụ (Port)
+
+| Cổng (Port) | Chức năng | Port Mapping |
+| ------- | -------- | ------------- |
+| `10588` | Giao diện phần mềm | `10588:10588` |
+
+**Giải thích Biến môi trường:**
+
+| Biến (Variable) | Giải thích |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | Môi trường chạy, `prod` là môi trường Product (sản xuất) |
+| `PORT` | Port lắng nghe của dịch vụ (Mặc định: 10588) |
+| `OSSURL` | Địa chỉ truy cập lưu trữ file, dùng cho các tài nguyên tĩnh (Static) |
+
+---
+
+## Triển khai trên Máy chủ Đám mây (Cloud)
+
+### 1. Yêu cầu Môi trường Máy chủ
+
+- **Hệ điều hành**: Ubuntu 20.04+ / CentOS 7+
+- **Node.js**: 24.x (Khuyên dùng, Tối thiểu 23.11.1+)
+- **RAM**: 2GB+
+
+### 2. Triển khai Máy chủ
+
+#### 1. Cài đặt Môi trường
+
+```bash
+# Cài đặt Node.js
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+source ~/.bashrc
+nvm install 24
+# Cài đặt Yarn và PM2
+npm install -g yarn pm2
+```
+
+#### 2. Triển khai Dự án
+
+**Clone từ GitHub:**
+
+```bash
+cd /opt
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+**Clone từ Gitee (Khuyên dùng tại TQ):**
+
+```bash
+cd /opt
+git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+#### 3. Cấu hình PM2
+
+Tạo tệp `pm2.json`:
+
+```json
+{
+ "name": "toonflow-app",
+ "script": "data/serve/app.js",
+ "instances": "max",
+ "exec_mode": "cluster",
+ "env": {
+ "NODE_ENV": "prod",
+ "PORT": 10588,
+ "OSSURL": "http://127.0.0.1:10588/"
+ }
+}
+```
+
+**Giải thích Biến môi trường:**
+
+| Biến (Variable) | Giải thích |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | Môi trường chạy, `prod` là môi trường Product |
+| `PORT` | Cổng lắng nghe của dịch vụ (Port) |
+| `OSSURL` | Địa chỉ truy cập lưu trữ file, dùng cho tài nguyên tĩnh |
+
+---
+
+#### 4. Khởi chạy Dịch vụ
+
+```bash
+pm2 start pm2.json
+pm2 startup
+pm2 save
+```
+
+#### 5. Các lệnh PM2 thường dùng
+
+```bash
+pm2 list # Xem danh sách tiến trình
+pm2 logs toonflow-app # Xem log (nhật ký)
+pm2 restart all # Khởi động lại dịch vụ
+pm2 monit # Mở bảng điều khiển giám sát
+```
+
+> ⚠️ **Đăng nhập lần đầu**
+> Tài khoản: `admin`
+> Mật khẩu: `admin123`
+
+#### 6. Triển khai trang web Frontend
+
+Nếu bạn cần triển khai riêng hoặc tùy chỉnh giao diện Frontend, vui lòng tham khảo Repository Frontend:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+> 💡 **Lưu ý**: Repository này đã được tích hợp sẵn tài nguyên Frontend đã build. Người dùng thông thường không cần tự triển khai Frontend riêng. Repository Frontend chỉ dành cho các nhà phát triển muốn tùy chỉnh chuyên sâu.
+
+---
+
+# 🔧 Hướng dẫn Quy trình Phát triển (Development Workflow)
+
+> [!CAUTION]
+> 🚧 **Quy định nộp PR (Pull Request)** 🚧
+>
+> ⛔ Nhánh `master` KHÔNG chấp nhận bất kỳ PR nào ｜ ✅ Vui lòng gửi PR vào nhánh `develop`
+>
+> Chào mừng các nhà phát triển tham gia đóng góp cho Toonflow. Nếu có hứng thú, vui lòng liên hệ với quản trị viên ACT trong nhóm giao lưu.
+
+## 🛠️ Công nghệ sử dụng (Tech Stack)
+
+| Phân loại | Công nghệ |
+| ---------- | ----------------------------------------------------------------------------------------- |
+| Môi trường | Node.js 23.11.1+ |
+| Ngôn ngữ | TypeScript 5.x |
+| Backend | Express 5 |
+| Cơ sở dữ liệu | SQLite (better-sqlite3 / knex) |
+| Tích hợp AI| Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Qwen / xAI) |
+| Suy luận Local| @huggingface/transformers (ONNX) |
+| Real-time | Socket.IO |
+| Ứng dụng Desktop | Electron 40 |
+| Xử lý ảnh | Sharp |
+| Container | Docker |
+
+## Chuẩn bị Môi trường Phát triển
+
+- **Node.js**: Yêu cầu phiên bản 23.11.1 trở lên
+- **Yarn**: Khuyến nghị sử dụng làm Package Manager
+
+## Khởi chạy Dự án nhanh
+
+1. **Clone dự án**
+
+ **Clone từ GitHub:**
+
+ ```bash
+ git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+ **Clone từ Gitee:**
+
+ ```bash
+ git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+2. **Cài đặt Dependencies**
+
+ Chạy lệnh sau tại thư mục gốc của dự án:
+
+ ```bash
+ yarn install
+ ```
+
+3. **Khởi chạy môi trường Dev**
+
+ Dự án bao gồm **Backend API** và **Trang Frontend**. Tùy nhu cầu mà chọn cách khởi chạy:
+
+ - **Cách 1: Chỉ chạy Backend API**
+
+ ```bash
+ yarn dev
+ ```
+
+ > ⚠️ Lệnh này chỉ khởi chạy Backend API (Port 10588), không bao gồm giao diện Frontend. Khi truy cập http://localhost:10588 chỉ có thể gọi API. Nếu muốn sử dụng giao diện, vui lòng chạy Frontend riêng hoặc dùng chế độ GUI bên dưới.
+
+ - **Cách 2: Khởi chạy Client Desktop Electron (Khuyên dùng)**
+
+ ```bash
+ yarn dev:gui
+ ```
+
+ > Lệnh này sẽ chạy đồng thời Backend và cửa sổ Desktop Electron với giao diện Frontend đã tích hợp sẵn. Mở lên là có thể sử dụng ngay mà không cần cấu hình thêm. Phù hợp nhất cho lập trình viên muốn trải nghiệm toàn bộ tính năng.
+
+ - **Cách 3: Chạy ở chế độ Product (Sản xuất)**
+
+ ```bash
+ yarn start
+ ```
+
+ > Chạy trực tiếp dịch vụ sau khi đã build (Cần chạy lệnh yarn build trước).
+
+4. **Đóng gói dự án (Build / Pack)**
+
+ - Biên dịch tệp TypeScript:
+
+ ```bash
+ yarn build
+ ```
+
+ - Đóng gói thành tệp thực thi cho Windows:
+
+ ```bash
+ yarn dist:win
+ ```
+
+ - Đóng gói thành tệp thực thi cho MacOS:
+
+ ```bash
+ yarn dist:mac
+ ```
+
+ - Đóng gói thành tệp thực thi cho Linux:
+
+ ```bash
+ yarn dist:linux
+ ```
+
+5. **Kiểm tra chất lượng mã (Lint)**
+
+ - Kiểm tra cú pháp và quy chuẩn toàn cục:
+
+ ```bash
+ yarn lint
+ ```
+
+6. **Bảng điều khiển Debug AI (Tùy chọn)**
+
+ Mở công cụ Debug trực quan của AI SDK để tiện theo dõi các lời gọi AI:
+
+ ```bash
+ yarn debug:ai
+ ```
+
+## Phát triển Frontend
+
+Nếu bạn cần chỉnh sửa giao diện Frontend, vui lòng chuyển sang kho lưu trữ Frontend riêng:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+Sau khi build Frontend xong, hãy copy toàn bộ thư mục dist vào thư mục data/web của dự án này để tích hợp.
+
+## Cấu trúc Dự án
+
+```
+📂 build/ # Sản phẩm sau khi build
+📂 data/ # Dữ liệu Runtime
+│ ├─ 📂 models/ # Mô hình suy luận Local (ONNX)
+│ ├─ 📂 oss/ # Lưu trữ Object (ảnh, nhân vật, cảnh)
+│ ├─ 📂 serve/ # Cổng vào môi trường Production
+│ ├─ 📂 skills/ # Prompt kỹ năng của Agent
+│ └─ 📂 web/ # Frontend đã build (tích hợp sẵn)
+📂 docs/ # Tài liệu và hình ảnh
+📂 env/ # Cấu hình môi trường
+📂 scripts/ # Script hỗ trợ và Build
+📂 src/
+├─ 📂 agents/ # Module AI Agent
+│ ├─ 📂 productionAgent/ # Agent Sản xuất (Production)
+│ └─ 📂 scriptAgent/ # Agent Kịch bản (Script)
+├─ 📂 lib/ # Thư viện chung (Khởi tạo Database, định dạng Response)
+├─ 📂 middleware/ # Middleware
+├─ 📂 routes/ # Các Module Routing
+│ ├─ 📂 agents/ # Quản lý bộ nhớ Agent
+│ ├─ 📂 artStyle/ # Quản lý phong cách nghệ thuật
+│ ├─ 📂 assets/ # Quản lý tài nguyên (Assets)
+│ ├─ 📂 assetsGenerate/ # Trình tạo tài nguyên
+│ ├─ 📂 cornerScape/ # Quản lý phân cảnh (Storyboard)
+│ ├─ 📂 general/ # API chung
+│ ├─ 📂 login/ # Xác thực đăng nhập
+│ ├─ 📂 migrate/ # Di chuyển dữ liệu (Migration)
+│ ├─ 📂 modelSelect/ # Chọn mô hình
+│ ├─ 📂 novel/ # Quản lý tiểu thuyết
+│ ├─ 📂 other/ # Các tính năng khác
+│ ├─ 📂 production/ # Quản lý sản xuất / dựng phim
+│ ├─ 📂 project/ # Quản lý dự án
+│ ├─ 📂 script/ # Tạo kịch bản
+│ ├─ 📂 scriptAgent/ # Interface của Agent kịch bản
+│ ├─ 📂 setting/ # Cài đặt hệ thống
+│ ├─ 📂 task/ # Quản lý tác vụ (Task)
+│ └─ 📂 test/ # API thử nghiệm (Test)
+├─ 📂 socket/ # Giao tiếp Real-time qua WebSocket
+├─ 📂 types/ # Khai báo Type của TypeScript
+├─ 📂 utils/ # Các hàm tiện ích
+├─ 📄 app.ts # Entry của ứng dụng
+├─ 📄 core.ts # Khởi tạo Core
+├─ 📄 env.ts # Xử lý biến môi trường
+├─ 📄 err.ts # Xử lý lỗi (Error handling)
+├─ 📄 logger.ts # Module ghi log (Logger)
+├─ 📄 router.ts # Đăng ký Router
+└─ 📄 utils.ts # Công cụ chung
+📄 Dockerfile # Tệp cấu hình Build Docker
+📄 electron-builder.yml # Cấu hình đóng gói Electron
+📄 skillList.json # Danh sách kỹ năng
+📄 LICENSE # Giấy phép (Apache-2.0)
+📄 NOTICES.txt # Khai báo thư viện bên thứ ba
+📄 package.json # Cấu hình dự án
+📄 tsconfig.json # Cấu hình TypeScript
+```
+
+---
+
+# 🔗 Các Kho lưu trữ Liên quan
+
+| Repository (Kho) | Mô tả | GitHub | Gitee |
+| ---------------- | ---------------------------------- | -------------------------------------------------- | ------------------------------------------------ |
+| **Toonflow-app** | Client hoàn chỉnh (Repo này, khuyến nghị cho người dùng) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) |
+| **Toonflow-web** | Mã nguồn Frontend (Dành cho lập trình viên Frontend) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) |
+
+> 💡 **Mẹo nhỏ**: Nếu bạn chỉ muốn sử dụng Toonflow, hãy tải Client hoàn chỉnh từ kho này là đủ. Kho Toonflow-web chỉ dành cho các nhà phát triển cần chỉnh sửa hoặc phát triển lại giao diện (secondary development).
+
+---
+
+# 👨👩👧👦 Nhóm Discord Cộng đồng
+
+Nhấn vào biểu tượng bên dưới để tham gia Discord:
+
+[](https://discord.gg/HEjKmpNpAZ)
+
+Hoặc click trực tiếp vào link: [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
+
+---
+
+# 💌 Liên hệ với chúng tôi
+
+📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow%20%C6%B0%C9%9B)
+
+---
+
+# 📜 Giấy phép (License)
+
+Toonflow được phát hành mã nguồn mở dưới giấy phép Apache-2.0, kèm theo Thỏa thuận thương mại bổ sung.
+
+Chi tiết giấy phép Apache-2.0: https://www.apache.org/licenses/LICENSE-2.0
+
+## Thỏa thuận bổ sung
+
+- Nếu phần mềm này được phân phối dưới dạng sản phẩm cho **2 hoặc nhiều bên thứ ba độc lập** sử dụng, bắt buộc phải có **giấy phép thương mại bằng văn bản** từ HBAI-Ltd.
+- Nếu **≤ 5 pháp nhân** hợp tác vận hành để sử dụng nội bộ và không cung cấp dịch vụ ra bên ngoài, thì được coi là sử dụng nội bộ và **không cần cấp phép**.
+- Không được phép xóa hoặc sửa đổi logo hoặc thông tin bản quyền trong Toonflow.
+
+## Các trường hợp Miễn phí Vĩnh viễn
+
+- ✅ Dùng Toonflow để sản xuất nội dung và nhận chia sẻ doanh thu từ các nền tảng video
+- ✅ Chỉnh sửa mã nguồn (Secondary development) để dùng cho nhóm nội bộ
+- ✅ ≤ 5 pháp nhân hợp tác vận hành để sử dụng nội bộ
+- ✅ Phục vụ học tập cá nhân, nghiên cứu và các mục đích phi thương mại
+
+## Bảng giá Cấp phép Thương mại
+
+| Giai đoạn | Doanh thu Hàng năm | Phí Hàng năm |
+|------|---------|------|
+| 🌱 Ươm mầm | < ¥100k (RMB) | **Miễn phí** |
+| 🚀 Khởi nghiệp | ¥100k – 500k (RMB) | ¥5,000 / Năm |
+| 📈 Tăng trưởng | ¥500k – 1.5M (RMB) | ¥20,000 / Năm |
+| 🏢 Quy mô | ¥1.5M – 5M (RMB) | ¥80,000 / Năm |
+| 🌐 Doanh nghiệp | > ¥5M (RMB) | Thương lượng |
+
+> **Điều khoản Không hồi tố**: Những người dùng đã sử dụng Toonflow dưới giấy phép AGPL-3.0 trước khi phát hành phiên bản v1.0.8 sẽ tiếp tục tuân theo AGPL-3.0 và không bị ràng buộc bởi sự thay đổi thỏa thuận này.
+
+Xem toàn bộ thỏa thuận tại tệp [LICENSE](./LICENSE).
+
+---
+
+# ⭐️ Lịch sử Thả sao (Star History)
+
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
+
+---
+
+
+# 🙏 Lời Cảm ơn
+
+Xin cảm ơn các dự án mã nguồn mở sau đây đã hỗ trợ đắc lực cho Toonflow:
+
+- [Express](https://expressjs.com/) - Web framework cho Node.js cực nhanh và tối giản
+- [AI SDK](https://ai-sdk.dev/) - Bộ công cụ AI dành cho TypeScript
+- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - Thư viện liên kết SQLite3 hiệu suất cao
+- [Sharp](https://sharp.pixelplumbing.com/) - Thư viện xử lý hình ảnh Node.js hiệu suất cao
+- [Axios](https://axios-http.com/) - HTTP client dựa trên Promise
+- [Zod](https://zod.dev/) - Thư viện xác thực Schema ưu tiên TypeScript
+- [Socket.IO](https://socket.io/) - Công cụ giao tiếp sự kiện hai chiều thời gian thực
+- [Electron](https://www.electronjs.org/) - Framework phát triển ứng dụng Desktop đa nền tảng
+- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - Thư viện suy luận Machine Learning tại Local
+
+Xin cảm ơn các tổ chức/đơn vị/cá nhân sau đây đã hỗ trợ cho Toonflow:
+
+
+
+
+ | Logo |
+ Tên |
+ Hình thức hỗ trợ |
+ Mô tả |
+ Website |
+
+
+
+
+ |
+ Sophnet |
+ 💻 Tài trợ điện toán |
+ Nền tảng API suy luận mô hình một cửa, nhanh hơn, ổn định hơn và tiết kiệm hơn |
+ Website |
+
+
+ |
+ Atlas Cloud |
+ 💻 Tài trợ điện toán |
+ Nền tảng suy luận đa phương thức đầu tiên trên thế giới. Chat, hình ảnh, video, âm thanh — tất cả qua một API thống nhất. 300+ mô hình, tương thích OpenAI. |
+ Website |
+
+
+ |
+ Tencent Hunyuan3D |
+ 🌐 Hỗ trợ kỹ thuật World Model |
+ Tencent Hunyuan3D AI Creation Engine dựa trên mô hình Tencent Hunyuan3D 2.5 — nền tảng tạo nội dung 3D AI tích hợp đầu tiên trong ngành. Hỗ trợ text-to-3D, image-to-3D, tạo hoạt hình 3D, tạo kết cấu, sketch-to-3D và tạo nhân vật 3D, với lợi thế trong tạo mô hình low-poly. |
+ Website |
+
+
+
+
+Vui lòng xem danh sách đầy đủ các thư viện phụ thuộc của bên thứ ba trong tệp `NOTICES.txt`.
+
+##### Copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/README.zhtw.md b/README.zhtw.md
new file mode 100644
index 0000000..dc51540
--- /dev/null
+++ b/README.zhtw.md
@@ -0,0 +1,709 @@
+
+
+
+
+
+
+ |
+
+
+
+ |
+
+
+
+
+
+
+ 简体中文 |
+ 繁體中文 |
+ English |
+ ไทย |
+ Tiếng Việt |
+ 日本語 |
+ Русский
+
+
+
+
+
+
+# Toonflow
+
+
+
+ Nhà máy Phim ngắn AI
+
+ Chỉ với vài cú click, tiểu thuyết lập tức biến thành phim!
+
+ Kịch bản AI × Hình ảnh AI × Tạo siêu tốc 🔥
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ > 🚀 **Dự án Phim ngắn All-in-One**: Từ văn bản đến nhân vật, từ storyboard đến video hoàn chỉnh. Tự động hóa toàn bộ quy trình bằng AI – không rào cản, tăng hiệu suất sáng tạo lên gấp 10 lần!
+
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## Thông tin Demo
+
+| Mục | Chi tiết |
+|-----|---------|
+| Thời gian sản xuất | ~2 giờ |
+| Mô hình video | Seedance 2.0 |
+| Mô hình hình ảnh | GPT Image 2 |
+| Mô hình ngôn ngữ | Claude Opus 4.6 |
+| Thời lượng | ~2 phút (tư liệu gốc 3 phút, cắt ~1 phút)|
+
+## Chi tiết Chi phí
+
+| Mục | Chi phí |
+|-----|---------|
+| Hình ảnh (270 ảnh × ¥0.04) | ¥10.8 |
+| Video (45 clip × ¥3.5) | ¥157.5 |
+| Tổng | **~¥168** |
+
+> 📌 Độ phân giải gốc của Demo là 1080×1882, phiên bản phát hành đã nén xuống 480p. Nếu có vấn đề bản quyền, vui lòng liên hệ [ltlctools@outlook.com](mailto:ltlctools@outlook.com).
+
+## Video Demo
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> Nếu video không phát được, [click để tải xuống](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9).
+
+---
+
+# 🚀 Cài đặt
+
+## Điều kiện tiên quyết
+
+Trước khi cài đặt và sử dụng phần mềm, vui lòng chuẩn bị:
+
+- ✅ Địa chỉ API của Mô hình ngôn ngữ lớn (LLM)
+- ✅ Địa chỉ API của dịch vụ video Sora hoặc Doubao
+- ✅ Địa chỉ API của dịch vụ tạo ảnh Nano Banana Pro
+
+## Cài đặt trên máy cá nhân (Local)
+
+### 1. Tải xuống & Cài đặt
+
+| Hệ điều hành | GitHub | Atomgit | Tải qua Quark Drive | Mô tả |
+| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
+| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Bản cài đặt chính thức |
+
+> [!CAUTION]
+> Với hệ điều hành MacOS, vui lòng vào "Cài đặt hệ thống" -> "Quyền riêng tư & Bảo mật" để cấp quyền mở ứng dụng, nếu không phần mềm có thể không mở được do vấn đề chứng chỉ.
+>
+> Tham khảo hướng dẫn Zhihu: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+
+> Do giới hạn môi trường Gitee OS và giới hạn kích thước tệp tải lên của Release, chúng tôi tạm thời không cung cấp link tải qua Gitee Release.
+
+### 2. Khởi chạy Dịch vụ
+
+Sau khi cài đặt xong, hãy mở chương trình để bắt đầu sử dụng.
+
+> ⚠️ **Đăng nhập lần đầu**
+> Tài khoản: `admin`
+> Mật khẩu: `admin123`
+
+## Triển khai bằng Docker
+
+### Điều kiện tiên quyết
+
+- Đã cài đặt [Docker](https://docs.docker.com/get-docker/) (Phiên bản 20.10+)
+
+### Cách 1: Triển khai trực tuyến
+
+Đang hoàn thiện, tạm thời sử dụng cách Build tại máy (Local build).
+
+### Cách 2: Build tại máy (Local build)
+
+Sử dụng mã nguồn có sẵn để build trực tiếp. Phù hợp với lập trình viên hoặc người dùng đã clone repository. (Yêu cầu cài đặt git trên máy):
+
+```shell
+# Clone dự án (Bỏ qua nếu đã clone)
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+
+# Sử dụng docker-compose để build và chạy
+yarn docker:local
+
+# Hoặc build thủ công
+docker build -t toonflow .
+docker run -d -p :10588 -v <Đường dẫn dữ liệu trên máy>:/app/data toonflow
+
+# Sau đó, truy cập giao diện qua đường dẫn /web/index.html bằng Port đã thiết lập
+# Ví dụ: http://localhost:10588/web/index.html
+```
+
+### Cấu hình Cổng dịch vụ (Port)
+
+| Cổng (Port) | Chức năng | Port Mapping |
+| ------- | -------- | ------------- |
+| `10588` | Giao diện phần mềm | `10588:10588` |
+
+**Giải thích Biến môi trường:**
+
+| Biến (Variable) | Giải thích |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | Môi trường chạy, `prod` là môi trường Product (sản xuất) |
+| `PORT` | Port lắng nghe của dịch vụ (Mặc định: 10588) |
+| `OSSURL` | Địa chỉ truy cập lưu trữ file, dùng cho các tài nguyên tĩnh (Static) |
+
+---
+
+## Triển khai trên Máy chủ Đám mây (Cloud)
+
+### 1. Yêu cầu Môi trường Máy chủ
+
+- **Hệ điều hành**: Ubuntu 20.04+ / CentOS 7+
+- **Node.js**: 24.x (Khuyên dùng, Tối thiểu 23.11.1+)
+- **RAM**: 2GB+
+
+### 2. Triển khai Máy chủ
+
+#### 1. Cài đặt Môi trường
+
+```bash
+# Cài đặt Node.js
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+source ~/.bashrc
+nvm install 24
+# Cài đặt Yarn và PM2
+npm install -g yarn pm2
+```
+
+#### 2. Triển khai Dự án
+
+**Clone từ GitHub:**
+
+```bash
+cd /opt
+git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+**Clone từ Gitee (Khuyên dùng tại TQ):**
+
+```bash
+cd /opt
+git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+cd Toonflow-app
+yarn install
+yarn build
+```
+
+#### 3. Cấu hình PM2
+
+Tạo tệp `pm2.json`:
+
+```json
+{
+ "name": "toonflow-app",
+ "script": "data/serve/app.js",
+ "instances": "max",
+ "exec_mode": "cluster",
+ "env": {
+ "NODE_ENV": "prod",
+ "PORT": 10588,
+ "OSSURL": "http://127.0.0.1:10588/"
+ }
+}
+```
+
+**Giải thích Biến môi trường:**
+
+| Biến (Variable) | Giải thích |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | Môi trường chạy, `prod` là môi trường Product |
+| `PORT` | Cổng lắng nghe của dịch vụ (Port) |
+| `OSSURL` | Địa chỉ truy cập lưu trữ file, dùng cho tài nguyên tĩnh |
+
+---
+
+#### 4. Khởi chạy Dịch vụ
+
+```bash
+pm2 start pm2.json
+pm2 startup
+pm2 save
+```
+
+#### 5. Các lệnh PM2 thường dùng
+
+```bash
+pm2 list # Xem danh sách tiến trình
+pm2 logs toonflow-app # Xem log (nhật ký)
+pm2 restart all # Khởi động lại dịch vụ
+pm2 monit # Mở bảng điều khiển giám sát
+```
+
+> ⚠️ **Đăng nhập lần đầu**
+> Tài khoản: `admin`
+> Mật khẩu: `admin123`
+
+#### 6. Triển khai trang web Frontend
+
+Nếu bạn cần triển khai riêng hoặc tùy chỉnh giao diện Frontend, vui lòng tham khảo Repository Frontend:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+> 💡 **Lưu ý**: Repository này đã được tích hợp sẵn tài nguyên Frontend đã build. Người dùng thông thường không cần tự triển khai Frontend riêng. Repository Frontend chỉ dành cho các nhà phát triển muốn tùy chỉnh chuyên sâu.
+
+---
+
+# 🔧 Hướng dẫn Quy trình Phát triển (Development Workflow)
+
+> [!CAUTION]
+> 🚧 **Quy định nộp PR (Pull Request)** 🚧
+>
+> ⛔ Nhánh `master` KHÔNG chấp nhận bất kỳ PR nào ｜ ✅ Vui lòng gửi PR vào nhánh `develop`
+>
+> Chào mừng các nhà phát triển tham gia đóng góp cho Toonflow. Nếu có hứng thú, vui lòng liên hệ với quản trị viên ACT trong nhóm giao lưu.
+
+## 🛠️ Công nghệ sử dụng (Tech Stack)
+
+| Phân loại | Công nghệ |
+| ---------- | ----------------------------------------------------------------------------------------- |
+| Môi trường | Node.js 23.11.1+ |
+| Ngôn ngữ | TypeScript 5.x |
+| Backend | Express 5 |
+| Cơ sở dữ liệu | SQLite (better-sqlite3 / knex) |
+| Tích hợp AI| Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Qwen / xAI) |
+| Suy luận Local| @huggingface/transformers (ONNX) |
+| Real-time | Socket.IO |
+| Ứng dụng Desktop | Electron 40 |
+| Xử lý ảnh | Sharp |
+| Container | Docker |
+
+## Chuẩn bị Môi trường Phát triển
+
+- **Node.js**: Yêu cầu phiên bản 23.11.1 trở lên
+- **Yarn**: Khuyến nghị sử dụng làm Package Manager
+
+## Khởi chạy Dự án nhanh
+
+1. **Clone dự án**
+
+ **Clone từ GitHub:**
+
+ ```bash
+ git clone https://github.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+ **Clone từ Gitee:**
+
+ ```bash
+ git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
+ cd Toonflow-app
+ ```
+
+2. **Cài đặt Dependencies**
+
+ Chạy lệnh sau tại thư mục gốc của dự án:
+
+ ```bash
+ yarn install
+ ```
+
+3. **Khởi chạy môi trường Dev**
+
+ Dự án bao gồm **Backend API** và **Trang Frontend**. Tùy nhu cầu mà chọn cách khởi chạy:
+
+ - **Cách 1: Chỉ chạy Backend API**
+
+ ```bash
+ yarn dev
+ ```
+
+ > ⚠️ Lệnh này chỉ khởi chạy Backend API (Port 10588), không bao gồm giao diện Frontend. Khi truy cập http://localhost:10588 chỉ có thể gọi API. Nếu muốn sử dụng giao diện, vui lòng chạy Frontend riêng hoặc dùng chế độ GUI bên dưới.
+
+ - **Cách 2: Khởi chạy Client Desktop Electron (Khuyên dùng)**
+
+ ```bash
+ yarn dev:gui
+ ```
+
+ > Lệnh này sẽ chạy đồng thời Backend và cửa sổ Desktop Electron với giao diện Frontend đã tích hợp sẵn. Mở lên là có thể sử dụng ngay mà không cần cấu hình thêm. Phù hợp nhất cho lập trình viên muốn trải nghiệm toàn bộ tính năng.
+
+ - **Cách 3: Chạy ở chế độ Product (Sản xuất)**
+
+ ```bash
+ yarn start
+ ```
+
+ > Chạy trực tiếp dịch vụ sau khi đã build (Cần chạy lệnh yarn build trước).
+
+4. **Đóng gói dự án (Build / Pack)**
+
+ - Biên dịch tệp TypeScript:
+
+ ```bash
+ yarn build
+ ```
+
+ - Đóng gói thành tệp thực thi cho Windows:
+
+ ```bash
+ yarn dist:win
+ ```
+
+ - Đóng gói thành tệp thực thi cho MacOS:
+
+ ```bash
+ yarn dist:mac
+ ```
+
+ - Đóng gói thành tệp thực thi cho Linux:
+
+ ```bash
+ yarn dist:linux
+ ```
+
+5. **Kiểm tra chất lượng mã (Lint)**
+
+ - Kiểm tra cú pháp và quy chuẩn toàn cục:
+
+ ```bash
+ yarn lint
+ ```
+
+6. **Bảng điều khiển Debug AI (Tùy chọn)**
+
+ Mở công cụ Debug trực quan của AI SDK để tiện theo dõi các lời gọi AI:
+
+ ```bash
+ yarn debug:ai
+ ```
+
+## Phát triển Frontend
+
+Nếu bạn cần chỉnh sửa giao diện Frontend, vui lòng chuyển sang kho lưu trữ Frontend riêng:
+
+- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
+- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
+
+Sau khi build Frontend xong, hãy copy toàn bộ thư mục dist vào thư mục data/web của dự án này để tích hợp.
+
+## Cấu trúc Dự án
+
+```
+📂 build/ # Sản phẩm sau khi build
+📂 data/ # Dữ liệu Runtime
+│ ├─ 📂 models/ # Mô hình suy luận Local (ONNX)
+│ ├─ 📂 oss/ # Lưu trữ Object (ảnh, nhân vật, cảnh)
+│ ├─ 📂 serve/ # Cổng vào môi trường Production
+│ ├─ 📂 skills/ # Prompt kỹ năng của Agent
+│ └─ 📂 web/ # Frontend đã build (tích hợp sẵn)
+📂 docs/ # Tài liệu và hình ảnh
+📂 env/ # Cấu hình môi trường
+📂 scripts/ # Script hỗ trợ và Build
+📂 src/
+├─ 📂 agents/ # Module AI Agent
+│ ├─ 📂 productionAgent/ # Agent Sản xuất (Production)
+│ └─ 📂 scriptAgent/ # Agent Kịch bản (Script)
+├─ 📂 lib/ # Thư viện chung (Khởi tạo Database, định dạng Response)
+├─ 📂 middleware/ # Middleware
+├─ 📂 routes/ # Các Module Routing
+│ ├─ 📂 agents/ # Quản lý bộ nhớ Agent
+│ ├─ 📂 artStyle/ # Quản lý phong cách nghệ thuật
+│ ├─ 📂 assets/ # Quản lý tài nguyên (Assets)
+│ ├─ 📂 assetsGenerate/ # Trình tạo tài nguyên
+│ ├─ 📂 cornerScape/ # Quản lý phân cảnh (Storyboard)
+│ ├─ 📂 general/ # API chung
+│ ├─ 📂 login/ # Xác thực đăng nhập
+│ ├─ 📂 migrate/ # Di chuyển dữ liệu (Migration)
+│ ├─ 📂 modelSelect/ # Chọn mô hình
+│ ├─ 📂 novel/ # Quản lý tiểu thuyết
+│ ├─ 📂 other/ # Các tính năng khác
+│ ├─ 📂 production/ # Quản lý sản xuất / dựng phim
+│ ├─ 📂 project/ # Quản lý dự án
+│ ├─ 📂 script/ # Tạo kịch bản
+│ ├─ 📂 scriptAgent/ # Interface của Agent kịch bản
+│ ├─ 📂 setting/ # Cài đặt hệ thống
+│ ├─ 📂 task/ # Quản lý tác vụ (Task)
+│ └─ 📂 test/ # API thử nghiệm (Test)
+├─ 📂 socket/ # Giao tiếp Real-time qua WebSocket
+├─ 📂 types/ # Khai báo Type của TypeScript
+├─ 📂 utils/ # Các hàm tiện ích
+├─ 📄 app.ts # Entry của ứng dụng
+├─ 📄 core.ts # Khởi tạo Core
+├─ 📄 env.ts # Xử lý biến môi trường
+├─ 📄 err.ts # Xử lý lỗi (Error handling)
+├─ 📄 logger.ts # Module ghi log (Logger)
+├─ 📄 router.ts # Đăng ký Router
+└─ 📄 utils.ts # Công cụ chung
+📄 Dockerfile # Tệp cấu hình Build Docker
+📄 electron-builder.yml # Cấu hình đóng gói Electron
+📄 skillList.json # Danh sách kỹ năng
+📄 LICENSE # Giấy phép (Apache-2.0)
+📄 NOTICES.txt # Khai báo thư viện bên thứ ba
+📄 package.json # Cấu hình dự án
+📄 tsconfig.json # Cấu hình TypeScript
+```
+
+---
+
+# 🔗 Các Kho lưu trữ Liên quan
+
+| Repository (Kho) | Mô tả | GitHub | Gitee |
+| ---------------- | ---------------------------------- | -------------------------------------------------- | ------------------------------------------------ |
+| **Toonflow-app** | Client hoàn chỉnh (Repo này, khuyến nghị cho người dùng) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) |
+| **Toonflow-web** | Mã nguồn Frontend (Dành cho lập trình viên Frontend) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) |
+
+> 💡 **Mẹo nhỏ**: Nếu bạn chỉ muốn sử dụng Toonflow, hãy tải Client hoàn chỉnh từ kho này là đủ. Kho Toonflow-web chỉ dành cho các nhà phát triển cần chỉnh sửa hoặc phát triển lại giao diện (secondary development).
+
+---
+
+# 👨👩👧👦 Nhóm Discord Cộng đồng
+
+Nhấn vào biểu tượng bên dưới để tham gia Discord:
+
+[](https://discord.gg/HEjKmpNpAZ)
+
+Hoặc click trực tiếp vào link: [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
+
+---
+
+# 💌 Liên hệ với chúng tôi
+
+📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow%20%C6%B0%C9%9B)
+
+---
+
+# 📜 Giấy phép (License)
+
+Toonflow được phát hành mã nguồn mở dưới giấy phép Apache-2.0, kèm theo Thỏa thuận thương mại bổ sung.
+
+Chi tiết giấy phép Apache-2.0: https://www.apache.org/licenses/LICENSE-2.0
+
+## Thỏa thuận bổ sung
+
+- Nếu phần mềm này được phân phối dưới dạng sản phẩm cho **2 hoặc nhiều bên thứ ba độc lập** sử dụng, bắt buộc phải có **giấy phép thương mại bằng văn bản** từ HBAI-Ltd.
+- Nếu **≤ 5 pháp nhân** hợp tác vận hành để sử dụng nội bộ và không cung cấp dịch vụ ra bên ngoài, thì được coi là sử dụng nội bộ và **không cần cấp phép**.
+- Không được phép xóa hoặc sửa đổi logo hoặc thông tin bản quyền trong Toonflow.
+
+## Các trường hợp Miễn phí Vĩnh viễn
+
+- ✅ Dùng Toonflow để sản xuất nội dung và nhận chia sẻ doanh thu từ các nền tảng video
+- ✅ Chỉnh sửa mã nguồn (Secondary development) để dùng cho nhóm nội bộ
+- ✅ ≤ 5 pháp nhân hợp tác vận hành để sử dụng nội bộ
+- ✅ Phục vụ học tập cá nhân, nghiên cứu và các mục đích phi thương mại
+
+## Bảng giá Cấp phép Thương mại
+
+| Giai đoạn | Doanh thu Hàng năm | Phí Hàng năm |
+|------|---------|------|
+| 🌱 Ươm mầm | < ¥100k (RMB) | **Miễn phí** |
+| 🚀 Khởi nghiệp | ¥100k – 500k (RMB) | ¥5,000 / Năm |
+| 📈 Tăng trưởng | ¥500k – 1.5M (RMB) | ¥20,000 / Năm |
+| 🏢 Quy mô | ¥1.5M – 5M (RMB) | ¥80,000 / Năm |
+| 🌐 Doanh nghiệp | > ¥5M (RMB) | Thương lượng |
+
+> **Điều khoản Không hồi tố**: Những người dùng đã sử dụng Toonflow dưới giấy phép AGPL-3.0 trước khi phát hành phiên bản v1.0.8 sẽ tiếp tục tuân theo AGPL-3.0 và không bị ràng buộc bởi sự thay đổi thỏa thuận này.
+
+Xem toàn bộ thỏa thuận tại tệp [LICENSE](./LICENSE).
+
+---
+
+# ⭐️ Lịch sử Thả sao (Star History)
+
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
+
+---
+
+
+# 🙏 Lời Cảm ơn
+
+Xin cảm ơn các dự án mã nguồn mở sau đây đã hỗ trợ đắc lực cho Toonflow:
+
+- [Express](https://expressjs.com/) - Web framework cho Node.js cực nhanh và tối giản
+- [AI SDK](https://ai-sdk.dev/) - Bộ công cụ AI dành cho TypeScript
+- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - Thư viện liên kết SQLite3 hiệu suất cao
+- [Sharp](https://sharp.pixelplumbing.com/) - Thư viện xử lý hình ảnh Node.js hiệu suất cao
+- [Axios](https://axios-http.com/) - HTTP client dựa trên Promise
+- [Zod](https://zod.dev/) - Thư viện xác thực Schema ưu tiên TypeScript
+- [Socket.IO](https://socket.io/) - Công cụ giao tiếp sự kiện hai chiều thời gian thực
+- [Electron](https://www.electronjs.org/) - Framework phát triển ứng dụng Desktop đa nền tảng
+- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - Thư viện suy luận Machine Learning tại Local
+
+Xin cảm ơn các tổ chức/đơn vị/cá nhân sau đây đã hỗ trợ cho Toonflow:
+
+
+
+
+ | Logo |
+ Tên |
+ Hình thức hỗ trợ |
+ Mô tả |
+ Website |
+
+
+
+
+ |
+ Sophnet |
+ 💻 Tài trợ điện toán |
+ Nền tảng API suy luận mô hình một cửa, nhanh hơn, ổn định hơn và tiết kiệm hơn |
+ Website |
+
+
+ |
+ Atlas Cloud |
+ 💻 Tài trợ điện toán |
+ Nền tảng suy luận đa phương thức đầu tiên trên thế giới. Chat, hình ảnh, video, âm thanh — tất cả qua một API thống nhất. 300+ mô hình, tương thích OpenAI. |
+ Website |
+
+
+ |
+ Tencent Hunyuan3D |
+ 🌐 Hỗ trợ kỹ thuật World Model |
+ Tencent Hunyuan3D AI Creation Engine dựa trên mô hình Tencent Hunyuan3D 2.5 — nền tảng tạo nội dung 3D AI tích hợp đầu tiên trong ngành. Hỗ trợ text-to-3D, image-to-3D, tạo hoạt hình 3D, tạo kết cấu, sketch-to-3D và tạo nhân vật 3D, với lợi thế trong tạo mô hình low-poly. |
+ Website |
+
+
+
+
+Vui lòng xem danh sách đầy đủ các thư viện phụ thuộc của bên thứ ba trong tệp `NOTICES.txt`.
+
+##### Copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/docs/QR.png b/docs/QR.png
index d7eaba9..51e0640 100644
Binary files a/docs/QR.png and b/docs/QR.png differ
diff --git a/docs/README.en.md b/docs/README.en.md
index 50515ba..af70f6b 100644
--- a/docs/README.en.md
+++ b/docs/README.en.md
@@ -1,3 +1,5 @@
+
+
@@ -48,11 +50,49 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
> 🚀 **All-in-One Short Drama Studio**: From text to characters, from storyboard to final video.
> Fully AI-powered workflow with zero barrier to entry — boosting your creative efficiency by 10x or more!
+
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## Demo Information
+
+| Item | Details |
+|------|---------|
+| Production Period | ~2 hours |
+| Video Model | Seedance 2.0 |
+| Image Model | GPT Image 2 |
+| Language Model | Claude Opus 4.6 |
+| Runtime | ~2 min (raw footage 3 min, ~1 min removed) |
+
+## Cost Breakdown
+
+| Item | Cost |
+|------|------|
+| Images (270 pics × ¥0.04) | ¥10.8 |
+| Videos (45 clips × ¥3.5) | ¥157.5 |
+| Total | **~¥168** |
+
+> 📌 Demo original resolution is 1080×1882, published version compressed to 480p. For copyright concerns, please contact us at [ltlctools@outlook.com](mailto:ltlctools@outlook.com).
+
+## Demo Video
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> If the video doesn't play, [click here to download](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9).
+
+---
+
# 🚀 Installation
## Prerequisites
@@ -563,10 +658,13 @@ For the full agreement, please refer to the [LICENSE](./LICENSE) file.
# ⭐️ Star History
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
---
+
# 🙏 Acknowledgements
We sincerely thank the following open-source projects for providing robust support to Toonflow:
@@ -620,4 +718,6 @@ Thanks to the following organizations/individuals for supporting Toonflow:
For a complete list of third-party dependencies, please refer to `NOTICES.txt`.
-##### Copyright © Beijing AIA Network Technology Co., Ltd.
\ No newline at end of file
+##### Copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/docs/README.ja.md b/docs/README.ja.md
index b1adf3e..98b6501 100644
--- a/docs/README.ja.md
+++ b/docs/README.ja.md
@@ -1,3 +1,5 @@
+
+
@@ -48,11 +50,49 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
> 🚀 **オールインワン制作環境**：テキストからキャラクター、絵コンテから動画まで。
専門知識ゼロでも全プロセスをAIが**アシスト**し、創作効率を10倍以上に引き上げます！
+
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## デモ情報
+
+| 項目 | 詳細 |
+|------|------|
+| 制作期間 | 約2時間 |
+| 動画モデル | Seedance 2.0 |
+| 画像モデル | GPT Image 2 |
+| 言語モデル | Claude Opus 4.6 |
+| 尺 | 約2分（素材3分、約1分カット）|
+
+## コスト内訳
+
+| 項目 | 費用 |
+|------|------|
+| 画像（270枚 × ¥0.04）| ¥10.8 |
+| 動画（45クリップ × ¥3.5）| ¥157.5 |
+| 合計 | **約¥168** |
+
+> 📌 デモ動画の原解像度は1080×1882、公開版は480pに圧縮済みです。著作権に関するお問い合わせは [ltlctools@outlook.com](mailto:ltlctools@outlook.com) までご連絡ください。
+
+## デモ動画
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> 再生できない場合は[こちらからダウンロード](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9)してください。
+
+---
+
# 🚀 インストール
## 必須環境（前提条件）
@@ -554,10 +649,13 @@ Toonflow は Apache-2.0 ライセンスに基づいてオープンソースと
# ⭐️ Star 獲得履歴
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
---
+
# 🙏 謝辞
Toonflow に強力なサポートを提供してくださる以下のオープンソースプロジェクトに感謝いたします：
@@ -611,4 +709,6 @@ Toonflow を支援してくださる以下の組織・団体・個人に感謝
完全なサードパーティの依存関係リストについては `NOTICES.txt` をご参照ください。
-##### copyright © Beijing AIA Network Technology Co., Ltd.
\ No newline at end of file
+##### copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/docs/README.ru.md b/docs/README.ru.md
index fd44dcc..2fbdc18 100644
--- a/docs/README.ru.md
+++ b/docs/README.ru.md
@@ -1,3 +1,5 @@
+
+
@@ -48,10 +50,48 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
> 🚀 **All-in-One платформа для коротких сериалов и фильмов**: От текста до персонажей, от раскадровки до готового видео. Полная автоматизация с помощью ИИ с нулевым порогом входа — повышает эффективность творчества в 10 раз и более!
+
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## Информация о демо
+
+| Пункт | Подробности |
+|-------|------------|
+| Период производства | ~2 часа |
+| Модель видео | Seedance 2.0 |
+| Модель изображений | GPT Image 2 |
+| Языковая модель | Claude Opus 4.6 |
+| Хронометраж | ~2 мин (исходный материал 3 мин, ~1 мин удалено)|
+
+## Разбивка затрат
+
+| Пункт | Стоимость |
+|-------|-----------|
+| Изображения (270 шт. × ¥0.04) | ¥10.8 |
+| Видео (45 клипов × ¥3.5) | ¥157.5 |
+| Итого | **~¥168** |
+
+> 📌 Исходное разрешение демо-видео — 1080×1882, опубликованная версия сжата до 480p. По вопросам авторских прав обращайтесь: [ltlctools@outlook.com](mailto:ltlctools@outlook.com).
+
+## Демо-видео
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> Если видео не воспроизводится, [нажмите для скачивания](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9).
+
+---
+
# 🚀 Установка
## Предварительные требования
@@ -565,10 +660,13 @@ Toonflow распространяется как open-source проект под
# ⭐️ История звезд (Star History)
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
---
+
# 🙏 Благодарности
Выражаем благодарность следующим open-source проектам за мощную поддержку Toonflow:
@@ -622,4 +720,6 @@ Toonflow распространяется как open-source проект под
Полный список зависимостей третьих сторон находится в файле `NOTICES.txt`.
-##### copyright © Beijing AIA Network Technology Co., Ltd.
\ No newline at end of file
+##### copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/docs/README.th.md b/docs/README.th.md
index ade2b15..3e1a3e8 100644
--- a/docs/README.th.md
+++ b/docs/README.th.md
@@ -1,3 +1,5 @@
+
+
@@ -48,10 +50,48 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
> 🚀 **สตูดิโอภาพยนตร์สั้น All-in-One**: จากข้อความสู่ตัวละคร จากสตอรี่บอร์ดสู่ภาพยนตร์ ใช้ AI อัตโนมัติทั้งกระบวนการ ไม่ต้องมีพื้นฐานใด ๆ เพิ่มประสิทธิภาพการสร้างสรรค์มากกว่า 10 เท่า!
+
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## ข้อมูล Demo
+
+| รายการ | รายละเอียด |
+|--------|-----------|
+| ระยะเวลาผลิต | ประมาณ 2 ชั่วโมง |
+| โมเดลวิดีโอ | Seedance 2.0 |
+| โมเดลรูปภาพ | GPT Image 2 |
+| โมเดลภาษา | Claude Opus 4.6 |
+| ความยาว | ประมาณ 2 นาที (ต้นฉบับ 3 นาที ตัดออกประมาณ 1 นาที)|
+
+## รายละเอียดต้นทุน
+
+| รายการ | ค่าใช้จ่าย |
+|--------|-----------|
+| รูปภาพ (270 รูป × ¥0.04) | ¥10.8 |
+| วิดีโอ (45 คลิป × ¥3.5) | ¥157.5 |
+| รวม | **~¥168** |
+
+> 📌 Demo มีความละเอียดต้นฉบับ 1080×1882 บีบอัดเป็น 480p สำหรับเวอร์ชันที่เผยแพร่ หากมีปัญหาด้านลิขสิทธิ์ กรุณาติดต่อ [ltlctools@outlook.com](mailto:ltlctools@outlook.com)
+
+## วิดีโอตัวอย่าง
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> หากวิดีโอไม่เล่น [คลิกที่นี่เพื่อดาวน์โหลด](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9)
+
+---
+
# 🚀 การติดตั้ง
## ข้อกำหนดเบื้องต้น
@@ -564,10 +659,13 @@ Toonflow เปิดเผยเป็นโอเพ่นซอร์สภ
# ⭐️ ประวัติการให้ดาว (Star History)
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
---
+
# 🙏 ขอขอบคุณ
ขอขอบคุณโปรเจกต์โอเพ่นซอร์สต่อไปนี้ที่ช่วยสนับสนุน Toonflow อย่างมาก:
@@ -621,4 +719,6 @@ Toonflow เปิดเผยเป็นโอเพ่นซอร์สภ
รายการ Third-party Dependencies แบบสมบูรณ์ สามารถดูได้ที่ไฟล์ `NOTICES.txt`
-##### copyright © Beijing AIA Network Technology Co., Ltd.
\ No newline at end of file
+##### copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/docs/README.vi.md b/docs/README.vi.md
index 10d635c..fba0cb4 100644
--- a/docs/README.vi.md
+++ b/docs/README.vi.md
@@ -1,3 +1,5 @@
+
+
@@ -48,10 +50,48 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
> 🚀 **Dự án Phim ngắn All-in-One**: Từ văn bản đến nhân vật, từ storyboard đến video hoàn chỉnh. Tự động hóa toàn bộ quy trình bằng AI – không rào cản, tăng hiệu suất sáng tạo lên gấp 10 lần!
+
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## Thông tin Demo
+
+| Mục | Chi tiết |
+|-----|---------|
+| Thời gian sản xuất | ~2 giờ |
+| Mô hình video | Seedance 2.0 |
+| Mô hình hình ảnh | GPT Image 2 |
+| Mô hình ngôn ngữ | Claude Opus 4.6 |
+| Thời lượng | ~2 phút (tư liệu gốc 3 phút, cắt ~1 phút)|
+
+## Chi tiết Chi phí
+
+| Mục | Chi phí |
+|-----|---------|
+| Hình ảnh (270 ảnh × ¥0.04) | ¥10.8 |
+| Video (45 clip × ¥3.5) | ¥157.5 |
+| Tổng | **~¥168** |
+
+> 📌 Độ phân giải gốc của Demo là 1080×1882, phiên bản phát hành đã nén xuống 480p. Nếu có vấn đề bản quyền, vui lòng liên hệ [ltlctools@outlook.com](mailto:ltlctools@outlook.com).
+
+## Video Demo
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> Nếu video không phát được, [click để tải xuống](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9).
+
+---
+
# 🚀 Cài đặt
## Điều kiện tiên quyết
@@ -549,10 +644,13 @@ Xem toàn bộ thỏa thuận tại tệp [LICENSE](./LICENSE).
# ⭐️ Lịch sử Thả sao (Star History)
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
---
+
# 🙏 Lời Cảm ơn
Xin cảm ơn các dự án mã nguồn mở sau đây đã hỗ trợ đắc lực cho Toonflow:
@@ -606,4 +704,6 @@ Xin cảm ơn các tổ chức/đơn vị/cá nhân sau đây đã hỗ trợ ch
Vui lòng xem danh sách đầy đủ các thư viện phụ thuộc của bên thứ ba trong tệp `NOTICES.txt`.
-##### Copyright © Beijing AIA Network Technology Co., Ltd.
\ No newline at end of file
+##### Copyright © Beijing AIA Network Technology Co., Ltd.
+
+
\ No newline at end of file
diff --git a/docs/README.zhtw.md b/docs/README.zhtw.md
index 433e6e8..6938d21 100644
--- a/docs/README.zhtw.md
+++ b/docs/README.zhtw.md
@@ -1,3 +1,5 @@
+
+
@@ -48,10 +50,48 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
> 🚀 **一站式短劇工程**：從文字到角色，從分鏡到影片，0 門檻全流程 AI 化，創作效率提升 10 倍+！
+
+
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+ |
+ |
+
+
+
+## Demo 資訊
+
+| 項目 | 詳情 |
+|------|------|
+| 製作週期 | 約 2 小時 |
+| 影片模型 | Seedance 2.0 |
+| 圖像模型 | GPT Image 2 |
+| 語言模型 | Claude Opus 4.6 |
+| 時長 | 約 2 分鐘（原始素材 3 分鐘，剪除約 1 分鐘）|
+
+## 成本明細
+
+| 項目 | 費用 |
+|------|------|
+| 圖像（270 張 × ¥0.04）| ¥10.8 |
+| 影片（45 段 × ¥3.5）| ¥157.5 |
+| 合計 | **約 ¥168** |
+
+> 📌 Demo 原始解析度為 1080×1882，發布版本已壓縮至 480p。如涉及版權問題，請通過 [ltlctools@outlook.com](mailto:ltlctools@outlook.com) 聯繫我們處理。
+
+## Demo 影片
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+> 若影片無法播放，請[點此下載](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9)。
+
+---
+
# 🚀 安裝
## 前置條件
@@ -557,10 +652,13 @@ Toonflow 基於 Apache-2.0 協定開源發佈，並附有補充商業協議。
# ⭐️ Star 歷史
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
---
+
# 🙏 致謝
感謝以下開源專案為 Toonflow 提供強大支援：
@@ -614,4 +712,6 @@ Toonflow 基於 Apache-2.0 協定開源發佈，並附有補充商業協議。
完整的第三方相依性清單請查閱 `NOTICES.txt`
-##### copyright © 北京艾阿網絡科技有限公司
\ No newline at end of file
+##### copyright © 北京艾阿網絡科技有限公司
+
+
\ No newline at end of file
diff --git a/docs/screenshot/1.png b/docs/screenshot/1.png
new file mode 100644
index 0000000..b36ff71
Binary files /dev/null and b/docs/screenshot/1.png differ
diff --git a/docs/screenshot/10.png b/docs/screenshot/10.png
new file mode 100644
index 0000000..712c147
Binary files /dev/null and b/docs/screenshot/10.png differ
diff --git a/docs/screenshot/2.png b/docs/screenshot/2.png
new file mode 100644
index 0000000..082c766
Binary files /dev/null and b/docs/screenshot/2.png differ
diff --git a/docs/screenshot/3.png b/docs/screenshot/3.png
new file mode 100644
index 0000000..0794579
Binary files /dev/null and b/docs/screenshot/3.png differ
diff --git a/docs/screenshot/4.png b/docs/screenshot/4.png
new file mode 100644
index 0000000..7512596
Binary files /dev/null and b/docs/screenshot/4.png differ
diff --git a/docs/screenshot/5.png b/docs/screenshot/5.png
new file mode 100644
index 0000000..6630b82
Binary files /dev/null and b/docs/screenshot/5.png differ
diff --git a/docs/screenshot/6.png b/docs/screenshot/6.png
new file mode 100644
index 0000000..d2ec473
Binary files /dev/null and b/docs/screenshot/6.png differ
diff --git a/docs/screenshot/7.png b/docs/screenshot/7.png
new file mode 100644
index 0000000..499ddec
Binary files /dev/null and b/docs/screenshot/7.png differ
diff --git a/docs/screenshot/8.png b/docs/screenshot/8.png
new file mode 100644
index 0000000..d8180eb
Binary files /dev/null and b/docs/screenshot/8.png differ
diff --git a/docs/screenshot/9.png b/docs/screenshot/9.png
new file mode 100644
index 0000000..8b47bf5
Binary files /dev/null and b/docs/screenshot/9.png differ
+
+https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
+
+如无法播放，请[点击下载视频](./docs/screenshot/demo.mp4)
+
+
+
+## Demo 信息
+
+| 项目 | 详情 |
+| :--- | :--- |
+| 制作周期 | 约 2 小时 |
+| 视频模型 | Seedance 2.0 |
+| 图片模型 | GPT Image 2 |
+| 语言模型 | Claude Opus 4.6 |
+| 成片总时长 | 约 2 分钟（原始素材 3 分钟，剪除废片约 1 分钟） |
+
+## 成本明细
+
+| 模型类型 | 费用 |
+| :--- | :--- |
+| 语言模型 | 约 ¥10 |
+| 视频模型（全量生成） | 约 ¥120 |
+| 图片模型 | 不足 ¥1 |
+| **合计** | **约 ¥130** |
+
+> **声明**：Demo 原始分辨率为 1080×1882，发布版本已压缩至 480p。如涉及版权问题，请通过 [ltlctools@outlook.com](mailto:ltlctools@outlook.com) 联系我们处理。
+
+---
+
# 🚀 安装
## 前置条件
@@ -571,10 +664,13 @@ Toonflow 基于 Apache-2.0 协议开源发布，并附有补充商业协议。
# ⭐️ 星标历史
+[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
+
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
---
+
# 🙏 致谢
感谢以下开源项目为 Toonflow 提供强大支持：
@@ -629,3 +725,7 @@ Toonflow 基于 Apache-2.0 协议开源发布，并附有补充商业协议。
完整的第三方依赖清单请查阅 `NOTICES.txt`
##### copyright © 北京爱阿科技有限公司
+
+
+
+