video-flow-toon/docs/README.th.md
ACT丶流星雨 cfdb3131d1 完善协议
2026-03-31 03:22:27 +08:00

29 KiB
Raw Blame History

GitHub  |  Gitee  |  Atomgit Atomgit

简体中文 | 繁體中文 | English | ไทย | Tiếng Việt | 日本語 | Русский

Toonflow Logo

Toonflow

โรงงานละครสั้น AI
แตะเพียงครั้งเดียว นิยายกลายเป็นตอนทันที!
สคริปต์ AI × ภาพ AI × สร้างเร็วสายฟ้าแลบ 🔥

Stars Badge Apache-2.0 License Badge release

🚀 ผลิตละครสั้นครบวงจร: จากข้อความสู่นักแสดง จากสตอรี่บอร์ดสู่วิดีโอ AI แบบเต็มกระบวนการ ทุกขั้นตอน ไม่มีอุปสรรค ประสิทธิภาพสร้าง 10 เท่าขึ้นไป!


🌟 ฟีเจอร์หลัก

Toonflow คือเครื่องมือคอมิกละครสั้น AI ที่ใช้เทคโนโลยี AI แปลงนิยายเป็นสคริปต์โดยอัตโนมัติ และใช้ภาพและวิดีโอ AI เพื่อสร้างละครสั้นได้อย่างมีประสิทธิภาพ ด้วย Toonflow คุณสามารถสร้างผลงานจากข้อความสู่ภาพนิ่งจนถึงวิดีโอ ได้อย่างชาญฉลาดและสะดวก

  • สร้างตัวละครอัตโนมัติ
    วิเคราะห์เนื้อหานิยายต้นฉบับ ระบุและสร้างข้อมูลตัวละครอย่างชาญฉลาด ทั้งรูปร่าง นิสัย ตัวตน เป็นต้น สร้างพื้นฐานที่แข็งแรงสำหรับสคริปต์และภาพในขั้นถัดไป
  • สร้างสคริปต์อัตโนมัติ
    จากเหตุการณ์และบทที่เลือก ระบบจะสร้างสคริปต์เชิงโครงสร้างอัตโนมัติ ครอบคลุมบทสนทนา คำบรรยายฉาก และทิศทางเนื้อเรื่อง เปลี่ยนข้อความวรรณกรรมเป็นสคริปต์ละครได้อย่างรวดเร็ว
  • ผลิตสตอรี่บอร์ดอัตโนมัติ
    ตามสคริปต์ สร้างพรอมต์สตอรี่บอร์ดและงานออกแบบภาพอัตโนมัติ รายละเอียดองค์ประกอบหน้า/กลาง/หลัง การเคลื่อนไหวตัวละคร อุปกรณ์ประกอบฉาก และการจัดวางฉาก พลิกสคริปต์เป็นสตอรี่บอร์ดวางแผนผลิตวิดีโอได้ครบถ้วน
  • ประกอบวิดีโอด้วย AI
    ผนวกเทคโนโลยีภาพและวิดีโอ AI สร้างคลิปวิดีโอด้วย AI รวมฟีเจอร์แก้ไขออนไลน์ รองรับการตั้งค่าผลลัพธ์ที่ปรับแต่งได้ ทำให้การสร้างภาพยนตร์/ละครมีประสิทธิภาพและทำงานร่วมทีมได้

📦 ตัวอย่างการใช้งาน

  • สร้างวิดีโอละครสั้น
  • ทดลองแปลงนิยายสู่ภาพยนตร์/ละคร
  • เครื่องมือดัดแปลงวรรณกรรมด้วย AI
  • การพัฒนาสคริปต์และต้นแบบผลิตงานเร็ว
  • สร้างวัตถุดิบประกอบวิดีโอ

🔰 คู่มือผู้ใช้

📺 วิดีโอสอนใช้งาน

https://www.bilibili.com/video/BV1na6wB6Ea2 Toonflow 8-Minute Quick Start AI Video

วิดีโอแนะนำ Toonflow ฉบับเร่งด่วน 8 นาที 👉 คลิกเพื่อรับชม

📱 สแกนด้วย WeChat บนมือถือเพื่อชม

