开源英雄联盟桌面助手：查战绩、看阵容、选人播报、出装与符文导入，以及常用客户端工具。
当前版本：v0.2.13 · QQ 群：947461001
下载 Windows 版 · 更新日志 · 功能使用指南
新版统一浅色 / 深色主题，采用分组侧栏、紧凑卡片和自适应布局。以下为当前 QML 渲染的界面示例，使用演示数据；点击图片可查看大图。
| 我的生涯 · 浅色 | 我的生涯 · 深色 |
|---|---|
 |
 |
| 战绩列表 | 英雄选择 |
 |
 |
| 对局详情 | 工具面板 |
 |
 |
- 在 Releases 下载
lol-copilot-windows-v0.2.13.zip。 - 完整解压，进入
lol-copilot文件夹，运行lol-copilot.exe。保留同目录的_internal文件夹及其他文件。 - 登录英雄联盟客户端，等待标题栏显示已连接，即可查询战绩、查看阵容或使用工具。
- 升级前从系统托盘退出旧版，再解压运行新版。原有设置会继续读取。
首次启动默认浅色主题，标题栏可切换深色。关闭窗口默认隐藏到托盘，可在设置中改为直接退出；彻底退出请选择托盘菜单中的“退出”。
| 页面 / 功能 | 可以做什么 |
|---|---|
| 我的生涯 | 查看个人资料、排位段位、近 20 场胜负、胜率与场均 KDA；快速跳转战绩、好友和自动动作 |
| 战绩列表 | 每页 20 场，按模式与胜负筛选，查看装备、评分及 MVP / ACE；继续加载更早战绩 |
| 对局详情 | 双方玩家、技能、符文、装备、团队统计；切换总览、伤害 / 承伤、符文与出装；打开玩家主页 |
| 召唤师搜索 | 按召唤师名或 名字#TAG 查询；顶部 Ctrl+K 快速搜索，历史记录支持筛选、点选、删除与清空 |
| 英雄选择 | 友方 / 敌方切换，五列近期战绩、段位、胜负与 KDA；阵容播报、大乱斗备战席换人与重摇 |
| 对局 | 查看游戏中的双方阵容、近期表现和开黑组标记；准备我方战绩快捷键播报 |
| 好友 / 最近队友 | 好友在线与游戏状态、开黑组；共同场次、共同胜负、胜率与常用英雄；为玩家添加本地备注 |
| 英雄池 | 按场次、胜率或 KDA 排序查看英雄表现 |
| OP.GG 出装 | 按模式 / 位置等条件查询推荐出装、召唤师技能、加点与符文；选择方案导入装备方案及符文页 |
| ARAM 增益 | 查看英雄伤害、承伤等平衡倍率，筛选加强 / 削弱英雄 |
| AI 复盘 | 在对局详情中生成全场点评或个人复盘，支持流式输出和重新生成；默认中转无需自备 API Key，额度按 IP 限制 |
| 录像回放 | 从对局详情请求下载并启动客户端回放，检查客户端状态、录像可用性与版本兼容性 |
| 自动动作 | 自动接受对局、按英雄优先级自动禁用 / 选择、选人时自动播报；托盘可统一暂停与恢复 |
| 快捷建房 | 创建单双排、灵活、匹配、极地大乱斗、海克斯大乱斗和斗魂房间；支持 5v5 训练 / 自定义及大乱斗自定义 |
| 个人资料工具 | 修改头像、个性签名、生涯背景，移除荣耀水晶框，切换在线 / 离开 / 移动端 / 请勿打扰 / 隐身状态 |
| 赫克斯科技工坊 | 查看精粹、钥匙、宝箱和碎片；一键整理、只开宝箱或只分解重复碎片 |
| 客户端与浮窗 | 重启客户端界面；可选置顶浮窗显示对局时间、龙 / 男爵与玩家复活倒计时 |
- 支持近 10 / 20 场，按场均 KDA 排序，展示实际统计场数、胜率与“特等马 / 上等马 / 中等马 / 下等马”评价。
- 选人阶段：在“英雄选择”页预览并发送到聊天，可包含敌方；开启自动播报后，阵容数据加载完成会自动发送一次我方信息。
- 自定义我的胜率：0–100%，默认关闭。入口在“英雄选择 → 战绩播报”或“工具 → 自动动作”，仅替换选人预览、手动及自动播报中自己的百分比。
- 游戏内：手动
Enter打开并清空聊天框 → 按下并松开Ctrl+Alt+Z填入 → 核对后手动Enter发送。仅统计我方，使用真实胜率；快捷键只在游戏窗口处于前台且对局进行中时生效，可在助手中关闭。
场均 KDA 为逐场 (击杀 + 助攻) / max(死亡, 1) 的平均值；≥5 为特等马，≥3 为上等马，≥2 为中等马，<2 为下等马，不足 5 场不评价。排位阵容仅统计单双排与灵活排位，其他 PvP 口径排除人机、教学和自定义；不足场数按实际数据展示。
- 更早战绩：已适配的国服大区优先使用腾讯 SGP 分页查询，失败时回退 LCU 并提供重试；是否能继续查询以服务端返回为准。查询方式与实测
- 数据可信度：服务端缺失的数据展示为未知；其他玩家负场不可靠时显示“负场未提供 / 胜率未知”，避免把缺失负场当作 100% 胜率。
- 特殊模式：支持海克斯强化图标与稀有度配色；斗魂竞技场详情暂不展示基于 5v5 的胜负与表现评分，小队和名次视图仍在适配。
- 建房与换人：“快速匹配”创建对应模式房间，之后在客户端开始匹配；斗魂自动选择当前开放的轮换队列。备战席换人、重摇次数及模式开放情况仍受客户端限制。
- 外部服务：OP.GG 推荐、游戏资源、SGP 和 AI 复盘需要对应服务可用；AI 内容仅供参考，回放需要录像仍可下载且与客户端版本兼容。
统一“墨影御风”亚索图标；支持浅色 / 深色主题、窄窗口折叠侧栏、窗口尺寸与位置记忆、应用内通知。图标优先通过 LCU 本地接口加载并缓存。单实例运行，重复启动唤回原窗口；Windows 任务栏再次点击前台窗口图标可最小化，之后点击恢复。
使用 Python 3.12（与远程打包环境一致）。Windows PowerShell：
python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
# 启动 GUI
python app.py
# CLI 调试（不需要 GUI）
python app.py --cli status
python app.py --cli me
python app.py --cli history --count 20
python app.py --cli watchUI 使用 PySide6 + FluentUI-QML，通过本机 LCU HTTPS / WebSocket 与客户端连接；游戏内数据通过 Live Client Data API 读取。推荐出装来自 OP.GG，游戏资源使用 LCU / Community Dragon，更早国服战绩使用腾讯 SGP。
Build Windows Release 使用 GitHub Actions、Python 3.12、requirements.lock.txt 和 PyInstaller 构建 Windows one-dir 便携包。
- 发布版本：更新
app/common/config.py中的APP_VERSION和对应docs/releases/v<版本>/文档，提交并推送代码，再推送同版本的v*tag，工作流会自动打包并创建 GitHub Release。 - 仅远程打包：在 Actions 页面选择
Build Windows Release → Run workflow和目标分支；完成后在该次运行的lol-copilot-windowsartifact 下载，不创建 Release。
例如发布当前版本：
git tag -a v0.2.13 -m "发布 v0.2.13"
git push origin v0.2.13Release 压缩包命名为 lol-copilot-windows-v<版本>.zip，手动构建为 lol-copilot-windows-v<版本>-manual-<运行编号>.zip。包内包含 lol-copilot.exe、_internal、更新日志.txt 和 功能使用指南.txt；完整解压后运行。
app/
common/ # 配置、日志、搜索历史与本地备注
lcu/ # LCU 连接、HTTP、WebSocket、API 封装
core/ # 战绩分析、阵容统计、播报与自动动作
services/ # OP.GG、SGP、游戏资源、游戏内数据与快捷键
cli/ # 命令行调试入口
view/ # QML UI、Python 桥接、托盘与窗口集成
docs/ # 界面截图、功能文档与版本说明
packaging/ # PyInstaller 打包配置
tests/ # 业务逻辑与离屏 QML 检查
- 基于客户端接口与普通窗口文字输入。战绩与选人等功能通过 LCU API 完成，游戏内数据通过本机 Live Client Data API 读取。游戏内播报由用户手动打开聊天框、触发快捷键填入并手动发送；不涉及内存读取、封包修改或代码注入。
- 源码公开可审。功能按需访问本机 LCU / Live Client、腾讯 SGP、Community Dragon、OP.GG 及 AI 复盘服务。SGP 登录凭据仅保留在内存并发送到内置腾讯 HTTPS 地址；使用 AI 复盘时会向 AI 服务发送对局分析数据。
- 仅供个人学习交流使用。严禁用于代打代练、付费售卖、捆绑推广、二次打包贩售、付费会员服务等商业或盈利用途。
- 使用风险自担。自动接受、自动禁用、自动选择等自动化功能可能违反游戏服务条款，存在账号处罚风险；请自行决定是否启用并承担后果。
- 非官方第三方工具。本项目与 Riot Games / League of Legends 无关联，未获其授权、认可或背书；游戏资源、图片与数据的权利归各自权利人所有。
- 不提供担保。作者不对使用本工具导致的账号处罚、数据丢失、客户端异常或其他直接 / 间接损失承担责任。使用即视为已阅读并同意上述声明。