- Atomgit
+
+也可以点击图标加入 Discord：
+
+[](https://discord.gg/HEjKmpNpAZ)
+
+或点击邀请连接： [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
+
---
# 💌 联系我们
diff --git a/docs/README.en.md b/docs/README.en.md
index 02ee01d..a9be70f 100644
--- a/docs/README.en.md
+++ b/docs/README.en.md
@@ -8,18 +8,17 @@
|
-
- Atomgit
+
- 简体中文 | + 简体中文 | 繁體中文 | English | ไทย | Tiếng Việt | - 日本語 | + 日本語 | Русский
@@ -33,9 +32,9 @@ AI Short Drama Factory@@ -50,49 +49,57 @@
- > 🚀 **One-stop short drama production**: From text to characters, from storyboard to video, 0 barrier full-process AI, 10x+ creation efficiency! +> 🚀 **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! --- -# 🌐 Multilingual Support +# 🌐 Multi-Language Support Toonflow supports the following interface languages: -| Language | Native Name | -|----------|-------------| -| Chinese (Simplified) | 简体中文 | -| Chinese (Traditional) | 繁體中文 | +| Language | Language Name | +|------|----------| +| 简体中文 | Chinese (Simplified) | +| 繁體中文 | Chinese (Traditional) | | English | English | -| Thai | ไทย | -| Vietnamese | Tiếng Việt | -| Japanese | 日本語 | -| Russian | Русский | +| ไทย | Thai | +| Tiếng Việt | Vietnamese | +| 日本語 | Japanese | +| Русский | Russian | + +> 💡 More languages are on the way. Translation contributions are highly welcome! --- -# �🌟 Main Features +# 🌟 Main Features -Toonflow is an AI short drama comic tool that leverages AI technology to automatically convert novels into scripts, and uses AI-generated images and videos for efficient short drama creation. With Toonflow, you can easily complete the entire process from text to images, making short drama production more intelligent and convenient. +Toonflow is an AI-powered tool for creating short dramas, short films, and comics. It can automatically transform novels into scripts, then combine AI-generated characters, images, and videos to produce high-quality content efficiently. + +With Toonflow, you can complete the entire workflow from text to final video with ease — making short-form video and drama production significantly smarter and more convenient. - ✅ **Character Generation** - Automatically analyzes the original novel text, intelligently identifies and generates character settings, including appearance, personality, identity, etc., providing a reliable foundation for subsequent script and visual creation. + Automatically analyzes the original novel text, intelligently identifies key elements, and generates detailed character profiles including appearance, personality, background, and relationships — laying a strong foundation for scriptwriting and visual production. + - ✅ **Script Generation** - Based on selected events and chapters, the system automatically generates structured scripts, covering dialogue, scene descriptions, and plot direction, enabling efficient transformation from literary texts to film/TV scripts. -- ✅ **Storyboard Production** - Based on the script content, intelligently generates storyboard prompts and visual design, detailing foreground/midground/background, character dynamics, prop settings, and scene layout; automatically turns scripts into storyboards, providing a complete route blueprint for video production. -- ✅ **Video Composition** - Integrates AI image and video technologies to generate video clips using AI. Includes online editing and supports personalized output adjustments, making film & TV production collaborative and efficient. + Based on selected events and chapters, the system automatically creates well-structured scripts with natural dialogue, scene descriptions, and plot development, enabling efficient adaptation from literature to cinematic format. + +- ✅ **Storyboard Creation** + From the generated script, Toonflow intelligently creates storyboard prompts and visual layouts. It details foreground, midground, and background elements, character movements, props, and scene composition — providing a complete and ready-to-use blueprint for video production. + +- ✅ **Video Synthesis** + Integrates advanced AI image and video generation technologies to produce high-quality video clips. The built-in online editor allows flexible personalization and fine-tuning, making the entire creative process smooth, fast, and highly efficient. --- -# 📦 Application Scenarios +# 📦 Use Cases -- Short video content creation -- Novel-to-film/TV experiments -- AI literature adaptation tools +- Short video content creation (Shorts, Reels, TikTok) +- Novel-to-film / drama adaptation experiments +- AI-powered literary adaptation tool - Script development and rapid prototyping -- Video material generation +- Video asset and footage generation --- @@ -100,15 +107,15 @@ Toonflow is an AI short drama comic tool that leverages AI technology to automat ## 📺 Video Tutorial -https://www.bilibili.com/video/BV1na6wB6Ea2 -[](https://www.bilibili.com/video/BV1na6wB6Ea2) +[https://www.bilibili.com/video/BV1na6wB6Ea2](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) +**Toonflow: 8-Minute AI Video Quick Start** +👉 [Click to Watch](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e) -📱 Scan with WeChat on your phone to watch +📱 Scan the QR code to watch on mobile -
+
---
@@ -116,34 +123,34 @@ https://www.bilibili.com/video/BV1na6wB6Ea2
## Prerequisites
-Before installing and using this software, please prepare the following:
+Before installing and using Toonflow, please prepare the following:
-- ✅ Large language model AI service API address
-- ✅ Sora or Doubao video service API address
-- ✅ Nano Banana Pro image generation model service API
+- ✅ API endpoint for Large Language Model (LLM)
+- ✅ API endpoint for video generation services (Sora or Doubao)
+- ✅ API endpoint for image generation model (Nano Banana Pro)
## Local Installation
-### 1. Download & Install
+### 1. Download and Install
-| Operating System | GitHub | Atomgit | Quark Cloud Download | Description |
-| :--------------: | :------------------------------------------------------ | :---------------------------------------------------- | :------------------------------------------------------ | :-------------------- |
-| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Cloud](https://pan.quark.cn/s/94ef07509df0) | Official release package |
-| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Cloud](https://pan.quark.cn/s/94ef07509df0) | Official release package |
-| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Cloud](https://pan.quark.cn/s/94ef07509df0) | Official release package |
+| OS | GitHub | Atomgit | Quark Drive Download | Description |
+| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
+| 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) | Official Installer |
+| 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) | Official Installer |
+| 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) | Official Installer |
> [!CAUTION]
-> On MacOS, please go to Settings - Privacy & Security to configure security settings, otherwise, you may not be able to open the app due to certificate issues.
+> **MacOS Users:** Please go to `System Settings > Privacy & Security` to allow the application to run; otherwise, it may fail to open due to certificate issues.
>
-> See Zhihu documentation: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+> Reference (Zhihu): [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
-> Due to Gitee OS environment and Release file upload size limits, Gitee Release download is currently not available.
+> Due to Gitee OS environment constraints and Release file size upload limits, Gitee Release download links are currently unavailable.
-### 2. Start Service
+### 2. Start the Service
-After installation, launch the program to start using this service.
+After installation, simply launch the program to start using the service.
-> ⚠️ **First-time Login**
+> ⚠️ **Default Login**
> Username: `admin`
> Password: `admin123`
@@ -151,45 +158,45 @@ After installation, launch the program to start using this service.
### Prerequisites
-- [Docker](https://docs.docker.com/get-docker/) installed (version 20.10+)
+- [Docker](https://docs.docker.com/get-docker/) installed (Version 20.10+)
### Method 1: Online Deployment
-To be developed; please use local build for now.
+To be updated. Please use local build for now.
### Method 2: Local Build
-Build directly from local source code, suitable for developers or users who have cloned the repo; requires Git installed locally:
+Build directly using the local source code. This is suitable for developers or users who have cloned the repository. You will need `git` installed locally:
```shell
-# Clone the project (skip if already cloned)
+# Clone the repository first (skip if already cloned)
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
-# Build and start locally with docker-compose
+# Build and start locally using docker-compose
yarn docker:local
# Or build manually
docker build -t toonflow .
-docker run -d -p 
+[](https://discord.gg/HEjKmpNpAZ)
+
+Or click the direct link: [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
---
# 💌 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 Apache-2.0 with a supplementary commercial agreement.
+Toonflow is open-sourced under the Apache-2.0 License with an additional supplementary commercial agreement.
License details: https://www.apache.org/licenses/LICENSE-2.0
-## Supplementary Agreement
+## Supplementary Commercial Agreement
-- If you distribute this software as a product to **2 or more independent third parties**, you must obtain **written commercial authorization** from HBAI-Ltd.
-- **≤ 5 legal entities** operating jointly for internal use without providing services externally are considered **internal use and require no authorization**.
-- You may not remove or modify any trademarks, logos, or copyright notices in Toonflow.
+- If this software is distributed as a product to **2 or more independent third parties**, a **written commercial license** from HBAI-Ltd is required.
+- Joint operation and internal use by **≤ 5 legal entities** (without providing services to external users) is considered internal use and **does not require a license**.
+- It is strictly prohibited to remove or modify any logos or copyright information within Toonflow.
-## Always Free — No Authorization Required
+## Forever Free Usage Scenarios
-- ✅ Using Toonflow to produce content and earn platform revenue shares
+- ✅ Using Toonflow to create content and earning revenue share from video platforms
- ✅ Secondary development for internal team use
-- ✅ ≤ 5 legal entities operating jointly, internally only
+- ✅ Joint/internal use by up to 5 legal entities
- ✅ Personal learning, research, and non-commercial purposes
-## Licensing Pricing
+## Commercial License Pricing
-| Stage | Annual Revenue | Annual Fee |
-|------|---------|------|
-| 🌱 Nurture | < $10k | **Free** |
-| 🚀 Startup | $10k–$50k | ¥5,000/year |
-| 📈 Growth | $50k–$150k | ¥20,000/year |
-| 🏢 Scale | $150k–$500k | ¥80,000/year |
-| 🌐 Enterprise | > $500k | Negotiable |
+| Phase | Annual Revenue | Annual Fee |
+|----------------|-------------------------|---------------------|
+| 🌱 Incubation | < $15,000 | **Free** |
+| 🚀 Startup | $15,000 – $75,000 | $750 / year |
+| 📈 Growth | $75,000 – $200,000 | $2,900 / year |
+| 🏢 Scale | $200,000 – $750,000 | $11,500 / year |
+| 🌐 Enterprise | > $750,000 | Negotiable |
-> **Non-Retroactivity Clause**: Users who used Toonflow under AGPL-3.0 prior to the v1.0.8 release are not affected by this change. Their existing usage continues under AGPL-3.0.
+> **Non-Retroactivity Clause**: Users who were using Toonflow under the AGPL-3.0 license before version v1.0.8 will continue to be governed by AGPL-3.0 and are not affected by this agreement change.
-See the full [LICENSE](../LICENSE) file for details.
+For the full agreement, please refer to the [LICENSE](./LICENSE) file.
---
@@ -555,34 +567,34 @@ See the full [LICENSE](../LICENSE) file for details.
---
-# 🙏 Thanks
+# 🙏 Acknowledgements
-Thank you to the following open-source projects for supporting Toonflow:
+We sincerely thank the following open-source projects for providing robust support to Toonflow:
-- [Express](https://expressjs.com/) - Fast, open, minimalist Node.js Web framework
-- [AI SDK](https://ai-sdk.dev/) - TypeScript-first AI toolkit
-- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - High-performance SQLite3 bindings
-- [Sharp](https://sharp.pixelplumbing.com/) - High-performance Node.js image toolkit
+- [Express](https://expressjs.com/) - Fast, unopinionated, minimalist web framework for Node.js
+- [AI SDK](https://ai-sdk.dev/) - The AI toolkit for TypeScript
+- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - High-performance SQLite3 binding library
+- [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 library
-- [Socket.IO](https://socket.io/) - Real-time bidirectional event framework
-- [Electron](https://www.electronjs.org/) - Cross-platform desktop app framework
-- [Hugging Face Transformers](https://huggingface.co./transformers.js) - Local ML inference library
+- [Zod](https://zod.dev/) - TypeScript-first schema validation
+- [Socket.IO](https://socket.io/) - Real-time bidirectional event-based communication
+- [Electron](https://www.electronjs.org/) - Cross-platform desktop application framework
+- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - State-of-the-art Machine Learning for the web
-Thanks to the following organizations/individuals for their support:
+Thanks to the following organizations/individuals for supporting Toonflow:
- 
+
|
- SophNet Cloud provides computing power sponsorship - [Official Website] + Sophnet for providing computing power sponsorship + [Website] |
+
- Atomgit
+
- 簡体字中国語 | - 繁体字中国語 | - 英語 | - タイ語 | - ベトナム語 | + 简体中文 | + 繁體中文 | + English | + ไทย | + Tiếng Việt | 日本語 | - ロシア語 + Русский
- AI短編ドラマ工場
+ AI ショートドラマ制作スタジオ
- 指先ひとつで、小説が瞬時にドラマ化！
+ 指先一つで、小説があっという間にドラマに！
AI脚本 × AI映像 × 超高速生成 🔥
@@ -50,173 +49,175 @@
+
---
# 🚀 インストール
-## 前提条件
+## 必須環境（前提条件）
-本ソフトウェアのインストール・利用前に以下をご用意ください：
+本ソフトウェアをインストールして使用する前に、以下の準備をお願いします：
-- ✅ 大規模言語モデルAIサービスのエンドポイント
-- ✅ SoraまたはDoubao動画サービスAPI
-- ✅ Nano Banana Pro画像生成モデルAPI
+- ✅ 大規模言語モデル (LLM) の AI サービス API エンドポイント
+- ✅ Sora または 豆包 (Doubao) の動画サービス API エンドポイント
+- ✅ Nano Banana Pro の画像生成モデルサービス API エンドポイント
-## ローカルインストール
+## ローカル環境へのインストール
-### 1. ダウンロード＆インストール
+### 1. ダウンロードとインストール
-| オペレーティングシステム | GitHub | Atomgit | クアークネットディスクダウンロード | 説明 |
+| OS | GitHub | Atomgit | Quark Drive | 説明 |
| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
-| Windows | [リリース](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [リリース](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [クアークネットディスク](https://pan.quark.cn/s/94ef07509df0) | 公式リリースインストールパッケージ |
-| Linux | [リリース](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [リリース](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [クアークネットディスク](https://pan.quark.cn/s/94ef07509df0) | 公式リリースインストールパッケージ |
-| macOS | [リリース](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [リリース](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [クアークネットディスク](https://pan.quark.cn/s/94ef07509df0) | 公式リリースインストールパッケージ |
+| 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) | 公式インストーラ |
+| 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) | 公式インストーラ |
+| 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) | 公式インストーラ |
> [!CAUTION]
-> MacOSの場合は、設定→プライバシーとセキュリティでセキュリティ設定を許可してください。証明書問題でアプリが開かない場合があります。
+> MacOS システムをご利用の場合、「システム設定」-「プライバシーとセキュリティ」からセキュリティ設定を行ってください。そうしないと、証明書の問題で正常に開けない場合があります。
>
-> 参考：知乎ドキュメント：[https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+> 参考ドキュメント（Zhihu）：[https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
-> Gitee OSの制限とReleaseファイルのサイズ上限により、Gitee側のReleaseダウンロードは現在未提供です。
+> Gitee OS 環境の制限および Release ファイルのアップロード容量制限により、現在 Gitee Release のダウンロードリンクは提供していません。
-### 2. サービス起動
+### 2. サービスの起動
-インストール後、アプリを起動してください。
+インストール完了後、プログラムを起動すればサービスを利用開始できます。
-> ⚠️ **初回ログイン**
-> アカウント：`admin`
+> ⚠️ **初回ログイン**
+> ユーザー名：`admin`
> パスワード：`admin123`
-## Dockerデプロイ
+## Docker を利用した導入
-### 前提条件
+### 必須環境
-- [Docker](https://docs.docker.com/get-docker/)（バージョン 20.10以上）インストール済み
+- [Docker](https://docs.docker.com/get-docker/) がインストール済みであること（バージョン 20.10+）
-### 方法1：オンラインデプロイ
+### 方法1：オンライン展開
-現在準備中。しばらくはローカルビルドをご利用ください。
+現在準備中です。一時的にローカルでのビルドをご利用ください。
-### 方法2：ローカルビルド
+### 方法2：ローカルでのビルド
-お手持ちのソースコードから直接ビルド。開発者またはリポジトリクローン済ユーザー向け（git要インストール）。
+既存のソースコードを使用して直接ビルドします。開発者やリポジトリをクローンしたユーザーに適しています（ローカルに git がインストールされている必要があります）：
```shell
-# まずプロジェクトをクローン（既にある場合は省略可）
+# まずプロジェクトをクローン（既に存在する場合はスキップ）
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
-# docker-composeでローカルビルド＆起動
+# docker-compose を使用してローカルでビルド・起動
yarn docker:local
-# または手動ビルド
+# または手動でビルド
docker build -t toonflow .
docker run -d -p <ローカルポート>:10588 -v <ローカルデータパス>:/app/data toonflow
-# 指定ポートの /web/index.html でアクセス可
-# 例）http://localhost:10588/web/index.html
+# これで指定したポートの /web/index.html にアクセスできます
+# 例: http://localhost:10588/web/index.html
```
-### サービスポート情報
+### サービスポートの説明
-| ポート | 用途 | デプロイマッピング |
+| ポート | 用途 | デプロイマッピング |
| ------- | -------- | ------------- |
-| `10588` | UI | `10588:10588` |
+| `10588` | ソフトウェア画面 | `10588:10588` |
-**環境変数メモ：**
+**環境変数の説明：**
-| 変数 | 説明 |
-| ------------ | -------------------------- |
-| `NODE_ENV` | 実行環境、`prod`が本番 |
-| `PORT` | サービスポート（デフォルト10588） |
-| `OSSURL` | ファイル保存URL（静的リソース） |
+| 変数名 | 説明 |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | 実行環境。`prod` は本番環境を示します |
+| `PORT` | サービスの待受ポート（デフォルト 10588） |
+| `OSSURL` | ファイルストレージのアクセスURL（静的リソース用） |
---
-## クラウドデプロイ
+## クラウド（サーバー）への導入
-### 1. サーバー環境要件
+### 1. サーバー環境の要件
-- **OS**：Ubuntu 20.04以上/CentOS 7以上
-- **Node.js**：24.x（推奨、最低23.11.1以上）
+- **OS**：Ubuntu 20.04+ / CentOS 7+
+- **Node.js**：24.x（推奨、最低 23.11.1+）
- **メモリ**：2GB以上
-### 2. サーバーデプロイ
+### 2. サーバーへの配置
-#### 1. 環境インストール
+#### 1. 環境構築
```bash
-# Node.jsインストール
+# Node.js のインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24
-# YarnとPM2インストール
+# Yarn と PM2 のインストール
npm install -g yarn pm2
```
-#### 2. プロジェクト導入
+#### 2. プロジェクトの配置
-**GitHubからクローン：**
+**GitHub からクローン：**
```bash
cd /opt
@@ -226,7 +227,7 @@ yarn install
yarn build
```
-**Giteeからクローン（中国国内推奨）：**
+**Gitee からクローン（中国国内推奨）：**
```bash
cd /opt
@@ -236,9 +237,9 @@ yarn install
yarn build
```
-#### 3. PM2構成
+#### 3. PM2 の設定
-`pm2.json`ファイルを作成：
+`pm2.json` ファイルを作成します：
```json
{
@@ -254,17 +255,17 @@ yarn build
}
```
-**環境変数説明：**
+**環境変数の説明：**
-| 変数 | 説明 |
-| ------------ | -------------------------- |
-| `NODE_ENV` | 実行環境、`prod`が本番 |
-| `PORT` | サービスポート |
-| `OSSURL` | ファイル保存URL（静的リソース） |
+| 変数名 | 説明 |
+| ---------- | ---------------------------------- |
+| `NODE_ENV` | 実行環境。`prod` は本番環境を示します |
+| `PORT` | サービスの待受ポート |
+| `OSSURL` | ファイルストレージのアクセスURL（静的リソース用） |
---
-#### 4. サービス起動
+#### 4. サービスの起動
```bash
pm2 start pm2.json
@@ -275,77 +276,77 @@ pm2 save
#### 5. よく使うコマンド
```bash
-pm2 list # プロセス一覧
-pm2 logs toonflow-app # ログを見る
-pm2 restart all # サービス再起動
-pm2 monit # 監視パネル
+pm2 list # プロセス一覧の確認
+pm2 logs toonflow-app # ログの確認
+pm2 restart all # サービスの再起動
+pm2 monit # 監視パネルの表示
```
-> ⚠️ **初回ログイン**
-> アカウント：`admin`
+> ⚠️ **初回ログイン**
+> ユーザー名：`admin`
> パスワード：`admin123`
-#### 6. フロントエンドのデプロイ
+#### 6. フロントエンドサイトの配置
-前端の分離デプロイやカスタマイズが必要な場合はこちら：
+フロントエンド画面を単独で配置、またはカスタマイズしたい場合は、フロントエンドのリポジトリを参照してください：
- **GitHub**：[Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
- **Gitee**：[Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
-> 💡 **補足**：このリポジトリにはビルド済のフロントリソースが内蔵済み。通常ユーザーはフロント分離構築は不要。フロントリポジトリはカスタム開発用です。
+> 💡 **補足**：本リポジトリには既にコンパイル済みのフロントエンド成果物が組み込まれているため、一般ユーザーはフロントエンドを個別に配置する必要はありません。フロントエンドのリポジトリは、二次開発を行う開発者向けです。
---
# 🔧 開発フローガイド
> [!CAUTION]
-> 🚧 **PR提出ガイドライン** 🚧
+> 🚧 **PR（プルリクエスト）提出のルール** 🚧
>
-> ⛔ `master`ブランチはPR不可 ｜ ✅ `develop`ブランチにPR提出
+> ⛔ `master` ブランチへの PR は受け付けていません ｜ ✅ PR は `develop` ブランチへ提出してください
>
-> 開発者のご参加を歓迎します。参加希望はコミュニティで主催者ACTにご連絡ください。
+> 開発者の皆様の Toonflow への共同参加を歓迎します。興味のある方は、交流グループ内で管理者の ACT までご連絡ください。
-## 🛠️ 技術スタック
+## 🛠️ 採用技術
-| カテゴリ | 技術 |
-| -------------- | ---------------------------------------------------------------------------------------- |
-| ランタイム | Node.js 23.11.1+ |
-| 言語 | TypeScript 5.x |
-| バックエンド | Express 5 |
-| データベース | SQLite（better-sqlite3 / knex） |
-| AI連携 | Vercel AI SDK（OpenAI / Anthropic / Google / DeepSeek / 智谱 / MiniMax / 通義千問 / xAI） |
-| ローカル推論 | @huggingface/transformers（ONNX） |
-| リアルタイム通信 | Socket.IO |
-| デスクトップ | Electron 40 |
-| 画像処理 | Sharp |
-| コンテナ化 | Docker |
+| カテゴリ | 技術 |
+| ---------- | ----------------------------------------------------------------------------------------- |
+| 実行環境 | Node.js 23.11.1+ |
+| 言語 | TypeScript 5.x |
+| バックエンド | Express 5 |
+| データベース | SQLite（better-sqlite3 / knex） |
+| AI 統合 | Vercel AI SDK（OpenAI / Anthropic / Google / DeepSeek / 智譜 / MiniMax / 通義千問 / xAI） |
+| ローカル推論 | @huggingface/transformers（ONNX） |
+| リアルタイム通信 | Socket.IO |
+| デスクトップアプリ | Electron 40 |
+| 画像処理 | Sharp |
+| コンテナ化 | Docker |
-## 開発環境準備
+## 開発環境の準備
-- **Node.js**：バージョン23.11.1以上
-- **Yarn**：パッケージマネージャ推奨
+- **Node.js**：バージョン 23.11.1 以上が必要
+- **Yarn**：プロジェクトのパッケージマネージャーとして推奨
-## プロジェクトのクイック起動
+## プロジェクトのクイックスタート
-1. **プロジェクトクローン**
+1. **プロジェクトのクローン**
- **GitHubからクローン：**
+ **GitHub からクローン：**
```bash
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
```
- **Giteeからクローン（中国国内推奨）：**
+ **Gitee からクローン（中国国内推奨）：**
```bash
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
```
-2. **依存パッケージインストール**
+2. **依存関係（パッケージ）のインストール**
- プロジェクト直下で次を実行：
+ プロジェクトのルートディレクトリで以下のコマンドを実行します：
```bash
yarn install
@@ -353,69 +354,69 @@ pm2 monit # 監視パネル
3. **開発環境の起動**
- 本プロジェクトは**バックエンドAPIサービス**と**フロントエンド**があります。次から用途を選択。
+ 本プロジェクトは **バックエンド API サービス** と **フロントエンド画面** の2つの部分を含みます。必要に応じて起動方法を選択してください：
- - **方法1：バックエンドのみ起動**
+ - **方法1：バックエンドサービスのみ起動**
```bash
yarn dev
```
- > ⚠️ このコマンドはAPIサーバー（ポート10588）のみ起動。`http://localhost:10588`でAPIのみ利用。GUI表示にはフロントプロジェクトの起動または下記のGUIモードをご利用ください。
+ > ⚠️ このコマンドはバックエンド API サービス（ポート 10588）のみを起動し、**フロントエンド画面は含まれません**。直接 `http://localhost:10588` にアクセスしても API を呼び出せるだけで、完全な Web 画面は見えません。画面を利用する場合はフロントエンドプロジェクトを別途起動するか、以下の GUI モードを使用してください。
- - **方法2：Electronデスクトップクライアント**
+ - **方法2：Electron デスクトップクライアントの起動**
```bash
yarn dev:gui
```
- > バックエンドとElectronウィンドウが同時起動。内蔵フロント付きで即利用OK。すべての機能を体験したい方向け。
+ > このコマンドはバックエンドサービスと Electron のデスクトップウィンドウを同時に起動します。フロントエンド画面が内蔵されており、追加の設定なしですぐに使えます。すべての機能を体験したい開発者に最適です。
- - **方法3：本番モードで起動**
+ - **方法3：本番（Production）モードで起動**
```bash
yarn start
```
- > 本番モードでビルド済サービスを直接起動（`yarn build`が必要）。
+ > コンパイル済みのサービスを本番モードで直接実行します（事前に `yarn build` を実行しておく必要があります）。
-4. **プロジェクトパッケージ化**
+4. **プロジェクトのパッケージ化（ビルド）**
- - TypeScriptファイルのビルド：
+ - コンパイルして TypeScript ファイルを生成：
```bash
yarn build
```
- - Windows用実行ファイル化：
+ - Windows 用の実行ファイルをパッケージ化：
```bash
yarn dist:win
```
- - Mac用実行ファイル化：
+ - Mac 用の実行ファイルをパッケージ化：
```bash
yarn dist:mac
```
- - Linux用実行ファイル化：
+ - Linux 用の実行ファイルをパッケージ化：
```bash
yarn dist:linux
```
-5. **コード品質チェック**
+5. **コード品質チェック（Lint）**
- - グローバルLintチェック：
+ - グローバルな構文およびコーディング規約のチェックを実行：
```bash
yarn lint
```
-6. **AIデバッグパネル（任意）**
+6. **AI デバッグパネル（オプション）**
- AI SDKのGUIデバッグツール。AI呼び出しのデバッグに便利。
+ AI SDK のビジュアルデバッグツールを起動し、AI の呼び出しを簡単にデバッグできます：
```bash
yarn debug:ai
@@ -423,68 +424,68 @@ pm2 monit # 監視パネル
## フロントエンド開発
-フロントUIの修正はフロントエンドリポジトリへ：
+フロントエンド画面を修正する必要がある場合は、フロントエンドのリポジトリで開発を行ってください：
- **GitHub**：[Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
- **Gitee**：[Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
-ビルド後、`dist`以下を本プロジェクト `data/web`へコピーで統合完了。
+フロントエンドのビルド後、`dist` ディレクトリの内容を本プロジェクトの `data/web` ディレクトリにコピーするだけで統合できます。
## プロジェクト構成
```
📂 build/ # ビルド成果物
📂 data/ # 実行時データ
-│ ├─ 📂 models/ # ローカル推論モデル（ONNX）
-│ ├─ 📂 oss/ # オブジェクトストレージ（素材/キャラ/背景）
-│ ├─ 📂 serve/ # 本番エントリ
-│ ├─ 📂 skills/ # Agentプロンプト集
-│ └─ 📂 web/ # ビルトインフロント
-📂 docs/ # ドキュメントリソース
+│ ├─ 📂 models/ # ローカル推論モデル（ONNX）
+│ ├─ 📂 oss/ # オブジェクトストレージ（素材/キャラクター/背景）
+│ ├─ 📂 serve/ # 本番環境のエントリー
+│ ├─ 📂 skills/ # Agent スキルのプロンプト
+│ └─ 📂 web/ # フロントエンドビルド成果物（内蔵）
+📂 docs/ # ドキュメントや画像リソース
📂 env/ # 環境設定
-📂 scripts/ # ビルド＆ツールスクリプト
+📂 scripts/ # ビルドや補助スクリプト
📂 src/
-├─ 📂 agents/ # AI Agentモジュール
-│ ├─ 📂 productionAgent/ # プロダクション用Agent
-│ └─ 📂 scriptAgent/ # 脚本Agent
-├─ 📂 lib/ # 共通ライブラリ（DB初期化等）
-├─ 📂 middleware/ # ミドルウェア
-├─ 📂 routes/ # ルーティングモジュール
-│ ├─ 📂 agents/ # Agentメモリ管理
-│ ├─ 📂 artStyle/ # 画風管理
-│ ├─ 📂 assets/ # 素材管理
-│ ├─ 📂 assetsGenerate/ # 素材生成
-│ ├─ 📂 cornerScape/ # 絵コンテ管理
-│ ├─ 📂 general/ # 共通API
-│ ├─ 📂 login/ # ログイン認証
-│ ├─ 📂 migrate/ # データ移行
-│ ├─ 📂 modelSelect/ # モデル選択
-│ ├─ 📂 novel/ # 小説管理
-│ ├─ 📂 other/ # その他機能
-│ ├─ 📂 production/ # 制作管理
-│ ├─ 📂 project/ # プロジェクト管理
-│ ├─ 📂 script/ # 脚本生成
-│ ├─ 📂 scriptAgent/ # 脚本AgentAPI
-│ ├─ 📂 setting/ # システム設定
-│ ├─ 📂 task/ # タスク管理
-│ └─ 📂 test/ # テストAPI
-├─ 📂 socket/ # WebSocket通信
-├─ 📂 types/ # TypeScript型
-├─ 📂 utils/ # ユーティリティ
-├─ 📄 app.ts # アプリエントリ
-├─ 📄 core.ts # コア初期化
-├─ 📄 env.ts # 環境変数処理
-├─ 📄 err.ts # エラーハンドラ
-├─ 📄 logger.ts # ロギング
-├─ 📄 router.ts # ルート登録
-└─ 📄 utils.ts # 共通ツール
-📄 Dockerfile # Dockerビルド
-📄 electron-builder.yml # Electronパッケージ設定
+├─ 📂 agents/ # AI Agent モジュール
+│ ├─ 📂 productionAgent/ # 制作 Agent
+│ └─ 📂 scriptAgent/ # 脚本 Agent
+├─ 📂 lib/ # 共通ライブラリ（DB初期化、レスポンス形式など）
+├─ 📂 middleware/ # ミドルウェア
+├─ 📂 routes/ # ルーティングモジュール
+│ ├─ 📂 agents/ # Agent メモリ管理
+│ ├─ 📂 artStyle/ # 画風（アートスタイル）管理
+│ ├─ 📂 assets/ # 素材管理
+│ ├─ 📂 assetsGenerate/ # 素材生成
+│ ├─ 📂 cornerScape/ # 絵コンテ管理
+│ ├─ 📂 general/ # 汎用 API
+│ ├─ 📂 login/ # ログイン認証
+│ ├─ 📂 migrate/ # データ移行
+│ ├─ 📂 modelSelect/ # モデル選択
+│ ├─ 📂 novel/ # 小説管理
+│ ├─ 📂 other/ # その他機能
+│ ├─ 📂 production/ # 制作進行管理
+│ ├─ 📂 project/ # プロジェクト管理
+│ ├─ 📂 script/ # 脚本生成
+│ ├─ 📂 scriptAgent/ # 脚本 Agent インターフェース
+│ ├─ 📂 setting/ # システム設定
+│ ├─ 📂 task/ # タスク管理
+│ └─ 📂 test/ # テスト用 API
+├─ 📂 socket/ # WebSocket リアルタイム通信
+├─ 📂 types/ # TypeScript 型定義
+├─ 📂 utils/ # ユーティリティ関数
+├─ 📄 app.ts # アプリケーションエントリー
+├─ 📄 core.ts # コア初期化
+├─ 📄 env.ts # 環境変数の処理
+├─ 📄 err.ts # エラーハンドリング
+├─ 📄 logger.ts # ログモジュール
+├─ 📄 router.ts # ルーティング登録
+└─ 📄 utils.ts # 汎用ツール
+📄 Dockerfile # Docker ビルドファイル
+📄 electron-builder.yml # Electron パッケージ設定
📄 skillList.json # スキルリスト
📄 LICENSE # ライセンス（Apache-2.0）
-📄 NOTICES.txt # サードパーティ依存リスト
+📄 NOTICES.txt # 依存パッケージに関する表記
📄 package.json # プロジェクト設定
-📄 tsconfig.json # TypeScript設定
+📄 tsconfig.json # TypeScript 設定
```
---
@@ -492,64 +493,66 @@ pm2 monit # 監視パネル
# 🔗 関連リポジトリ
| リポジトリ | 説明 | 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-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を利用したいだけなら本リポジトリをそのままダウンロードすればOK。フロントリポジトリはフロントカスタマイズや2次開発者向けです。
+> 💡 **ヒント**：Toonflow を使用するだけであれば、本リポジトリのクライアントを直接ダウンロードするだけで十分です。フロントエンドのリポジトリは、二次開発やフロントエンド画面のカスタマイズが必要な開発者向けです。
---
-# 👨👩👧👦 WeChatコミュニティグループ
+# 👨👩👧👦 Discord 交流グループ
-グループ招待アシスタント:
+下のアイコンをクリックして Discord に参加：
-
+[](https://discord.gg/HEjKmpNpAZ)
+
+または直接リンクをクリック： [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
---
# 💌 お問い合わせ
-📧 メール：[ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow相談)
+📧 メール：[ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflowのお問い合わせ)
---
# 📜 ライセンス
-ToonflowはApache-2.0ライセンス＋補足商業契約でオープンソース公開されています。
+Toonflow は Apache-2.0 ライセンスに基づいてオープンソースとして公開されており、補足的な商業契約が付随しています。
-ライセンス詳細：https://www.apache.org/licenses/LICENSE-2.0
+ライセンスの詳細：https://www.apache.org/licenses/LICENSE-2.0
-## 補足契約
+## 補足条項
-- 本ソフトウェアを製品として**2つ以上の独立した第三者**に配布する場合、HBAI-Ltdの**書面による商業許諾**が必要です。
-- **5法人以下**の共同運営で内部利用のみの場合は、**商業許諾不要**です。
-- Toonflowの商標・ロゴ・著作権情報の削除・改変は禁止です。
+- 本ソフトウェアを製品として **2つ以上の独立した第三者** に配布・提供する場合、HBAI-Ltd からの **書面による商業ライセンス（許諾）** を取得する必要があります。
+- **5法人以下** が共同で運営し、外部にサービスを提供せずに内部利用のみとする場合は、内部利用と見なされ、**商業ライセンスの取得は不要**です。
+- Toonflow 内のロゴや著作権情報を削除または変更することは禁止されています。
-## 永久無料シーン
+## 永久無料となるケース
-- ✅ Toonflowでコンテンツを制作しプラットフォーム収益を得る
-- ✅ 自チーム内部利用の二次開発
-- ✅ ≤ 5法人の共同運営内部利用
-- ✅ 個人学習・研究・非商用利用
+- ✅ Toonflow を利用してコンテンツを制作し、プラットフォームから収益分配を得る場合
+- ✅ 自分のチーム内で使用するために二次開発を行う場合
+- ✅ 5法人以下の共同運営による内部利用
+- ✅ 個人の学習、研究、非営利目的
## 商業ライセンス価格
-| 段階 | 年間売上高 | 年間費用 |
+| フェーズ | 年間売上高 | 年間費用 |
|------|---------|------|
-| 🌱 育成期 | < ¥10万 | **無料** |
-| 🚀 スタートアップ | ¥10〜50万 | ¥5,000/年 |
-| 📈 成長期 | ¥50〜150万 | ¥20,000/年 |
-| 🏢 拡大期 | ¥150〜500万 | ¥80,000/年 |
-| 🌐 エンタープライズ | > ¥500万 | 要相談 |
+| 🌱 支援期 | 200万円 未満 | **無料** |
+| 🚀 創業期 | 200万円 ～ 1,000万円 | 108,000 円/年 |
+| 📈 成長期 | 1,000万円 ～ 3,000万円 | 420,000 円/年 |
+| 🏢 規模拡大期 | 3,000万円 ～ 1億円 | 1,680,000 円/年 |
+| 🌐 エンタープライズ | 1億円 超 | 応相談 |
-> **不遡及条項**：v1.0.8リリース前にAGPL-3.0でToonflowを使用していたユーザーは、本変更の影響を受けません。既存の利用はAGPL-3.0に基づき継続されます。
+> **遡及（そきゅう）適用除外条項**：v1.0.8 リリース以前に AGPL-3.0 に基づいて使用していたユーザーは、引き続き AGPL-3.0 に従い、本契約変更の制約を受けません。
-完全な契約内容は [LICENSE](../LICENSE) をご覧ください。
+契約の全文については [LICENSE](./LICENSE) ファイルを参照してください。
---
-# ⭐️ スター履歴
+# ⭐️ Star 獲得履歴
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
@@ -557,34 +560,32 @@ ToonflowはApache-2.0ライセンス＋補足商業契約でオープンソー
# 🙏 謝辞
-以下のオープンソースプロジェクトの強力な支援に感謝します：
+Toonflow に強力なサポートを提供してくださる以下のオープンソースプロジェクトに感謝いたします：
-- [Express](https://expressjs.com/) - 高速・オープンなNode.js Webフレームワーク
-- [AI SDK](https://ai-sdk.dev/) - TypeScript向けAIツールキット
-- [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優先のバリデーション
-- [Socket.IO](https://socket.io/) - リアルタイム双方向通信エンジン
-- [Electron](https://www.electronjs.org/) - クロスプラットフォームデスクトップ開発
-- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - ローカル機械学習推論ライブラリ
+- [Express](https://expressjs.com/) - 高速でオープン、ミニマルな Node.js Web フレームワーク
+- [AI SDK](https://ai-sdk.dev/) - TypeScript 向け AI ツールキット
+- [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 ファーストのスキーマ検証ライブラリ
+- [Socket.IO](https://socket.io/) - リアルタイムの双方向イベント通信エンジン
+- [Electron](https://www.electronjs.org/) - クロスプラットフォームデスクトップアプリ開発フレームワーク
+- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - ローカル ML 推論ライブラリ
-以下の組織・団体・個人によるToonflowへの協力に感謝します：
+Toonflow を支援してくださる以下の組織・団体・個人に感謝いたします：
|
-
+
|
- 算能云 よりコンピューティング協賛 - [公式サイト] + 算能雲 (Sophnet) 様より計算リソースの提供をいただいております + [公式サイト] |
- Atomgit
+
- 简体中文 | + 简体中文 | 繁體中文 | English | ไทย | @@ -31,11 +30,11 @@
- AI-фабрика коротких сериалов
+ Фабрика AI-мини-сериалов и короткометражных фильмов
- Одним движением — роман за секунду становится сериалом!
+ Всего несколько кликов — и ваша новелла превращается в фильм или сериал!
- AI-сценарий × AI-изображения × Молниеносная генерация 🔥
+ AI-сценарий × AI-изображения × Сверхбыстрая генерация 🔥
@@ -50,65 +49,71 @@
- > 🚀 **Универсальный конвейер коротких сериалов**: от текста к персонажам, от раскадровки к видео, 0 порога по всему процессу на базе AI, рост эффективности творчества 10× и более! +> 🚀 **All-in-One платформа для коротких сериалов и фильмов**: От текста до персонажей, от раскадровки до готового видео. Полная автоматизация с помощью ИИ с нулевым порогом входа — повышает эффективность творчества в 10 раз и более! --- -# 🌐 Многоязычная поддержка +# 🌐 Мультиязычная поддержка Toonflow поддерживает следующие языки интерфейса: -| Язык | Language | -|------|----------| -| 简体中文 | Китайский (упрощённый) | -| 繁體中文 | Китайский (традиционный) | -| English | Английский | -| ไทย | Тайский | -| Tiếng Việt | Вьетнамский | -| 日本語 | Японский | -| Русский | Русский | +| Язык | Language | +|---------------|---------------------------| +| 简体中文 | Chinese (Simplified) | +| 繁體中文 | Chinese (Traditional) | +| English | English | +| ไทย | Thai | +| Tiếng Việt | Vietnamese | +| 日本語 | Japanese | +| Русский | Russian | + +> 💡 В настоящее время мы активно добавляем новые языки. Будем рады вашей помощи с переводами! --- -# 🌟 Основные функции +# 🌟 Основные возможности -Toonflow — инструмент для создания коротких сериалов и комиксов с помощью AI, позволяющий автоматически превращать романы в сценарии и генерировать изображения и видео с помощью нейросетей. Используя Toonflow, вы легко пройдёте путь от текста к видео: создание коротких фильмов становится умнее и удобнее. +Toonflow — это мощный ИИ-инструмент для создания коротких видео, мини-сериалов и комиксов. Он автоматически превращает новеллы в сценарии, а затем с помощью ИИ генерирует изображения и видео, позволяя быстро и эффективно создавать качественный контент. +С Toonflow вы можете пройти весь цикл производства — от текста до готового видео — легко и удобно, без специальных навыков. - ✅ **Генерация персонажей** - Автоматически анализирует исходный текст романа, интеллектуально идентифицирует и генерирует параметры персонажей, включая внешний вид, характер, социальный статус и др., формируя прочную основу для дальнейшей разработки сценария и визуала. + Автоматический анализ оригинального текста новеллы, интеллектуальное распознавание и создание подробных профилей персонажей (внешность, характер, личность, отношения и другие детали). Это закладывает прочную основу для сценария и визуальной части. + - ✅ **Генерация сценария** - На основе выбранных событий и глав система автоматически создает структурированный сценарий, включая диалоги, описание сцен и развитие сюжета, обеспечивая эффективную трансформацию из литературного текста в кинематографический сценарий. -- ✅ **Раскадровка** - На основе сценария AI генерирует креативные промпты и дизайн кадров, прорабатывает передний-средний-задний план, динамику персонажей, реквизит и компоновку сцен, автоматически создаёт раскадровку для дальнейшей видеосборки. -- ✅ **Видеосборка** - Интегрирует AI-технологии генерации изображений и видео. Позволяет создавать фрагменты видео с помощью ИИ. Системы онлайн-редактирования поддерживают индивидуальные настройки и быстрый вывод конечного результата. + На основе выбранных событий и глав система автоматически создаёт структурированный сценарий с естественными диалогами, описаниями сцен и развитием сюжета, обеспечивая эффективную адаптацию литературного произведения в видеоформат. + +- ✅ **Создание раскадровки (Storyboard)** + Автоматическая генерация промптов и дизайн кадров на основе сценария. Детальная проработка переднего, среднего и заднего планов, движений персонажей, реквизита и композиции — готовая раскадровка становится точным планом для производства видео. + +- ✅ **Синтез видео** + Интеграция современных ИИ-технологий для генерации изображений и видеоклипов. Встроенный онлайн-редактор позволяет гибко настраивать результат, делая процесс создания видео быстрым, удобным и плавным. --- -# 📦 Области применения +# 📦 Сценарии использования -- Создание коротких видео-контента -- Эксперименты по экранизации романов -- Инструмент AI для литературных адаптаций -- Разработка сценариев и быстрые прототипы -- Генерация видеоматериалов +- Создание контента для коротких видео (Shorts, Reels, TikTok) +- Экранизация и визуализация новелл +- ИИ-инструмент для адаптации литературных произведений +- Разработка сценариев и быстрое прототипирование +- Генерация видеоматериалов и футажей --- # 🔰 Руководство пользователя -## 📺 Видеоруководство +## 📺 Видеоуроки -https://www.bilibili.com/video/BV1na6wB6Ea2 -[](https://www.bilibili.com/video/BV1na6wB6Ea2) +[https://www.bilibili.com/video/BV1na6wB6Ea2](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) +**Toonflow: Быстрый старт в AI-видео за 8 минут** +👉 [Нажмите для просмотра](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e) -📱 Сканируйте WeChat QR-код для просмотра на телефоне +📱 Отсканируйте QR-код для просмотра видео на телефоне -
+
---
@@ -116,34 +121,34 @@ https://www.bilibili.com/video/BV1na6wB6Ea2
## Предварительные требования
-Перед установкой и использованием программы подготовьте следующее:
+Перед установкой и использованием Toonflow подготовьте следующее:
-- ✅ Адрес API сервиса языковой AI-модели
-- ✅ Адрес API Sora или Doubao для видео
-- ✅ Адрес API сервиса модели Nano Banana Pro для генерации изображений
+- ✅ URL API для LLM (большой языковой модели)
+- ✅ URL API для генерации видео (Sora или Doubao)
+- ✅ URL API для генерации изображений (Nano Banana Pro)
-## Установка локально
+## Локальная установка (на ПК)
### 1. Скачивание и установка
-| Операционная система | GitHub | Atomgit | Скачать из Quark Net Disk | Описание |
-| :------------------: | :---------------------------------------------------------- | :------------------------------------------------------------- | :-------------------------------------------------- | :------------------ |
-| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Net Disk](https://pan.quark.cn/s/94ef07509df0) | Официальный установочный пакет |
-| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Net Disk](https://pan.quark.cn/s/94ef07509df0) | Официальный установочный пакет |
-| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Net Disk](https://pan.quark.cn/s/94ef07509df0) | Официальный установочный пакет |
+| ОС | GitHub | Atomgit | Скачать (Quark Drive) | Описание |
+| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
+| 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) | Официальный установщик |
+| 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) | Официальный установщик |
+| 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) | Официальный установщик |
> [!CAUTION]
-> Для macOS: откройте "Настройки → Конфиденциальность и безопасность" и настройте параметры безопасности, иначе может не открыться из-за проблемы с сертификатом.
+> Пользователям macOS необходимо перейти в **Системные настройки → Конфиденциальность и безопасность** и разрешить запуск приложения. В противном случае программа может не открыться из-за проблем с сертификатом.
>
-> См. на Zhihu: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+> Подробнее (на китайском): [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
-> Из-за ограничений Gitee OS и лимита по размеру файлов Release — отдельная ссылка для загрузки с Gitee временно недоступна.
+> Из-за технических ограничений Gitee Release (размер файлов и окружение) ссылки для скачивания на Gitee временно недоступны.
### 2. Запуск сервиса
-После установки запустите приложение для начала работы.
+После завершения установки просто откройте программу Toonflow — сервис будет готов к работе.
-> ⚠️ **Первый вход**
+> ⚠️ **Данные для первого входа**
> Логин: `admin`
> Пароль: `admin123`
@@ -151,56 +156,59 @@ https://www.bilibili.com/video/BV1na6wB6Ea2
### Предварительные требования
-- Установлен [Docker](https://docs.docker.com/get-docker/) (версия 20.10+)
+- Установлен [Docker](https://docs.docker.com/get-docker/) версии 20.10 или выше
### Способ 1: Онлайн-развертывание
-В разработке — пока используйте локальную сборку.
+В настоящее время в стадии разработки.
+Рекомендуется использовать локальную сборку.
### Способ 2: Локальная сборка
-Собирается локально из скачанного репозитория, подходит для разработчиков либо скачавших код через git:
+Сборка проекта непосредственно из исходного кода на вашем компьютере.
+Подходит для разработчиков и пользователей, которые уже клонировали репозиторий. Требуется установленная система контроля версий Git:
```shell
-# Клонировать проект (если уже есть — пропустите)
+# Сначала клонируйте проект (пропустите, если уже сделано)
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
-# Запускаем сборку и запуск с помощью docker-compose
+# Локальная сборка и запуск с помощью docker-compose
yarn docker:local
-# Или вручную
+# Или ручная сборка
docker build -t toonflow .
-docker run -d -p <локальный_порт>:10588 -v <путь_к_данным>:/app/data toonflow
+docker run -d -p <локальный_порт>:10588 -v <путь_к_локальным_данным>:/app/data toonflow
-# Доступ по адресу: http://localhost:10588/web/index.html
+# После этого интерфейс будет доступен по пути /web/index.html на указанном порту
+# Пример: http://localhost:10588/web/index.html
```
-### Описание портов
+### Описание портов сервиса
-| Порт | Назначение | Мэппинг в контейнере |
-| -------- | ------------- | ---------------------------- |
-| `10588` | Web-интерфейс | `10588:10588` |
+| Порт | Назначение | Маппинг |
+| ------- | --------------------------- | ---------------- |
+| `10588` | Основной порт сервиса (API) | `10588:10588` |
-**Переменные окружения:**
+**Переменные окружения (Environment Variables):**
-| Переменная | Описание |
-| ------------ | --------------------------------------- |
-| `NODE_ENV` | Среда запуска, `prod` — продуктивная |
-| `PORT` | Порт службы (по умолчанию 10588) |
-| `OSSURL` | Доступ к хранилищу файлов, для статики |
+| Переменная | Описание |
+| ---------- | ----------------------------------------------------- |
+| `NODE_ENV` | Среда выполнения (`prod` = Production) |
+| `PORT` | Порт сервиса (по умолчанию 10588) |
+| `OSSURL` | Адрес Object Storage для хранения и отдачи статических файлов |
---
-## Развёртывание в облаке
+## Облачное развертывание / Установка на сервер
-### 1. Требования к серверу
+### I. Требования к серверу
-- **ОС**: Ubuntu 20.04+ / CentOS 7+
-- **Node.js**: 24.x (рекомендуется; минимум 23.11.1+)
-- **ОЗУ**: от 2 ГБ
+- **Операционная система**: Ubuntu 20.04+ / CentOS 7+
+- **Node.js**: 24.x (рекомендуется, минимум 23.11.1+)
+- **ОЗУ**: 2 ГБ и более
-### 2. Развёртывание на сервере
+### II. Развертывание
#### 1. Установка окружения
@@ -213,9 +221,9 @@ nvm install 24
npm install -g yarn pm2
```
-#### 2. Развёртывание проекта
+#### 2. Загрузка и сборка проекта
-**Клонировать из GitHub:**
+**Клонирование с GitHub:**
```bash
cd /opt
@@ -225,7 +233,7 @@ yarn install
yarn build
```
-**Клонировать из Gitee (для пользователей из Китая):**
+**Клонирование с Gitee (рекомендуется для Китая):**
```bash
cd /opt
@@ -253,13 +261,13 @@ yarn build
}
```
-**Описание переменных:**
+**Переменные окружения (Environment Variables):**
-| Переменная | Описание |
-| ------------ | --------------------------------|
-| `NODE_ENV` | Среда запуска, `prod` — продакшн |
-| `PORT` | Слушаемый порт |
-| `OSSURL` | Адрес доступа к статике |
+| Переменная | Описание |
+| ---------- | ----------------------------------------------------- |
+| `NODE_ENV` | Среда выполнения (`prod` = Production) |
+| `PORT` | Порт сервиса (по умолчанию 10588) |
+| `OSSURL` | Адрес Object Storage для хранения и отдачи статических файлов |
---
@@ -276,57 +284,58 @@ pm2 save
```bash
pm2 list # Список процессов
pm2 logs toonflow-app # Просмотр логов
-pm2 restart all # Перезапуск сервиса
-pm2 monit # Мониторинг
+pm2 restart all # Перезапуск сервисов
+pm2 monit # Панель мониторинга
```
-> ⚠️ **Первый вход**
+> ⚠️ **Данные для первого входа**
> Логин: `admin`
> Пароль: `admin123`
-#### 6. Развёртывание фронта
+#### 6. Развертывание Frontend
-Если нужна кастомизация интерфейса или отдельное развертывание фронта — используйте репозиторий фронтенда:
+Если вам нужно отдельно развернуть или кастомизировать фронтенд, перейдите в репозиторий Toonflow-web:
- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
-> 💡 **Примечание:** В этот репозиторий уже встроен скомпилированный фронт. Обычным пользователям отдельная установка канала не требуется. Фронт-репозиторий — только для тех, кто хочет разрабатывать/модифицировать UI.
+> 💡 **Примечание**: Этот репозиторий уже содержит скомпилированные файлы Frontend. Обычным пользователям не требуется отдельно устанавливать фронтенд. Репозиторий Toonflow-web предназначен только для разработчиков, которые хотят внести изменения или доработать интерфейс.
---
-# 🔧 Руководство по процессу разработки
+# 🔧 Руководство разработчика
> [!CAUTION]
-> 🚧 **Правила по PR** 🚧
+> 🚧 **Правила отправки Pull Request** 🚧
>
-> ⛔ В `master` запрещены любые PR | ✅ Создавайте PR только в ветку `develop`
+> ⛔ **Ветка `master` не принимает PR** ｜ ✅ **Отправляйте все PR в ветку `develop`**
>
-> Разработчиков приглашаем к со-разработке Toonflow! Для участия пишите главному админу ACT в группу.
+> Приглашаем всех желающих разработчиков присоединиться к развитию Toonflow.
+> Если вы хотите участвовать, свяжитесь с куратором проекта ACT в нашей группе сообщества.
-## 🛠️ Технологический стек
+## 🛠️ Стек технологий
-| Категория | Технологии |
-| ------------ | ------------------------------------------------------------------------------------------------------------------- |
-| Рантайм | Node.js 23.11.1+ |
-| Язык | TypeScript 5.x |
-| Бэкенд | Express 5 |
-| БД | SQLite (better-sqlite3 / knex) |
-| AI-интеграции| Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhihu / MiniMax / Tongyi Qianwen / xAI) |
-| Локальный AI | @huggingface/transformers (ONNX) |
-| RTC | Socket.IO |
-| Десктоп-клиент| Electron 40 |
-| Графика | Sharp |
-| Контейнеризация| Docker |
+| Категория | Технология |
+|------------------------|-----------------------------------------------------------------------------------------|
+| Runtime | Node.js 23.11.1+ |
+| Язык | TypeScript 5.x |
+| Backend-фреймворк | Express 5 |
+| База данных | SQLite (better-sqlite3 / knex) |
+| Интеграция ИИ | Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Qwen / xAI) |
+| Локальный инференс | @huggingface/transformers (ONNX) |
+| Real-time связь | Socket.IO |
+| Desktop-клиент | Electron 40 |
+| Обработка изображений | Sharp |
+| Контейнеризация | Docker |
## Подготовка среды разработки
-- **Node.js**: не ниже 23.11.1
-- **Yarn**: рекомендуется менеджер пакетов
+- **Node.js**: версия 23.11.1 и выше
+- **Yarn**: рекомендуется использовать в качестве пакетного менеджера
-## Быстрый старт проекта
+## Быстрый запуск проекта
-1. **Клонируйте проект**
+1. **Клонирование проекта**
**С GitHub:**
@@ -342,9 +351,9 @@ pm2 monit # Мониторинг
cd Toonflow-app
```
-2. **Установите зависимости**
+2. **Установка зависимостей**
- В корне проекта выполните:
+ Выполните следующую команду в корневой папке проекта:
```bash
yarn install
@@ -352,203 +361,209 @@ pm2 monit # Мониторинг
3. **Запуск среды разработки**
- Проект состоит из backend API и frontend. Возможные варианты запуска:
+ Проект состоит из **Backend API** и **Frontend страниц**. Выберите нужный способ запуска:
- - **1: Только backend**
+ - **Способ 1: Запуск только Backend**
```bash
yarn dev
```
- > ⚠️ Запускает только backend API (порт 10588); без интерфейса. Для доступа к UI — используйте отдельный frontend проект или запускайте через GUI-модули ниже.
+ > ⚠️ Эта команда запускает **только Backend API** (порт 10588) **без интерфейса Frontend**.
+ > При переходе по адресу `http://localhost:10588` вы сможете только обращаться к API. Полноценный графический интерфейс отображаться не будет.
+ > Чтобы работать с UI, запустите Frontend отдельно или используйте режим GUI (см. ниже).
- - **2: Electron-desktop-клиент**
+ - **Способ 2: Запуск клиента Electron (GUI)**
```bash
yarn dev:gui
```
- > Открывает backend и Electron GUI-окно — всё встроено, без доп. настроек. Рекомендуется для полноценного использования.
+ > Эта команда одновременно запускает Backend и десктопное приложение Electron со встроенным Frontend.
+ > Программа готова к работе сразу после запуска, без дополнительных настроек.
+ > Идеально подходит для разработчиков, которые хотят быстро протестировать весь функционал приложения.
- - **3: Режим продакшн**
+ - **Способ 3: Запуск в режиме Production**
```bash
yarn start
```
- > Запуск производственной сборки (предварительно `yarn build` обязателен).
+ > Запуск скомпилированного сервиса в режиме Production (сначала необходимо выполнить `yarn build`).
-4. **Сборка проекта**
+4. **Сборка проекта (Build & Package)**
- - Компиляция .ts файлов:
+ - Компиляция и генерация TypeScript:
```bash
yarn build
```
- - Сборка exe для Windows:
+ - Сборка исполняемого файла для Windows:
```bash
yarn dist:win
```
- - Сборка для Mac:
+ - Сборка исполняемого файла для Mac:
```bash
yarn dist:mac
```
- - Сборка для Linux:
+ - Сборка исполняемого файла для Linux:
```bash
yarn dist:linux
```
-5. **Lint и проверка кода**
+5. **Проверка качества кода (Linting)**
- - Проверка кода на ошибки и стиль:
+ - Запуск глобальной проверки синтаксиса:
```bash
yarn lint
```
-6. **AI Debug-панель (по желанию)**
+6. **Панель отладки AI (Опционально)**
- Запуск GUI для отладки AI SDK:
+ Запуск визуального инструмента отладки AI SDK:
```bash
yarn debug:ai
```
-## Фронтенд разработка
+## Разработка Frontend
-Для редактирования интерфейса используйте фронт-репозиторий:
+Если вам нужно внести изменения в пользовательский интерфейс, перейдите в репозиторий фронтенда:
- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
-После сборки фронта (`dist/`) скопируйте его содержимое в `data/web/` основного проекта.
+После сборки (build) фронтенда скопируйте всю папку `dist` в директорию `data/web` этого проекта для интеграции.
## Структура проекта
```
-📂 build/ # Скомпилированные файлы
-📂 data/ # Данные во время работы
-│ ├─ 📂 models/ # Локальные AI-модели (ONNX)
-│ ├─ 📂 oss/ # Объектное хранилище (ассеты/персонажи/сцены)
-│ ├─ 📂 serve/ # Вход в проде
-│ ├─ 📂 skills/ # Prompt-словари умений Agent
-│ └─ 📂 web/ # Скомпилированный фронтенд (встроен)
-📂 docs/ # Документация
-📂 env/ # Переменные окружения
-📂 scripts/ # Скрипты и утилиты
+📂 build/ # Артефакты сборки
+📂 data/ # Данные времени выполнения (Runtime)
+│ ├─ 📂 models/ # Локальные модели (ONNX)
+│ ├─ 📂 oss/ # Object Storage (изображения, персонажи, сцены)
+│ ├─ 📂 serve/ # Точка входа в Production-режим
+│ ├─ 📂 skills/ # Промпты навыков Agent
+│ └─ 📂 web/ # Скомпилированный Frontend (встроен в проект)
+📂 docs/ # Документация и ресурсы
+📂 env/ # Конфигурации окружения
+📂 scripts/ # Скрипты сборки и вспомогательные скрипты
📂 src/
-├─ 📂 agents/ # AI agent-модули
-│ ├─ 📂 productionAgent/ # Агент генерации
-│ └─ 📂 scriptAgent/ # Агент сценария
-├─ 📂 lib/ # Общие библиотеки
-├─ 📂 middleware/ # Мидлвари
-├─ 📂 routes/ # Роутинг модули
-│ ├─ 📂 agents/ # Память агента
-│ ├─ 📂 artStyle/ # Управление стилями
-│ ├─ 📂 assets/ # Ассеты
-│ ├─ 📂 assetsGenerate/ # Генерация ассетов
-│ ├─ 📂 cornerScape/ # Раскадровка
-│ ├─ 📂 general/ # Общие эндпоинты
-│ ├─ 📂 login/ # Авторизация
-│ ├─ 📂 migrate/ # Миграции
-│ ├─ 📂 modelSelect/ # Выбор модели
-│ ├─ 📂 novel/ # Управление романами
-│ ├─ 📂 other/ # Другое
-│ ├─ 📂 production/ # Управление производством
-│ ├─ 📂 project/ # Управление проектом
-│ ├─ 📂 script/ # Генерация сценария
-│ ├─ 📂 scriptAgent/ # Эндпоинты агента сценария
-│ ├─ 📂 setting/ # Настройки системы
-│ ├─ 📂 task/ # Задачи
-│ └─ 📂 test/ # Тестовые эндпоинты
-├─ 📂 socket/ # RealTime WebSocket
-├─ 📂 types/ # TypeScript типы
-├─ 📂 utils/ # Утилиты
-├─ 📄 app.ts # Точка входа
-├─ 📄 core.ts # Инициализация ядра
-├─ 📄 env.ts # Работа с окружением
-├─ 📄 err.ts # Обработка ошибок
-├─ 📄 logger.ts # Модуль логгирования
-├─ 📄 router.ts # Регистрация роутов
-└─ 📄 utils.ts # Вспомогательные функции
-📄 Dockerfile # Dockerfile
-📄 electron-builder.yml # Конфиг Electron Builder
+├─ 📂 agents/ # Модули AI Agent
+│ ├─ 📂 productionAgent/ # Production Agent (агент производства)
+│ └─ 📂 scriptAgent/ # Script Agent (агент сценариев)
+├─ 📂 lib/ # Общие библиотеки (инициализация БД, форматы ответов)
+├─ 📂 middleware/ # Middleware
+├─ 📂 routes/ # Модули маршрутизации
+│ ├─ 📂 agents/ # Управление памятью Agent
+│ ├─ 📂 artStyle/ # Управление художественными стилями
+│ ├─ 📂 assets/ # Управление ассетами
+│ ├─ 📂 assetsGenerate/ # Генерация ассетов
+│ ├─ 📂 cornerScape/ # Управление раскадровкой (Storyboard)
+│ ├─ 📂 general/ # Общие API
+│ ├─ 📂 login/ # Аутентификация
+│ ├─ 📂 migrate/ # Миграция данных
+│ ├─ 📂 modelSelect/ # Выбор моделей
+│ ├─ 📂 novel/ # Управление новеллами
+│ ├─ 📂 other/ # Прочие функции
+│ ├─ 📂 production/ # Управление производством и монтажом
+│ ├─ 📂 project/ # Управление проектами
+│ ├─ 📂 script/ # Генерация сценариев
+│ ├─ 📂 scriptAgent/ # Интерфейс Script Agent
+│ ├─ 📂 setting/ # Системные настройки
+│ ├─ 📂 task/ # Управление задачами
+│ └─ 📂 test/ # Тестовые API
+├─ 📂 socket/ # Real-time коммуникация через WebSocket
+├─ 📂 types/ # Типы TypeScript
+├─ 📂 utils/ # Вспомогательные утилиты
+├─ 📄 app.ts # Точка входа приложения (App Entry)
+├─ 📄 core.ts # Инициализация ядра системы
+├─ 📄 env.ts # Обработка переменных окружения
+├─ 📄 err.ts # Обработка ошибок
+├─ 📄 logger.ts # Модуль логирования
+├─ 📄 router.ts # Регистрация маршрутов
+└─ 📄 utils.ts # Общие утилиты
+📄 Dockerfile # Файл для сборки Docker
+📄 electron-builder.yml # Конфигурация сборки Electron
📄 skillList.json # Список навыков
📄 LICENSE # Лицензия (Apache-2.0)
-📄 NOTICES.txt # Информация о сторонних зависимостях
-📄 package.json # Конфиг пакетов
-📄 tsconfig.json # Конфиг TypeScript
+📄 NOTICES.txt # Уведомления о сторонних зависимостях
+📄 package.json # Конфигурация проекта
+📄 tsconfig.json # Конфигурация TypeScript
```
---
# 🔗 Связанные репозитории
-| Репозиторий | Описание | 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) |
+| Репозиторий | Описание | GitHub | Gitee |
+|------------------|---------------------------------------------------------------|----------------------------------------------------|--------------------------------------------------|
+| **Toonflow-app** | Полноценный клиент (этот репозиторий, рекомендуется для большинства пользователей) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) |
+| **Toonflow-web** | Исходный код Frontend (для frontend-разработчиков) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) |
-> 💡 **Подсказка:** если вы просто хотите пользоваться Toonflow — скачайте этот клиент. Отдельный frontend нужен только разработчикам UI.
+> 💡 **Совет**: Если вы просто хотите использовать Toonflow, достаточно скачать клиент из этого репозитория. Репозиторий Toonflow-web предназначен только для разработчиков, желающих внести изменения или доработать интерфейс.
---
-# 👨👩👧👦 WeChat-группы
+# 👨👩👧👦 Discord сообщество
-Ассистент по добавлению в группу:
+Нажмите на иконку ниже, чтобы присоединиться к Discord:
-
+[](https://discord.gg/HEjKmpNpAZ)
+
+Или перейдите по прямой ссылке: [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
---
-# 💌 Обратная связь
+# 💌 Свяжитесь с нами
-📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow咨询)
+📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Запрос%20Toonflow)
---
# 📜 Лицензия
-Toonflow распространяется по лицензии Apache-2.0 с дополнительным коммерческим соглашением.
+Toonflow распространяется как open-source проект под лицензией Apache-2.0 с дополнительным коммерческим соглашением.
-Подробности: https://www.apache.org/licenses/LICENSE-2.0
+Подробнее о лицензии Apache-2.0: https://www.apache.org/licenses/LICENSE-2.0
-## Дополнительное соглашение
+## Дополнительное коммерческое соглашение
-- Если вы распространяете данное ПО как продукт **2 и более независимым третьим сторонам**, необходимо получить **письменную коммерческую лицензию** от HBAI-Ltd.
-- **≤ 5 юридических лиц**, совместно использующих ПО для внутренних нужд без предоставления услуг третьим сторонам — это **внутреннее использование, лицензия не требуется**.
-- Запрещено удалять или изменять товарные знаки, логотипы или уведомления об авторских правах Toonflow.
+- Если данное ПО распространяется в виде продукта для **2 и более независимых третьих лиц**, необходимо получить **письменную коммерческую лицензию** от HBAI-Ltd.
+- Если ПО используется совместно **не более чем 5 юридическими лицами** только для внутренних нужд (без оказания услуг внешним пользователям), это считается внутренним использованием и **лицензия не требуется**.
+- Запрещается удалять или изменять логотипы и информацию об авторских правах в Toonflow.
-## Всегда бесплатно — без лицензии
+## Сценарии бессрочного бесплатного использования
-- ✅ Создание контента в Toonflow и получение дохода на платформах
-- ✅ Доработка для внутреннего использования команды
-- ✅ ≤ 5 юрлиц — совместная внутренняя эксплуатация
-- ✅ Личное обучение, исследования, некоммерческое использование
+- ✅ Создание контента с помощью Toonflow и монетизация через видеоплатформы
+- ✅ Вторичная разработка (secondary development) для внутреннего использования команды
+- ✅ Совместное использование группой из ≤ 5 юридических лиц только внутри организации
+- ✅ Личное обучение, научные исследования и любые некоммерческие цели
-## Цены на коммерческую лицензию
+## Тарифы коммерческой лицензии
-| Этап | Годовой оборот | Годовая плата |
-|------|---------|------|
-| 🌱 Старт | < ¥100 тыс. | **Бесплатно** |
-| 🚀 Стартап | ¥100–500 тыс. | ¥5 000/год |
-| 📈 Рост | ¥500 тыс.–1,5 млн | ¥20 000/год |
-| 🏢 Масштаб | ¥1,5–5 млн | ¥80 000/год |
-| 🌐 Корпоративный | > ¥5 млн | По договорённости |
+| Стадия | Годовая выручка | Годовой взнос |
+|---------------------|-----------------------------|-----------------------|
+| 🌱 Старт / Поддержка | < ¥100 000 RMB | **Бесплатно** |
+| 🚀 Стартап | ¥100 000 – 500 000 RMB | ¥5,000 / год |
+| 📈 Рост | ¥500 000 – 1 500 000 RMB | ¥20,000 / год |
+| 🏢 Масштабирование | ¥1 500 000 – 5 000 000 RMB | ¥80,000 / год |
+| 🌐 Корпоративный | > ¥5 000 000 RMB | Договорная цена |
-> **Условие отсутствия обратной силы**: Пользователи, использовавшие Toonflow по AGPL-3.0 до релиза v1.0.8, продолжают работу по AGPL-3.0 и не затрагиваются данным изменением.
+> **Оговорка о необратной силе**: Пользователи, которые использовали Toonflow под лицензией AGPL-3.0 до выхода версии v1.0.8, продолжают работать по правилам AGPL-3.0. Изменения данного соглашения на них не распространяются.
-Полный текст соглашения см. в файле [LICENSE](../LICENSE).
+Полный текст соглашения доступен в файле [LICENSE](./LICENSE).
---
-# ⭐️ История звёзд
+# ⭐️ История звезд (Star History)
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
@@ -556,32 +571,32 @@ Toonflow распространяется по лицензии Apache-2.0 с д
# 🙏 Благодарности
-Спасибо нижеперечисленным open-source проектам за мощную поддержку Toonflow:
+Выражаем благодарность следующим open-source проектам за мощную поддержку Toonflow:
-- [Express](https://expressjs.com/) — быстрый, открытый и лёгкий фреймворк для Node.js
-- [AI SDK](https://ai-sdk.dev/) — инструменты AI для TypeScript
-- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) — высокопроизводительная обвязка SQLite3
-- [Sharp](https://sharp.pixelplumbing.com/) — быстрая библиотека для работы с изображениями на Node.js
-- [Axios](https://axios-http.com/) — HTTP-клиент на промисах
-- [Zod](https://zod.dev/) — TS-first валидация схем
-- [Socket.IO](https://socket.io/) — обмен событиями в реальном времени
-- [Electron](https://www.electronjs.org/) — кроссплатформенный desktop-фреймворк
-- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) — фреймворк для локального ML
+- [Express](https://expressjs.com/) - Быстрый, гибкий и минималистичный веб-фреймворк для Node.js
+- [AI SDK](https://ai-sdk.dev/) - AI инструментарий для TypeScript
+- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - Библиотека с высокой производительностью для SQLite3
+- [Sharp](https://sharp.pixelplumbing.com/) - Высокопроизводительная библиотека Node.js для обработки изображений
+- [Axios](https://axios-http.com/) - Promise-based HTTP клиент
+- [Zod](https://zod.dev/) - Библиотека валидации схем, ориентированная на TypeScript
+- [Socket.IO](https://socket.io/) - Движок для двунаправленной real-time связи на основе событий
+- [Electron](https://www.electronjs.org/) - Фреймворк для кроссплатформенных десктоп-приложений
+- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - Библиотека для локального ML инференса
-Спасибо за поддержку проекту Toonflow от следующих организаций:
+Спасибо следующим организациям/лицам за поддержку Toonflow:
|
-
+
|
- Sophnet Cloud — спонсор вычислительных ресурсов - [сайт] + Sophnet (算能云) Спонсор вычислительных мощностей + [Сайт] |
+
- Atomgit
+
- 简体中文 | + 简体中文 | 繁體中文 | English | ไทย | @@ -31,11 +30,11 @@
- โรงงานละครสั้น AI
+ โรงงานผลิตภาพยนตร์สั้น AI
- แตะเพียงครั้งเดียว นิยายกลายเป็นตอนทันที!
+ เพียงคลิกไม่กี่ครั้ง นิยายก็กลายเป็นภาพยนตร์ได้ในพริบตา!
- สคริปต์ AI × ภาพ AI × สร้างเร็วสายฟ้าแลบ 🔥
+ บทภาพยนตร์ AI × ภาพ AI × สร้างวิดีโอความเร็วสูง 🔥
@@ -50,14 +49,14 @@
- > 🚀 **ผลิตละครสั้นครบวงจร:** จากข้อความสู่นักแสดง จากสตอรี่บอร์ดสู่วิดีโอ AI แบบเต็มกระบวนการ ทุกขั้นตอน ไม่มีอุปสรรค ประสิทธิภาพสร้าง 10 เท่าขึ้นไป! +> 🚀 **สตูดิโอภาพยนตร์สั้น All-in-One**: จากข้อความสู่ตัวละคร จากสตอรี่บอร์ดสู่ภาพยนตร์ ใช้ AI อัตโนมัติทั้งกระบวนการ ไม่ต้องมีพื้นฐานใด ๆ เพิ่มประสิทธิภาพการสร้างสรรค์มากกว่า 10 เท่า! --- -# � รองรับหลายภาษา +# 🌐 การรองรับหลายภาษา -Toonflow รองรับภาษาในอินเทอร์เฟซดังนี้: +Toonflow รองรับอินเทอร์เฟซภาษาดังต่อไปนี้: | ภาษา | Language | |------|----------| @@ -69,139 +68,144 @@ Toonflow รองรับภาษาในอินเทอร์เฟซ | 日本語 | Japanese | | Русский | Russian | +> 💡 กำลังเพิ่มการรองรับภาษาอื่นๆ ยินดีต้อนรับผู้ที่ต้องการช่วยแปล! + --- # 🌟 ฟีเจอร์หลัก -Toonflow คือเครื่องมือคอมิกละครสั้น AI ที่ใช้เทคโนโลยี AI แปลงนิยายเป็นสคริปต์โดยอัตโนมัติ และใช้ภาพและวิดีโอ AI เพื่อสร้างละครสั้นได้อย่างมีประสิทธิภาพ ด้วย Toonflow คุณสามารถสร้างผลงานจากข้อความสู่ภาพนิ่งจนถึงวิดีโอ ได้อย่างชาญฉลาดและสะดวก +Toonflow เป็นเครื่องมือ AI สำหรับสร้างภาพยนตร์สั้นและการ์ตูน ที่สามารถแปลงนิยายเป็นภาพยนตร์ได้โดยอัตโนมัติ ด้วยการผสานเทคโนโลยี AI ในการสร้างตัวละคร บทภาพยนตร์ ภาพประกอบ และวิดีโอ ทำให้กระบวนการผลิตภาพยนตร์สั้นมีประสิทธิภาพสูง ด้วย Toonflow คุณสามารถจัดการทุกขั้นตอนตั้งแต่ข้อความต้นฉบับจนถึงวิดีโอสำเร็จรูปได้อย่างง่ายดาย ทำให้การผลิตภาพยนตร์สั้นฉลาด สะดวก และรวดเร็วยิ่งขึ้น - ✅ **สร้างตัวละครอัตโนมัติ** - วิเคราะห์เนื้อหานิยายต้นฉบับ ระบุและสร้างข้อมูลตัวละครอย่างชาญฉลาด ทั้งรูปร่าง นิสัย ตัวตน เป็นต้น สร้างพื้นฐานที่แข็งแรงสำหรับสคริปต์และภาพในขั้นถัดไป -- ✅ **สร้างสคริปต์อัตโนมัติ** - จากเหตุการณ์และบทที่เลือก ระบบจะสร้างสคริปต์เชิงโครงสร้างอัตโนมัติ ครอบคลุมบทสนทนา คำบรรยายฉาก และทิศทางเนื้อเรื่อง เปลี่ยนข้อความวรรณกรรมเป็นสคริปต์ละครได้อย่างรวดเร็ว -- ✅ **ผลิตสตอรี่บอร์ดอัตโนมัติ** - ตามสคริปต์ สร้างพรอมต์สตอรี่บอร์ดและงานออกแบบภาพอัตโนมัติ รายละเอียดองค์ประกอบหน้า/กลาง/หลัง การเคลื่อนไหวตัวละคร อุปกรณ์ประกอบฉาก และการจัดวางฉาก พลิกสคริปต์เป็นสตอรี่บอร์ดวางแผนผลิตวิดีโอได้ครบถ้วน -- ✅ **ประกอบวิดีโอด้วย AI** - ผนวกเทคโนโลยีภาพและวิดีโอ AI สร้างคลิปวิดีโอด้วย AI รวมฟีเจอร์แก้ไขออนไลน์ รองรับการตั้งค่าผลลัพธ์ที่ปรับแต่งได้ ทำให้การสร้างภาพยนตร์/ละครมีประสิทธิภาพและทำงานร่วมทีมได้ + วิเคราะห์ข้อความจากนิยายต้นฉบับโดยอัตโนมัติ ระบุและสร้างโปรไฟล์ตัวละครอย่างชาญฉลาด รวมถึงรูปร่างหน้าตา นิสัย ตัวตน และรายละเอียดอื่น ๆ เพื่อสร้างพื้นฐานที่แข็งแรงสำหรับบทภาพยนตร์และภาพในขั้นตอนต่อไป + +- ✅ **สร้างบทภาพยนตร์** + จากเหตุการณ์และบท (Chapter) ที่เลือก ระบบจะสร้างบทภาพยนตร์ที่มีโครงสร้างชัดเจน ประกอบด้วยบทสนทนา คำอธิบายฉาก และทิศทางเรื่องราว ช่วยแปลงงานวรรณกรรมเป็นบทภาพยนตร์ได้อย่างมีประสิทธิภาพ + +- ✅ **สร้างสตอรี่บอร์ด (Storyboard)** + จากบทภาพยนตร์ ระบบจะสร้างพรอมต์และออกแบบเฟรมภาพสตอรี่บอร์ดโดยอัตโนมัติ โดยระบุรายละเอียดฉากหน้า ฉากกลาง ฉากหลัง การเคลื่อนไหวของตัวละคร พร็อพ และการจัดวางฉาก เพื่อสร้างแผนการผลิตวิดีโอที่สมบูรณ์ + +- ✅ **สังเคราะห์และตัดต่อวิดีโอ** + ใช้เทคโนโลยี AI สร้างคลิปวิดีโอคุณภาพสูง รองรับระบบตัดต่อออนไลน์ที่สามารถปรับแต่งได้ตามต้องการ ช่วยให้กระบวนการสร้างภาพยนตร์สั้นเป็นไปอย่างราบรื่นและรวดเร็ว --- -# 📦 ตัวอย่างการใช้งาน +# 📦 รูปแบบการใช้งาน (Use Cases) -- สร้างวิดีโอละครสั้น -- ทดลองแปลงนิยายสู่ภาพยนตร์/ละคร -- เครื่องมือดัดแปลงวรรณกรรมด้วย AI -- การพัฒนาสคริปต์และต้นแบบผลิตงานเร็ว -- สร้างวัตถุดิบประกอบวิดีโอ +- สร้างคอนเทนต์วิดีโอสั้น +- ทดลองแปลงนิยายเป็นภาพยนตร์สั้น +- เครื่องมือ AI ในการดัดแปลงวรรณกรรมเป็นภาพยนตร์ +- พัฒนาบทภาพยนตร์และสร้างต้นแบบ (Rapid Prototyping) อย่างรวดเร็ว +- สร้างฟุตเทจและวัสดุวิดีโอคุณภาพสูง ---- +# 🔰 คู่มือการใช้งาน -# 🔰 คู่มือผู้ใช้ +## 📺 วิดีโอสอนการใช้งาน -## 📺 วิดีโอสอนใช้งาน +[https://www.bilibili.com/video/BV1na6wB6Ea2](https://www.bilibili.com/video/BV1na6wB6Ea2) +[](https://www.bilibili.com/video/BV1na6wB6Ea2) -https://www.bilibili.com/video/BV1na6wB6Ea2 -[](https://www.bilibili.com/video/BV1na6wB6Ea2) - -**วิดีโอแนะนำ Toonflow ฉบับเร่งด่วน 8 นาที** +**เริ่มต้นสร้างวิดีโอ AI กับ Toonflow ใน 8 นาที** 👉 [คลิกเพื่อรับชม](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e) -📱 สแกนด้วย WeChat บนมือถือเพื่อชม +📱 **สแกน QR Code เพื่อรับชมวิดีโอบนมือถือ** -
+
---
# 🚀 การติดตั้ง
-## สิ่งที่ต้องเตรียมก่อน
+## ข้อกำหนดเบื้องต้น
-ก่อนติดตั้งและใช้งานซอฟต์แวร์นี้ กรุณาเตรียมสิ่งเหล่านี้:
+ก่อนติดตั้งและใช้งาน Toonflow โปรดเตรียมข้อมูลต่อไปนี้ให้พร้อม:
-- ✅ ที่อยู่ API บริการ AI แบบ Large Language Model
-- ✅ ที่อยู่ API บริการวิดีโอ Sora หรือ Doubao
-- ✅ ที่อยู่ API โมเดลสร้างภาพ Nano Banana Pro
+- ✅ ที่อยู่ API ของโมเดลภาษาขนาดใหญ่ (LLM)
+- ✅ ที่อยู่ API ของบริการสร้างวิดีโอ (Sora หรือ Doubao)
+- ✅ ที่อยู่ API ของโมเดลสร้างภาพ Nano Banana Pro
-## ติดตั้งในเครื่อง (Local Installation)
+## การติดตั้งบนเครื่อง (Local)
### 1. ดาวน์โหลดและติดตั้ง
-| ระบบปฏิบัติการ | GitHub | Atomgit | ดาวน์โหลดผ่าน Quark Netdisk | หมายเหตุ |
-| :------------: | :------------------------------------------------------- | :---------------------------------------------------- | :--------------------------------------------------- | :---------------------- |
-| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Netdisk](https://pan.quark.cn/s/94ef07509df0) | แพ็กเกจติดตั้งอย่างเป็นทางการ |
-| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Netdisk](https://pan.quark.cn/s/94ef07509df0) | แพ็กเกจติดตั้งอย่างเป็นทางการ |
-| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Netdisk](https://pan.quark.cn/s/94ef07509df0) | แพ็กเกจติดตั้งอย่างเป็นทางการ |
+| ระบบปฏิบัติการ | GitHub | Atomgit | ดาวน์โหลดผ่าน Quark Drive | คำอธิบาย |
+| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
+| 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) | ตัวติดตั้งอย่างเป็นทางการ |
+| 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) | ตัวติดตั้งอย่างเป็นทางการ |
+| 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) | ตัวติดตั้งอย่างเป็นทางการ |
> [!CAUTION]
-> บน MacOS ให้ไปที่ ตั้งค่า - ความเป็นส่วนตัวและความปลอดภัย ตั้งค่าความปลอดภัยก่อน มิฉะนั้นอาจไม่สามารถเปิดแอปได้เพราะปัญหาใบรับรอง
+> สำหรับระบบ macOS โปรดไปที่ **การตั้งค่า > ความเป็นส่วนตัวและความปลอดภัย** เพื่ออนุญาตให้แอปพลิเคชันทำงาน มิฉะนั้นอาจเปิดโปรแกรมไม่ได้เนื่องจากปัญหาใบรับรองความปลอดภัย
>
-> ดูเอกสารฉบับภาษาจีน: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+> อ้างอิงเอกสารจาก Zhihu: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
-> ด้วยข้อจำกัดของสภาพแวดล้อม Gitee OS และขนาดไฟล์ Release การดาวน์โหลดผ่าน Gitee Release ยังไม่เปิดให้บริการในขณะนี้
+> เนื่องจากข้อจำกัดเรื่องสภาพแวดล้อมระบบและขนาดไฟล์ของ Gitee Release ปัจจุบันจึงยังไม่มีลิงก์ดาวน์โหลดบน Gitee
-### 2. เปิดใช้งานโปรแกรม
+### 2. เริ่มการทำงาน
-ติดตั้งเสร็จแล้วให้เปิดโปรแกรมเพื่อเริ่มใช้งาน
+หลังจากติดตั้งเสร็จสิ้น เพียงเปิดโปรแกรม Toonflow ก็สามารถเริ่มใช้งานได้ทันที
-> ⚠️ **ล็อกอินครั้งแรก**
+> ⚠️ **เข้าสู่ระบบครั้งแรก**
> ชื่อผู้ใช้: `admin`
> รหัสผ่าน: `admin123`
-## การใช้ Docker
+## การใช้งานผ่าน Docker
-### สิ่งที่ต้องเตรียม
+### ข้อกำหนดเบื้องต้น
-- ติดตั้ง [Docker](https://docs.docker.com/get-docker/) (เวอร์ชัน 20.10+)
+- ติดตั้ง [Docker](https://docs.docker.com/get-docker/) เวอร์ชัน 20.10 ขึ้นไป เรียบร้อยแล้ว
-### วิธีที่ 1: ติดตั้งออนไลน์
+### วิธีที่ 1: การติดตั้งออนไลน์
-กำลังพัฒนา; ขณะนี้ให้ใช้การ build ในเครื่อง
+กำลังพัฒนา
+ปัจจุบันแนะนำให้ใช้วิธี Build บนเครื่องก่อน
-### วิธีที่ 2: สร้างเองในเครื่อง
+### วิธีที่ 2: การ Build บนเครื่อง
-สำหรับนักพัฒนา หรือผู้ที่ clone repo แล้ว ต้องติดตั้ง Git ที่เครื่อง
+ใช้วิธี Build จากซอร์สโค้ดที่มีอยู่ในเครื่องโดยตรง
+เหมาะสำหรับนักพัฒนาหรือผู้ใช้ที่โคลน Repository มาแล้ว (ต้องติดตั้ง Git บนเครื่องก่อน)
```shell
-# clone โปรเจกต์ (ถ้าทำแล้วข้าม)
+# โคลนโปรเจกต์ก่อน (ข้ามขั้นตอนนี้ถ้ามีอยู่แล้ว)
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
-# สร้างและเริ่มผ่าน docker-compose
+# ใช้ docker-compose ในการ Build และรันบนเครื่อง
yarn docker:local
-# หรือสร้างแบบ manual
+# หรือทำการ Build แบบแมนนวล
docker build -t toonflow .
-docker run -d -p
+[](https://discord.gg/HEjKmpNpAZ)
+
+หรือคลิกลิงก์โดยตรง: [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
---
# 💌 ติดต่อเรา
-📧 อีเมล: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow inquiry)
+📧 อีเมล: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=สอบถาม%20เรื่อง%20Toonflow)
---
-# 📜 ใบอนุญาต
+# 📜 ใบอนุญาต (License)
-Toonflow เป็นโอเพ่นซอร์สภายใต้ Apache-2.0 พร้อมข้อตกลงเชิงพาณิชย์เพิ่มเติม
+Toonflow เปิดเผยเป็นโอเพ่นซอร์สภายใต้สัญญาอนุญาต Apache-2.0 พร้อมด้วยข้อตกลงเชิงพาณิชย์เพิ่มเติม
-รายละเอียด: https://www.apache.org/licenses/LICENSE-2.0
+รายละเอียดสัญญา Apache-2.0: https://www.apache.org/licenses/LICENSE-2.0
-## ข้อตกลงเพิ่มเติม
+## ข้อตกลงเชิงพาณิชย์เพิ่มเติม
-- หากแจกจ่ายซอฟต์แวร์นี้ในฐานะผลิตภัณฑ์ให้ **บุคคลที่สามอิสระ 2 รายขึ้นไป** ต้องได้รับ **อนุญาตเชิงพาณิชย์เป็นลายลักษณ์อักษร** จาก HBAI-Ltd
-- **≤ 5 นิติบุคคล** ร่วมดำเนินงานภายในโดยไม่ให้บริการภายนอก ถือเป็น **การใช้งานภายใน ไม่ต้องขออนุญาต**
-- ห้ามลบหรือแก้ไขเครื่องหมายการค้า โลโก้ หรือข้อมูลลิขสิทธิ์ใน Toonflow
+- หากนำซอฟต์แวร์นี้ไปเผยแพร่ในรูปแบบผลิตภัณฑ์ให้กับ **บุคคลที่สามอิสระตั้งแต่ 2 รายขึ้นไป** ต้องได้รับ **การอนุญาตเชิงพาณิชย์เป็นลายลักษณ์อักษร** จาก HBAI-Ltd
+- หากใช้งานร่วมกันภายในโดย **นิติบุคคลไม่เกิน 5 ราย** และไม่ให้บริการแก่บุคคลภายนอก จะถือเป็นการใช้งานภายในและ **ไม่ต้องขออนุญาต**
+- ห้ามลบหรือแก้ไขโลโก้หรือข้อมูลลิขสิทธิ์ภายใน Toonflow
-## ใช้งานฟรีตลอดกาล
+## กรณีใช้งานฟรีตลอดชีพ
-- ✅ ใช้ Toonflow สร้างเนื้อหาและรับส่วนแบ่งรายได้จากแพลตฟอร์ม
-- ✅ พัฒนาต่อยอดสำหรับทีมภายใน
-- ✅ ≤ 5 นิติบุคคลร่วมดำเนินงานภายใน
-- ✅ เรียนรู้ส่วนตัว วิจัย และใช้งานที่ไม่ใช่เชิงพาณิชย์
+- ✅ ใช้ Toonflow สร้างเนื้อหาเพื่อรับส่วนแบ่งรายได้จากแพลตฟอร์มวิดีโอ
+- ✅ นำโค้ดไปพัฒนาต่อยอดเพื่อใช้งานภายในทีม
+- ✅ ใช้งานร่วมกันภายในโดยนิติบุคคลไม่เกิน 5 ราย
+- ✅ เพื่อการศึกษา การวิจัย และวัตถุประสงค์ที่ไม่ใช่เชิงพาณิชย์
-## ราคาใบอนุญาตเชิงพาณิชย์
+## โครงสร้างราคาการอนุญาตเชิงพาณิชย์
-| ระยะ | ยอดขายต่อปี | ค่าธรรมเนียมต่อปี |
-|------|---------|------|
-| 🌱 บ่มเพาะ | < ¥100,000 | **ฟรี** |
-| 🚀 สตาร์ทอัพ | ¥100,000–500,000 | ¥5,000/ปี |
-| 📈 เติบโต | ¥500,000–1,500,000 | ¥20,000/ปี |
-| 🏢 ขยายตัว | ¥1,500,000–5,000,000 | ¥80,000/ปี |
-| 🌐 องค์กร | > ¥5,000,000 | เจรจา |
+| ระยะ | ยอดขายรายปี | ค่าธรรมเนียมรายปี |
+|--------------|-----------------------------|-----------------------|
+| 🌱 ช่วงเริ่มต้น (Incubation) | < ¥100,000 | **ฟรี** |
+| 🚀 ช่วง startup | ¥100,000 – 500,000 | ¥5,000 / ปี |
+| 📈 ช่วงเติบโต (Growth) | ¥500,000 – 1,500,000 | ¥20,000 / ปี |
+| 🏢 ช่วงขยายขนาด (Scale) | ¥1,500,000 – 5,000,000 | ¥80,000 / ปี |
+| 🌐 ระดับองค์กร (Enterprise) | > ¥5,000,000 | เจรจาต่อรอง |
-> **เงื่อนไขไม่ย้อนหลัง**: ผู้ใช้ที่ใช้ Toonflow ภายใต้ AGPL-3.0 ก่อนการเผยแพร่ v1.0.8 จะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ การใช้งานปัจจุบันยังคงเป็นไปตาม AGPL-3.0
+> **ข้อกำหนดไม่ย้อนหลัง (Non-Retroactivity)**: ผู้ใช้ที่เคยใช้งาน Toonflow ภายใต้สัญญา AGPL-3.0 ก่อนเวอร์ชัน v1.0.8 จะยังคงผูกพันตาม AGPL-3.0 ต่อไป และไม่ได้รับผลกระทบจากการเปลี่ยนแปลงข้อตกลงนี้
-ดูข้อตกลงฉบับเต็มที่ [LICENSE](../LICENSE)
+ดูรายละเอียดข้อตกลงฉบับเต็มได้ที่ไฟล์ [LICENSE](./LICENSE)
---
-# ⭐️ ประวัติการกดดาว
+# ⭐️ ประวัติการให้ดาว (Star History)
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
@@ -557,32 +570,32 @@ Toonflow เป็นโอเพ่นซอร์สภายใต้ Apache-
# 🙏 ขอขอบคุณ
-ขอบคุณโอเพ่นซอร์สต่อไปนี้ที่สนับสนุน Toonflow:
+ขอขอบคุณโปรเจกต์โอเพ่นซอร์สต่อไปนี้ที่ช่วยสนับสนุน Toonflow อย่างมาก:
-- [Express](https://expressjs.com/) - เฟรมเวิร์ก Node.js ที่เร็ว เล็ก และเปิดกว้าง
-- [AI SDK](https://ai-sdk.dev/) - ชุดเครื่องมือ AI-first สำหรับ TypeScript
-- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - Binding SQLite3 ประสิทธิภาพสูง
-- [Sharp](https://sharp.pixelplumbing.com/) - ไลบรารีจัดการภาพบน Node.js ประสิทธิภาพสูง
-- [Axios](https://axios-http.com/) - HTTP client แบบ Promise
-- [Zod](https://zod.dev/) - ไลบรารีตรวจสอบชนิด TypeScript เป็นหลัก
-- [Socket.IO](https://socket.io/) - เฟรมเวิร์ก event bidirectional แบบเรียลไทม์
-- [Electron](https://www.electronjs.org/) - เฟรมเวิร์กสร้างแอปเดสก์ท็อปข้ามแพลตฟอร์ม
-- [Hugging Face Transformers](https://huggingface.co./transformers.js) - ไลบรารี ML inference ในเครื่อง
+- [Express](https://expressjs.com/) - Web Framework สำหรับ Node.js ที่รวดเร็ว เปิดกว้าง และใช้งานง่าย
+- [AI SDK](https://ai-sdk.dev/) - ชุดเครื่องมือ AI สำหรับ TypeScript
+- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - ไลบรารี SQLite3 ประสิทธิภาพสูง
+- [Sharp](https://sharp.pixelplumbing.com/) - ไลบรารีประมวลผลภาพบน Node.js ประสิทธิภาพสูง
+- [Axios](https://axios-http.com/) - HTTP Client แบบ Promise-based
+- [Zod](https://zod.dev/) - ไลบรารีตรวจสอบโครงสร้างข้อมูล (Schema Validation) สำหรับ TypeScript
+- [Socket.IO](https://socket.io/) - เอนจินการสื่อสารเรียลไทม์แบบสองทาง
+- [Electron](https://www.electronjs.org/) - เฟรมเวิร์กพัฒนาแอปพลิเคชันเดสก์ท็อปข้ามแพลตฟอร์ม
+- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - ไลบรารี Machine Learning สำหรับการ Inference บนเครื่อง
-ขอบคุณองค์กร/บุคคลต่อไปนี้สนับสนุน Toonflow:
+ขอขอบคุณองค์กรและผู้สนับสนุนต่อไปนี้ที่ช่วยเหลือ Toonflow:
|
-
+
|
- SophNet Cloud เป็นผู้สนับสนุนทรัพยากรการประมวลผล
- [เว็บไซต์]
+ Sophnet (算能云) ให้การสนับสนุนด้านพลังการประมวลผล (Computing Power) + [เว็บไซต์ทางการ] |
- Atomgit
+
- 简体中文 | + 简体中文 | 繁體中文 | English | ไทย | @@ -31,11 +30,11 @@
- Xưởng sản xuất phim ngắn AI
+ Nhà máy Phim ngắn AI
- Động ngón tay là tiểu thuyết hóa thành phim ngay!
+ 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 dựng thần tốc 🔥
+ Kịch bản AI × Hình ảnh AI × Tạo siêu tốc 🔥
@@ -50,17 +49,17 @@
- > 🚀 **Công cụ sản xuất phim ngắn một cửa**: Từ văn bản tới nhân vật, từ dàn cảnh tới video, toàn bộ quy trình AI hóa không cần kỹ năng, tăng hiệu quả sáng tạo gấp 10 lần+! + > 🚀 **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! --- -# 🌐 Hỗ trợ đa ngôn ngữ +# 🌐 Hỗ trợ Đa ngôn ngữ -Toonflow hỗ trợ các ngôn ngữ giao diện sau: +Toonflow hỗ trợ giao diện với các ngôn ngữ sau: | Ngôn ngữ | Language | -|-----------|----------| +|------|----------| | 简体中文 | Chinese (Simplified) | | 繁體中文 | Chinese (Traditional) | | English | English | @@ -69,46 +68,43 @@ Toonflow hỗ trợ các ngôn ngữ giao diện sau: | 日本語 | Japanese | | Русский | Russian | ---- - -# 🌟 Tính năng chính - -Toonflow là công cụ AI tạo phim truyện tranh ngắn, tận dụng công nghệ AI để chuyển tự động tiểu thuyết thành kịch bản, kết hợp hình ảnh, video AI để sáng tác phim ngắn hiệu quả. Với Toonflow, bạn dễ dàng hoàn thành toàn bộ quy trình từ văn bản tới hình ảnh, khiến chế tác phim ngắn trở nên thông minh và tiện lợi hơn bao giờ hết. - -- ✅ **Tạo nhân vật** - Phân tích tự động văn bản tiểu thuyết gốc, nhận diện thông minh và xây dựng thiết lập nhân vật, gồm ngoại hình, tính cách, thân phận,... cung cấp nền tảng chắc chắn cho sáng tác kịch bản và hình ảnh sau này. -- ✅ **Tạo kịch bản** - Dựa trên sự kiện và chương đã chọn, hệ thống tự động tạo kịch bản có cấu trúc gồm thoại, mô tả cảnh, diễn biến tình tiết, chuyển đổi hiệu quả từ văn học sang kịch bản truyền hình, điện ảnh. -- ✅ **Làm phân cảnh** - Theo nội dung kịch bản, tự động tạo từ khóa phân cảnh, thiết kế hình ảnh, chi tiết tiền trung hậu cảnh, động thái nhân vật, thiết lập đạo cụ và bố trí trường quay, tự động phân cảnh dựa trên kịch bản, tối ưu đường lối sản xuất video. -- ✅ **Tổng hợp video** - Tích hợp công nghệ tạo ảnh và video AI, dùng AI tạo phân đoạn video, biên tập trực tuyến, hỗ trợ điều chỉnh cá nhân hóa đầu ra, giúp sáng tác phim hiệu quả, triển khai nhanh. +> 💡 Đang cập nhật thêm nhiều ngôn ngữ, hoan nghênh bạn đóng góp bản dịch! --- -# 📦 Ứng dụng +# 🌟 Tính năng Chính -- Sáng tác nội dung video ngắn -- Thử nghiệm điện ảnh hóa tiểu thuyết -- Công cụ AI chuyển thể văn học -- Phát triển, dựng mẫu nhanh kịch bản -- Tạo nguyên liệu video +Toonflow là công cụ AI chuyên tạo phim ngắn và truyện tranh, có khả năng tự động biến tiểu thuyết thành phim chỉ trong một quy trình liền mạch. Từ văn bản gốc, AI sẽ tạo nhân vật, viết kịch bản, thiết kế phân cảnh và tổng hợp video hoàn chỉnh – giúp bạn sản xuất phim ngắn nhanh chóng, thông minh và tiết kiệm chi phí tối đa. + +- ✅ **Tạo Nhân vật Tự động** Hệ thống phân tích tiểu thuyết gốc, thông minh nhận diện và xây dựng hồ sơ nhân vật chi tiết (ngoại hình, tính cách, danh tính, mối quan hệ…). Tạo nền tảng vững chắc cho kịch bản và hình ảnh sau này. +- ✅ **Tạo Kịch bản Thông minh** Dựa trên các chương/sự kiện bạn chọn, AI tự động xây dựng kịch bản có cấu trúc rõ ràng, bao gồm hội thoại tự nhiên, mô tả cảnh quay và hướng phát triển cốt truyện – chuyển đổi văn học sang kịch bản phim một cách hiệu quả. +- ✅ **Tạo Phân cảnh (Storyboard)** Từ kịch bản, hệ thống tự động sinh ra các prompt phân cảnh và thiết kế khung hình chi tiết. Bao gồm tiền cảnh/trung cảnh/hậu cảnh, hành động nhân vật, đạo cụ và bố cục điện ảnh – tạo ra lộ trình hoàn chỉnh sẵn sàng cho việc sản xuất video. +- ✅ **Tổng hợp & Chỉnh sửa Video** Tích hợp công nghệ AI hình ảnh và video để tạo ra các đoạn clip chất lượng cao. Hỗ trợ chỉnh sửa trực tuyến linh hoạt, cho phép bạn tinh chỉnh theo ý muốn, giúp toàn bộ quy trình sáng tạo phim diễn ra mượt mà và cực kỳ nhanh chóng. --- -# 🔰 Hướng dẫn sử dụng +# 📦 Ứng dụng Thực tế -## 📺 Video hướng dẫn +- Sáng tạo nội dung video ngắn +- Thử nghiệm chuyển thể tiểu thuyết thành phim ngắn +- Công cụ AI chuyển thể văn học thành video +- Phát triển kịch bản và tạo bản mẫu nhanh (Rapid Prototyping) +- Tạo tài liệu video chất lượng cao -https://www.bilibili.com/video/BV1na6wB6Ea2 -[](https://www.bilibili.com/video/BV1na6wB6Ea2) +--- -**Toonflow 8 phút nhanh chóng bắt đầu với AI Video** -👉 [Click xem tại đây](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e) +# 🔰 Hướng dẫn Sử dụng -📱 Quét mã QR trên WeChat để xem trên điện thoại +## 📺 Hướng dẫn bằng Video -
+[https://www.bilibili.com/video/BV1na6wB6Ea2](https://www.bilibili.com/video/BV1na6wB6Ea2)
+[](https://www.bilibili.com/video/BV1na6wB6Ea2)
+
+**Toonflow - 8 phút làm quen nhanh với Video AI**
+👉 [Nhấn để xem](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e)
+
+📱 **Quét mã QR để xem video trên điện thoại**
+
---
@@ -116,105 +112,105 @@ https://www.bilibili.com/video/BV1na6wB6Ea2
## Điều kiện tiên quyết
-Trước khi cài đặt và sử dụng, hãy chuẩn bị:
+Trước khi cài đặt và sử dụng phần mềm, vui lòng chuẩn bị:
-- ✅ Địa chỉ API dịch vụ mô hình ngôn ngữ lớn (AI)
-- ✅ Địa chỉ API dịch vụ video Sora hoặc Đậu Bao
-- ✅ Địa chỉ API dịch vụ tạo ảnh Nano Banana Pro
+- ✅ Đị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 tại máy
+## Cài đặt trên máy cá nhân (Local)
-### 1. Tải về & cài đặt
+### 1. Tải xuống & Cài đặt
-| Hệ điều hành | GitHub | Atomgit | Tải về trên Quark Drive | Ghi chú |
-| :----------: | :------------------------------------------------------- | :----------------------------------------------------- | :--------------------------------------------------- | :-------------- |
-| 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) | Gói 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) | Gói 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) | Gói cài đặt chính thức |
+| 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]
-> Đối với MacOS, vào Cài đặt - Quyền riêng tư & Bảo mật để cấu hình, nếu không phần mềm có thể không mở được do vấn đề chứng chỉ
+> 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 tài liệu Zhihu: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+> Tham khảo hướng dẫn Zhihu: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
-> Do hạn chế môi trường Gitee OS và kích thước upload Release, hiện chưa cung cấp đường dẫn tải Release tại Gitee.
+> 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 động dịch vụ
+### 2. Khởi chạy Dịch vụ
-Cài đặt xong, mở chương trình là có thể bắt đầu sử dụng.
+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**
+> ⚠️ **Đăng nhập lần đầu**
> Tài khoản: `admin`
> Mật khẩu: `admin123`
-## Triển khai Docker
+## Triển khai bằng Docker
-### Điều kiện
+### Điều kiện tiên quyết
-- Đã cài đặt [Docker](https://docs.docker.com/get-docker/) (version 20.10+)
+- Đã 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 build trên máy.
+Đ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 local
+### Cách 2: Build tại máy (Local build)
-Dùng mã nguồn sẵn có, phù hợp cho dev hoặc người đã clone repo, cần cài git trên máy:
+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 nếu chưa có
+# Clone dự án (Bỏ qua nếu đã clone)
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
-# Build và khởi động bằng docker-compose
+# 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
+[](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ệ
+# 💌 Liên hệ với chúng tôi
-📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow咨询)
+📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow%20%C6%B0%C9%9B)
---
-# 📜 Giấy phép
+# 📜 Giấy phép (License)
-Toonflow phát hành mã nguồn mở theo Apache-2.0, kèm thỏa thuận thương mại bổ sung.
+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: https://www.apache.org/licenses/LICENSE-2.0
+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 phối phần mềm này dưới dạng sản phẩm cho **2 bên thứ ba độc lập trở lên**, bạn phải có **ủy quyền thương mại bằng văn bản** từ HBAI-Ltd.
-- **≤ 5 pháp nhân** cùng vận hành nội bộ mà không cung cấp dịch vụ ra bên ngoài được coi là **sử dụng nội bộ, không cần ủy quyền**.
-- Không được xóa hoặc sửa đổi nhãn hiệu, logo hoặc thông tin bản quyền trong Toonflow.
+- 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.
-## Miễn phí vĩnh viễn
+## Các trường hợp Miễn phí Vĩnh viễn
-- ✅ Sử dụng Toonflow tạo nội dung và nhận chia sẻ doanh thu nền tảng
-- ✅ Phát triển thêm cho sử dụng nội bộ nhóm
-- ✅ ≤ 5 pháp nhân vận hành chung nội bộ
-- ✅ Học tập cá nhân, nghiên cứu, mục đích phi thương mại
+- ✅ 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á ủy quyền thương mại
+## Bảng giá Cấp phép Thương mại
-| Giai đoạn | Doanh thu năm | Phí hàng năm |
+| Giai đoạn | Doanh thu Hàng năm | Phí Hàng năm |
|------|---------|------|
-| 🌱 Ươm tạo | < ¥100,000 | **Miễn phí** |
-| 🚀 Khởi nghiệp | ¥100,000–500,000 | ¥5,000/năm |
-| 📈 Tăng trưởng | ¥500,000–1,500,000 | ¥20,000/năm |
-| 🏢 Mở rộng | ¥1,500,000–5,000,000 | ¥80,000/năm |
-| 🌐 Doanh nghiệp | > ¥5,000,000 | Thương lượng |
+| 🌱 Ươ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ố**: Người dùng đã sử dụng Toonflow theo AGPL-3.0 trước khi phát hành v1.0.8 không bị ảnh hưởng. Việc sử dụng hiện tại tiếp tục theo AGPL-3.0.
+> **Đ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 thỏa thuận đầy đủ tại [LICENSE](../LICENSE).
+Xem toàn bộ thỏa thuận tại tệp [LICENSE](./LICENSE).
---
-# ⭐️ Lịch sử đánh dấu sao
+# ⭐️ Lịch sử Thả sao (Star History)
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
---
-# 🙏 Lời cảm ơn
+# 🙏 Lời Cảm ơn
-Cảm ơn các dự án open source sau đã hỗ trợ Toonflow mạnh mẽ:
+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/) - Framework Web Node.js nhanh, mở, gọn nhẹ
-- [AI SDK](https://ai-sdk.dev/) - Bộ tool AI cho TypeScript
-- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - Bindings SQLite3 hiệu năng cao
-- [Sharp](https://sharp.pixelplumbing.com/) - Thư viện xử lý ảnh Node.js nhanh
+- [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/) - Library kiểm tra schema ưu tiên TypeScript
-- [Socket.IO](https://socket.io/) - Engine realtime song phương sự kiện
-- [Electron](https://www.electronjs.org/) - Framework phát triển desktop app đa nền tảng
-- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - Thư viện infer ML local
+- [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
-Cảm ơn các tổ chức/đơn vị/cá nhân sau đã hỗ trợ Toonflow:
+Xin cảm ơn các tổ chức/đơn vị/cá nhân sau đây đã hỗ trợ cho Toonflow:
|
-
+
|
- Suanneng Cloud tài trợ năng lực tính toán - [Trang chủ] + Sophnet (算能云) Tài trợ năng lực tính toán (Computing power) + [Website] |
+
- Atomgit
+
- 简体中文 | + 简体中文 | 繁體中文 | English | - ไทย | - Tiếng Việt | - 日本語 | - Русский + ไทย | + Tiếng Việt | + 日本語 | + Русский
- AI短劇工廠
+ AI 短劇工廠
- 一鍵點擊，小說秒變短劇！
+ 動動手指，小說秒變劇集！
- AI劇本 × AI視覺 × 渦輪生成 🔥
+ AI 劇本 × AI 影像 × 極速生成 🔥
@@ -50,7 +49,7 @@
- > 🚀 **一站式短劇生產**：從文本到人物、從分鏡到影片，零門檻全流程AI，10倍以上創作效率！ + > 🚀 **一站式短劇工程**：從文字到角色，從分鏡到影片，0 門檻全流程 AI 化，創作效率提升 10 倍+！
+
---
-# 🚀 安裝方法
+# 🚀 安裝
-## 前置準備
+## 前置條件
-安裝與使用前請準備以下內容：
+安裝並使用本軟體前，請先準備以下項目：
-- ✅ 大語言模型AI服務API地址
-- ✅ Sora或豆包視頻服務API地址
-- ✅ Nano Banana Pro圖像生成模型API
+- ✅ 大型語言模型 (LLM) 的 API 網址
+- ✅ Sora 或豆包影片生成服務的 API 網址
+- ✅ Nano Banana Pro 圖像生成模型的 API 網址
-## 本地安裝
+## 本機安裝
-### 1. 下載安裝
+### 1. 下載與安裝
-| 作業系統 | GitHub | Atomgit | 夸克網盤下載 | 說明 |
+| 作業系統 | GitHub | Atomgit | 夸克網碟下載 | 說明 |
| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
-| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [夸克網盤](https://pan.quark.cn/s/94ef07509df0) | 官方發布安裝包 |
-| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [夸克網盤](https://pan.quark.cn/s/94ef07509df0) | 官方發布安裝包 |
-| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [夸克網盤](https://pan.quark.cn/s/94ef07509df0) | 官方發布安裝包 |
+| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [夸克網碟](https://pan.quark.cn/s/94ef07509df0) | 官方發佈安裝包 |
+| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [夸克網碟](https://pan.quark.cn/s/94ef07509df0) | 官方發佈安裝包 |
+| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [夸克網碟](https://pan.quark.cn/s/94ef07509df0) | 官方發佈安裝包 |
> [!CAUTION]
-> MacOS上需進入設定–隱私安全配置安全設定，否則可能因憑證問題無法打開應用。
+> MacOS 系統請至「系統設定」-「隱私權與安全性」設定安全性，否則可能因憑證問題無法正常開啟。
>
-> 參考知乎文檔：[https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
+> 參考知乎教學：[https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
-> 受Gitee作業系統環境與釋出檔案大小限制，目前Gitee釋出下載暫不開放。
+> 因 Gitee OS 環境限制及 Release 檔案上傳大小限制，暫不提供 Gitee Release 下載連結。
### 2. 啟動服務
安裝完成後，啟動程式即可開始使用本服務。
-> ⚠️ **首次登入**
-> 用戶名：`admin`
+> ⚠️ **首次登入**
+> 帳號：`admin`
> 密碼：`admin123`
-## Docker部署
+## Docker 部署
-### 前置準備
+### 前置條件
-- 已安裝 [Docker](https://docs.docker.com/get-docker/)（20.10+）
+- 已安裝 [Docker](https://docs.docker.com/get-docker/)（版本 20.10+）
-### 方法一：線上部署
+### 方式一：線上部署
-待開發，現請使用本地構建。
+待完善，暫時使用本機建置。
-### 方法二：本地構建
+### 方式二：本機建置
-適用於開發者或已克隆源碼的用戶，需本地安裝Git：
+使用本機已有的原始碼直接建置，適合開發者或已 Clone 儲存庫的使用者，這需要您在本機安裝 git：
```shell
-# 克隆專案（已克隆則略過）
+# 先 Clone 專案（若已有則跳過）
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
-# 用docker-compose本地構建啟動
+# 使用 docker-compose 進行本機建置並啟動
yarn docker:local
-# 或手動構建
+# 或者手動建置
docker build -t toonflow .
-docker run -d -p
+[](https://discord.gg/HEjKmpNpAZ)
+
+或直接點擊連結： [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
---
-# 💌 聯繫我們
+# 💌 聯絡我們
-📧 郵箱：[ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow inquiry)
+📧 信箱：[ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow諮詢)
---
-# 📜 開源協議
+# 📜 授權條款
-Toonflow 基於 Apache-2.0 協議開源發布，並附有補充商業協議。
+Toonflow 基於 Apache-2.0 協定開源發佈，並附有補充商業協議。
-授權詳情：https://www.apache.org/licenses/LICENSE-2.0
+授權條款詳情：https://www.apache.org/licenses/LICENSE-2.0
## 補充協議
-- 若將本軟體以產品形式分發給 **2 個及以上獨立第三方**使用，須取得 HBAI-Ltd **書面商業授權**。
-- **≤ 5 個法人**聯合運營內部使用，不對外提供服務的，視為內部使用，**無需授權**。
+- 若將本軟體以產品形式散佈給 **2 個及以上獨立第三方**使用，須取得 HBAI-Ltd **書面商業授權**。
+- **≤ 5 個法人**聯合營運內部使用，不對外提供服務的，視為內部使用，**無需授權**。
- 不得刪除或修改 Toonflow 中的標識或版權資訊。
## 永久免費場景
-- ✅ 用 Toonflow 製作內容並獲得平台分帳
+- ✅ 用 Toonflow 製作內容並獲得平台分潤
- ✅ 二次開發供自己團隊內部使用
-- ✅ ≤ 5 個法人聯合運營內部使用
+- ✅ ≤ 5 個法人聯合營運內部使用
- ✅ 個人學習、研究、非商業用途
-## 商業授權定價
+## 商業授權定價（人民幣）
-| 階段 | 年銷售額 | 年費 |
-|------|---------|------|
-| 🌱 扶持期 | < ¥10 萬 | **免費** |
-| 🚀 初創期 | ¥10–50 萬 | ¥5,000/年 |
-| 📈 成長期 | ¥50–150 萬 | ¥20,000/年 |
-| 🏢 規模期 | ¥150–500 萬 | ¥80,000/年 |
-| 🌐 企業級 | > ¥500 萬 | 面議 |
+| 階段 | 年營業額 | 年費 |
+|------------|---------------------------|-------------------|
+| 🌱 扶持期 | < 10 萬人民幣 | **免費** |
+| 🚀 初創期 | 10–50 萬人民幣 | ¥5,000 / 年 |
+| 📈 成長期 | 50–150 萬人民幣 | ¥20,000 / 年 |
+| 🏢 規模期 | 150–500 萬人民幣 | ¥80,000 / 年 |
+| 🌐 企業級 | > 500 萬人民幣 | 面議 |
-> **不追溯條款**：v1.0.8 發布前基於 AGPL-3.0 使用的用戶，繼續按 AGPL-3.0 執行，不受本協議變更約束。
+> **不溯及既往條款**：v1.0.8 發佈前基於 AGPL-3.0 使用的使用者，繼續按 AGPL-3.0 執行，不受本協議變更約束。
-完整協議詳見 [LICENSE](../LICENSE) 檔案。
+完整協議詳見 [LICENSE](./LICENSE) 檔案。
---
@@ -555,34 +561,34 @@ Toonflow 基於 Apache-2.0 協議開源發布，並附有補充商業協議。
---
-# 🙏 感謝
+# 🙏 致謝
-感謝以下開源專案對Toonflow的支持：
+感謝以下開源專案為 Toonflow 提供強大支援：
-- [Express](https://expressjs.com/) - 快速、開放、極簡的Node.js Web框架
-- [AI SDK](https://ai-sdk.dev/) - TypeScript優先的AI工具包
-- [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優先的型別驗證庫
-- [Socket.IO](https://socket.io/) - 實時雙向事件框架
-- [Electron](https://www.electronjs.org/) - 跨平台桌面應用框架
-- [Hugging Face Transformers](https://huggingface.co./transformers.js) - 本地ML推理庫
+- [Express](https://expressjs.com/) - 快速、開放、極簡的 Node.js Web 框架
+- [AI SDK](https://ai-sdk.dev/) - 面向 TypeScript 的 AI 工具包
+- [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 優先的結構驗證庫
+- [Socket.IO](https://socket.io/) - 即時雙向事件通訊引擎
+- [Electron](https://www.electronjs.org/) - 跨平台桌面應用開發框架
+- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - 本機 ML 推論庫
-感謝以下組織/個人的支持：
+感謝以下組織/單位/個人為 Toonflow 提供支援：
|
-
+
|
- SophNet Cloud 提供算力贊助 - [官方網站] + 算能雲 提供算力贊助 + [官網] |