docs & feat: add license & attribution notice (Apache-2.0 / GPL-3.0) and core system enhancements

README.md

@@ -5,7 +5,7 @@
 **เซิร์ฟเวอร์จำลอง Honkai: Star Rail ประสิทธิภาพสูง พัฒนาด้วยภาษา Go**  
 พอร์ตจาก [`GaC-hkrpg-ps`](https://github.com/CAtlas0784/GaC-hkrpg-rust) พร้อมอ้างอิงโปรโตคอลจาก `PearlSR` และ `Currency-War-SR`
 
-[English](docs/README_EN.md) | [ภาษาไทย](README.md)
+[English](docs/README_EN.md) | [ภาษาไทย](README.md) | [简体中文](docs/README_ZH.md)
 
 </div>
 
@@ -20,10 +20,14 @@
 
 โปรเจกต์อยู่ระหว่างพัฒนา โดยกำลังตรวจการใช้งานกับ Client **4.6.53 OS** ตารางคำสั่งและ handler ที่แก้ล่าสุดอ้างอิง PearlSR commit `005d2c12db4781071f4b5b68e8f364587886a710` รายละเอียดอยู่ใน [บันทึกอัปเดต protocol](docs/protocol-update.md) การตรงกันของ schema ไม่ได้ยืนยันว่าเกมทุกระบบทำงานครบ
 
+Gateway รองรับการค้นหา metadata ตามเวอร์ชันก่อน build suffix และมีรายการ Android 4.6.53/54 ใน `hotfix.json` จากรายงานที่แนบมากับงานพอร์ต Android ค่า CDN และการเข้าเกมยังรอทดสอบกับ Client จริง
+
 [เอกสารประกอบ](docs/) • [วิธีเริ่มใช้งาน](#เริ่มใช้งานบน-windows) • [การตั้งค่า](#config-และกฎห้าม-hardcode) • [แหล่งที่มาและเครดิต](#-แหล่งที่มาและเครดิต-credits--acknowledgments)
 
 ## CW — กำลังพัฒนา
 
+แก้ 7 จุดจาก review งาน Gemini แล้ว รวม validation การย้ายตำแหน่ง, การนับพันธะ, archive ถาวร และ Warp visibility ส่วน Talent/รับรางวัลรายสัปดาห์ที่ยังไม่มีกฎครบจะตอบข้อผิดพลาดแทน success ว่าง รายละเอียดและข้อจำกัดอยู่ใน [บันทึกแก้บัค](docs/GEMINI-FIXES.md) ยังต้องตรวจพฤติกรรมใหม่ใน Client
+
 เริ่มพอร์ต CW จาก [Currency-War-SR ของ xaodev](https://gaytea.cod-algieba.ts.net/xaodev/Currency-War-SR) แล้ว: เพิ่ม factory ของ Encounter หลัง Supply, ตารางตัวเลือก/ความยากที่ revision ตรงกัน และ EXP ตามโหมด/บท/Boss โดยยังรักษาเส้นทาง Battle ที่จับไว้เดิม งานนี้ยังเป็นการพอร์ตบางส่วนและยังไม่ได้ยืนยันเส้นทางใหม่ใน Client อ่านสถานะ ผลทดสอบ และงานส่งต่อใน [CW xaodev handoff](docs/CW-XAODEV-CLAUDE-HANDOFF.md)
 
 คำสั่งเวลาใน GaCy-Srtool: `/faketime status` ดูเวลาเกม, `/faketime <Unix seconds>` หรือ `/faketime <วันที่ RFC3339 พร้อม timezone>` ตั้งเวลาจำลอง และ `/faketime off` คืนเวลาจริง เวลาจำลองเดินต่อและบันทึกใน `game_clock.state_file` จาก config (override ด้วย `GAC_GAME_CLOCK_STATE_FILE`) ใช้กับ Login/heartbeat; ไม่เปลี่ยนนาฬิกา Windows, network timeout หรือเวลา log หลังเปลี่ยนให้เปิดสมุดใหม่ หรือเข้าเกมใหม่หากหน้าจอเก็บตารางเวลาไว้
@@ -485,7 +489,7 @@ Client ยืนยันแล้วว่าเริ่มรอบ เปิ
 
 ไฟล์ `resources/ActivityPreviewPolicy.json` ใช้เลือกพรีแฟบหน้าต่างอีเวนต์จาก `PreviewGameplayCatalog.json` สำหรับพรีวิวอื่น ๆ ขณะนี้ถูกระงับไว้ก่อน เนื่องจากบันทึกจาก Client พบปัญหา asset รางวัลสูญหายและการค้นหาไอเทมผิดพลาดใน ActiveActivity จึงควรเปิดใช้งานแต่ละหน้าต่างใหม่เมื่อตรวจสอบ asset ที่ติดตั้ง, identity ของโมดูล และความเกี่ยวโยงของรางวัลเรียบร้อยแล้วเท่านั้น ส่วนการต่อสู้เฉพาะอีเวนต์และการกดรับรางวัลยังทำไม่เสร็จสมบูรณ์
 
-รายชื่อตู้กาชาพิเศษอ้างอิงจากแถวพรีแฟบแบนเนอร์ตัวละครที่ดึงมา ปัจจุบันมี 2 ตู้ แต่ Client ที่ติดตั้งไม่สามารถโหลดพรีแฟบของ Seele ได้ ทำให้การเปลี่ยนหน้า UI ค้าง การตรวจสอบ `AssetMgr.Exists` ขณะรันพบเฉพาะ asset ของตู้ถาวร (Standard) และตู้เริ่มต้น (Beginner) แต่ไม่พบ asset ตู้ลิมิเต็ดทั้ง 4 ตู้ที่ดึงมา ปัจจุบัน `GachaSandboxPolicy.json` จึงเปิดให้เรียกดูได้เฉพาะหน้าต่าง Standard ที่ยืนยันแล้วเท่านั้น โดยการสุ่มจะตอบกลับเป็น `RET_GACHA_NOT_SUPPORT` จนกว่าจะยืนยัน asset ตู้พิเศษที่ใช้งานได้จริง และหากรายการที่ยืนยันว่างเปล่าจะปฏิเสธการเข้าหน้านี้ด้วย แถวในตารางเพียงอย่างเดียวไม่ถือเป็นหลักฐานว่ามี asset ติดตั้งอยู่จริง ต้องตรวจสอบ bundle ใน Client ก่อนเพิ่ม path ลงในรายการ สำหรับการแจกตัวละครจะให้ตัวละครตามภาพพร้อมไอเทม Eidolon ซ้ำตามที่ตั้งค่าไว้ โดยคงสถานะ Rank/EX/Traces เดิม และยังไม่ได้ยืนยันผลใน Client หากตัวละครไม่มีใน roster ที่นำเข้าจะถูกปฏิเสธ นโยบาย Sandbox นี้ใช้การสุ่มฟรีและไม่ได้จำลองเรทหรือกฎการแปลงไอเทมอย่างเป็นทางการ
+หน้า Warp ส่งเฉพาะตู้ที่มีข้อมูลจาก Client และตรวจพบ prefab ใน `resources/GachaSandboxPolicy.json` เท่านั้น บันทึก Client พบว่า ID 2120 จากชุด handoff ไม่มีใน `GachaBasicInfo` ของ Client นี้ และ prefab ตู้จำกัดที่ตรวจสอบก็ไม่พบ การส่งตู้เหล่านั้นทำให้เปิดหน้าไม่ได้ จึงยังไม่สามารถปลดตู้ย้อนหลังจากชุด handoff ได้ การสุ่มถูกระงับไว้จนกว่าจะตรวจสอบ pool, การให้ไอเทม และ protocol กับ Client ได้ คำสั่ง `/unlockall warp` และ `/reload banner` ยังไม่ทำให้ตู้ที่ไม่ได้ตรวจสอบปรากฏใน Client
 
 ข้อมูลตารางที่ดึงมาระหว่างรันและข้อจำกัดการตรวจสอบในปัจจุบันถูกบันทึกไว้ใน [docs/offline-gameplay-continuation.md](docs/offline-gameplay-continuation.md) การคอมไพล์ handler เหล่านี้ผ่านไม่ได้ยืนยันว่าหน้าจอหรือระบบการเล่นใน Client จะทำงานได้สมบูรณ์
 
@@ -561,4 +565,24 @@ CW ล่าสุด: ผู้ใช้ยืนยัน Battle ห้อง
 - **AstralOS ([Ma3-OS/AstralOS](https://gaytea.cod-algieba.ts.net/AstralOS/AstralOS))**:
   - ชุดเครื่องมือวิเคราะห์โปรโตคอล, การถอดรหัส IL2CPP Metadata / Dumper, การ Hook เครือข่าย และเครื่องมือ Reverse Engineering ที่เคยนำมาใช้ในการวิเคราะห์และศึกษาโครงสร้างระบบ
 
-</details>
+</details>
+
+
+---
+
+## 📜 สัญญาอนุญาตและข้อกำหนดการใช้งาน (License & Attribution Notice)
+
+โครงการนี้เผยแพร่ภายใต้เงื่อนไขตามแนวทางสัญญาอนุญาต **Apache License 2.0** และ **GNU General Public License v3 (GPL-3.0)** โดยมีข้อกำหนดเรื่อง **การระบุต้นฉบับ (Attribution)** และ **การระบุส่วนที่แก้ไข (State Changes)** อย่างเคร่งครัด
+
+หากท่านนำซอร์สโค้ด, สคริปต์, เครื่องมือ, หรือส่วนประกอบใดๆ ของโปรเจกต์นี้ไปใช้งาน, พัฒนาต่อ (Fork), ดัดแปลง หรือแจกจ่ายต่อ **จะต้องปฏิบัติตามเงื่อนไขดังต่อไปนี้:**
+
+1. **ต้องระบุแหล่งที่มาและโครงการต้นฉบับอย่างชัดเจน (Attribution):**
+   - ต้องระบุชื่อโครงการต้นฉบับและทำลิงก์อ้างอิงกลับมายัง Repository ต้นฉบับอย่างเด่นชัด
+   - ต้องคงข้อความประกาศลิขสิทธิ์เดิม เครดิตผู้พัฒนา และเอกสารสัญญาอนุญาตดั้งเดิมไว้ในทุกไฟล์หรือทุกชุดแจกจ่าย
+
+2. **ต้องระบุส่วนที่มีการแก้ไขให้ชัดเจน (State Changes Notice):**
+   - หากมีการแก้ไข, เพิ่มเติม, ดัดแปลง หรือตัดทอนไฟล์หรือโค้ดส่วนใดส่วนหนึ่ง **จะต้องใส่ข้อความระบุไว้อย่างชัดเจน (Prominent Notices) ว่าไฟล์นั้นๆ ถูกแก้ไขส่วนใดบ้าง และแก้ไขเมื่อใด** ตามข้อกำหนด 4(b) ของ Apache-2.0 และ 5(a) ของ GPL-3.0
+   - ห้ามแอบอ้าง ลบเครดิต หรือนำโค้ดที่ดัดแปลงไปเผยแพร่โดยอ้างว่าเป็นผลงานต้นฉบับของตนเองทั้งหมด
+
+3. **ข้อจำกัดการใช้งานและการค้า (Non-Commercial / Educational Use):**
+   - โปรเจกต์นี้จัดทำขึ้นเพื่อการวิจัย, การศึกษาโครงสร้างโปรโตคอลเครือข่าย และการใช้งานส่วนบุคคลเท่านั้น **ห้ามนำไปจำหน่าย แสวงหาผลกำไร หรือใช้ในเชิงพาณิชย์โดยไม่ได้รับอนุญาต**