# คู่มือติดตั้งและอัปเดต Craft apps ด้วย SuitePilot

SuitePilot เป็นเครื่องมืออิสระที่ช่วยติดตั้งและอัปเดตแอปต้นฉบับใน Craft App Suite
โดยดาวน์โหลดแอปจาก GitHub ของ StoryTold ชุดนี้ไม่ใช่ตัวติดตั้งทางการของ ArtCraft

คู่มือนี้เหมาะสำหรับผู้ที่ต้องการเปิดแอปใช้งาน ไม่จำเป็นต้องติดตั้งเครื่องมือสำหรับพัฒนา
ก่อนเริ่ม ให้เชื่อมต่ออินเทอร์เน็ตและเตรียมพื้นที่ว่างสำหรับไฟล์ติดตั้ง แอป และการอัปเดต

> **สถานะรุ่นทดลอง:** ชุด Windows ผ่านการทดสอบติดตั้งตัวจัดการและเปิดใช้งานบน
> Windows 10 x64 ในเครื่องทดสอบ ผู้ใช้ได้ลองสคริปต์พื้นฐานบน Mac และรายงานว่าใช้งานได้
> ส่วนไฟล์ดับเบิลคลิกใหม่บน Mac และการติดตั้งบน Ubuntu ยังไม่ได้ทดสอบบนระบบนั้นโดยตรง
> จึงยังไม่รับประกันว่าจะใช้ได้กับทุกเครื่องหรือทุกฟังก์ชันของทุกแอป

## เลือกไฟล์ดาวน์โหลด

เลือกไฟล์ให้ตรงกับระบบของคุณจากหน้าเว็บนี้:

| ระบบ | ไฟล์ที่ต้องดาวน์โหลด | ขนาดประมาณ |
| --- | --- | --- |
| Windows 10/11 x64 | `suitepilot-0.1.0-windows-x64.msi` | 226 MB |
| macOS — Apple Silicon หรือ Intel | `suitepilot-macos-double-click-preview-20261027.zip` | 101 MB |
| Ubuntu — x64 หรือ ARM64 | `suitepilot-ubuntu-scripts-preview-20261027.zip` | 114 MB |

ไฟล์สำหรับตรวจความถูกต้องคือ `SHA256SUMS.txt` สำหรับ Windows,
`suitepilot-macos-double-click-preview-20261027.zip.sha256` สำหรับ Mac และ
`SuitePilot-Unix-preview-SHA256SUMS.txt` สำหรับ Ubuntu ไฟล์ checksum ใช้ตรวจว่า
ชุดดาวน์โหลดตรงกับต้นฉบับที่ผู้จัดแจกหรือไม่; โปรดดาวน์โหลดจากแหล่งที่คุณเชื่อถือ

---

## Windows

### ติดตั้ง SuitePilot

1. ดาวน์โหลดไฟล์ **MSI สำหรับ Windows** จากตารางด้านบน
2. ดับเบิลคลิกไฟล์ แล้วทำตามหน้าจอ **Next → Install → Finish**
3. เปิด **SuitePilot** จากไอคอนบน Desktop หรือจาก Start menu

ชุดทดลองนี้ยังไม่ได้ลงลายเซ็นดิจิทัล Windows จึงอาจแสดงคำเตือนเกี่ยวกับผู้เผยแพร่
โปรดตรวจสอบว่าคุณได้รับไฟล์จากผู้จัดแจกที่เชื่อถือก่อนเลือกดำเนินการต่อ

### ติดตั้งแอป

1. เปิด SuitePilot แล้วเลือกแอปที่ต้องการ หรือกด **Select all**
2. หากต้องการ เปลี่ยนภาษาและโฟลเดอร์ติดตั้งใน **Settings**
3. กด **Review selected** แล้วตรวจชื่อแอป รุ่น และโฟลเดอร์ที่จะติดตั้ง
4. กด **Install/Apply** หรือ **Agree and install/apply** แล้วรอผล
5. เมื่อแอปแสดง **Done** ให้กด **Open** เพื่อเปิดใช้งาน

หากเลือก ArtCraft AI ให้อ่านเงื่อนไข Microsoft WebView2 ก่อนยืนยัน Windows อาจขอ
สิทธิ์ผู้ดูแลระบบ ชุดติดตั้งแพ็กตัวติดตั้ง WebView2 ของ Microsoft มาด้วยแล้ว
จึงไม่ต้องดาวน์โหลด runtime ตัวนี้แยก แต่ยังต้องใช้อินเทอร์เน็ตเพื่อดาวน์โหลดแอป

### อัปเดตและจัดการแอป

