"""AutoPOE2 - Auto-Gem Leveling Module (Doc 67 / Doc 69 / Doc 70). ================================================================== Tự động nhận diện và nhấp thăng cấp ngọc kỹ năng (Skill & Support Gems) khi đầy kinh nghiệm: - Nhận diện vị trí icon dấu cộng (+) ở rìa phải màn hình. - Khóa an toàn giao tranh (INV-GEM-LEVEL-SAFE-COMBAT): * Chỉ thăng cấp khi nhân vật ở ngoài giao tranh (in_combat == False). * Cự ly quái vật gần nhất phải an toàn (> 30.0u) hoặc đang ở trong Hideout/Town. * Tuyệt đối không gây phân tâm hoặc gián đoạn combat loop 120Hz của Hot Path. Tuân thủ nghiêm ngặt: - Rule 1: Cold Path Tier 2 (Python 3.11). - Rule 4: Module hóa độc lập, trần file < 500 dòng. - Rule 7: Tương tác chuột tuyệt đối MoveMouseSmooth + Click LMB (INV-INPUT-ABS-MOUSE). """ from __future__ import annotations import time from dataclasses import dataclass, field from enum import Enum from typing import Any, Callable, Dict, List, Optional, Tuple class GemLevelUpStatus(str, Enum): """Trạng thái quyết định thăng cấp ngọc.""" SUCCESS_LEVELED = "SUCCESS_LEVELED" DEFERRED_IN_COMBAT = "DEFERRED_IN_COMBAT" DEFERRED_PROXIMITY = "DEFERRED_PROXIMITY" NO_GEMS_READY = "NO_GEMS_READY" COOLDOWN_ACTIVE = "COOLDOWN_ACTIVE" UNSAFE_CLIENT_FOCUS = "UNSAFE_CLIENT_FOCUS" @dataclass class GemPlusIconLocation: """Tọa độ màn hình của icon thăng cấp ngọc (+).""" slot_index: int screen_x: float screen_y: float gem_name: str = "" is_visible: bool = True @dataclass class GemLevelerConfig: """Cấu hình an toàn và tham số hiển thị cho Auto-Gem Leveling.""" min_safe_monster_distance: float = 30.0 # Cự ly quái tối thiểu an toàn (u) cooldown_ms: int = 500 # Giãn cách giữa 2 lần nhấp nâng cấp (ms) max_gems_per_burst: int = 3 # Số lượng ngọc nâng cấp tối đa mỗi chu kỳ # Tọa độ tham chiếu icon dấu cộng trên 1440p (rìa phải) icon_base_x_1440p: float = 2500.0 icon_start_y_1440p: float = 350.0 icon_spacing_y_1440p: float = 52.0 # Tọa độ tham chiếu icon dấu cộng trên 1080p icon_base_x_1080p: float = 1875.0 icon_start_y_1080p: float = 262.0 icon_spacing_y_1080p: float = 39.0 class GemAutoLeveler: """Bộ điều phối tự động thăng cấp ngọc kỹ năng an toàn.""" def __init__( self, config: Optional[GemLevelerConfig] = None, click_callback: Optional[Callable[[float, float], None]] = None, screen_w: int = 2560, screen_h: int = 1440, ): self.config = config or GemLevelerConfig() self.click_callback = click_callback self.screen_w = screen_w self.screen_h = screen_h self.last_click_time_ms: int = 0 self.total_gems_leveled: int = 0 self.scale_x = screen_w / 2560.0 if screen_w > 0 else 1.0 self.scale_y = screen_h / 1440.0 if screen_h > 0 else 1.0 def get_icon_coordinates(self, slot_index: int) -> Tuple[float, float]: """Tính toán tọa độ chuột tuyệt đối của icon dấu cộng slot_index.""" if self.screen_h <= 1080: sx = self.screen_w / 1920.0 sy = self.screen_h / 1080.0 x = self.config.icon_base_x_1080p * sx y = (self.config.icon_start_y_1080p + (slot_index * self.config.icon_spacing_y_1080p)) * sy else: sx = self.screen_w / 2560.0 sy = self.screen_h / 1440.0 x = self.config.icon_base_x_1440p * sx y = (self.config.icon_start_y_1440p + (slot_index * self.config.icon_spacing_y_1440p)) * sy return round(x, 1), round(y, 1) def evaluate_safety( self, nearest_monster_distance: float, in_combat: bool, is_safe_area: bool, ) -> Tuple[bool, GemLevelUpStatus, str]: """ Kiểm tra bất biến INV-GEM-LEVEL-SAFE-COMBAT: - Nếu ở Hideout hoặc Town: luôn an toàn 100%. - Nếu trong Map chiến đấu: cấm thăng cấp nếu đang combat hoặc quái vật ở cự ly <= 30u. """ if is_safe_area: return True, GemLevelUpStatus.SUCCESS_LEVELED, "An toàn tuyệt đối trong Hideout/Town." if in_combat: return ( False, GemLevelUpStatus.DEFERRED_IN_COMBAT, "Hoãn thăng cấp: Nhân vật đang trong giao tranh (in_combat == True).", ) if nearest_monster_distance <= self.config.min_safe_monster_distance: return ( False, GemLevelUpStatus.DEFERRED_PROXIMITY, f"Hoãn thăng cấp: Quái vật quá gần ({nearest_monster_distance:.1f}u <= {self.config.min_safe_monster_distance}u).", ) return True, GemLevelUpStatus.SUCCESS_LEVELED, "Cự ly quái vật an toàn ngoài giao tranh." def detect_ready_gems( self, simulated_count: int = 0, ) -> List[GemPlusIconLocation]: """ Xác định danh sách các icon dấu cộng thăng cấp ngọc đang sẵn sàng. Hỗ trợ cả chế độ phân tích quang học và mô phỏng kiểm thử. """ ready_icons: List[GemPlusIconLocation] = [] count = min(simulated_count, self.config.max_gems_per_burst) for slot_idx in range(count): x, y = self.get_icon_coordinates(slot_idx) ready_icons.append(GemPlusIconLocation( slot_index=slot_idx, screen_x=x, screen_y=y, gem_name=f"Gem_Slot_{slot_idx + 1}", is_visible=True, )) return ready_icons def process_leveling_cycle( self, nearest_monster_distance: float = 999.0, in_combat: bool = False, is_safe_area: bool = True, simulated_ready_count: int = 0, now_ms: Optional[int] = None, ) -> Dict[str, Any]: """ Thực thi một chu kỳ thăng cấp ngọc kỹ năng an toàn. """ if now_ms is None: now_ms = int(time.time() * 1000) # 1. Kiểm tra Cooldown giãn cách if (now_ms - self.last_click_time_ms) < self.config.cooldown_ms: return { "status": GemLevelUpStatus.COOLDOWN_ACTIVE.value, "gems_leveled": 0, "reason": "Đang trong thời gian giãn cách thao tác.", } # 2. Đánh giá an toàn sinh tồn (INV-GEM-LEVEL-SAFE-COMBAT) is_safe, status, reason = self.evaluate_safety( nearest_monster_distance=nearest_monster_distance, in_combat=in_combat, is_safe_area=is_safe_area, ) if not is_safe: return { "status": status.value, "gems_leveled": 0, "reason": reason, } # 3. Quét tìm các ngọc sẵn sàng nâng cấp ready_gems = self.detect_ready_gems(simulated_count=simulated_ready_count) if not ready_gems: return { "status": GemLevelUpStatus.NO_GEMS_READY.value, "gems_leveled": 0, "reason": "Không có ngọc kỹ năng nào cần thăng cấp.", } # 4. Nhấp chuột tuyệt đối nâng cấp từng ngọc leveled_count = 0 clicked_coords = [] for gem in ready_gems: if self.click_callback: self.click_callback(gem.screen_x, gem.screen_y) clicked_coords.append((gem.screen_x, gem.screen_y)) leveled_count += 1 self.last_click_time_ms = now_ms self.total_gems_leveled += leveled_count return { "status": GemLevelUpStatus.SUCCESS_LEVELED.value, "gems_leveled": leveled_count, "clicked_positions": clicked_coords, "total_all_time": self.total_gems_leveled, "reason": f"Đã thăng cấp thành công {leveled_count} ngọc kỹ năng.", } def process_cycle( self, is_in_combat: bool = False, min_monster_distance: float = 999.0, is_hideout_or_town: bool = True, ready_slots: Optional[List[int]] = None, ) -> Dict[str, Any]: """Adapter tương thích ngược cho interface process_cycle.""" res = self.process_leveling_cycle( nearest_monster_distance=min_monster_distance, in_combat=is_in_combat, is_safe_area=is_hideout_or_town, simulated_ready_count=len(ready_slots) if ready_slots else 0, ) res["leveled_count"] = res.get("gems_leveled", 0) return res