| |

TypeScript Node.js Docker Electron

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

--- # 🌐 รองรับหลายภาษา Toonflow รองรับอินเทอร์เฟซภาษาดังต่อไปนี้: | ภาษา | Language | | ---------- | --------------------- | | 简体中文 | Chinese (Simplified) | | 繁體中文 | Chinese (Traditional) | | English | English | | ไทย | Thai | | Tiếng Việt | Vietnamese | | 日本語 | Japanese | | Русский | Russian | > 💡 กำลังปรับภาษาเพิ่มเติม ยินดีต้อนรับการมีส่วนร่วมในการแปล! --- # 🌟 ฟังก์ชันหลัก Toonflow คือเวิร์กสเตชัน AI ที่มุ่งเน้นการผลิตซีรีส์สั้น สร้างวงจรปิดที่สมบูรณ์ตั้งแต่ "การวางแผน → การเขียนบท → การทำสตอรี่บอร์ด → การผลิตคลิป" และรองรับกระบวนการผลิตที่ปรับเปลี่ยนได้ในพื้นที่ สามารถตั้งโปรแกรมได้ และพัฒนาอย่างต่อเนื่อง - ✅ **เวิร์กสเตชันการผลิตแบบผืนผ้าใบไม่จำกัด** จัดระเบียบสคริปต์ ตัวละคร สตอรี่บอร์ด 素材 และโหนดวิดีโอในรูปแบบผืนผ้าใบไม่จำกัด รองรับการจัดเรียงอิสระ การย้อนกลับ และการผลิตแบบขนาน ไม่ถูกจำกัดด้วยขั้นตอนเชิงเส้น - ✅ **ระบบความร่วมมือ Agent สามชั้น** ชั้น决策 (การตัดสินใจ) ชั้น执行 (การปฏิบัติ) และชั้น监督 (การกำกับดูแล) ทำงานร่วมกัน ครอบคลุมการแยกย่อยงาน การสร้างเนื้อหา การตรวจสอบคุณภาพ และการ反馈 (ข้อเสนอแนะ) เพื่อเพิ่มความเสถียรและความสอดคล้องของผลงาน - ✅ **ความจำ Agent แบบถาวร** ระบบความจำข้ามเซสชันที่ใช้การค้นหาเวกเตอร์ ONNX ในพื้นที่ รองรับข้อความระยะสั้น สรุประยะยาว และการเรียกคืนความหมาย เพื่อรับประกันความต่อเนื่องในการสร้างสรรค์หลายรอบ - ✅ **ระบบผู้ให้บริการที่ตั้งโปรแกรมได้** รองรับการเขียนตรรกะ TypeScript ของผู้ให้บริการในศูนย์การตั้งค่าและ生效 (มีผล) ทันที โดยไม่ต้องแก้ไขซอร์สโค้ดหรือรีสตาร์ท สะดวกสำหรับการปรับใช้ส่วนตัวและการเชื่อมต่อหลายโมเดล - ✅ **การปรับบทโดยใช้แผนที่เหตุการณ์ของบท** แยกเหตุการณ์ในบทของต้นฉบับโดยอัตโนมัติและจัดเก็บอย่างมีโครงสร้าง การปรับบทจะเรียกใช้บริบทตามแผนที่เหตุการณ์อย่างแม่นยำ ลดการสูญเสียข้อมูลในข้อความยาว - ✅ **การกำหนดค่า Skill เป็นไฟล์** คำแนะนำหลักของ ScriptAgent และ ProductionAgent ถูกแยกออกเป็นไฟล์ Markdown Skill รองรับการแก้ไขออนไลน์และการปรับแต่งอย่างรวดเร็ว --- # 📦 สถานการณ์การใช้งาน - การสร้างเนื้อหาวิดีโอสั้น - การทดลองทำนิยายเป็นภาพยนตร์ - เครื่องมือปรับบทวรรณกรรมด้วย AI - การพัฒนาบทและการสร้างต้นแบบอย่างรวดเร็ว - การสร้าง素材วิดีโอ --- # 🔰 คู่มือการใช้งาน ## เริ่มต้นใช้งานอย่างรวดเร็ว 1. เปิดแอปพลิเคชันและเข้าสู่ระบบ (บัญชีเริ่มต้น: `admin` / `admin123`) 2. กำหนดค่าผู้ให้บริการโมเดลในศูนย์การตั้งค่า (โมเดลข้อความ/รูปภาพ/วิดีโอ) 3. สร้างโปรเจกต์ใหม่และนำเข้านิยายต้นฉบับ ดำเนินการแยกเหตุการณ์ในบท 4. เข้าสู่ ScriptAgent เพื่อสร้างโครงเรื่อง กลยุทธ์การปรับบท และสคริปต์ที่มีโครงสร้าง 5. สลับไปที่ ProductionAgent จัดระเบียบสตอรี่บอร์ด 素材 และโหนดวิดีโอในผืนผ้าใบไม่จำกัด 6. ปรับแต่งภาพสตอรี่บอร์ดเป็นโหนดอย่างละเอียดแล้วส่งกลับไปยังเวิร์กสเตชันเพื่อทำการต่อวิดีโอและส่งออก ## 📺 บทเรียนวิดีโอ https://www.bilibili.com/video/BV1oXD7BqEqJ [![Toonflow 12 นาที เริ่มต้นใช้งาน AI อย่างรวดเร็ว](./videoCover.jpg)](https://www.bilibili.com/video/BV1oXD7BqEqJ) **Toonflow 12 นาที เริ่มต้นใช้งาน AI อย่างรวดเร็ว** 👉 [คลิกเพื่อรับชม](https://www.bilibili.com/video/BV1oXD7BqEqJ) 📱 สแกนด้วย WeChat บนมือถือเพื่อรับชม สแกนด้วย WeChat เพื่อรับชม