1. เปิด SuitePilot แล้วกดปุ่มตรวจอัปเดต
2. เลือก **Update** จากเมนู Action และเลือกแอปที่ต้องการ
3. กด **Review selected** ตรวจรายละเอียด แล้วกดยืนยัน

**Repair** ใช้ซ่อมรุ่นที่ติดตั้งไว้ ส่วน **Uninstall** จัดการเฉพาะแอปที่ SuitePilot
ติดตั้งและบันทึกไว้ การติดตั้งเดิมจากเครื่องมืออื่นไม่ได้ถูกนำมาเป็นของ SuitePilot
โดยอัตโนมัติ หากโฟลเดอร์เป้าหมายมีไฟล์เดิมที่ตัวจัดการไม่รู้จัก ให้เลือกโฟลเดอร์ใหม่
หากปิดหน้าต่างแล้วโปรแกรมยังอยู่ใน tray ให้เข้า **Settings → Quit SuitePilot**

---

## macOS

ชุดนี้ออกแบบสำหรับ macOS 11 ขึ้นไป ทั้ง Apple Silicon และ Intel แตก ZIP ทั้งชุด
และเก็บไฟล์กับโฟลเดอร์ `runtime` ไว้ด้วยกัน ห้ามแยกไฟล์สคริปต์ออกมาเพียงไฟล์เดียว

### วิธีที่ 1: ดับเบิลคลิก แล้วเลือก Open Anyway — รุ่นทดลอง

ไฟล์ดับเบิลคลิกใหม่นี้ยังไม่ได้ทดสอบบน Mac จริง หากเปิดไม่ได้ให้ใช้วิธี Terminal
ในหัวข้อถัดไป ซึ่งผู้ใช้ได้ลองกับสคริปต์พื้นฐานบน Mac แล้ว

1. ดาวน์โหลด **ZIP สำหรับ macOS** จากตาราง แล้วดับเบิลคลิกเพื่อแตกไฟล์
2. เปิดโฟลเดอร์ที่แตกแล้ว ดับเบิลคลิก **Install or Update.command**
3. หาก Mac แจ้งว่า Apple ไม่สามารถตรวจสอบไฟล์ได้ ให้กด **Done** หรือ **Cancel**
   แล้วเปิด **System Settings → Privacy & Security**
4. เลื่อนลงไปกด **Open Anyway** จากนั้นกดยืนยัน **Open** ตามหน้าจอ
5. Terminal จะเปิดขึ้นและเริ่มติดตั้งหรืออัปเดต รอจนเห็นสรุปผลในหน้าต่าง
   สามารถปิดหน้าต่างหลังตรวจผลแล้วได้

