Wao Echo

Công cụ tính toán sát thương, thẩm định Echo & mô phỏng chuỗi combo cho Wuthering Waves

Cài Đặt & Sử Dụng • Tính Năng • Cơ Chế Tính Toán • Cấu Trúc Dự Án • Đóng Góp

---

📖 Giới Thiệu

Wao Echo là một ứng dụng web mã nguồn mở giúp người chơi Wuthering Waves phân tích chỉ số, đánh giá phôi Echo và lên kế hoạch chuỗi combo (rotation) cho đội hình 3 nhân vật một cách trực quan và chính xác.

---

🎯 Giá Trị Mang Lại

• Tính toán chính xác theo cơ chế game: Áp dụng đúng công thức kháng 3 miền (piecewise resistance) và cơ chế tính giáp theo chênh lệch cấp độ nhân vật/quái vật.
• Mô phỏng chuỗi combo theo mốc thời gian (Timestamp): Theo dõi chính xác thời điểm kích hoạt và hết hạn của từng loại buff (Outro 14s, buff đội 30s) thay vì tính trung bình phẳng.
• Kiểm toán hiệu quả nạp (Energy Audit): Tính toán lượng năng lượng tích lũy qua từng đòn đánh để xác định combo có đủ nạp cho chiêu cuối hay không.
• Tối ưu hóa lựa chọn trang bị 4-3-3-1-1: Tự động tìm kiếm các bộ 5 viên Echo tối ưu nhất từ kho đồ hiện có dựa trên thuật toán Min-Heap.
• Giao diện Tiếng Việt thân thiện: Toàn bộ thuật ngữ, chỉ số và mô tả kỹ năng được bản địa hóa rõ ràng.

---

🚀 Tính Năng Chính

1. Quản Lý Kho Echo & Quét Ảnh OCR

• Tự động trích xuất Tên, Bộ Sonata, Dòng chính và 5 Dòng phụ từ ảnh chụp màn hình game bằng AI OCR (Tesseract.js).
• Quá trình nhận diện diễn ra 100% trên trình duyệt của người dùng, không cần tải ảnh lên máy chủ.
• Hỗ trợ lọc theo Cost, Bộ Sonata, trạng thái trang bị và tìm kiếm nhanh.

2. Thẩm Định & Chấm Điểm Echo 3 Tầng

• Tier 1 - Roll Quality (%): Đánh giá chất lượng các lần roll dòng phụ dựa trên thang giá trị Min-Max của game.
• Tier 2 - Character Value Score (PTS): Chấm điểm độ phù hợp với từng nhân vật cụ thể theo trọng số thuộc tính.
• Tier 3 - Marginal Delta DPS (+%): Đo lường mức tăng sát thương thực tế khi đưa viên Echo vào đội hình hoàn chỉnh.

3. Tối Ưu Hóa Tổ Hợp 4-3-3-1-1 (Build Optimizer)

• Tự động duyệt các tổ hợp 5 viên Echo thỏa mãn quy tắc 4-3-3-1-1.
• Lọc theo mốc Nạp tối thiểu (Target ER) và ưu tiên kích hoạt hiệu ứng bộ Sonata 5 món hoặc 2 món.
• Hiển thị Top 5 bộ trang bị có sát thương kỳ vọng cao nhất cùng nút áp dụng nhanh vào nhân vật.

4. Lập Kế Hoạch & Mô Phỏng Combo (Rotation Planner)

• Sắp xếp chuỗi hành động của 3 nhân vật trên Timeline trực quan.
• Tính toán tổng sát thương toàn đội (DPR), sát thương mỗi giây (DPS) và tỷ lệ đóng góp của từng thành viên.
• Tích hợp cơ sở dữ liệu Boss Tháp Nghịch Cảnh (Tower of Adversity) kèm thanh máu mô phỏng thực tế.

---

⚙️ Cơ Chế Tính Toán

1. Công Thức Sát Thương Tổng Hợp

$$\text{Final Damage} = \text{Base Scaling} \times (1 + \text{DMG%}) \times (1 + \text{Deepen%}) \times \text{Crit} \times \text{Def Multiplier} \times \text{Res Multiplier}$$

2. Hàm Kháng Nguyên Tố 3 Miền (Piecewise RES)

