HexAss - 海克斯大乱斗智能助手

基于 OP.GG 数据 + AI 推理 + 游戏本地公开接口 的英雄联盟 ARAM 海克斯大乱斗助手。

功能

• 🎯 自动检测对局 — 通过 LCU API 自动获取双方阵容，开局即生成攻略
• 🛒 局内装备推荐 — 金币超过阈值时自动推荐当前应购买的装备
• ⚡ 海克斯识别推荐 — 快捷键截图 + OCR 识别海克斯名称，AI 给出三选一建议
• 📊 双数据源 — OP.GG 为主，ApexLol 为辅，本地 JSON 缓存
• 🤖 多 AI 服务商 — 支持 DeepSeek / OpenAI / 通义千问（OpenAI 兼容接口）
• 🖥️ 系统托盘常驻 — 关闭窗口最小化到托盘，不影响游戏

快速开始

# 安装依赖
pip install -r requirements.txt

# 启动
python app.py

首次启动后：

1. 在设置面板中选择 AI 服务商并填写 API Key
2. 点击「立即同步数据」爬取 OP.GG / ApexLol 数据
3. 启动英雄联盟，进入 ARAM 对局即可自动分析

快捷键

快捷键	功能
Ctrl+F12	截图识别海克斯（可在设置中自定义）

项目结构

app.py                     # 应用入口
config/settings.py         # 配置管理（持久化到 user_config.json）
ai/ai_client.py            # 统一 AI 调用层（OpenAI 兼容接口）
ui/main_window.py          # PySide6 设置面板
ui/tray_icon.py            # 系统托盘
ui/overlay.py              # 悬浮窗（攻略/海克斯/装备推荐）
core/game_monitor.py       # 游戏状态监控（QTimer 轮询）
core/lcu_service.py        # LCU API 客户端
core/live_data.py          # Live Client Data API（2999端口）
core/hotkey_manager.py     # 全局快捷键
core/prompt_builder.py     # Prompt 构建器（三类场景）
data/champion_aliases.py   # 英雄别名映射
data/data_manager.py       # 数据缓存管理
data/opgg_scraper.py       # OP.GG 数据抓取（并发）
data/apex_scraper.py       # ApexLol 数据抓取（并发）
capture/screenshot.py      # 截图模块
capture/ocr_reader.py      # OCR 识别

技术栈

• UI: PySide6
• AI: openai 库（兼容 DeepSeek / OpenAI / 通义千问）
• 数据: requests + BeautifulSoup + 并发爬取
• 游戏接口: LCU API + Live Client Data API（本地公开接口）
• OCR: rapidocr-onnxruntime

合规声明

• 不修改游戏客户端
• 不读取游戏内存
• 仅使用公开本地接口、截图和公开网页数据
• OP.GG / ApexLol 数据版权归原站所有

许可

MIT License