Scan WeChat to Watch

🚀 การติดตั้ง

สิ่งที่ต้องเตรียมก่อน

ก่อนติดตั้งและใช้งานซอฟต์แวร์นี้ กรุณาเตรียมสิ่งเหล่านี้:

  • ที่อยู่ API บริการ AI แบบ Large Language Model
  • ที่อยู่ API บริการวิดีโอ Sora หรือ Doubao
  • ที่อยู่ API โมเดลสร้างภาพ Nano Banana Pro

ติดตั้งในเครื่อง (Local Installation)

1. ดาวน์โหลดและติดตั้ง

ระบบปฏิบัติการ ดาวน์โหลดจาก GitHub ดาวน์โหลดผ่าน Quark Cloud หมายเหตุ
Windows Release Quark Cloud ตัวติดตั้งอย่างเป็นทางการ
Linux Release Quark Cloud ตัวติดตั้งอย่างเป็นทางการ
macOS Release Quark Cloud ตัวติดตั้งอย่างเป็นทางการ

Caution

บน MacOS ให้ไปที่ ตั้งค่า - ความเป็นส่วนตัวและความปลอดภัย ตั้งค่าความปลอดภัยก่อน มิฉะนั้นอาจไม่สามารถเปิดแอปได้เพราะปัญหาใบรับรอง

ดูเอกสารฉบับภาษาจีน: https://www.zhihu.com/question/433389276

ด้วยข้อจำกัดของสภาพแวดล้อม Gitee OS และขนาดไฟล์ Release การดาวน์โหลดผ่าน Gitee Release ยังไม่เปิดให้บริการในขณะนี้

2. เปิดใช้งานโปรแกรม

ติดตั้งเสร็จแล้วให้เปิดโปรแกรมเพื่อเริ่มใช้งาน

⚠️ ล็อกอินครั้งแรก
ชื่อผู้ใช้: admin
รหัสผ่าน: admin123

การใช้ Docker

สิ่งที่ต้องเตรียม

  • ติดตั้ง Docker (เวอร์ชัน 20.10+)

วิธีที่ 1: ติดตั้งออนไลน์

กำลังพัฒนา; ขณะนี้ให้ใช้การ build ในเครื่อง

วิธีที่ 2: สร้างเองในเครื่อง

สำหรับนักพัฒนา หรือผู้ที่ clone repo แล้ว ต้องติดตั้ง Git ที่เครื่อง

# 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. ติดตั้งสภาพแวดล้อม

# ติดตั้ง 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:

cd /opt
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build

Clone จาก Gitee (แนะนำในจีนแผ่นดินใหญ่):

cd /opt
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build

3. ตั้งค่า PM2

สร้างไฟล์ pm2.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. เริ่มบริการ

pm2 start pm2.json
pm2 startup
pm2 save

5. คำสั่งที่ใช้บ่อย

pm2 list              # ดูรายชื่อโปรเซส
pm2 logs toonflow-app # ดู Log
pm2 restart all       # รีสตาร์ทบริการ
pm2 monit             # ดูระบบแบบเรียลไทม์

⚠️ ล็อกอินครั้งแรก
ชื่อผู้ใช้: admin
รหัสผ่าน: admin123

6. ติดตั้งส่วนหน้าเว็บไซต์

ถ้าต้องการใช้ Frontend แยก หรือปรับแต่ UI ศึกษาที่ repo ส่วน frontend:

💡 หมายเหตุ: รีโปนี้ใส่ 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:

    git clone https://github.com/HBAI-Ltd/Toonflow-app.git
    cd Toonflow-app
    

    Gitee (ในจีนแผ่นดินใหญ่แนะนำ):

    git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
    cd Toonflow-app
    
  2. ติดตั้ง dependencies

    รันที่ root directory:

    yarn install
    
  3. เริ่มสภาพแวดล้อมพัฒนา

    โปรเจกต์นี้มี backend API service และ frontend interface เลือกวิธีเริ่มต้นได้:

    • ตัวเลือก 1: เริ่ม backend อย่างเดียว

      yarn dev
      

      ⚠️ คำสั่งนี้เปิดเฉพาะ backend API (พอร์ต 10588) ไม่มี web UI การเข้า http://localhost:10588 คือเรียก API เท่านั้น การใช้ web UI เต็มรูปแบบใช้วิธีด้านล่าง

    • ตัวเลือก 2: เริ่ม Electron desktop client

      yarn dev:gui
      

      คำสั่งนี้เปิดทั้ง backend และ Electron window มี web UI built-in พร้อมใช้งาน

    • ตัวเลือก 3: โหมด production

      yarn start
      

      รันทั้ง backend แบบโปรดักชั่น (ต้อง yarn build ก่อน)

  4. คอมไพล์โปรเจกต์

    • คอมไพล์ TypeScript:

      yarn build
      
    • สร้าง executable สำหรับ Windows:

      yarn dist:win
      
    • สร้าง executable สำหรับ Mac:

      yarn dist:mac
      
    • สร้าง executable สำหรับ Linux:

      yarn dist:linux
      
  5. ตรวจสอบคุณภาพโค้ด

    • เช็ค lint:

      yarn lint
      
  6. AI Debug panel (ไม่บังคับ)

    รัน Visual Debugging Tool ของ Vercel AI SDK เพื่อ debug integration AI ได้ง่ายขึ้น:

    yarn debug:ai
    

การพัฒนา Frontend

หากต้องการพัฒนา UI แก้ไขที่ frontend repo:

หลัง 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 Gitee
Toonflow-web ซอร์ส frontend (สำหรับ dev FE) GitHub Gitee

💡 หมายเหตุ: ถ้าแค่ต้องการใช้งาน ดาวน์โหลดไคลเอนต์จากรีโปนี้ได้เลย รีโป frontend เหมาะสำหรับ dev ที่จะพัฒนา UI ต่อ


👨‍👩‍👧‍👦 กลุ่ม WeChat

กลุ่ม 1

กลุ่ม 2

...

กลุ่ม 10

กลุ่ม 11

กลุ่ม 12

กลุ่ม 13

...

กลุ่ม 24

ผู้ช่วยกลุ่ม:

Toonflow QR

💌 ติดต่อเรา

📧 อีเมล: [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,000500,000 ¥5,000/ปี
📈 เติบโต ¥500,0001,500,000 ¥20,000/ปี
🏢 ขยายตัว ¥1,500,0005,000,000 ¥80,000/ปี
🌐 องค์กร > ¥5,000,000 เจรจา

เงื่อนไขไม่ย้อนหลัง: ผู้ใช้ที่ใช้ Toonflow ภายใต้ AGPL-3.0 ก่อนการเผยแพร่ v1.0.8 จะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ การใช้งานปัจจุบันยังคงเป็นไปตาม AGPL-3.0

ดูข้อตกลงฉบับเต็มที่ LICENSE


ประวัติการกดดาว

Star History Chart


🙏 ขอขอบคุณ

ขอบคุณโอเพ่นซอร์สต่อไปนี้ที่สนับสนุน Toonflow:

  • Express - เฟรมเวิร์ก Node.js ที่เร็ว เล็ก และเปิดกว้าง
  • AI SDK - ชุดเครื่องมือ AI-first สำหรับ TypeScript
  • Better-SQLite3 - Binding SQLite3 ประสิทธิภาพสูง
  • Sharp - ไลบรารีจัดการภาพบน Node.js ประสิทธิภาพสูง
  • Axios - HTTP client แบบ Promise
  • Zod - ไลบรารีตรวจสอบชนิด TypeScript เป็นหลัก
  • Socket.IO - เฟรมเวิร์ก event bidirectional แบบเรียลไทม์
  • Electron - เฟรมเวิร์กสร้างแอปเดสก์ท็อปข้ามแพลตฟอร์ม
  • Hugging Face Transformers - ไลบรารี ML inference ในเครื่อง

ขอบคุณองค์กร/บุคคลต่อไปนี้สนับสนุน Toonflow:

SophNet Logo SophNet Cloud เป็นผู้สนับสนุนทรัพยากรการประมวลผล [เว็บไซต์]

รายชื่อไลบรารีภายนอกทั้งหมด ดูได้ที่ NOTICES.txt