--- # 📸 ภาพหน้าจอและวิดีโอสาธิต ภาพหน้าจอและวิดีโอด้านล่างมาจากตัวอย่างซีรีส์สั้น AI ที่สร้างด้วย Toonflow ใช้เวลาทั้งหมดประมาณ 2 ชั่วโมง ครอบคลุมการสร้างสคริปต์ การทำสตอรี่บอร์ด และการตัดต่อ

## 🎬 วิดีโอสาธิต

https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9 หากเล่นไม่ได้ กรุณา [คลิกดาวน์โหลดวิดีโอ](./screenshot/demo.mp4)

## ข้อมูลสาธิต | รายการ | รายละเอียด | | :--- | :--- | | ระยะเวลาการผลิต | ประมาณ 2 ชั่วโมง | | โมเดลวิดีโอ | Seedance 2.0 | | โมเดลรูปภาพ | GPT Image 2 | | โมเดลภาษา | Claude Opus 4.6 | | ความยาวคลิปทั้งหมด | ประมาณ 2 นาที (素材ดิบ 3 นาที ตัดส่วนที่ไม่ใช้ออกประมาณ 1 นาที) | ## รายละเอียดค่าใช้จ่าย | ประเภทโมเดล | ค่าใช้จ่าย | | :--- | :--- | | โมเดลภาษา | ประมาณ ¥10 | | โมเดลวิดีโอ (สร้างทั้งหมด) | ประมาณ ¥120 | | โมเดลรูปภาพ | ไม่ถึง ¥1 | | **รวม** | **ประมาณ ¥130** | > **声明 (คำชี้แจง)**: ความละเอียดดั้งเดิมของตัวอย่างคือ 1080×1882 เวอร์ชันที่เผยแพร่ถูกบีบอัดเป็น 480p หากเกี่ยวข้องกับปัญหาเรื่องลิขสิทธิ์ โปรดติดต่อเราเพื่อดำเนินการลบออก --- # 🚀 การติดตั้ง ## ข้อกำหนดเบื้องต้น ก่อนติดตั้งและใช้งานซอฟต์แวร์นี้ โปรดเตรียมสิ่งต่อไปนี้: - ✅ ที่อยู่接口บริการ AI โมเดลภาษาใหญ่ - ✅ ที่อยู่接口บริการวิดีโอ Sora หรือ Doubao - ✅ บริการ接口โมเดลสร้างรูปภาพ Nano Banana Pro ## การติดตั้งบนเครื่อง ### 1. ดาวน์โหลดและติดตั้ง | ระบบปฏิบัติการ | GitHub | หมายเหตุ | | :------: | :----------------------------------------------------------- | :------------- | | Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | แพ็คเกจติดตั้งทางการ | | Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | แพ็คเกจติดตั้งทางการ | | macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | แพ็คเกจติดตั้งทางการ | > [!CAUTION] > สำหรับระบบ MacOS โปรดไปที่ การตั้งค่า-ความเป็นส่วนตัวและความปลอดภัย เพื่อกำหนดค่าความปลอดภัย มิฉะนั้นอาจเปิดไม่ได้เนื่องจากปัญหาใบรับรอง > > ดูเอกสารอ้างอิง Zhihu: [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: ปรับใช้ออนไลน์ อยู่ระหว่างการปรับปรุง ให้ใช้การสร้างในพื้นที่ก่อน ### วิธีที่ 2: สร้างในพื้นที่ ใช้ซอร์สโค้ดที่มีอยู่ในพื้นที่สร้างโดยตรง เหมาะสำหรับนักพัฒนาหรือผู้ที่ clone repository ไว้แล้ว ซึ่งต้องติดตั้ง git ในเครื่อง: ```shell # ขั้นแรก clone โปรเจกต์ (ข้ามได้ถ้ามีแล้ว) git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app # ใช้ docker-compose สร้างและเริ่มในพื้นที่ yarn docker:local # หรือสร้างด้วยตนเอง docker build -t toonflow . docker run -d -p <พอร์ตท้องถิ่น>:10588 -v <เส้นทางข้อมูลท้องถิ่น>:/app/data toonflow # จากนั้นสามารถเข้าถึงหน้าเว็บได้ที่路径 /index.html ของพอร์ตนั้น # ตัวอย่างเช่น http://localhost:10588/index.html ``` ### คำอธิบายพอร์ตบริการ | พอร์ต | การใช้งาน | การแมปปรับใช้ | | ------- | -------- | ------------- | | `10588` | อินเทอร์เฟซซอฟต์แวร์ | `10588:10588` | **คำอธิบายตัวแปรสภาพแวดล้อม:** | ตัวแปร | คำอธิบาย | | ---------- | ---------------------------------- | | `NODE_ENV` | สภาพแวดล้อมการทำงาน `prod` หมายถึงสภาพแวดล้อมการผลิต | | `PORT` | พอร์ตที่บริการรับฟัง (ค่าเริ่มต้น 10588) | | `OSSURL` | ที่อยู่เข้าถึงการจัดเก็บไฟล์ ใช้สำหรับเข้าถึงทรัพยากรแบบ static | --- ## การปรับใช้บนคลาวด์ ### การปรับใช้บนเซิร์ฟเวอร์คลาวด์ #### 1. ข้อกำหนดสภาพแวดล้อมเซิร์ฟเวอร์ - **ระบบ**: Ubuntu 20.04+ / CentOS 7+ - **Node.js**: 24.x (แนะนำ ขั้นต่ำ 23.11.1+) - **หน่วยความจำ**: 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` หมายถึงสภาพแวดล้อมการผลิต | | `PORT` | พอร์ตที่บริการรับฟัง | | `OSSURL` | ที่อยู่เข้าถึงการจัดเก็บไฟล์ ใช้สำหรับเข้าถึงทรัพยากรแบบ static | --- ##### 4. เริ่มบริการ ```bash pm2 start pm2.json pm2 startup pm2 save ``` ##### 5. คำสั่งที่ใช้บ่อย ```bash pm2 list # ดู processos pm2 logs toonflow-app # ดู log pm2 restart all # รีสตาร์ทบริการ pm2 monit # แผงตรวจสอบ ``` > ⚠️ **เข้าสู่ระบบครั้งแรก** > บัญชี: `admin` > รหัสผ่าน: `admin123` ##### 6. ปรับใช้เว็บไซต์ส่วนหน้า หากต้องการปรับใช้หรือปรับแต่งอินเทอร์เฟซส่วนหน้าแยกต่างหาก โปรดดูที่คลังส่วนหน้า: - **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web) - **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web) > 💡 **หมายเหตุ**: คลังนี้มีทรัพยากรส่วนหน้าที่ build ไว้ในตัวแล้ว ผู้ใช้ทั่วไปไม่จำเป็นต้องปรับใช้ส่วนหน้าแยกต่างหาก คลังส่วนหน้ามีไว้สำหรับนักพัฒนาที่ต้องการพัฒนาเพิ่มเติมเท่านั้น ### การปรับใช้บนแพลตฟอร์มคลาวด์ > 🎉 **แพลตฟอร์มพันธมิตรด้านการประมวลผลที่ได้รับการรับรองอย่างเป็นทางการใหม่ —— Zhixing Cloud (AI Galaxy)** > > **[Zhixing Cloud (AI Galaxy)](https://www.ai-galaxy.com/)** เป็น **ผู้ให้บริการอิมเมจเชิงพาณิชย์ที่ได้รับอนุญาตอย่างเป็นทางการจาก Toonflow** ซึ่งได้ติดตั้ง เผยแพร่ และรองรับการใช้งานเชิงพาณิชย์ของอิมเมจการผลิตละครสั้น AI ของ Toonflow แบบครบชุดอย่างถูกต้องตามกฎหมาย **พร้อมใช้งานทันที ไม่ต้องปรับใช้ด้วยตนเอง** > > - 🌐 เว็บไซต์: [https://www.ai-galaxy.com](https://www.ai-galaxy.com) > - 📖 คู่มือการปรับใช้อิมเมจอย่างเป็นทางการ: [คลิกเพื่อดู](https://mp.weixin.qq.com/s/lq9X1ovQ1_TKeXMOLgicKg?scene=1)

