# 02. Semantic Digest: Quá Trình Nghiên Cứu Visual Mods & Tách Rời Hoàn Toàn Khỏi Core (2026)

- **Mã lưu trữ**: `ARCHIVE-DIGEST-VISUAL-MODS-DECOUPLING`
- **Mốc thời gian nén**: `16/09/2026`
- **Các tài liệu gốc đã nén**: Doc 02, 28, 30, 31, 32, 33, 34, 35, 41, 42, 43, 52, 53, 54, 55.
- **Trạng thái**: `[HISTORICAL ARCHIVE — DECISION RECORD: DECOUPLED TO REPO Poe2VisualTool]`

---

## 1. Bối Cảnh Lịch Sử: Tham Vọng "Tất Cả Trong Một" (All-In-One Bot)
Từ ngày 07/09 đến 12/09/2026, dự án AutoPOE2 đã dành nhiều nỗ lực nghiên cứu can thiệp đồ họa DirectX (DXGI hook / VTable camera injection / Minimap shader exploration buffer / Cyan border removal) nhằm phục vụ các tính năng hỗ trợ tầm nhìn:
- Mở rộng góc nhìn camera (Camera Unclamp / Wheel Zoom override).
- Xóa sương mù bản đồ con (Minimap Fog Reveal).
- Hiển thị thông số vật phẩm tại chỗ (In-place Item Inspector hover overlay).

---

## 2. Các Cuộc Khủng Hoảng Kiến Trúc & Nguy Cơ Phát Hiện (Anti-Cheat / Stability RCA)

1. **Crash Render Loop DXGI & VTable Corrupted (Doc 30, Doc 33)**:
   - Việc hook vào `Present` của Direct3D11/12 hoặc can thiệp trực tiếp vào VTable Camera của POE2 gây hiện tượng crash ngẫu nhiên sau 15-45 phút khi game chuyển đổi giữa màn hình tải (Loading Screen) và render 3D.
   - Thách thức đa màn hình & DPI scaling: Tỷ lệ khung hình không đồng nhất (16:9, 16:10, 21:9) làm sai lệch ma trận chiếu camera isometric $3D 
ightarrow 2D$.

2. **Xung Đột Tính Năng Hai Tầng (Doc 53, Doc 54)**:
   - Các hook đồ họa đòi hỏi quyền can thiệp sâu vào process game, làm tăng diện tích tiếp xúc với hệ thống Anti-Cheat của Grinding Gear Games.
   - Khi luồng render đồ họa bị chậm (frame drop), nó làm giật/lag vòng lặp 120Hz Hot Path của C++ Core, đe dọa trực tiếp phản xạ sinh tồn Auto-Flask và Iframe Dodge.

---

## 3. Quyết Định Kiến Trúc Tối Thượng (ADR - Doc 55): Decouple Hoàn Toàn Sang Repo Riêng
Tại mốc ngày 13/09/2026 (Doc 55 - `complete_visual_tool_decoupling_and_pure_bot_architecture.md`):
- **Quyết định**: Cắt bỏ 100% các thành phần inject DXGI, VTable hooking, Shader patcher ra khỏi repository AutoPOE2.
- **Tách biệt sản phẩm**:
  - Toàn bộ tính năng Visual Mod được chuyển sang repository độc lập riêng biệt: `Poe2VisualTool` (`AutoPOE2_VisualTool.exe`).
  - Repository **AutoPOE2** quay trở về bản chất chuẩn mực: **Pure External Bot & Companion System** hoạt động hoàn toàn qua cơ chế Out-of-Process (User-Mode RPM + KMBox Net USB Hardware + Lock-Free IPC Shared Memory).
- **Kết quả**: AutoPOE2 đạt độ ổn định 100%, 0 crash do đồ họa, và độ an toàn tài khoản tối đa.