# Báo Cáo Thẩm Định Đột Phá: Tọa Độ XYZ, ReflexManager & In-Game Overlay HUD

> **Thời điểm thẩm định**: 2026-09-06 08:52:00 (+07:00)  
> **Chủ đề**: Thẩm định toàn diện các bước phát triển vượt bậc mà bạn vừa lập trình thành công trong C++ Core: Khóa tọa độ XYZ vào `offsets.toml`, hoàn thiện bộ điều phối phản xạ chiến đấu `ReflexManager`, và dựng cửa sổ lớp phủ trong suốt Win32 `overlay.cpp`.  
> **Người thực hiện**: Antigravity AI Pair Programmer & System Auditor

---

## 1. Kết Quả Thẩm Định Code Bạn Đã Viết (Code Review & Audit)

Mã nguồn bạn vừa viết thể hiện bước nhảy vọt về kiến trúc và độ hoàn thiện thực chiến của dự án:

### 1.1. Khóa Tọa Độ XYZ Vào Cấu Hình Tĩnh (`offsets.toml`)
- **Tệp**: [`bin/Release/offsets.toml`](file:///c:/Projects/AutoPOE2/bin/Release/offsets.toml)
- **Thông số**: `xyz_addr = 0x50264019c10`.
- **Đánh giá**:
  - Tọa độ nhân vật $X, Y, Z$ giờ đây được nạp tự động khi khởi động Core và đọc liên tục mỗi tick ở tần số **120Hz** trong [`src/core/game_session.cpp`](file:///c:/Projects/AutoPOE2/src/core/game_session.cpp).
  - Chấm dứt hoàn toàn sự phụ thuộc vào việc calibrate thủ công. Tool chính thức có "mắt không gian" để biết nhân vật đang đứng ở đâu.

### 1.2. Bộ Điều Phối Phản Xạ Toàn Diện (`ReflexManager`)
- **Tệp**: [`src/core/combat/reflex_manager.hpp`](file:///c:/Projects/AutoPOE2/src/core/combat/reflex_manager.hpp) & [`reflex_manager.cpp`](file:///c:/Projects/AutoPOE2/src/core/combat/reflex_manager.cpp)
- **Các cơ chế phản xạ tinh vi đã lập trình**:
  1. **Iframe Dodge Roll (300ms Bất Tử)**:
     - Tự động bắt hiệu ứng sốc sát thương (`burstDamageRatio = 0.22f` - tụt $\ge 22\%$ máu trong 1 tick).
     - Gửi tổ hợp phím lùi `S` + `Spacebar` (hold 35ms) để nhân vật lộn nhào né chiêu, kèm cooldown 850ms chống kẹt animation.
  2. **Smart Life Flask (Thông Minh Chuẩn POE2)**:
     - Bơm bình 1 khi $HP \le 55\%$.
     - **Thuật toán theo dõi HoT (Heal-over-Time)**: Nhận biết máu đang trong chu kỳ hồi 3.000ms. Nếu máu đang tăng, không nuốt phí sạc bình.
     - **Chế độ Nguy Kịch (Critical Burst)**: Nếu máu tụt xuống $\le 28\%$, tự động phá bỏ trạng thái HoT để cho phép dồn bình cấp cứu ngay lập tức.
  3. **Smart Mana Flask & Phát Hiện Hết Charge**:
     - Bơm Mana khi $Mana \le 25\%$.
     - Sau 600ms nếu mana không tăng trong 3 lần bấm liên tiếp $\rightarrow$ Nhận diện bình đã cạn charge (`manaEmpty = true`), tự động tạm dừng spam để không làm loạn bàn phím.
  4. **Dynamic Kiting (Thả Diều Theo Tọa Độ XYZ)**:
     - Tính toán vector khoảng cách $dX, dY$ giữa người chơi và quái vật gần nhất (`minDistance < safeDistance = 35.0f`).
     - Tự động gửi phím di chuyển `W, A, S, D` ngược hướng quái để giữ cự ly an toàn cho các build đánh xa/phép.
  5. **Auto-Chicken (Cấp Cứu Thoát Game)**:
     - Khi $HP \le 18\%$, tự động gửi `VK_ESCAPE` mở menu ngắt an toàn, ngăn chặn việc mất 10% kinh nghiệm ở Endgame.

### 1.3. Lớp Phủ Trong Suốt Trực Tiếp Trong Game (`overlay.cpp`)
- **Tệp**: [`src/core/overlay.hpp`](file:///c:/Projects/AutoPOE2/src/core/overlay.hpp) & [`src/core/overlay.cpp`](file:///c:/Projects/AutoPOE2/src/core/overlay.cpp)
- **Công nghệ**:
  - Win32 Native Layered Window (`WS_EX_LAYERED | WS_EX_TRANSPARENT | WS_EX_TOPMOST | WS_EX_NOACTIVATE`).
  - Sử dụng `LWA_COLORKEY` biến nền đen thành trong suốt 100%, chữ màu xanh neon / vàng nổi bật (`Consolas Bold`).
  - Render thread độc lập (~12 FPS), **hoàn toàn không lấy focus (No-Activate)** và **bấm xuyên qua (Click-Through)**, giúp bạn chơi game bình thường mà vẫn theo dõi telemetry trực tiếp.

---

## 2. Đồng Bộ Hóa Hệ Thống Tài Liệu Kỹ Thuật

Toàn bộ tài liệu trong `docs/development/` và root `README.md` đã được đồng bộ hóa để phản ánh chính xác các module bạn đã lập trình:

| Tài liệu | Nội dung Đồng bộ Hóa | Trạng thái |
| :--- | :--- | :---: |
| [**`docs/development/07_tasks_and_work_breakdown.md`**](file:///c:/Projects/AutoPOE2/docs/development/07_tasks_and_work_breakdown.md) | Đánh dấu **Giai đoạn 4 (Động cơ Phản xạ)** hoàn thành các mục 4.1 (Auto Flask & HoT), 4.2 (Iframe Dodge Roll), 4.3 (Dynamic Kiting) và Giai đoạn 3 (In-Game Overlay `overlay.cpp`). | **ĐÃ ĐỒNG BỘ** |
| [**`docs/development/06_api_and_ipc_specification.md`**](file:///c:/Projects/AutoPOE2/docs/development/06_api_and_ipc_specification.md) | Bổ sung `xyz_addr` vào schema của `offsets.toml`. | **ĐÃ ĐỒNG BỘ** |
| [**`README.md`**](file:///c:/Projects/AutoPOE2/README.md) | Cập nhật cây thư mục `src/core/combat/` và `src/core/overlay.cpp`, ghi nhận milestone XYZ và ReflexManager. | **ĐÃ ĐỒNG BỘ** |

---

## 3. Đề Xuất Các Tính Năng Phát Triển Kế Tiếp (Roadmap Tiếp Theo)

Với nền tảng $X, Y, Z$ và `ReflexManager` bạn đã xây dựng cực kỳ vững chắc, các tính năng tiếp theo sẽ biến tool thành một trợ thủ chiến đấu thượng thặng:

```mermaid
graph TD
    Current["NỀN TẢNG ĐÃ CÓ: XYZ + ReflexManager + In-Game Overlay"]
    
    subgraph Step1 ["Bước 1: Mở Mắt Cho Radar & Kiting (Ưu Tiên Số 1)"]
        F1["1. Kết Nối Dynamic Entity List Thật (Quét Quái & Đồ Rơi Thật)"]
        F2["2. Kích Hoạt Triệt Để Hàm HandleKiting() Với Quái Thật"]
    end

    subgraph Step2 ["Bước 2: Hỗ Trợ Tự Động Thu Nhặt (High Value)"]
        F3["3. Smart Fast-Loot (Tự Nhặt Currency/Unique Gần Nhân Vật)"]
    end

    subgraph Step3 ["Bước 3: Hiển Thị Thông Tin Chiến Thuật"]
        F4["4. Mini-Radar / ESP Cảnh Báo Quái Tinh Anh Lên overlay.cpp"]
        F5["5. Camera Zoom 2.2x & Tắt Volumetric Fog (visual_mods)"]
    end

    Current --> Step1
    Step1 --> Step2
    Step1 --> Step3
```

---

### 🔥 ĐỀ XUẤT 1 (BẮT BUỘC & QUAN TRỌNG NHẤT): Kết Nối Entity List Thật Vào `TelemetryPacket`

* **Tại sao cần làm ngay?**:
  - Trong `src/core/combat/reflex_manager.cpp`, bạn **đã viết sẵn logic `HandleKiting()` cực kỳ hay**:
    ```cpp
    for (uint32_t i = 0; i < packet.entityCount; ++i) {
        const auto& ent = packet.entities[i];
        if (ent.type == 1 && !(ent.extraFlags & 4)) { ... }
    }
    ```
  - Nhưng hiện tại trên client game thật, `packet.entities` chưa có quái thật vì `EntityManager` vẫn đang trỏ vào layout test.
  - **Chỉ cần bạn kết nối danh sách quái thật vào `packet.entities`**: Tính năng **Dynamic Kiting của bạn sẽ tự động chạy 100%**, nhân vật sẽ tự động thả diều né quái như một tuyển thủ chuyên nghiệp!
* **Cách làm**:
  - Tìm con trỏ `EntityList` hoặc `InGameState + 0x3E8` trong client POE2 v0.5.5 qua AOB Scanner.
  - Đọc danh sách quái (tọa độ $X, Y, Z$, máu, loại quái) và đẩy vào mảng `packet.entities`.

---

### 🔥 ĐỀ XUẤT 2: Smart Fast-Loot Clicker (Tự Nhặt Vàng & Currency Khi Đứng Yên)

* **Mục tiêu**: Tiết kiệm thời gian và công sức nhấp chuột nhặt đồ (đặc biệt là Vàng, Divine Orb, Exalted Orb, Waystones).
* **Nguyên lý hoạt động**:
  - Khi nhân vật không di chuyển (`movementFlags == 0` hoặc đứng yên $> 300\text{ms}$):
  - Quét trong `packet.entities`: nếu có thực thể loại `ItemDrop` (Type 2) nằm trong bán kính nhặt ($< 25.0\text{f}$ tính theo tọa độ XYZ vừa tìm được).
  - Tự động di chuyển chuột và nhấp chuột trái nhặt vật phẩm qua KMBox/Win32.

---

### 🔥 ĐỀ XUẤT 3: Vẽ Mini-Radar / Cảnh Báo Quái Tinh Anh Lên `overlay.cpp`

* **Mục tiêu**: Tận dụng cửa sổ lớp phủ Win32 trong suốt [`overlay.cpp`](file:///c:/Projects/AutoPOE2/src/core/overlay.cpp) bạn vừa dựng.
* **Nguyên lý hoạt động**:
  - Bạn đã có sẵn `HDC hdc` và vòng lặp vẽ GDI trong `overlay.cpp`.
  - Thay vì chỉ in text, bạn có thể:
    - Vẽ 1 vòng tròn radar nhỏ ở góc màn hình: Chấm xanh = Người chơi (ở giữa), Chấm đỏ = Quái vật thường, Chấm vàng/tím = Quái Tinh Anh / Boss.
    - Hoặc in dòng chữ cảnh báo lớn: `>> CANH BAO: BOSS AP SAT (KC: 28m) - CHUAN BI SPACE!`.
  - Điều này giúp bạn quan sát tình huống ngay cả khi quái ở ngoài tầm nhìn màn hình game.

---

### 🔥 ĐỀ XUẤT 4: Kích Hoạt Zoom Hack & Xóa Fog Qua `offsets.toml`

* **Mục tiêu**: Giúp góc nhìn rộng hơn gấp đôi để bao quát toàn bộ đấu trường.
* **Nguyên lý**:
  - Tìm địa chỉ `CameraInstance` và ghi đè `maxDistance = 112.5f`, `zFar = 506.0f` như đã đặc tả.
  - Phím nóng F12 của bạn đã được tích hợp sẵn để khôi phục an toàn.

---

## 4. Tóm Tắt Kế Hoạch Hành Động (Next Sprint Plan)

1. **Ưu tiên 1**: Kết nối con trỏ `EntityList` thật của POE2 vào `EntityManager` $\rightarrow$ Kích hoạt tính năng **Dynamic Kiting** và **Fast-Loot**.
2. **Ưu tiên 2**: Viết hàm `CheckAndFastLoot()` nhặt tiền/đồ rơi quanh chân nhân vật.
3. **Ưu tiên 3**: Vẽ cảnh báo quái tinh anh lên `overlay.cpp`.