📄 คลิกเพื่อขยายคู่มือฉบับข้อความ

#### 1. ขั้นตอนการเช่า GPU 1. ที่ Zhixing Cloud - ตลาดพลังประมวลผล - 4090 / 4090 Plus คลิก "เช่าทันที" เพื่อเข้าสู่หน้ารายละเอียดการเช่า > 💡 แนะนำให้เปิดโหมด "ต่ออายุอัตโนมัติรายชั่วโมง" เพื่อป้องกันไม่ให้อินสแตนซ์หมดอายุขณะกำลังเรนเดอร์วิดีโอ 2. เลือกอิมเมจ: `windows10LTSCwin10_Toonflow` - สร้างอินสแตนซ์ 3. รออินสแตนซ์เริ่มทำงาน 30~60 วินาที ตรวจสอบวิธีเชื่อมต่อ - ดาวน์โหลดไฟล์เข้าสู่ระบบ RDP - คัดลอกรหัสผ่าน - ดับเบิลคลิกไฟล์เชื่อมต่อคลาวด์ที่ดาวน์โหลดไว้ 4. วางรหัสผ่านที่คัดลอกไว้และเข้าสู่ระบบ เชื่อมต่อเข้าสู่เดสก์ท็อปคลาวด์ > 💡 เลื่อนเมาส์ไปที่ด้านบนของเดสก์ท็อปคลาวด์ค้างไว้สักครู่ จะแสดงแถบสลับเดสก์ท็อป คลิก "──" เพื่อสลับกลับไปยังเดสก์ท็อปคอมพิวเตอร์ของคุณ หรือคลิก "□" เพื่อย่อเป็นหน้าต่างบนเดสก์ท็อปของคุณ #### 2. ขั้นตอนการตั้งค่า Toonflow และเริ่ม ComfyUI 1. ตั้งค่าโมเดลที่ Agent เรียกใช้ก่อน: เปิด Toonflow บนเดสก์ท็อป - บริการโมเดล - อินเทอร์เฟซมาตรฐาน OpenAI - กรอกคีย์ API และที่อยู่คำขอ บัญชีเริ่มต้น: `admin` รหัสผ่าน: `admin123` (แนะนำให้เปลี่ยนรหัสผ่านหลังเข้าสู่ระบบ) > 💡 ที่นี่ใช้บริการ Token โมเดลภาษาขนาดใหญ่ AI ของ Zhixing Cloud โดยตรง อินเทอร์เฟซอย่างเป็นทางการ มั่นคงและปลอดภัย ลดสูงสุดถึง 40% (การแปลงนิยายเป็นบทละครใช้เพียงประมาณ ¥0.64) - ที่อยู่คำขอ Token สำหรับเรียกใช้โมเดลของ Zhixing Cloud: `https://token.ai-galaxy.com/v1` - ขั้นตอนการเติมเงิน Token ของ Zhixing Cloud: ตลาด Token - ภาพรวมบัญชี - เติมเงิน - เติมยอดเงินคงเหลือหรือคูปองพลังประมวลผลของ Zhixing Cloud เข้าบัญชี Token - หลังเติมเงินแล้ว เข้าไปที่ "จัดการ Key" - สร้าง API ใหม่ ตั้งชื่อว่า `Toonflow` หรือชื่ออื่นก็ได้ คลิกยืนยันและคัดลอกคีย์ API 2. กลับไปที่ขั้นตอนที่ 1 วางคีย์ API และที่อยู่คำขอที่สร้างไว้ลงในบริการโมเดลของ Toonflow กรอกเสร็จแล้วคลิกที่ว่าง ระบบจะแจ้งว่า "การกำหนดค่าผู้ให้บริการได้รับการอัปเดตแล้ว" คลิก "เพิ่มด้วยตนเอง" กลับไปที่หน้าตลาด Token ของ Zhixing Cloud และคัดลอกชื่อโมเดลแบบเต็ม > 💡 คีย์เดียวสามารถเรียกใช้โมเดลทั้งหมดบน Zhixing Cloud ได้ เลือกโมเดลที่ต้องการใช้ได้เลย แนะนำ `deepseek-v4-pro` วางชื่อโมเดลแบบเต็มลงใน Toonflow และยืนยันเพื่อทำการตั้งค่าโมเดลให้เสร็จสมบูรณ์ 3. หลังตั้งค่าเสร็จแล้ว ตรวจสอบสองจุด: - สวิตช์เรียกใช้โมเดลทั้งสามในบริการโมเดลเปิดอยู่หรือไม่ - โมเดลที่เรียกใช้ในการตั้งค่า Agent ตรงกับที่คุณตั้งค่าไว้หรือไม่ (หากไม่ตรงกัน คลิกเพื่อแก้ไข) 4. เริ่ม ComfyUI: เดสก์ท็อปคลาวด์ - ตัวเปิด ComfyUI - เริ่มด้วยคลิกเดียว 5. การเริ่มทำงานใช้เวลาประมาณ 1~2 นาที หลังเริ่มทำงานเสร็จแล้ว ให้เปิดหน้านี้ค้างไว้

