# JX Automation Suite — Mục lục Điều hướng Agent (Modular SSoT 2026)

Hiến pháp, tư duy thống soái và bảng bất biến trung tâm: **[`AGENTS.md`](./AGENTS.md)**.

## 1. Bản Đồ Tài Liệu Chuyên Biệt (`docs/`)
- **Chống Ảo Giác & Hard Guardrail**: [`docs/anti_hallucination.md`](./docs/anti_hallucination.md) (`INV-ANTI-HALLUCINATION-GUARD`)
- **Tích Hợp AutoVLBS & Bảng Kỹ Năng**: [`docs/autovlbs_integration.md`](./docs/autovlbs_integration.md) (TCVN3, 10 phái, Cái Bang Kháng Long cấp 50, Nga My, Ngũ Độc)
- **Kịch Bản Tác Chiến 4 Acc & Tài Khoản**: [`docs/multi_account_tactics.md`](./docs/multi_account_tactics.md) (`accounts.json`, THP Dương Châu, Tuần tự 7x, Chủ PT Thiếu Lâm, Cự ly 100px, Đánh 1000px)
- **Khớp Text Hội Thoại NPC & Sổ Tay Test**: [`docs/npc_dialog_runbook.md`](./docs/npc_dialog_runbook.md) & [`LIVE_TESTING_RUNBOOK.md`](./LIVE_TESTING_RUNBOOK.md)

## 2. Bản Đồ Mã Nguồn Hệ Thống (`src/JXHelper/`)
- **Platform (Tầng Tác Động OS & Win32)**:
  * Actuator chạy ngầm 100%: [`BackgroundInput.cs`](./src/JXHelper/Platform/BackgroundInput.cs)
  * Quản lý cửa sổ & Handle: [`WindowManager.cs`](./src/JXHelper/Platform/WindowManager.cs)
  * Bộ khởi chạy Game & Auto: [`GameLauncher.cs`](./src/JXHelper/Platform/GameLauncher.cs)
  * Hằng số Win32: [`NativeMethods.cs`](./src/JXHelper/Platform/NativeMethods.cs)
  * Manifest & Nâng quyền UAC Administrator: [`app.manifest`](./src/JXHelper/app.manifest), [`Program.cs`](./src/JXHelper/Program.cs) (`INV-AUTO-UAC-ELEVATION`)
- **Core (Tầng Động Cơ Tác Chiến)**:
  * Bộ não FSM & Điều phối đa acc: [`BotBrain.cs`](./src/JXHelper/Core/BotBrain.cs), [`BotCoordinator.cs`](./src/JXHelper/Core/BotCoordinator.cs), [`BotSession.cs`](./src/JXHelper/Core/BotSession.cs)
  * Động cơ Chiến đấu, Tuần tra & Phục hồi: [`CombatEngine.cs`](./src/JXHelper/Core/CombatEngine.cs), [`PatrolEngine.cs`](./src/JXHelper/Core/PatrolEngine.cs), [`ControlEngine.cs`](./src/JXHelper/Core/ControlEngine.cs), [`RecoveryEngine.cs`](./src/JXHelper/Core/RecoveryEngine.cs) (`INV-NGUDOC-KIMYEN-CURSE`, `INV-NEWBIE-BLOOD-POUCH`, `INV-SMART-LEADER-FOLLOW`)
  * Động cơ Đăng nhập siêu tốc: [`AutoLoginEngine.cs`](./src/JXHelper/Core/AutoLoginEngine.cs) (`INV-TURBO-LEAN-LOGIN`)
  * Định danh nhân vật & RAM tĩnh: [`CharacterNameResolver.cs`](./src/JXHelper/Core/CharacterNameResolver.cs) (`INV-STATIC-RAM-LOCAL-PLAYER`, `INV-DUAL-FACTOR-INGAME`)
  * Đọc chỉ số nhân vật & tọa độ thời gian thực (HP, Stamina, Mana, X, Y): [`PlayerStatsReader.cs`](./src/JXHelper/Core/PlayerStatsReader.cs) (`INV-RAM-LIVE-PLAYER-STATS`, `INV-RAM-LIVE-PLAYER-COORDS`)
  * Động cơ Thần Hành Phù & Hậu Cần: [`ThanHanhPhuExecutor.cs`](./src/JXHelper/Core/ThanHanhPhuExecutor.cs), [`ActionExecutor.cs`](./src/JXHelper/Core/ActionExecutor.cs) (`INV-MULTI-TIER-THP`, `INV-SAFE-REPAIR-SEQUENCE`, `INV-NEWBIE-BLOOD-POUCH`)
  * Quét chiêu thức & TCVN3: [`SkillScanner.cs`](./src/JXHelper/Core/SkillScanner.cs), [`SkillDatabase.cs`](./src/JXHelper/Core/SkillDatabase.cs), [`Tcvn3Encoding.cs`](./src/JXHelper/Core/Tcvn3Encoding.cs)
  * Khớp Text NPC: [`NpcDialogTextMatcher.cs`](./src/JXHelper/Core/NpcDialogTextMatcher.cs)
  * Dữ liệu bản đồ & Điều hướng đồ thị: [`MapDatabase.cs`](./src/JXHelper/Core/MapDatabase.cs) (`INV-STATIC-RAM-MAP-ID`, `INV-MAP-GRAPH-TOPOLOGY`)
- **Config & Persistence (Tầng Lưu Trữ)**:
  * Cấu hình SSoT từng nhân vật: [`BotConfig.cs`](./src/JXHelper/Config/BotConfig.cs)
  * Quản lý tài khoản: [`AccountModel.cs`](./src/JXHelper/Config/AccountModel.cs), `config/accounts.json`
- **UI (Giao Diện Người Dùng)**:
  * Form chính phong cách VLAuto: [`MainForm.cs`](./src/JXHelper/UI/MainForm.cs) (Túi Máu Tân Thủ Tab Phục hồi & Bám Acc Chính Xuyên Map Tab Điều khiển)
  * Form Quản lý tài khoản: [`AccountManagerForm.cs`](./src/JXHelper/UI/AccountManagerForm.cs)
  * Form Hỗ trợ phái đặc thù: [`SupportSkillsForm.cs`](./src/JXHelper/UI/SupportSkillsForm.cs) (TabControl 3 phân hệ: Hỗ trợ & Buff, Ngũ Độc Kim Yến, Nga My)

## 3. Công Cụ & Kịch Bản Tác Chiến Thực Địa (`scripts/`)
- Kịch bản tự động kiểm thử 4 acc có Hard Guardrail: [`scripts/run_live_field_scenario.py`](./scripts/run_live_field_scenario.py)
- Kịch bản tự động kiểm thử tổng hợp: [`scripts/run_automated_field_test.py`](./scripts/run_automated_field_test.py)
- Điều phối biên dịch Shadow Binary: [`scripts/dev_supervisor.py`](./scripts/dev_supervisor.py)