$$\text{Res Multiplier} = \begin{cases} 1 - \frac{\text{RES}}{2} & \text{khi } \text{RES} < 0 \\ 1 - \text{RES} & \text{khi } 0 \le \text{RES} < 0.8 \\ \frac{1}{1 + 5 \times \text{RES}} & \text{khi } \text{RES} \ge 0.8 \end{cases}$$

3. Hệ Số Phòng Thủ (DEF Multiplier)

$$\text{Def Multiplier} = \frac{800 + 8 \times L_{\text{char}}}{(800 + 8 \times L_{\text{char}}) + (792 + 8 \times L_{\text{enemy}}) \times (1 - \text{Def Ignore}) \times (1 - \text{Def Shred})}$$

---

💻 Cài Đặt & Khởi Chạy

Yêu Cầu Hệ Thống

• Node.js: Phiên bản 18.0.0 trở lên.
• Trình duyệt: Hỗ trợ ES2022 và WebAssembly (Chrome, Edge, Firefox, Safari).

Các Bước Thực Hiện

# 1. Clone mã nguồn
git clone https://github.com/WahuVN/wao-echo.git

# 2. Di chuyển vào thư mục
cd wao-echo

# 3. Cài đặt các gói phụ thuộc
npm install

# 4. Khởi chạy máy chủ phát triển
npm run dev

Truy cập ứng dụng tại: http://localhost:5173/

Chạy Bộ Kiểm Thử Toán Học

npm run test

---

📁 Cấu Trúc Dự Án

wao-echo/
├── public/assets/          # Tài nguyên hình ảnh (Nhân vật, Vũ khí, Echo, Sonata)
├── src/
│   ├── components/         # Giao diện người dùng
│   │   ├── BuildOptimizer/ # Bộ tối ưu hóa tổ hợp
│   │   ├── CharacterBuild/ # Bảng chỉ số & sát thương kỹ năng
│   │   ├── EchoHub/        # Quản lý kho đồ & modal OCR
│   │   ├── RotationPlanner/# Timeline combo & thanh máu Boss
│   │   └── Theorycraft/    # Bảng giải thích công thức toán
│   ├── core/
│   │   ├── data/           # Dữ liệu Resonator, Weapon, Echo, Boss
│   │   ├── engine/         # Các động cơ tính toán độc lập
│   │   │   ├── damage/     # Hệ số sát thương & hàm kháng 3 miền
│   │   │   ├── optimizer/  # Thuật toán Min-Heap Knapsack
│   │   │   ├── rotation/   # Bộ mô phỏng combat theo timestamp
│   │   │   └── scoring/    # Đánh giá Echo 3 tầng
│   │   └── ocr/            # Bộ xử lý ảnh OCR (Tesseract.js)
│   ├── game-data/          # Package dữ liệu game theo từng patch
│   └── utils/              # Từ điển dịch thuật & helper
├── test_advanced_engine.ts # Bộ kiểm thử hồi quy toán học
└── package.json

---

🗺️ Kế Hoạch Phát Triển (Roadmap)

• Phiên bản 1.0.0
  • Động cơ sát thương với 8 nhóm thừa số nhân và hàm kháng 3 miền.
  • Bộ mô phỏng combo theo dòng thời gian kèm kiểm toán năng lượng.
  • Tối ưu hóa tổ hợp 4-3-3-1-1 với thuật toán Min-Heap.
  • Nhận diện chỉ số Echo qua AI OCR trên trình duyệt.
  • Bản địa hóa Tiếng Việt toàn diện.
• Phiên bản tiếp theo
  • Cập nhật thêm nhân vật và vũ khí của các phiên bản game mới.
  • Hỗ trợ so sánh trực quan giữa 2 chuỗi rotation khác nhau.
  • Cải thiện độ chính xác của OCR đối với các định dạng ảnh có độ tương phản thấp.

---

🤝 Đóng Góp

Mọi đóng góp nhằm hoàn thiện công cụ đều được hoan nghênh. Bạn có thể mở một Issue để báo lỗi hoặc tạo Pull Request theo hướng dẫn tại CONTRIBUTING.md.

---

📜 Giấy Phép

Dự án được phân phối theo giấy phép MIT License.

Lưu ý: Wao Echo là dự án mã nguồn mở do cộng đồng phát triển, không liên kết chính thức với Kuro Games. Tất cả hình ảnh và tài sản trò chơi thuộc bản quyền của Kuro Games.