v2.5.0 - 海克斯分析优化：砍掉OCR直连AI视觉

🚀 v2.5.0 更新内容

⚡ 海克斯分析大幅优化

• 砍掉 OCR 中间层：不再走本地 OCR 识别符文名，直接用 Gemini 截图视觉分析，消除幻觉源头
• 放宽截图裁剪范围：确保海克斯符文名称不被裁掉，AI 能看到完整的选项标题
• 截图后立即恢复主窗口：不用等 AI 分析完才能看攻略，分析卡住时也能自己挑选

🔄 数据缓存自动刷新

• 启动时自动检测 ApexLol 缓存过期状态
• 已过期或 24 小时内即将过期时，自动后台静默刷新
• 首次使用自动爬取，无需手动点击更新

🧠 AI 提示词优化

• 无 ApexLol 数据时，AI 仍会基于内部知识推荐海克斯方案
• 修复了数据缺失时海克斯推荐被跳过的问题

v2.4.0: 彻底根治海克斯OCR幻觉与超时机制

• 修复海克斯超时卡死：限制 API 重试次数和短时限硬超时机制，保证极速反馈，不再停摆读秒。
• 杜绝文字兜底时的AI幻觉：拆分图像/文字专用 Prompt，遇到仅识别到1-2个符文时，强制指令 AI 只在可见选项里选，不再自行脑补虚构选项（如冒出选项4等）。
• 修复OCR固定词汇高频误触发：大幅收紧 4-5 字词组的模糊匹配阈值（完全杜绝了游戏中泛滥的'攻击速度'这一词汇被强行匹配成'速度恶魔'的Bug）。
• 优化裁剪区域：放大垂直扫描高度，同时避开小字描述区，完美应对大乱斗不同分辨率以及鼠标点击选项时的动画放大效果带来的排版错位。

v2.3.0: 纯净海克斯分析，零幻觉提升

1. 精准裁剪海克斯识别区域，杜绝外围UI对选项乱码干扰。\n2. 增强OCR纠错算法，识别复杂背景下的文字并严格排除无用UI词汇。\n3. 爬取并注入每个符文的【真实游戏效果说明】，彻底解决截图模式下AI对陌生符文的“懂装不懂”的幻觉。\n4. 加入LCU英雄二次校验机制，修复锁定英雄后更换导致的攻略僵死问题。

v2.2.0: Synergy Builds & Priority Grab

v2.2.0: Synergy Builds & Priority Grab

（工具基本上完全体了）应该是终版了把~

选人阶段可以在工具内输入英雄称号或名称、昵称，获得极速前瞻即海克斯装备联动的骚操作，3 套；
加载阶段获取双方阵容，给出加点出装和对战攻略；
海克斯选择阶段给出选择建议。

��� ApexLol Synergy Builds (v2.1.0)

• Item Extraction: The scraper now captures recommended items from gold-bordered icons on ApexLol.info.
• Actionable Advice: Detailed build paths (e.g., Heartsteel -> Riftmaker) are now displayed directly under each hextech synergy.
• Encoding Fix: Corrected mojibake for item names to ensure perfect Chinese display.

��� Enhanced Champion Grab (v2.2.0)

• Priority Logic: Grabbing follows your wishlist order strictly (Top = Highest Priority).
• Interactive Popup: Clicking 'Grab' opens a UI dialog to edit your wishlist on the fly.
• Persistent Settings: Your wishlist is saved locally and survives tool restarts.

���️ Internal Improvements

• Privacy First: Confirmed no API keys are hardcoded in the repository.
• Robust LCU Sync: Fixed edge cases where empty PUUIDs could cause champion identification failure.

v1.5.5: Precision Identification Update

Finetuned identification logic based on user feedback. The AI now specifically looks for the Poro icon in the middle-bottom of the card and the golden text directly beneath it to identify the player's champion.

v1.5.4: Smarter Hero Identification

Optimized Gemini prompts to use golden name text and Poro icons as spatial landmarks for better self-identification accuracy in standard loading screens.

v1.5.2: Restore Auto-Grab & Fix Layout

Restored 'Grab Champion' feature, improved Gemini layout prompts, and fixed SSL retry logic.

v1.5.1: AI Prompt Fix & Hextech Combos Optimization

Fix loading screen AI layout description & Optimize S-Tier Hextech combos

v1.5: SSL自动重试 + 三套符文方案 + ApexLol数据模块

新功能

SSL 自动重试

• 遇到代理 SSL EOF 错误时自动重试（最多2次，间隔2秒）
• 仅针对 SSL 连接中断错误，其他错误不受影响

三套海克斯符文推荐

• 🥇 最佳方案（最高胜率/最强联动）
• 🥈 次选方案（备选风格/不同思路）
• 🥉 第三方案（完全不同的打法方向）

ApexLol 数据模块

• 新增 apexlol_scraper.py: 从 apexlol.info 爬取英雄海克斯联动数据
• 新增 apexlol_data.py: 数据缓存与查询管理
• 点击 🔄 数据 按钮即可一键爬取172位英雄数据

其他改进

• 模型切换为 gemini-3.1-flash-lite-preview
• 修复 BOM 编码问题

v1.0 - 首发版本

ARAM Tool v1.0 - 海克斯大乱斗智能助手

功能

• 一键截图分析 点击浮动按钮，自动截图并发送给 Gemini AI
• 智能阵容识别 AI 从加载界面读取所有英雄名，自动识别你的英雄
• 完整攻略输出 海克斯符文、6件装备、技能加点、打法要点、团队策略
• 队友推荐 为每个队友提供符文和出装建议
• 悬浮窗显示 始终置顶的攻略窗口，支持拖拽和快捷键

使用方法

1. 获取 Gemini API Key（免费）
2. 设置环境变量：setx GEMINI_API_KEY 你的密钥
3. 安装依赖：pip install -r requirements.txt
4. 运行 launch.bat 或 python main.py
5. 进入大乱斗加载界面后，点击浮动按钮开始分析