TikTok Bot V7.7 Capabilities

# บอททำอะไรได้บ้าง

หน้านี้สรุปความสามารถทั้งหมดของโปรแกรมแบบ source-backed แยกตาม workflow จริงใน side panel, content scripts, report tools, backup tools และ release tooling

เริ่มจาก Home ตรวจ Queue ดู Reports+

## ภาพรวมสั้น

### Run automation

เลือกไฟล์, build queue, dry run, upload, caption, product attach, draft, post now, schedule, retry และ resume

### Data management

Product Map, Shop Catalog, CSV Planner, Import Diff, Backup, Restore, Undo, Storage Center และ Workspace Profiles

### Reporting and safety

Mission Control, Health Score, Reports+, Report Pack, Log, Support Bundle, Visual QA และ Release Doctor

## Extension และการโหลดเข้า Chrome

- ชื่อ extension คือ `TikTok Bot V7.7`
- Chrome manifest version คือ `7.7.0`
- npm package คือ `tiktok-bot-v7-5@7.7.0`
- โหลด Chrome จาก `dist\tiktok-bot-v7.5`
- ใช้ `npm run release:verify` เพื่อ build และตรวจ package ก่อน Load unpacked

## ความสามารถตามแถบ

แถบ | ทำอะไรได้ | ใช้เมื่อไร
--- | --- | ---
Home | Mission Control, Health Score, Fix Queue, Saved Views, Gallery Review, Backup Center, Export Report, Support Bundle | เริ่มงาน ตรวจ readiness และเลือก action ที่ควรทำต่อ
Setup | ตั้ง Draft/Post Now/Schedule, interval/time slots, exclude ranges, fallback, caption suffix, Workspace Profiles | กำหนด workflow ก่อน build queue
Files | เลือกไฟล์วิดีโอหรือโฟลเดอร์, clear list, เตรียมไฟล์เข้า queue | ก่อนสร้างคิวโพสต์
Queue | Build, Dry Run, Preflight, Start, Stop, Resume, Retry, session export | ตรวจและรันรอบงานจริง
Log | ดู runtime log, Save Log, Export Support Bundle | ตอน debug หรือส่งหลักฐาน
Products | จัดการ Product Map, Add/Edit, Best CSV, Best+, same-CSV drag reorder, URL auto-fill, Import Diff, Backup, Undo Center, Storage Center | แก้ข้อมูล CSV ID/SKU ที่บอทใช้จับสินค้า
Catalog | Scan Shop Showcase, filter catalog, Select 10, Bulk Add CSV, CSV Planner V2, ignore, Save View | เอาข้อมูลสินค้า TikTok Shop มาเชื่อมกับ CSV ID
Report | Classic summary, 30-day chart, latest failures, export/clear history | ดูผลแบบเร็วและย้อนหลังแบบคลาสสิก
Reports+ | Run history, analytics, insight cards, SKU performance, file history, report pack, Product 360 | วิเคราะห์ failed SKU และผลการทำงานละเอียด

## Posting automation

1. บอทดึง CSV ID จากชื่อไฟล์ เช่น `70001_video.mp4`
2. จับคู่ CSV ID กับสินค้าใน Product Map
3. Build Queue ตาม mode และ schedule ที่ตั้งไว้
4. Dry Run ตรวจไฟล์, product, catalog, stock, schedule และ fallback
5. เมื่อ Start จะส่ง command ไป content scripts ใน TikTok Studio
6. content layer จัดการ upload, caption, product dialog, product anchor, post settings, schedule/post now และ submit
7. ผลลัพธ์ถูกบันทึกลง run history/report history เพื่อใช้ใน Reports+

## Product และ Catalog

### Product Map

เป็นฐานจับคู่ CSV ID กับ SKU/product name/custom caption ใช้ตอน resolve product ใน Queue และ content product attach

### Shop Catalog

เป็น snapshot จาก TikTok Shop Showcase ใช้ตรวจ live status, stock, price, commission, image และ readiness

### CSV Planner V2

เลือกหลายสินค้าแล้ว assign CSV ID พร้อม preview, duplicate checks และ bulk save

### Product 360

รวม product map, catalog, linked CSV IDs, latest run และ latest error ไว้ใน drawer เดียว

- `Best CSV` copy row แบบ exact ไป CSV ID ใหม่ โดยไม่เปลี่ยน flag best seller/favorite เอง
- `Best+` copy row แล้วตั้ง `csv_group=best_seller`, `is_bestseller=true`, `is_favorite=true`
- Drag reorder ใน Products ย้ายลำดับได้เฉพาะรายการที่อยู่ใต้ CSV ID เดียวกัน และบันทึกผ่าน Change History
- Auto URL ดึง CSV/Product ID จากทั้ง URL path และ query string เช่น `?product_id=87654321`

## Safety features

- Import Diff preview ก่อน merge/replace
- Restore point ก่อน import/backup import
- Change History / Undo Center สำหรับ storage edits ที่ปลอดภัย
- Queue Dry Run / Preflight Audit ก่อน Start
- Storage Center พร้อม backup-gated cleanup
- Release Doctor ก่อนโหลด extension เข้า Chrome
- Support Bundle แบบ redact ข้อมูลส่วนตัว

## Reports และ diagnostics

- Reports+ เก็บ run history, success rate, failed SKU, error categories, SKU trends, time-of-day analytics และ file history
- Report Pack V2 export HTML พร้อม charts, failed SKU, gallery thumbnails, storage inventory, preflight, change history และ CSV fix lists
- Classic Report เก็บ `v6_report_history` สำหรับ summary/30-day chart/latest failures
- Log เก็บ runtime messages และ save เป็น text ได้
- Support Diagnostic Bundle รวม health, storage, preflight, run summary, logs, report stats และ validation summary
- Visual QA Center ถ่าย screenshot ทุก surface และตรวจ layout/console issues

## Backup และ storage

Storage key | ความหมาย
--- | ---
`products_map_custom` | Product Map ที่บอทใช้จับคู่ CSV ID กับ SKU
`shop_showcase_catalog` | snapshot สินค้าจาก TikTok Shop Showcase
`run_history` | ประวัติ run แบบ V7 สำหรับ Reports+
`v6_report_history` | ประวัติรายงานคลาสสิก
`runner_config` | mode, schedule, fallback, caption config
`tiktok_bot_v75_saved_views` | Saved Views ที่ user สร้างเอง
`tiktok_bot_v75_workspace_profiles` | โปรไฟล์ร้าน/account/workflow
`tiktok_bot_v75_change_history` | ประวัติการแก้ storage และ undo metadata
`tiktok_bot_v75_first_run` | สถานะ checklist ผู้ใช้ใหม่

## Workflow ที่แนะนำ

1. Home -> Refresh เพื่อดู Health Score
2. Setup -> เลือก mode หรือ Apply Workspace Profile
3. Header -> Refresh Tabs และ Ping
4. Catalog -> Scan หรือแก้ Need CSV ด้วย CSV Planner
5. Products -> ตรวจ Product Map / Check List
6. Files -> เลือกวิดีโอ
7. Queue -> Build และ Dry Run
8. Start เมื่อไม่มี blocker
9. Reports+ -> ตรวจผลและแก้ failed SKU
10. Support Bundle หรือ Report Pack เมื่อจำเป็นต้องส่งหลักฐาน

ข้อควรระวัง: ก่อน import, bulk edit, clear products หรือ cleanup storage ให้ export Portable Backup ก่อนเสมอ และถ้า Ping ไม่ผ่านไม่ควรกด Start