--- # 🔧 คู่มือขั้นตอนการพัฒนา > [!CAUTION] > 🚧 **ข้อกำหนดการส่ง PR** 🚧 > > ⛔ สาขา `master` ไม่รับ PR ใดๆ ｜ ✅ โปรดส่ง PR ไปยังสาขา `develop` > > ยินดีต้อนรับนักพัฒนาทุกท่านร่วมสร้างสรรค์ Toonflow หากสนใจเข้าร่วม โปรดติดต่อผู้ดูแล ACT ในกลุ่มสนทนา ## 🛠️ สแต็กเทคโนโลยี | ประเภท | เทคโนโลยี | | ---------- | ----------------------------------------------------------------------------------------- | | รันไทม์ | Node.js 23.11.1+ | | ภาษา | TypeScript 5.x | | เฟรมเวิร์กแบ็กเอนด์ | Express 5 | | ฐานข้อมูล | SQLite (better-sqlite3 / knex) | | การรวม AI | Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Tongyi Qianwen / xAI) | | การอนุมานในพื้นที่ | @huggingface/transformers (ONNX) | | การสื่อสารเรียลไทม์ | Socket.IO | | ไคลเอนต์เดสก์ท็อป | Electron 40 | | การประมวลผลภาพ | Sharp | | การทำคอนเทนเนอร์ | Docker | ## การเตรียมสภาพแวดล้อมการพัฒนา - **Node.js**: เวอร์ชัน 23.11.1 ขึ้นไป - **Yarn**: แนะนำให้ใช้เป็นตัวจัดการแพ็คเกจของโปรเจกต์ ## การเริ่มต้นโปรเจกต์อย่างรวดเร็ว 1. **Clone โปรเจกต์** **Clone จาก GitHub:** ```bash git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app ``` **Clone จาก Gitee (แนะนำสำหรับในประเทศจีน):** ```bash git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app ``` 2. **ติดตั้ง dependencies** โปรดรันคำสั่งต่อไปนี้ในไดเรกทอรีรากของโปรเจกต์เพื่อติดตั้ง dependencies: ```bash yarn install ``` 3. **เริ่มสภาพแวดล้อมการพัฒนา** โปรเจกต์นี้ประกอบด้วย **บริการ API แบ็กเอนด์** และ **หน้าส่วนหน้า** สองส่วน โปรดเลือกวิธีการเริ่มตามความต้องการ: - **วิธีที่ 1: เริ่มเฉพาะบริการแบ็กเอนด์** ```bash yarn dev ``` > ⚠️ คำสั่งนี้เริ่มเฉพาะบริการ API แบ็กเอนด์ (พอร์ต 10588) **ไม่มีหน้าส่วนหน้า** การเข้าถึง `http://localhost:10588` โดยตรงจะเรียกใช้接口 API ได้เท่านั้น ไม่สามารถเห็นอินเทอร์เฟซเว็บที่สมบูรณ์ได้ หากต้องการใช้หน้าส่วนหน้าพร้อมกัน โปรดใช้ร่วมกับโปรเจกต์ส่วนหน้าที่แยกต่างหาก หรือใช้โหมด GUI ด้านล่าง - **วิธีที่ 2: เริ่มไคลเอนต์เดสก์ท็อป Electron** ```bash yarn dev:gui ``` > คำสั่งนี้จะเริ่มบริการแบ็กเอนด์และหน้าต่างเดสก์ท็อป Electron พร้อมกัน มีหน้าส่วนหน้าในตัว พร้อมใช้งานทันที ไม่ต้องกำหนดค่าเพิ่มเติม เหมาะสำหรับนักพัฒนาที่ต้องการสัมผัสประสบการณ์ฟังก์ชันทั้งหมดอย่างสมบูรณ์ - **วิธีที่ 3: เริ่มโหมดการผลิต** ```bash yarn start ``` > รันบริการที่ compile แล้วโดยตรงในโหมดการผลิต (ต้องรัน `yarn build` ก่อน) 4. **การแพ็คเกจโปรเจกต์** - Compile และสร้างไฟล์ TypeScript: ```bash yarn build ``` - แพ็คเกจเป็นโปรแกรมที่รันได้บน Windows: ```bash yarn dist:win ``` - แพ็คเกจเป็นโปรแกรมที่รันได้บน Mac: ```bash yarn dist:mac ``` - แพ็คเกจเป็นโปรแกรมที่รันได้บน Linux: ```bash yarn dist:linux ``` 5. **การตรวจสอบคุณภาพโค้ด** - ตรวจสอบไวยากรณ์และมาตรฐานโดยรวม: ```bash yarn lint ``` 6. **แผงดีบัก AI (ไม่บังคับ)** เริ่มเครื่องมือดีบัก可视化ของ AI SDK เพื่อความสะดวกในการดีบักการเรียก AI: ```bash yarn debug:ai ``` ## การพัฒนาส่วนหน้า หากต้องการแก้ไขอินเทอร์เฟซส่วนหน้า โปรดไปที่คลังส่วนหน้าเพื่อพัฒนา: - **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web) - **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web) หลังจากสร้างส่วนหน้าแล้ว ให้คัดลอกเนื้อหาของไดเรกทอรี `dist` ไปยัง `data/web` ของโปรเจกต์นี้เพื่อรวมเข้าด้วยกัน ## โครงสร้างโปรเจกต์ ``` 📂 build/ # ผลลัพธ์การ compile 📂 data/ # ข้อมูลรันไทม์ │ ├─ 📂 models/ # โมเดลการอนุมานในพื้นที่ (ONNX) │ ├─ 📂 oss/ # ที่เก็บอ็อบเจกต์ (素材/ตัวละคร/ฉาก) │ ├─ 📂 serve/ # จุดเข้าใช้งานสภาพแวดล้อมการผลิต │ ├─ 📂 skills/ # คำแนะนำทักษะ Agent │ └─ 📂 web/ # ผลลัพธ์การ compile ส่วนหน้า (built-in) 📂 docs/ # ทรัพยากรเอกสาร 📂 env/ # การกำหนดค่าสภาพแวดล้อม 📂 scripts/ # สคริปต์การสร้างและเสริม 📂 src/ ├─ 📂 agents/ # โมดูล AI Agent │ ├─ 📂 productionAgent/ # Production Agent │ └─ 📂 scriptAgent/ # Script Agent ├─ 📂 lib/ # ไลบรารีสาธารณะ (การเริ่มต้นฐานข้อมูล, รูปแบบการตอบสนอง) ├─ 📂 middleware/ # มิดเดิลแวร์ ├─ 📂 routes/ # โมดูลเส้นทาง │ ├─ 📂 agents/ # การจัดการความจำ Agent │ ├─ 📂 artStyle/ # การจัดการสไตล์ภาพ │ ├─ 📂 assets/ # การจัดการ素材 │ ├─ 📂 assetsGenerate/ # การสร้าง素材 │ ├─ 📂 cornerScape/ # การจัดการสตอรี่บอร์ด │ ├─ 📂 general/ # อินเทอร์เฟซทั่วไป │ ├─ 📂 login/ # การรับรองความถูกต้องในการเข้าสู่ระบบ │ ├─ 📂 migrate/ # การย้ายข้อมูล │ ├─ 📂 modelSelect/ # การเลือกโมเดล │ ├─ 📂 novel/ # การจัดการนิยาย │ ├─ 📂 other/ # ฟังก์ชันอื่นๆ │ ├─ 📂 production/ # การจัดการการผลิต │ ├─ 📂 project/ # การจัดการโครงการ │ ├─ 📂 script/ # การสร้างสคริปต์ │ ├─ 📂 scriptAgent/ # อินเทอร์เฟซ Script Agent │ ├─ 📂 setting/ # การตั้งค่าระบบ │ ├─ 📂 task/ # การจัดการงาน │ └─ 📂 test/ # อินเทอร์เฟซทดสอบ ├─ 📂 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 # การประกาศ dependencies ของบุคคลที่สาม 📄 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) | > 💡 **คำแนะนำ**: หากคุณเพียงต้องการใช้ Toonflow ให้ดาวน์โหลดไคลเอนต์จากคลังนี้โดยตรง คลังส่วนหน้ามีไว้สำหรับนักพัฒนาที่ต้องการพัฒนาเพิ่มเติมหรือปรับแต่งอินเทอร์เฟซส่วนหน้าเท่านั้น --- # 👨‍👩‍👧‍👦 กลุ่มสนทนา WeChat ผู้ช่วยเพิ่มเพื่อน: Toonflow QR