ไฟล์ตัวช่วยของชุดทดลองยังไม่ได้ลงลายเซ็นหรือรับรองโดย Apple จึงอาจพบคำเตือนนี้
ให้ดำเนินการต่อเฉพาะเมื่อมั่นใจว่าไฟล์มาจากผู้จัดแจกที่เชื่อถือ หาก Mac แจ้งว่า
ไฟล์ **เสียหาย** หรือ **มีมัลแวร์** อย่าบังคับเปิด ให้ติดต่อผู้จัดแจกเพื่อตรวจสอบ
วิธี Open Anyway อาจต่างกันตาม macOS; ดู [คำแนะนำของ Apple](https://support.apple.com/en-sg/102445)

หากเปิดไฟล์ผ่านแล้ว ครั้งต่อไปดับเบิลคลิก **Install or Update.command** ไฟล์เดิมเพื่อเช็กรุ่นและอัปเดต
แอปที่สคริปต์นี้ติดตั้งไว้ โดยไม่ต้องพิมพ์คำสั่ง ไฟล์ที่ผ่าน Open Anyway แล้วปกติ
จะเปิดได้ในครั้งต่อไป แต่ไฟล์ชุดใหม่ที่ดาวน์โหลดภายหลังอาจถูกตรวจอีกครั้ง

### วิธีที่ 2: เปิดด้วย Terminal

ใช้วิธีนี้หากต้องการรันสคริปต์ด้วยตัวเอง:

1. ดาวน์โหลดและแตก ZIP สำหรับ macOS แล้วเปิดโฟลเดอร์ที่แตก
2. เปิด **Terminal**: กด Command + Space พิมพ์ `Terminal` แล้วกด Enter
3. ใน Terminal พิมพ์ `bash` แล้วกด Space หนึ่งครั้ง **ยังไม่ต้องกด Enter**
4. ลากไฟล์ **suitepilot.sh** จากโฟลเดอร์ที่แตกมาวางในหน้าต่าง Terminal
   ระบบจะเติมตำแหน่งไฟล์ให้เอง จากนั้นกด **Enter**
5. รอจนเห็นผลสรุปว่ารายการใดสำเร็จหรือไม่สำเร็จ

การรันโดยไม่มีคำสั่งต่อท้ายจะติดตั้งแอปที่ยังไม่มีและตรวจอัปเดตแอปที่สคริปต์นี้
ติดตั้งไว้ หากต้องการรันใหม่ในครั้งต่อไป ให้ทำขั้นตอนเดิมอีกครั้ง

### เปิดแอปที่ติดตั้งแล้ว

แอปติดตั้งในโฟลเดอร์ `~/Applications` ของผู้ใช้ เปิด Finder เลือก **Go → Go to Folder**
พิมพ์ `~/Applications` แล้วเลือกแอปที่ต้องการ สคริปต์ตรวจลายเซ็นและ Gatekeeper
ของแอปต้นฉบับก่อนติดตั้ง และไม่ทับแอปชื่อเดียวกันที่ไม่ได้ติดตั้งโดยสคริปต์นี้
หากแอปกำลังเปิดอยู่ ให้ปิดแอปนั้นก่อนอัปเดต

---

## Ubuntu

ชุดนี้ออกแบบสำหรับ Ubuntu 22.04 ขึ้นไป บนเครื่อง x64 หรือ ARM64

1. ดาวน์โหลด **ZIP สำหรับ Ubuntu** จากตาราง แล้วแตกไฟล์ทั้งหมดลงในโฟลเดอร์เดียวกัน
   เก็บไฟล์สคริปต์และโฟลเดอร์ `runtime` ไว้ด้วยกัน อย่าย้าย `suitepilot.sh` ออกมาเดี่ยว ๆ
2. เปิดโฟลเดอร์ที่แตก คลิกขวาบนพื้นที่ว่าง แล้วเลือก **Open in Terminal**
   หรือเปิด Terminal จากเมนู Applications
3. พิมพ์ `bash` แล้วกด Space หนึ่งครั้ง จากนั้นลากไฟล์ **suitepilot.sh** มาวางใน
   Terminal และกด **Enter** ระบบจะเติมตำแหน่งไฟล์ให้ ไม่ต้องพิมพ์ path เอง
4. เมื่อระบบขอรหัสผ่านผู้ดูแล ให้พิมพ์รหัสผ่านของคุณแล้วกด Enter
   ขณะพิมพ์รหัสผ่าน ตัวอักษรอาจไม่แสดงบนหน้าจอ
5. รอจนเห็นสรุปผล แล้วเปิดแอปจากเมนู Applications ของ Ubuntu

รันวิธีเดิมอีกครั้งเมื่อต้องการอัปเดต สคริปต์ใช้ `apt` และอาจดาวน์โหลด
ส่วนประกอบระบบที่ขาดเพิ่มเติมจากแหล่งซอฟต์แวร์ของเครื่อง จึงต้องใช้อินเทอร์เน็ต
Node.js ที่สคริปต์ใช้ถูกแพ็กมาแล้ว ไม่ต้องติดตั้ง Node.js หรือ npm เอง

**ArtCraft AI:** release ล่าสุดที่ตรวจพบยังไม่มีไฟล์สำหรับ Linux ชุด Ubuntu จึงแจ้งว่า
ArtCraft AI ยังไม่รองรับและแสดงผลว่างานไม่ครบ ส่วนแอปอื่นจะพยายามติดตั้งต่อ

---

## หากติดตั้งหรืออัปเดตไม่สำเร็จ

- ตรวจการเชื่อมต่ออินเทอร์เน็ต พื้นที่ว่าง และข้อความผลลัพธ์ของแอปที่มีปัญหา
- หาก GitHub แจ้ง **HTTP 403** อาจถึงขีดจำกัดการเรียกข้อมูล ให้รอสักพักแล้วลองใหม่
- บน Mac หากพบแอปเดิมที่ไม่ได้ติดตั้งโดยสคริปต์ ระบบจะไม่ทับแอปนั้นโดยอัตโนมัติ
- หากปิดเครื่องหรือบังคับปิดโปรแกรมระหว่างทำงาน อาจมีไฟล์ล็อกหรือข้อมูลการกู้คืน
  ค้างอยู่ ให้เก็บข้อความแจ้งเตือนและติดต่อผู้จัดแจกก่อนลบไฟล์ดังกล่าว
- การติดตั้งหลายแอปอาจสำเร็จบางรายการและล้มเหลวบางรายการ ตรวจสรุปผลก่อนปิดหน้าต่าง

Craft-libs, craft-fonts และ artcraft-services เป็นส่วนประกอบหรือบริการ ไม่ต้องเปิด
ติดตั้งเป็นแอปแยกด้วยคู่มือนี้ ส่วน dashboard สำหรับดูสถานะ repo ไม่ได้รวมอยู่ในชุดติดตั้ง