คู่มือใช้งานฉบับ V7.7

# คู่มือ TikTok Bot V7.7 สำหรับใช้งานทุกแถบ

หน้านี้เป็นแผนที่หลักของโปรแกรม อธิบายว่าแต่ละแถบใช้ทำอะไร และเชื่อมไปยังคู่มือย่อยแบบ step by step สำหรับทุก workflow สำคัญ

บอททำอะไรได้บ้าง เริ่มจาก Home เพิ่ม CSV หลายตะกร้า จัดการ Product Map

## คู่มือความสามารถทั้งหมด

เปิด ความสามารถทั้งหมด เพื่อดูว่า bot ทำอะไรได้บ้างแบบละเอียด: run automation, Product Map, Shop Catalog, CSV Planner, Queue Preflight, Reports+, Report Pack, Backup, Undo, Storage Center, Workspace Profiles, Support Bundle, Visual QA และ Release Doctor

## เปิดใช้งานจากโฟลเดอร์นี้

ใน Chrome ให้ใช้ Load unpacked ไปที่โฟลเดอร์ extension จริง:

    dist/tiktok-bot-v7.5

เวอร์ชันที่ถูกต้อง: Chrome extension แสดงชื่อ `TikTok Bot V7.7`, manifest version `7.7.0`, และ npm package version `7.7.0`.

## ส่วนหัวของโปรแกรม

### เลือก tab TikTok

ใช้เลือกแท็บ TikTok Studio ที่ bot จะควบคุม ก่อนกด Start ควรเลือกแท็บให้ถูกเสมอ

### Refresh / Ping

Refresh ใช้ค้นหาแท็บใหม่ Ping ใช้ตรวจว่า content script ในหน้า TikTok ตอบกลับได้

### Open TikTok Studio

เปิดหน้า upload ของ TikTok Studio เพื่อเตรียมพื้นที่ทำงานให้ bot

## ลำดับใช้งานที่แนะนำ

1. เปิด side panel แล้วดู `Home` เพื่อเช็ค Health Score และ Fix Queue ก่อนเริ่มงาน
2. ไปที่ `Setup` เลือกโหมด Draft, Post Now หรือ Schedule และตั้ง fallback/caption suffix
3. ไปที่ `Products` หรือ `Catalog` เพื่อเช็ค Product Map, Shop Catalog และ CSV ID ให้พร้อม
4. ไปที่ `Files` เลือกวิดีโอหรือโฟลเดอร์วิดีโอที่ต้องการใช้ในรอบนี้
5. ไปที่ `Queue` กด Build แล้วตรวจลำดับไฟล์ เวลา โหมด และสินค้า
6. เลือก TikTok tab ด้านบน จากนั้นกด Start เมื่อพร้อมจริง
7. หลังจบงาน ดู `Report` หรือ `Reports+` เพื่อเช็คผลลัพธ์ export หรือแก้ failed SKU
8. ถ้าต้องส่งหลักฐาน debug ให้กด `Support Bundle` จาก Home หรือ Log เพื่อ export JSON แบบไม่แนบวิดีโอส่วนตัว

## คำอธิบายทุกแถบ

Home Mission Control, Health Score, Fix Queue, Saved Views, Gallery Review, Backup Center, Export Report และ Support Bundle Setup ตั้งโหมดการทำงาน Draft/Post Now/Schedule, time slots, exclude range, product fallback และ caption suffix Files เลือกไฟล์หรือโฟลเดอร์วิดีโอ เลือกทั้งหมด ล้างรายการ และเตรียมไฟล์ให้ Queue Queue Build plan, ตรวจลำดับ, สถานะ, Start, Stop, Resume, Retry และ export report ของ session Log ดูข้อความ runtime, error, warning, save log และ export Support Bundle สำหรับ debug Products จัดการ Product Map, Add/Edit, Best CSV, Best+, drag reorder, URL auto-fill, Bulk Edit, Import/Export, Backup และ Check List Catalog สแกน Shop Showcase, filter สินค้า, Select 10, Bulk Add CSV, CSV Planner V2 และ Bulk Best CSV Report รายงานแบบคลาสสิก: summary, 30-day chart, failures ล่าสุด, export และ clear history Reports+run history, analytics, Action Center, Insight Cards, SKU performance, file history และ report pack

## แหล่งข้อมูลที่โปรแกรมใช้

ข้อมูล | ใช้ที่ไหน | ความหมาย
--- | --- | ---
`shop_showcase_catalog` | Products, Catalog, Home | snapshot สินค้าจาก TikTok Shop Showcase เป็นแหล่งอ้างอิงสถานะสินค้า
`products_map_custom` | Setup, Queue, Products, Catalog | Product Map ที่ bot ใช้จับคู่ CSV ID กับ SKU และชื่อสินค้า
`run_history` | Home, Reports+ | ประวัติ run แบบ V7 ใช้ทำ analytics และ insight cards
`v6_report_history` | Report | ประวัติรายงานแบบคลาสสิก เก็บได้สูงสุด 5,000 รายการ
`tiktok_bot_v75_last_backup_meta` | Home, Backup Center | metadata ล่าสุดหลัง export portable backup

## ภาพตัวอย่างหน้าหลัก