หรือคลิกไอคอนเพื่อเข้าร่วม Discord: [![Join our Discord](https://cdn.prod.website-files.com/6257adef93867e50d84d30e2/67d00cf7266d2c75571aebde_Example.svg)](https://discord.gg/HEjKmpNpAZ) หรือคลิกลิงก์เชิญ: [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ) --- # 💌 ติดต่อเรา 📧 อีเมล: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=สอบถาม Toonflow) --- # 📜 ใบอนุญาต 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 | เจรจาต่อรอง | > **ข้อกำหนดไม่ย้อนหลัง**: ผู้ใช้ที่ใช้งานภายใต้ AGPL-3.0 ก่อนการเผยแพร่ v1.0.8 จะยังคงปฏิบัติตาม AGPL-3.0 ต่อไป โดยไม่ถูกผูกมัดด้วยการเปลี่ยนแปลงข้อตกลงนี้ ข้อตกลงฉบับสมบูรณ์ดูได้จากไฟล์ [LICENSE](./LICENSE) --- # ⭐️ ประวัติดาว [![Star History Rank](https://api.star-history.com/badge?repo=HBAI-Ltd/Toonflow-app)](https://www.star-history.com/#HBAI-Ltd/Toonflow-app) [![Star History Chart](https://api.star-history.com/svg?repos=HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)](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 สำหรับ TypeScript - [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - ไลบรารีเชื่อมต่อ SQLite3 ประสิทธิภาพสูง - [Sharp](https://sharp.pixelplumbing.com/) - ไลบรารีประมวลผลภาพ Node.js ประสิทธิภาพสูง - [Axios](https://axios-http.com/) - ไคลเอนต์ HTTP ที่ใช้ Promise - [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	💻 สนับสนุนพลังประมวลผล	มุ่งมั่นสร้างแพลตฟอร์มบริการ API การอนุมานแบบครบวงจรที่เร็ว เสถียร และประหยัดยิ่งขึ้น	เว็บไซต์
Atlas Cloud	💻 สนับสนุนพลังประมวลผล	แพลตฟอร์มการอนุมานแบบครบวงจรระดับโลกแห่งแรก การสนทนา รูปภาพ วิดีโอ เสียง — API ที่เป็นหนึ่งเดียวทั้งหมด มีโมเดลมากกว่า 300 โมเดล รองรับ OpenAI	เว็บไซต์
Tencent Hunyuan 3D	🌐 สนับสนุนเทคโนโลยี World Model	Tencent Hunyuan 3D AI Creation Engine ใช้ Hunyuan 3D Generation Large Model เวอร์ชัน 2.5 เป็นแพลตฟอร์มสร้างเนื้อหา 3D แบบครบวงจรด้วย AI รายแรกในอุตสาหกรรม มีฟังก์ชันสร้าง 3D จากข้อความและรูปภาพ, สร้างแอนิเมชัน 3D, สร้างพื้นผิว เป็นต้น รองรับการสร้าง 3D จากภาพร่าง, การสร้างตัวละคร 3D มีข้อได้เปรียบในการสร้างโมเดลแบบ low-poly	เว็บไซต์
Zhixing Cloud (智星云)	💻 สนับสนุนพลังประมวลผล 🖼️ สนับสนุนอิมเมจ	แบรนด์บริการพลังประมวลผลระดับมืออาชีพที่มีชื่อเสียงในจีน ให้บริการพลังประมวลผลที่ราคาประหยัดและมั่นคง ให้บริการห้องปฏิบัติการของมหาวิทยาลัยชั้นนำกว่าพันแห่ง (Tsinghua, Peking, Fudan, Zhejiang University ฯลฯ) สถาบันบัณฑิตวิทยาศาสตร์จีน และบริษัท AI กว่า 5,000 แห่ง	เว็บไซต์