⚔️ SWM (Summoners War Master)
ศูนย์รวมยุทธวิธีกิลด์วอร์, สารานุกรมสกิลมอนสเตอร์ฉบับภาษาไทย, วิเคราะห์ RTA & สถิติเมต้าระดับโลก
🌐 Official Live Website: https://swm-blue.vercel.app/
🧭 ย้ายเครื่อง / เริ่มงานต่อ: อ่าน HANDOFF.md (ตั้งค่า env, โครงสร้าง, แหล่งข้อมูล, AegisLink, หลังบ้าน, งานที่ค้าง)
🌟 ฟีเจอร์หลักของระบบ (Key Features)
- 🎯 ระบบค้นหาทีมแก้ทาง 3MDC (Siege & Guild War)
- ค้นหาสูตรเจาะหอ 4★ และ 5★ คำนวณ Winrate % จากการรบจริง พร้อมคลิกดูทีมบุกเคาน์เตอร์
- 🏆 วิเคราะห์เวิลด์อารีน่า RTA & SWRT Intelligence (Season 38)
- RTA Tier List แยกตามระดับการ์เดียน (Guardian G1-G3), คอนเคอเรอร์ (C1-C3) และทุกระดับ
- ตารางสถิติ Pick / Win / Ban Rate จาก 6.8 ล้านแมตช์
- รีเพลย์แข่งสดพร้อมป้ายแบน และจุดตัดคะแนน Rank Cutoffs เรียลไทม์
- 📊 สถิติเมต้าโลก & Tier List แบบแถบสี (All Server Analytics)
- สลับมุมมองระหว่าง Table และ Tier List (SSS ถึง Other) คำนวณด้วยทฤษฎี Bayesian Theorem ตามแบบ SWGT
- อันดับมอนสเตอร์ฝั่งตั้งรับ (202 ตัว) และฝั่งบุก (247 ตัว)
- 📖 สารานุกรมสกิลมอนสเตอร์ 940 ตัว (Skill Encyclopedia)
- ชี้เมาส์ (Hover) ดู Tooltip สกิลได้ทันที พร้อมสูตรตัวคูณความเสียหาย (Multiplier) และดีบัฟ
- 💥 ดาเมจเสริมอาร์ติแฟกต์ (Artifact Additional Damage Optimizer)
- คำนวณดาเมจเสริม Multi-hit, SPD/HP/ATK/DEF scaling
- 🎁 คลังโค้ดแจกไอเทม (Active Game Codes)
- โค้ดแท้พร้อมปุ่มก็อปและลิงก์รับของรางวัลเข้าเกมผ่าน WithHive ทันที
- 🛡️ AegisLink Plugin Companion
- ปลั๊กอินดักจับข้อมูลการรบแบบเรียลไทม์สำหรับโปรแกรม SWEX
🚀 เทคโนโลยีที่ใช้ (Tech Stack)
- Frontend: React 19, Vite 8, Tailwind CSS 3
- Icons & UI: Lucide React, Custom SVG Tactical HUD
- Deployment: Vercel (Auto-deployment via GitHub CI/CD)
- Data Engine: Pre-compiled Client Datasets for 0ms Latency Instant Search
📡 แหล่งข้อมูล RTA (SWRT) และการอัปเดต
ข้อมูล RTA ดึงจาก endpoint สาธารณะ ของ swranking.com (https://m.swranking.com/api) เท่านั้น — ไม่ใช้บัญชี/token และไม่แตะ endpoint ค้นหาผู้เล่นที่ต้อง login (/player/list, /player/detail, /player/searchPlayer)
| ข้อมูล | Endpoint | ไฟล์ | สคริปต์ |
|---|
| Tier list, Pick/Win/Ban, รีเพลย์ล่าสุด, คะแนนตัดแรงค์ | monsterBase/getMonsterLevel, monster/statistical, player/replayallist, player/nowline | swrtTierList.json, swrtMetaMonsters.json, swrtRecentReplays.json, swrtRankCutoffs.json | node scripts/extract_swrt_data.cjs |
| โปรไฟล์ผู้เล่น Guardian (สร้างจากรีเพลย์สาธารณะ + ผู้เล่นท็อปต่อมอนสเตอร์) | player/replayallist?level=1, monster/topPlayer | swrtPlayersIndex.json (ค้นหา, อยู่ใน bundle) + public/data/swrt-matches/*.json (รีเพลย์ 32 shard โหลดเฉพาะคนที่เปิดดู) | npm run players:fetch (~50 นาที, บันทึกทีละหน้า หยุดกลางคันได้, --rebuild สร้างไฟล์ใหม่จาก .cache/ โดยไม่ต้องดึงซ้ำ) |
| คะแนนตัดแรงค์แบบสด | player/nowline (CORS เปิด) | ดึงตอนเปิดแท็บ Rank Cutoffs, cache 10 นาที, fallback เป็น JSON | src/services/swrtLive.js |
🧰 แสดงข้อมูลของตัวเอง (กล่องมอนสเตอร์ของฉัน)
หน้า /my-box รับไฟล์ JSON ที่ export จาก SWEX (เมนู Profile → ไฟล์ ชื่อไอดี-เลขไอดี.json)
ลากไฟล์วางในหน้าเว็บ → ระบบอ่าน wizard_info + unit_list ในเบราว์เซอร์ เก็บเฉพาะรายชื่อมอนสเตอร์/ดาว/เลเวล/สเตตัส ลง localStorage (swm:mybox)
ไม่มีการอัปโหลดขึ้นเซิร์ฟเวอร์ และไม่ต้องแก้ไฟล์ในโปรเจกต์ จากนั้นเว็บจะบอกว่า
- สูตรแก้ทาง 3MDC สูตรไหนที่คุณมีมอนสเตอร์ครบ (เทียบ
com2usId กับ allMdcData.json)
- มอนเมต้า Guardian 40 ตัวที่ถูกเลือกบ่อยสุด คุณมี/ขาดตัวไหน (จาก
swrtGuardianMeta.json)
- ทีม Abyss Hard ยอดนิยมที่คุณมีสมาชิกครบ
ถ้าต้องการให้โปรไฟล์ของคุณอยู่ในหน้า Player Tracker แบบถาวร (ไม่ใช่เฉพาะเครื่องตัวเอง) ให้เพิ่ม record ใน src/data/playerProfiles.json ตาม schema ของรายการที่มีอยู่ แล้ว commit — หรือถ้าเล่นถึง Guardian ระบบจะเก็บจากรีเพลย์สาธารณะของ SWRT ให้เองในรอบอัปเดตถัดไป
ซิงก์กล่องอัตโนมัติ (เรียลไทม์จากโฟลเดอร์ SWEX)
บน Chrome / Edge เดสก์ท็อป กด "เลือกโฟลเดอร์ SWEX" ครั้งเดียว (File System Access API, สิทธิ์อ่านอย่างเดียว) — เว็บจะตรวจไฟล์ *.json ที่ใหม่ที่สุดในโฟลเดอร์ทุก 20 วินาทีและตอนกลับมาที่แท็บ
ถ้าไฟล์ใหม่กว่าที่โหลดไว้จะนำเข้าให้เอง handle ของโฟลเดอร์เก็บใน IndexedDB (เปิดเบราว์เซอร์ใหม่ต้องกดยืนยันสิทธิ์อีกครั้ง 1 คลิก) เบราว์เซอร์อื่นใช้ปุ่ม "นำเข้าใหม่" ตามปกติ
🤖 AI ในระบบ (ใช้ endpoint แบบ OpenAI-compatible)
ตั้งค่า 3 ตัวแปร (server-side เท่านั้น ห้ามใส่ VITE_): AI_BASE_URL, AI_MODEL, AI_API_KEY
- ในเครื่อง: ใส่ใน
.env (gitignore แล้ว)
- Vercel: Project → Settings → Environment Variables (ให้
/api/ai/advise ใช้)
- GitHub: Repository secrets ชื่อเดียวกัน (ให้ cron รันงาน batch)
| ฟีเจอร์ | ที่อยู่ | ทำงานอย่างไร |
|---|
| โค้ช AI อธิบายวิธีแก้ทีม 3MDC / วิเคราะห์ดราฟต์ 5v5 | หน้า 3MDC และ Draft Explorer → ปุ่ม "ให้ AI วิเคราะห์" | เรียก POST /api/ai/advise (Vercel function ใน api/ai/advise.js) เซิร์ฟเวอร์ใส่สกิล/ลีด/สเตตัสจริงจาก monsterSkillsData.json ให้โมเดลแล้วบังคับให้ตอบจากข้อมูลนั้นเท่านั้น จำกัด 3 ครั้ง/นาที (12 เมื่อล็อกอิน) |
| สรุปแพตช์ภาษาไทย + ใครได้/เสีย + โน้ตรายตัว | หน้า Balance Patch | node scripts/ai_patch_summaries.mjs → balancePatchAi.json (cache ตาม hash ของแพตช์) |
| สรุปสไตล์ผู้เล่น Guardian จากรีเพลย์จริง | หน้า Player Tracker (โปรไฟล์จาก SWRT) | node scripts/ai_player_summaries.mjs --limit=150 → swrtPlayerSummaries.json (cache ตาม hash สถิติ) |
ตอน dev ใช้ npm run dev ได้เลย — vite.config.js มี middleware ให้ /api/ai/advise เรียก handler เดียวกับ Vercel
