简体中文 · English
面向 Windows 的英雄联盟极地大乱斗桌面助手：选人阶段给出英雄与席位建议，对局中识别三张海克斯卡片，并把胜率、出装与技能建议放到游戏旁边。
下载 Windows 安装包 · 使用指南 · LCU 排障
顶部浮窗保持左、中、右卡位顺序；右侧列表继续展示海克斯胜率、推荐度和关联出装。
| 阶段 | ARAMGG 读取 | 你会看到 |
|---|---|---|
ChampSelect |
只读 LCU 选人、英雄与 bench 状态 | 当前英雄数据和所有可用席位英雄建议 |
InProgress |
屏幕中的左 / 中 / 右海克斯标题区域 | 顶部三卡浮窗和右侧胜率、推荐列表 |
| 全程 | 当前语言的本地缓存或内置数据 | 英雄、海克斯、出装、召唤师技能与加点建议 |
Important
推荐链路只读取状态和统计数据。它不会自动选英雄、交换 bench、锁定英雄或接受交易；最终操作始终由玩家完成。
- 先识别游戏阶段。 应用通过 LCU gameflow 决定何时展示选人建议、何时运行游戏内 OCR，离开对局后会清理过期结果。
- 按真实卡位识别。 PaddleOCR 只读取左、中、右标题区域；某个位置读不到时保留空槽，不用宽区域结果打乱顺序。
- 本地优先展示。 完整的内置或缓存数据会先渲染，远端版本检查与下载在后台进行，且只在必需文件完整后切换。
- 界面与数据同语言。
zh-CN、en-US、zh-TW采用事务式切换，避免界面已经变更但数据仍停留在旧语言。
- 从 Releases 下载最新的
aramgg_client Setup <version>.exe。 - 安装并启动 ARAMGG 助手，再启动 League Client。应用会优先从运行中的客户端自动发现 LCU。
- 进入极地大乱斗：选人阶段查看英雄详情与席位建议；进入对局后等待海克斯界面出现。
- 自动识别失败时可按
F1手动截图分析。
「游戏目录」不是必填项。只有进程优先的 LCU 自动发现失败时，才需要把它作为读取 lockfile / 日志的高级兜底。
League Client ──只读 LCU──> 游戏阶段路由 ──ChampSelect──> 英雄详情 / 席位建议
└─InProgress──> 屏幕截图
│
本地优先的同语言数据 <────────────── PaddleOCR 标题识别 <────┘
│
└──────────────> 顶部三卡浮窗 / 右侧推荐列表
Renderer 不拥有 Node 能力，只能通过 sandbox preload 暴露的业务 API 与主进程通信。Electron 窗口保持 contextIsolation、sandbox 和 webSecurity 开启。
需要 Node 22.18.0 与 npm 10。
git clone https://github.com/valkia/aramgg_client.git
cd aramgg_client
npm install
npm run prepare:client-data
npm run dev提交前建议依次运行：
npm run test:unit
npm run test:augment-ocr
npm run lint
npm run type-check
npm run build项目基于 Electron、Vue 3、electron-vite、TypeScript 和 PaddleOCR。源码按进程边界组织在 src/main/、src/preload/、src/renderer/ 与 src/shared/；测试位于 tests/unit/ 和 tests/electron/。
客户端数据接口、API Key 申请和接入说明见 ARAMGG 数据 API 开发者页面。
维护者：发布与质量检查
GitHub Actions 会在 Windows Runner 上执行 lint、type-check、unit tests 和打包。正式发布使用 npm run release:patch|minor|major 创建版本提交与 annotated tag，再运行 npm run release:push。
源码开发和普通本地打包不会向生产服上传战绩；只有该 GitHub 官方发布 workflow 会注入官方通道标记和生产写接口 origin。
依赖或 lockfile 变更后，发布前使用 npm 10 验证：
npx -p npm@10 npm ci --ignore-scripts安装包发布后，还需要更新远端 /api/client/v1/config 中的 client.latestVersion、client.downloadUrl 和更新日志。自动更新链路未完整验证前保持 client.autoUpdateEnabled 关闭。
Star 趋势
支持项目
如果这个项目对你有帮助，欢迎支持后续开发与维护。