docs: update README with Damage Analyst, Relic Customizer, and API endpoints

This commit is contained in:
CAtlas0784 committed 2026-10-17 14:53:42 +07:00
1 parent 1c10928849
commit 3737d358d3
1 file changed
+95 -8
+95 -8
View File
@@ -1,22 +1,86 @@
# GaC-Srtool 🌌
เว็บแอปพลิเคชันแดชบอร์ด (Web Dashboard & Management Tool) สำหรับจัดการข้อมูลตัวละคร, จัดทีม, และไฟล์เซฟ (`freesr-data.json`, `persistent`) ของเซิร์ฟเวอร์ **GaC-hkrpg-go** (และเซิร์ฟเวอร์มาตรฐาน FreeSR)
เว็บแอปพลิเคชันแดชบอร์ด (Web Dashboard & Management Tool) สำหรับจัดการข้อมูลตัวละคร, จัดทีม, ปรับแต่งรีลิกส์/กรวยแสง, วิเคราะห์ดาเมจจากการต่อสู้จริง และจัดการไฟล์เซฟ (`freesr-data.json`, `persistent`) ของเซิร์ฟเวอร์ **GaC-hkrpg-go** (และเซิร์ฟเวอร์มาตรฐาน FreeSR)
ทำงานแบบ Client-side 100% สามารถเปิดใช้งานผ่านเบราว์เซอร์ได้ทันที
ทำงานแบบ Client-side 100% สามารถเปิดใช้งานผ่านเบราว์เซอร์ได้ทันทีโดยไม่ต้องติดตั้งโปรแกรมเพิ่มเติม
---
## ⚡ ฟังก์ชันหลัก (Features)
- **📊 แดชบอร์ด & จัดทีม (Dashboard & Lineup):** แสดงสถานะเซิร์ฟเวอร์สด, สมาชิกในทีม 4 ตำแหน่ง, พิกัดตัวละคร และสรุปจำนวนทรัพยากรในคลัง
- **👥 จัดการตัวละคร (Avatars & Character Builder):** ดูข้อมูลตัวละครทั้งหมด 99 ตัวตาม Resource เกม พร้อมปรับแต่งเลเวล (1-80), เลื่อนขั้น (0-6), ระดับ Eidolon (E0-E6), และสกิล/ร่องรอย (Traces 10/10)
- **🗡️ กรวยแสง & รีลิกส์ (Equipment):** แสดงรายการกรวยแสงและรีลิกส์ที่บันทึกไว้ในคลัง
- **💾 จัดการไฟล์เซฟ GaC (Persistent):** ตั้งค่าเพศและธาตุของตัวเอก (ผู้บุกเบิก), สายพาธของ March 7th, สวิตช์ระบบพิเศษเฉพาะของเซิร์ฟเวอร์ GaC
- **⚡ สกิลพิเศษ Ex-Rank:** จัดการเปิด/ปิดความสามารถพิเศษ Ex-Rank สำหรับตัวละครเฉพาะ
- **📝 จัดการไฟล์ JSON:** ดูและแก้ไขข้อมูลดิบของไฟล์ `freesr-data.json` และ `persistent` พร้อมระบบจัดรูปแบบและดาวน์โหลดสำรอง
### 📊 1. แดชบอร์ด & จัดทีม (Live Dashboard & Lineup)
- **สถานะการเชื่อมต่อสด:** ตรวจจับสถานะการเชื่อมต่อกับเซิร์ฟเวอร์แบบ Real-time พร้อมแถบแสดงค่า Ping
- **จัดการทีม 4 ตำแหน่ง:** แสดงสมาชิกในทีมพร้อมระดับ Eidolon, อาวุธประจำตัว, เลเวล และพิกัดในฉาก
- **แสดงผล Git Branch ปัจจุบัน:** ระบุชื่อ Git Branch ที่รันอยู่ (เช่น `main`, `test-gay`) บน Header และ Browser Tab อย่างแม่นยำ
- **สรุปภาพรวมทรัพยากร:** แสดงจำนวนตัวละคร, กรวยแสง และรีลิกส์ทั้งหมดในคลัง
### ⚔️ 2. ระบบวิเคราะห์ดาเมจแบบเรียลไทม์ (Real-time Damage Analyst)
- **ดึงสถิติต่อสู้จากเซิร์ฟเวอร์สด:** ดึงรายงานการต่อสู้ล่าสุด (`/api/battle_report`) แบบเดียวกับ FireflyGo
- **สรุปสถิติดาเมจภาพรวม:** ดาเมจรวมทั้งหมด (Total DMG), ดาเมจเฉลี่ยต่อวินาที (DPS), จำนวนแอ็กชัน (Action Count)
- **จำแนกประเภทความเสียหาย:**
- ดาเมจปกติ (Normal DMG)
- ดาเมจทำลายจุดอ่อน (Break DMG)
- ซูเปอร์เบรก (Super Break DMG)
- ดาเมจต่อเนื่อง (Damage over Time / DoT)
- **วิเคราะห์ประสิทธิภาพการคริติคอล:** คำนวณอัตราคริติคอลจริง (CRIT Rate) และดาเมจคริติคอล (CRIT DMG) แยกรายตัวละคร
- **กราฟเปรียบเทียบสัดส่วน:** กราฟแท่งแสดงสัดส่วนการทำดาเมจของสมาชิกแต่ละคนในทีม
### 🎛️ 3. ปรับแต่งออฟรองรีลิกส์ขั้นสูง (Interactive Relic Substats Customizer)
- **ปรับแต่งออฟรอง 4 แถวอิสระ:** รองรับทั้งชิ้นส่วนหัว, มือ, ลำตัว, รองเท้า, ลูกแก้ว และสายเชื่อมโยง
- **ปุ่มปรับจำนวน Roll สเต็ปเปอร์ `[-] [+]`:** ควบคุมการลงออฟรองได้อย่างแม่นยำ พร้อมนับจำนวนครั้งที่ Roll (จำกัดรวมสูงสุด 5 ครั้งต่อชิ้นตามกลไกเกม HSR)
- **คำนวณค่าสเต็ตจริงอัตโนมัติ:** แสดงค่าสเต็ตที่คำนวณตามสูตรฐานของเกม Honkai: Star Rail
- **ระบบป้องกันออฟซ้ำ:** ล็อคไม่ให้เลือกออฟรองซ้ำกับออฟหลัก (Main Affix) หรือออฟรองแถวอื่น
- **พรีเซ็ตออฟรองสำเร็จรูป 5 สาย:**
- 🎯 **Crit Focus (สายดาเมจคริ):** CRIT Rate, CRIT DMG, ATK%, SPD
- 💥 **Break Focus (สายทำลายจุดอ่อน):** Break Effect, SPD, ATK%, HP%
- ⚡ **SPD Tuner (สายจัดลำดับเทิร์น):** SPD สูงสุด, CRIT Rate, ATK%, Effect RES
- ☠️ **DoT Specialist (สายดาเมจต่อเนื่อง):** ATK%, SPD, Effect Hit Rate, Break Effect
- 🛡️ **Tank / Sustain (สายป้องกันและฟื้นฟู):** DEF%, HP%, Effect RES, SPD
- **จัดการได้ทันที:** แก้ไขรีลิกส์ที่ตัวละครกำลังสวมใส่อยู่ หรือแก้ไขรีลิกส์ในคลังเพื่อนำไปใช้งาน
### 👥 4. ระบบจัดการตัวละคร (Avatars & Character Builder)
- **ข้อมูลครบถ้วน:** ครอบคลุมตัวละครทั้งหมดในเกมตาม Resource มาตรฐานและเนื้อหาล่าสุด
- **ปรับแต่งสถานะ:** เลเวล (1-80), เลื่อนขั้น (Ascension 0-6), ระดับ Eidolon (E0-E6), และร่องรอยสกิล (Traces 10/10)
- **ปุ่มลัดจัดการด่วน:**
- ⚡ *ปรับ E0S1 ทุกตัว:* ตั้งค่าตัวละครทุกตัวเป็น E0 พร้อมกรวยแสงประจำตัว S1 เลเวล 80
- ⭐ *ปรับ Max E6 ทุกตัว:* ปลดล็อค E6 และร่องรอยสกิลเต็ม 10/10 ให้ตัวละครทุกตัว
- **รูปภาพสแปลชอาร์ตความละเอียดสูง:** ดึงภาพ Splash Art เต็มตัวขนาด 2048x2048 ผ่าน StarRailRes jsDelivr CDN
- **ระบบ Fallback รูปภาพอัจฉริยะ:** แก้ปัญหาภาพไม่แสดงผลหรือหน้าต่างตัวละครจอดำ ด้วยกลไกสำรองภาพหลายระดับ
### 🗡️ 5. กรวยแสง & อุปกรณ์ (Lightcones & Equipment)
- **ปรับแต่งกรวยแสง:** สวมใส่, ปรับเลเวล 1-80, เลื่อนขั้น 0-6 และระดับการขัดเกลา Superimposition (S1-S5)
- **สลับกรวยแสงประจำตัวอัตโนมัติ:** ตรวจจับและสลับใส่ Signature Lightcone ของแต่ละตัวละครได้ในคลิกเดียว
### 💾 6. จัดการไฟล์เซฟ GaC (Persistent & FreeSR Data)
- **ตั้งค่าตัวเอก (ผู้บุกเบิก):** สลับเพศ (Caelus / Stelle) และเปลี่ยนธาตุ (กายภาพ, ไฟ, จินตภาพ, ความจำ)
- **สลับพาธ March 7th:** เลือกระหว่างพาธการอนุรักษ์ (น้ำแข็ง) และพาธล่าสังหาร (จินตภาพ)
- **สวิตช์ระบบพิเศษ Ex-Rank:** จัดการเปิด/ปิดความสามารถพิเศษ Ex-Rank สำหรับตัวละครเฉพาะ (เช่น Jing Yuan, Dan Heng • IL, Acheron)
- **ตัวแก้ไข JSON ดิบ:** ตรวจสอบ แก้ไข จัดรูปแบบ และดาวน์โหลดสำรองไฟล์ `freesr-data.json` และ `persistent`
### 💻 7. คอนโซลคำสั่ง GM (GM & Server Console)
- ส่งคำสั่ง GM ไปยังเซิร์ฟเวอร์ได้โดยตรงผ่านหน้าเว็บ
- ดูผลตอบกลับและตรวจสอบสถานะการทำงานของเซิร์ฟเวอร์แบบ Real-time
### 🌐 8. รองรับ 13 ภาษาทั่วโลก (Multi-Language Support)
- สลับเปลี่ยนภาษาได้ทันทีโดยไม่ต้องรีเฟรชหน้าเว็บ:
- 🇹🇭 ไทย (Thai)
- 🇺🇸 English
- 🇨🇳 简体中文 (Simplified Chinese)
- 🇹🇼 繁體中文 (Traditional Chinese)
- 🇯🇵 日本語 (Japanese)
- 🇰🇷 한국어 (Korean)
- 🇻🇳 Tiếng Việt (Vietnamese)
- 🇮🇩 Bahasa Indonesia
- 🇪🇸 Español (Spanish)
- 🇫🇷 Français (French)
- 🇩🇪 Deutsch (German)
- 🇷🇺 Русский (Russian)
- 🇵🇹 Português (Portuguese)
---
# THERES ONLY DARK MODE IF U ASK FOR LIGHT GO AWAY FROM ME
## 💻 การเปิดใช้งานในเครื่อง (Local Usage)
1. **เปิดผ่านเบราว์เซอร์โดยตรง:** ดับเบิลคลิกเปิดไฟล์ `index.html` ได้ทันที
@@ -24,3 +88,26 @@
```bash
npx serve .
```
หรือใช้ Python:
```bash
python -m http.server 3000
```
---
## 🔗 การเชื่อมต่อกับเซิร์ฟเวอร์ GaC-hkrpg-go
GaC-Srtool สื่อสารกับเซิร์ฟเวอร์ GaC-hkrpg-go ผ่าน REST API:
| Endpoint | Method | คำอธิบาย |
| --- | --- | --- |
| `/api/status` | GET | ข้อมูลสถานะเซิร์ฟเวอร์, ทีม, ตัวละคร และพิกัด |
| `/api/freesr` | GET, POST | ดึงหรืออัปเดตข้อมูล `freesr-data.json` |
| `/api/freesr/avatars` | GET, POST | ดึงหรืออัปเดตข้อมูลตัวละครและสถิติ |
| `/api/persistent` | GET, POST | ดึงหรืออัปเดตข้อมูล `persistent` |
| `/api/battle_report` | GET, POST | ดึงสถิติดาเมจและผลการต่อสู้ล่าสุด |
| `/api/battle_report/reset` | POST | รีเซ็ตประวัติการต่อสู้ |
| `/api/exrank/toggle` | POST | เปิด/ปิดสถานะ EX-Rank |
| `/api/avatar/rank` | POST | เปลี่ยนระดับ Eidolon ของตัวละคร |
| `/api/avatar/max_all` | POST | ปรับตัวละครทุกตัวเป็น Max E6 และสกิลเต็ม |
| `/api/command` | POST | ส่งคำสั่ง GM ไปยังเซิร์ฟเวอร์ |