588 lines
30 KiB
Markdown
588 lines
30 KiB
Markdown
<p>
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app">
|
||
<img src="https://img.shields.io/badge/GitHub-181717?style=flat-square&logo=github&logoColor=white" alt="GitHub" />
|
||
</a>
|
||
|
|
||
<a href="https://gitee.com/HBAI-Ltd/Toonflow-app">
|
||
<img src="https://img.shields.io/badge/Gitee-C71D23?style=flat-square&logo=gitee&logoColor=white" alt="Gitee" />
|
||
</a>
|
||
|
|
||
<a href="https://gitcode.com/HBAI-Ltd/Toonflow-app">
|
||
<img src="./atomgitLogo.svg" alt="Atomgit" style="height:16px"/>
|
||
Atomgit
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="/README.md">简体中文</a> |
|
||
<a href="./README.zhtw.md">繁體中文</a> |
|
||
<a href="./README.en.md">English</a> |
|
||
<strong>ไทย</strong> |
|
||
<a href="./README.vi.md">Tiếng Việt</a> |
|
||
<a href="./README.ja.md">日本語</a> |
|
||
<a href="./README.ru.md">Русский</a>
|
||
</p>
|
||
|
||
<div align="center">
|
||
|
||
<img src="./logo.png" alt="Toonflow Logo" height="120"/>
|
||
|
||
# Toonflow
|
||
|
||
<p align="center">
|
||
<b>
|
||
โรงงานละครสั้น AI
|
||
<br />
|
||
แตะเพียงครั้งเดียว นิยายกลายเป็นตอนทันที!
|
||
<br />
|
||
สคริปต์ AI × ภาพ AI × สร้างเร็วสายฟ้าแลบ 🔥
|
||
</b>
|
||
</p>
|
||
<p align="center">
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app/stargazers">
|
||
<img src="https://img.shields.io/github/stars/HBAI-Ltd/Toonflow-app?style=for-the-badge&logo=github" alt="Stars Badge" />
|
||
</a>
|
||
<a href="https://www.apache.org/licenses/LICENSE-2.0" target="_blank">
|
||
<img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge" alt="Apache-2.0 License Badge" />
|
||
</a>
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app/releases">
|
||
<img alt="release" src="https://img.shields.io/github/v/release/HBAI-Ltd/Toonflow-app?style=for-the-badge" />
|
||
</a>
|
||
</p>
|
||
|
||
> 🚀 **ผลิตละครสั้นครบวงจร:** จากข้อความสู่นักแสดง จากสตอรี่บอร์ดสู่วิดีโอ AI แบบเต็มกระบวนการ ทุกขั้นตอน ไม่มีอุปสรรค ประสิทธิภาพสร้าง 10 เท่าขึ้นไป!
|
||
</div>
|
||
|
||
---
|
||
|
||
# <20> รองรับหลายภาษา
|
||
|
||
Toonflow รองรับภาษาในอินเทอร์เฟซดังนี้:
|
||
|
||
| ภาษา | Language |
|
||
|------|----------|
|
||
| 简体中文 | Chinese (Simplified) |
|
||
| 繁體中文 | Chinese (Traditional) |
|
||
| English | English |
|
||
| ไทย | Thai |
|
||
| Tiếng Việt | Vietnamese |
|
||
| 日本語 | Japanese |
|
||
| Русский | Russian |
|
||
|
||
---
|
||
|
||
# 🌟 ฟีเจอร์หลัก
|
||
|
||
Toonflow คือเครื่องมือคอมิกละครสั้น AI ที่ใช้เทคโนโลยี AI แปลงนิยายเป็นสคริปต์โดยอัตโนมัติ และใช้ภาพและวิดีโอ AI เพื่อสร้างละครสั้นได้อย่างมีประสิทธิภาพ ด้วย Toonflow คุณสามารถสร้างผลงานจากข้อความสู่ภาพนิ่งจนถึงวิดีโอ ได้อย่างชาญฉลาดและสะดวก
|
||
|
||
- ✅ **สร้างตัวละครอัตโนมัติ**
|
||
วิเคราะห์เนื้อหานิยายต้นฉบับ ระบุและสร้างข้อมูลตัวละครอย่างชาญฉลาด ทั้งรูปร่าง นิสัย ตัวตน เป็นต้น สร้างพื้นฐานที่แข็งแรงสำหรับสคริปต์และภาพในขั้นถัดไป
|
||
- ✅ **สร้างสคริปต์อัตโนมัติ**
|
||
จากเหตุการณ์และบทที่เลือก ระบบจะสร้างสคริปต์เชิงโครงสร้างอัตโนมัติ ครอบคลุมบทสนทนา คำบรรยายฉาก และทิศทางเนื้อเรื่อง เปลี่ยนข้อความวรรณกรรมเป็นสคริปต์ละครได้อย่างรวดเร็ว
|
||
- ✅ **ผลิตสตอรี่บอร์ดอัตโนมัติ**
|
||
ตามสคริปต์ สร้างพรอมต์สตอรี่บอร์ดและงานออกแบบภาพอัตโนมัติ รายละเอียดองค์ประกอบหน้า/กลาง/หลัง การเคลื่อนไหวตัวละคร อุปกรณ์ประกอบฉาก และการจัดวางฉาก พลิกสคริปต์เป็นสตอรี่บอร์ดวางแผนผลิตวิดีโอได้ครบถ้วน
|
||
- ✅ **ประกอบวิดีโอด้วย AI**
|
||
ผนวกเทคโนโลยีภาพและวิดีโอ AI สร้างคลิปวิดีโอด้วย AI รวมฟีเจอร์แก้ไขออนไลน์ รองรับการตั้งค่าผลลัพธ์ที่ปรับแต่งได้ ทำให้การสร้างภาพยนตร์/ละครมีประสิทธิภาพและทำงานร่วมทีมได้
|
||
|
||
---
|
||
|
||
# 📦 ตัวอย่างการใช้งาน
|
||
|
||
- สร้างวิดีโอละครสั้น
|
||
- ทดลองแปลงนิยายสู่ภาพยนตร์/ละคร
|
||
- เครื่องมือดัดแปลงวรรณกรรมด้วย AI
|
||
- การพัฒนาสคริปต์และต้นแบบผลิตงานเร็ว
|
||
- สร้างวัตถุดิบประกอบวิดีโอ
|
||
|
||
---
|
||
|
||
# 🔰 คู่มือผู้ใช้
|
||
|
||
## 📺 วิดีโอสอนใช้งาน
|
||
|
||
https://www.bilibili.com/video/BV1na6wB6Ea2
|
||
[](https://www.bilibili.com/video/BV1na6wB6Ea2)
|
||
|
||
**วิดีโอแนะนำ Toonflow ฉบับเร่งด่วน 8 นาที**
|
||
👉 [คลิกเพื่อรับชม](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e)
|
||
|
||
📱 สแกนด้วย WeChat บนมือถือเพื่อชม
|
||
|
||
<img src="./videoQR.png" alt="Scan WeChat to Watch" width="150"/>
|
||
|
||
---
|
||
|
||
# 🚀 การติดตั้ง
|
||
|
||
## สิ่งที่ต้องเตรียมก่อน
|
||
|
||
ก่อนติดตั้งและใช้งานซอฟต์แวร์นี้ กรุณาเตรียมสิ่งเหล่านี้:
|
||
|
||
- ✅ ที่อยู่ API บริการ AI แบบ Large Language Model
|
||
- ✅ ที่อยู่ API บริการวิดีโอ Sora หรือ Doubao
|
||
- ✅ ที่อยู่ API โมเดลสร้างภาพ Nano Banana Pro
|
||
|
||
## ติดตั้งในเครื่อง (Local Installation)
|
||
|
||
### 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) | แพ็กเกจติดตั้งอย่างเป็นทางการ |
|
||
|
||
> [!CAUTION]
|
||
> บน MacOS ให้ไปที่ ตั้งค่า - ความเป็นส่วนตัวและความปลอดภัย ตั้งค่าความปลอดภัยก่อน มิฉะนั้นอาจไม่สามารถเปิดแอปได้เพราะปัญหาใบรับรอง
|
||
>
|
||
> ดูเอกสารฉบับภาษาจีน: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
|
||
|
||
> ด้วยข้อจำกัดของสภาพแวดล้อม Gitee OS และขนาดไฟล์ Release การดาวน์โหลดผ่าน Gitee Release ยังไม่เปิดให้บริการในขณะนี้
|
||
|
||
### 2. เปิดใช้งานโปรแกรม
|
||
|
||
ติดตั้งเสร็จแล้วให้เปิดโปรแกรมเพื่อเริ่มใช้งาน
|
||
|
||
> ⚠️ **ล็อกอินครั้งแรก**
|
||
> ชื่อผู้ใช้: `admin`
|
||
> รหัสผ่าน: `admin123`
|
||
|
||
## การใช้ Docker
|
||
|
||
### สิ่งที่ต้องเตรียม
|
||
|
||
- ติดตั้ง [Docker](https://docs.docker.com/get-docker/) (เวอร์ชัน 20.10+)
|
||
|
||
### วิธีที่ 1: ติดตั้งออนไลน์
|
||
|
||
กำลังพัฒนา; ขณะนี้ให้ใช้การ build ในเครื่อง
|
||
|
||
### วิธีที่ 2: สร้างเองในเครื่อง
|
||
|
||
สำหรับนักพัฒนา หรือผู้ที่ clone repo แล้ว ต้องติดตั้ง Git ที่เครื่อง
|
||
|
||
```shell
|
||
# clone โปรเจกต์ (ถ้าทำแล้วข้าม)
|
||
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
|
||
cd Toonflow-app
|
||
|
||
# สร้างและเริ่มผ่าน docker-compose
|
||
yarn docker:local
|
||
|
||
# หรือสร้างแบบ manual
|
||
docker build -t toonflow .
|
||
docker run -d -p <local_port>:10588 -v <local_data_path>:/app/data toonflow
|
||
|
||
# ใช้งานที่ /web/index.html ในพอร์ตที่แม็ปไว้ เช่น
|
||
# http://localhost:10588/web/index.html
|
||
```
|
||
|
||
### รายละเอียดพอร์ตบริการ
|
||
|
||
| พอร์ต | วัตถุประสงค์ | Mapping ในการติดตั้ง |
|
||
| -------- | ------------ | -------------------- |
|
||
| `10588` | ส่วนติดต่อแอป | `10588:10588` |
|
||
|
||
**รายละเอียดตัวแปรแวดล้อม:**
|
||
|
||
| ตัวแปร | รายละเอียด |
|
||
| ------------- | ----------------------------------------- |
|
||
| `NODE_ENV` | สภาพแวดล้อม เลือก `prod` คือ production |
|
||
| `PORT` | พอร์ตการฟังบริการ (ค่าเริ่มต้น 10588) |
|
||
| `OSSURL` | ที่อยู่สำหรับเข้าถึงไฟล์ static |
|
||
|
||
---
|
||
|
||
## ติดตั้งบน Cloud
|
||
|
||
### 1. ข้อกำหนดเครื่องเซิร์ฟเวอร์
|
||
|
||
- **ระบบปฏิบัติการ:** Ubuntu 20.04+ / CentOS 7+
|
||
- **Node.js:** 24.x (แนะนำ ขั้นต่ำ 23.11.1+)
|
||
- **RAM:** 2GB ขึ้นไป
|
||
|
||
### 2. วิธีติดตั้ง
|
||
|
||
#### 1. ติดตั้งสภาพแวดล้อม
|
||
|
||
```bash
|
||
# ติดตั้ง Node.js
|
||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
|
||
source ~/.bashrc
|
||
nvm install 24
|
||
# ติดตั้ง Yarn และ PM2
|
||
npm install -g yarn pm2
|
||
```
|
||
|
||
#### 2. ติดตั้งโปรเจกต์
|
||
|
||
**Clone จาก GitHub:**
|
||
|
||
```bash
|
||
cd /opt
|
||
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
|
||
cd Toonflow-app
|
||
yarn install
|
||
yarn build
|
||
```
|
||
|
||
**Clone จาก Gitee (แนะนำในจีนแผ่นดินใหญ่):**
|
||
|
||
```bash
|
||
cd /opt
|
||
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
|
||
cd Toonflow-app
|
||
yarn install
|
||
yarn build
|
||
```
|
||
|
||
#### 3. ตั้งค่า PM2
|
||
|
||
สร้างไฟล์ `pm2.json`:
|
||
|
||
```json
|
||
{
|
||
"name": "toonflow-app",
|
||
"script": "data/serve/app.js",
|
||
"instances": "max",
|
||
"exec_mode": "cluster",
|
||
"env": {
|
||
"NODE_ENV": "prod",
|
||
"PORT": 10588,
|
||
"OSSURL": "http://127.0.0.1:10588/"
|
||
}
|
||
}
|
||
```
|
||
|
||
**รายละเอียดตัวแปรแวดล้อม:**
|
||
|
||
| ตัวแปร | รายละเอียด |
|
||
| ------------- | ---------------------------------------- |
|
||
| `NODE_ENV` | สภาพแวดล้อม เลือก `prod` คือ production |
|
||
| `PORT` | พอร์ตให้บริการ |
|
||
| `OSSURL` | ที่อยู่สำหรับเข้าถึงไฟล์ static |
|
||
|
||
---
|
||
|
||
#### 4. เริ่มบริการ
|
||
|
||
```bash
|
||
pm2 start pm2.json
|
||
pm2 startup
|
||
pm2 save
|
||
```
|
||
|
||
#### 5. คำสั่งที่ใช้บ่อย
|
||
|
||
```bash
|
||
pm2 list # ดูรายชื่อโปรเซส
|
||
pm2 logs toonflow-app # ดู Log
|
||
pm2 restart all # รีสตาร์ทบริการ
|
||
pm2 monit # ดูระบบแบบเรียลไทม์
|
||
```
|
||
|
||
> ⚠️ **ล็อกอินครั้งแรก**
|
||
> ชื่อผู้ใช้: `admin`
|
||
> รหัสผ่าน: `admin123`
|
||
|
||
#### 6. ติดตั้งส่วนหน้าเว็บไซต์
|
||
|
||
ถ้าต้องการใช้ Frontend แยก หรือปรับแต่ UI ศึกษาที่ repo ส่วน frontend:
|
||
|
||
- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
|
||
- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
|
||
|
||
> 💡 **หมายเหตุ:** รีโปนี้ใส่ frontend ที่ compile แล้วมาด้วย ผู้ใช้ทั่วไปไม่จำเป็นต้องติดตั้ง frontend แยก Repo frontend ใช้สำหรับนักพัฒนาที่ต้องการพัฒนาต่อ
|
||
|
||
---
|
||
|
||
# 🔧 คู่มือนักพัฒนา
|
||
|
||
> [!CAUTION]
|
||
> 🚧 **แนวทางการส่ง PR** 🚧
|
||
>
|
||
> ⛔ `master` ไม่รับ PR | ✅ ส่ง PR ที่ `develop`
|
||
>
|
||
> เชิญนักพัฒนาร่วมพัฒนา Toonflow ติดต่อเจ้าของ ACT ในแชทกลุ่ม
|
||
|
||
## 🛠️ Tech Stack
|
||
|
||
| หมวด | เทคโนโลยี |
|
||
| ------------ | ------------------------------------------------------------------------------------ |
|
||
| Runtime | Node.js 23.11.1+ |
|
||
| Language | TypeScript 5.x |
|
||
| Backend | Express 5 |
|
||
| Database | SQLite (better-sqlite3 / knex) |
|
||
| AI Integration | Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Qwen / xAI) |
|
||
| Local Inference | @huggingface/transformers (ONNX) |
|
||
| Real-Time | Socket.IO |
|
||
| Desktop | Electron 40 |
|
||
| Image Proc. | Sharp |
|
||
| Container | Docker |
|
||
|
||
## เตรียมสภาพแวดล้อม
|
||
|
||
- **Node.js:** ต้องใช้ 23.11.1 ขึ้นไปเท่านั้น
|
||
- **Yarn:** แนะนำให้ใช้เป็น package manager
|
||
|
||
## เริ่มพัฒนาอย่างรวดเร็ว
|
||
|
||
1. **Clone โปรเจกต์**
|
||
|
||
**GitHub:**
|
||
|
||
```bash
|
||
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
|
||
cd Toonflow-app
|
||
```
|
||
|
||
**Gitee (ในจีนแผ่นดินใหญ่แนะนำ):**
|
||
|
||
```bash
|
||
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
|
||
cd Toonflow-app
|
||
```
|
||
|
||
2. **ติดตั้ง dependencies**
|
||
|
||
รันที่ root directory:
|
||
|
||
```bash
|
||
yarn install
|
||
```
|
||
|
||
3. **เริ่มสภาพแวดล้อมพัฒนา**
|
||
|
||
โปรเจกต์นี้มี **backend API service** และ **frontend interface** เลือกวิธีเริ่มต้นได้:
|
||
|
||
- **ตัวเลือก 1: เริ่ม backend อย่างเดียว**
|
||
|
||
```bash
|
||
yarn dev
|
||
```
|
||
|
||
> ⚠️ คำสั่งนี้เปิดเฉพาะ backend API (พอร์ต 10588) **ไม่มี web UI** การเข้า http://localhost:10588 คือเรียก API เท่านั้น การใช้ web UI เต็มรูปแบบใช้วิธีด้านล่าง
|
||
|
||
- **ตัวเลือก 2: เริ่ม Electron desktop client**
|
||
|
||
```bash
|
||
yarn dev:gui
|
||
```
|
||
|
||
> คำสั่งนี้เปิดทั้ง backend และ Electron window มี web UI built-in พร้อมใช้งาน
|
||
|
||
- **ตัวเลือก 3: โหมด production**
|
||
|
||
```bash
|
||
yarn start
|
||
```
|
||
|
||
> รันทั้ง backend แบบโปรดักชั่น (ต้อง `yarn build` ก่อน)
|
||
|
||
4. **คอมไพล์โปรเจกต์**
|
||
|
||
- คอมไพล์ TypeScript:
|
||
|
||
```bash
|
||
yarn build
|
||
```
|
||
|
||
- สร้าง executable สำหรับ Windows:
|
||
|
||
```bash
|
||
yarn dist:win
|
||
```
|
||
|
||
- สร้าง executable สำหรับ Mac:
|
||
|
||
```bash
|
||
yarn dist:mac
|
||
```
|
||
|
||
- สร้าง executable สำหรับ Linux:
|
||
|
||
```bash
|
||
yarn dist:linux
|
||
```
|
||
|
||
5. **ตรวจสอบคุณภาพโค้ด**
|
||
|
||
- เช็ค lint:
|
||
|
||
```bash
|
||
yarn lint
|
||
```
|
||
|
||
6. **AI Debug panel (ไม่บังคับ)**
|
||
|
||
รัน Visual Debugging Tool ของ Vercel AI SDK เพื่อ debug integration AI ได้ง่ายขึ้น:
|
||
|
||
```bash
|
||
yarn debug:ai
|
||
```
|
||
|
||
## การพัฒนา Frontend
|
||
|
||
หากต้องการพัฒนา UI แก้ไขที่ frontend repo:
|
||
|
||
- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
|
||
- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web)
|
||
|
||
หลัง build frontend แล้ว ให้นำไฟล์ใน `dist` ไปวางใน `data/web` ของโปรเจกต์นี้
|
||
|
||
## โครงสร้างโปรเจกต์
|
||
|
||
```
|
||
📂 build/ # ผลลัพธ์หลังคอมไพล์
|
||
📂 data/ # ข้อมูล runtime
|
||
│ ├─ 📂 models/ # โมเดล inference ในเครื่อง (ONNX)
|
||
│ ├─ 📂 oss/ # ที่เก็บวัตถุ (assets/character/scene)
|
||
│ ├─ 📂 serve/ # จุดเริ่ม production
|
||
│ ├─ 📂 skills/ # เอเจนท์พรอมต์ทักษะต่างๆ
|
||
│ └─ 📂 web/ # asset frontend ที่มาในตัว
|
||
📂 ./ # เอกสาร
|
||
📂 env/ # ไฟล์ config environment
|
||
📂 scripts/ # script สร้างและช่วยงาน
|
||
📂 src/
|
||
├─ 📂 agents/ # โมดูล AI Agent ต่างๆ
|
||
│ ├─ 📂 productionAgent/ # เอเจนท์ผลิตงาน
|
||
│ └─ 📂 scriptAgent/ # เอเจนท์สคริปต์
|
||
├─ 📂 lib/ # ไลบรารีทั่วไป (db, response)
|
||
├─ 📂 middleware/ # Middleware ต่างๆ
|
||
├─ 📂 routes/ # เส้นทาง API หลัก
|
||
│ ├─ 📂 agents/ # จัดการความจำเอเจนท์
|
||
│ ├─ 📂 artStyle/ # จัดการสไตล์ศิลปะ
|
||
│ ├─ 📂 assets/ # จัดการ asset
|
||
│ ├─ 📂 assetsGenerate/ # สร้าง asset อัตโนมัติ
|
||
│ ├─ 📂 cornerScape/ # จัดการสตอรี่บอร์ด
|
||
│ ├─ 📂 general/ # API ทั่วไป
|
||
│ ├─ 📂 login/ # ยืนยันตัวตนเข้าใช้
|
||
│ ├─ 📂 migrate/ # ย้ายโครงสร้างข้อมูล
|
||
│ ├─ 📂 modelSelect/ # จัดการเลือกโมเดล
|
||
│ ├─ 📂 novel/ # จัดการนิยาย
|
||
│ ├─ 📂 other/ # ฟีเจอร์อื่นๆ
|
||
│ ├─ 📂 production/ # จัดการการผลิต
|
||
│ ├─ 📂 project/ # จัดการโปรเจกต์
|
||
│ ├─ 📂 script/ # สร้างสคริปต์
|
||
│ ├─ 📂 scriptAgent/ # Endpoint AI Agent สคริปต์
|
||
│ ├─ 📂 setting/ # ตั้งค่าระบบ
|
||
│ ├─ 📂 task/ # จัดการงาน
|
||
│ └─ 📂 test/ # ทดสอบ API
|
||
├─ 📂 socket/ # การสื่อสาร WebSocket
|
||
├─ 📂 types/ # TypeScript type definitions
|
||
├─ 📂 utils/ # ฟังก์ชันอรรถประโยชน์
|
||
├─ 📄 app.ts # จุดเข้าแอป
|
||
├─ 📄 core.ts # core initialization
|
||
├─ 📄 env.ts # ตัวแปร env
|
||
├─ 📄 err.ts # จัดการ error
|
||
├─ 📄 logger.ts # log โมดูล
|
||
├─ 📄 router.ts # ลงทะเบียน route ต่าง ๆ
|
||
└─ 📄 utils.ts # เครื่องมือทั่วไป
|
||
📄 Dockerfile # config สำหรับ docker build
|
||
📄 electron-builder.yml # config แพ็ค Electron
|
||
📄 skillList.json # รายการทักษะ
|
||
📄 LICENSE # ใบอนุญาต Apache-2.0
|
||
📄 NOTICES.txt # รายงานไลบรารีที่ใช้
|
||
📄 package.json # config โปรเจกต์
|
||
📄 tsconfig.json # TypeScript config
|
||
```
|
||
|
||
---
|
||
|
||
# 🔗 รีโพที่เกี่ยวข้อง
|
||
|
||
| รีโพ | คำอธิบาย | GitHub | Gitee |
|
||
| ------------ | ----------------- | ----------------------------------------------- | -------------------------------------------- |
|
||
| **Toonflow-app** | ตัวเต็ม (รีโปนี้, สำหรับผู้ใช้) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) |
|
||
| **Toonflow-web** | ซอร์ส frontend (สำหรับ dev FE) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) |
|
||
|
||
> 💡 **หมายเหตุ:** ถ้าแค่ต้องการใช้งาน ดาวน์โหลดไคลเอนต์จากรีโปนี้ได้เลย รีโป frontend เหมาะสำหรับ dev ที่จะพัฒนา UI ต่อ
|
||
|
||
---
|
||
|
||
# 👨👩👧👦 กลุ่ม WeChat
|
||
|
||
ผู้ช่วยกลุ่ม:
|
||
|
||
<img src="./QR.png" alt="Toonflow QR" height="400"/>
|
||
|
||
---
|
||
|
||
# 💌 ติดต่อเรา
|
||
|
||
📧 อีเมล: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow inquiry)
|
||
|
||
---
|
||
|
||
# 📜 ใบอนุญาต
|
||
|
||
Toonflow เป็นโอเพ่นซอร์สภายใต้ Apache-2.0 พร้อมข้อตกลงเชิงพาณิชย์เพิ่มเติม
|
||
|
||
รายละเอียด: https://www.apache.org/licenses/LICENSE-2.0
|
||
|
||
## ข้อตกลงเพิ่มเติม
|
||
|
||
- หากแจกจ่ายซอฟต์แวร์นี้ในฐานะผลิตภัณฑ์ให้ **บุคคลที่สามอิสระ 2 รายขึ้นไป** ต้องได้รับ **อนุญาตเชิงพาณิชย์เป็นลายลักษณ์อักษร** จาก HBAI-Ltd
|
||
- **≤ 5 นิติบุคคล** ร่วมดำเนินงานภายในโดยไม่ให้บริการภายนอก ถือเป็น **การใช้งานภายใน ไม่ต้องขออนุญาต**
|
||
- ห้ามลบหรือแก้ไขเครื่องหมายการค้า โลโก้ หรือข้อมูลลิขสิทธิ์ใน Toonflow
|
||
|
||
## ใช้งานฟรีตลอดกาล
|
||
|
||
- ✅ ใช้ 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 | เจรจา |
|
||
|
||
> **เงื่อนไขไม่ย้อนหลัง**: ผู้ใช้ที่ใช้ Toonflow ภายใต้ AGPL-3.0 ก่อนการเผยแพร่ v1.0.8 จะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ การใช้งานปัจจุบันยังคงเป็นไปตาม AGPL-3.0
|
||
|
||
ดูข้อตกลงฉบับเต็มที่ [LICENSE](../LICENSE)
|
||
|
||
---
|
||
|
||
# ⭐️ ประวัติการกดดาว
|
||
|
||
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
|
||
|
||
---
|
||
|
||
# 🙏 ขอขอบคุณ
|
||
|
||
ขอบคุณโอเพ่นซอร์สต่อไปนี้ที่สนับสนุน 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 ในเครื่อง
|
||
|
||
ขอบคุณองค์กร/บุคคลต่อไปนี้สนับสนุน Toonflow:
|
||
|
||
<table>
|
||
<tr>
|
||
<td>
|
||
<img src="./sponsored/sophnet.png" alt="SophNet Logo" width="48">
|
||
</td>
|
||
<td>
|
||
<b>SophNet Cloud</b> เป็นผู้สนับสนุนทรัพยากรการประมวลผล
|
||
<a href="https://www.sophnet.com/">[เว็บไซต์]</a>
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
รายชื่อไลบรารีภายนอกทั้งหมด ดูได้ที่ `NOTICES.txt`
|
||
|
||
##### copyright © 淮北艾阿网络科技有限公司 |