League Akari 完整上手指南:用一套 LCU API 工具把英雄联盟客户端的重复操作全部交给自动化
2026/8/21 19:47:07 网站建设 项目流程

League Akari 完整上手指南:用一套 LCU API 工具把英雄联盟客户端的重复操作全部交给自动化

【免费下载链接】League-ToolkitAn all-in-one toolkit for LeagueClient. Gathering power 🚀.项目地址: https://gitcode.com/gh_mirrors/le/League-Toolkit

开场:一个排位夜的真实片段

周五晚上十点,小陈结束加班打开英雄联盟。客户端刚登录,他就开始了一连串的机械动作——点匹配、等队列、抢着点接受、在 30 秒选人倒计时里飞快翻战绩、手滑选错英雄、进游戏忘记发大乱斗阵容提示、结束后又纠结要不要给队友点赞。一晚上五局下来,他发现自己真正"打游戏"的时间没多少,其余全耗在了这些琐事上。

如果你也有同感,那么 League Akari 就是为你准备的:这是一款基于 Riot 官方 LCU(League Client Update)接口开发的英雄联盟客户端工具箱,能把上述大部分重复操作自动化,同时把战绩查询、选人辅助、游戏内快捷消息等能力集中到同一个界面里。下面这份 League Akari 使用教程,会从零开始带你把它装好、配好,并串起一整局游戏的真实流程。

项目速览:它是什么、能解决什么问题

League Akari 的定位很直接——一个"All-in-one"的英雄联盟客户端工具箱,项目自述为An all-in-one toolkit for LeagueClient. Gathering power 🚀。它不修改游戏文件、不注入内存,只与客户端通过官方 LCU API 通信,属于非侵入式设计;运行不需要管理员权限(以管理员身份运行可以解锁额外功能),并支持除腾讯服务器外的大部分 Riot 服务器。

它能替你处理的事情大致分四类:

  • 对局流程自动化:自动接受匹配、自动重开、自动重新匹配、自动处理邀请、自动点赞、自动发送大乱斗队伍侧提示。
  • 选人阶段辅助:按位置配置英雄优先级,自动禁用、自动选人,甚至自动锁定(策略可调)。
  • 情报与数据:在选人和加载界面快速查看队友、对手的历史战绩与常用英雄。
  • 游戏内快捷消息:内置打野路线、开黑队友信息、段位展示等预设文案,一键发送到游戏内聊天。

技术层面它基于 Electron + Vue 3 + TypeScript 构建,主进程按"shard"模块化组织,例如src/main/shards/auto-gameflow/负责对局流程、src/main/shards/auto-select/负责选人逻辑、src/main/shards/in-game-send/负责游戏内消息,感兴趣的话可以直接翻源码对照着玩。

三步完成环境准备与安装

如果你想直接体验成品,用官方发布的安装包即可;想从源码跑起来,或者打算参与开发,跟着下面三步走。

第一步:克隆仓库并安装依赖

git clone https://gitcode.com/gh_mirrors/le/League-Toolkit cd League-Toolkit yarn install

项目使用 Yarn 管理依赖(仓库根目录有yarn.lock),包管理器版本建议对齐package.json中声明的yarn@4

第二步:启动开发模式

yarn dev

这会以开发模式拉起 Electron 窗口,并开启调试端口,适合边改代码边看效果。只想预览打包产物,也可以改用yarn start

第三步:构建可分发版本

yarn build:win

在 Windows 上执行这条命令,会先做类型检查和构建,再通过 electron-builder 产出安装包;macOS 对应yarn build:mac。构建配置见仓库根目录的electron-builder.yml

首次启动:完成三处必要设置

程序第一次跑起来,你不需要填写任何账号密码——League Akari 是本地工具,通过检测本机正在运行的英雄联盟客户端来建立连接。启动后建议按下面顺序过一遍:

  1. 确认客户端已登录:先登录英雄联盟客户端,再启动 League Akari,它会自动发现客户端并建立 LCU 连接。如果没连上,检查防火墙是否放行,或重启两边程序。
  2. 打开"自动化"设置页:在src/renderer/src-main-window/views/中可以看到界面按automation(自动化)、ongoing-game(对局中)、toolkit(工具箱)等分区组织,对应左侧导航。先把"自动接受对局""自动重开"这类开关打开,延迟建议设 3~5 秒,给自己留反应空间。
  3. 设定语言与偏好:多语言文案位于src/shared/i18n/(含 zh-CN 与 en),界面里可直接切换;主题、通知方式等按个人喜好调整即可。

小提示:想验证自动化是否生效,最稳妥的办法是先开一局自定义或人机,观察"自动接受"和"自动选人"是否按预期执行,再投入排位。

实战演练:从开黑到结算的一整天

这一节我们跟着一位叫阿岚的玩家,看他用 League Akari 打完一个完整游戏日,你会看到每个功能在真实流程中出现在哪个环节。

19:00 组队开黑——邀请与匹配交给程序

阿岚和两个朋友在客户端组好队,准备开始匹配。他在自动化设置里打开了"自动处理邀请"和"自动重新匹配",并设置了最短开赛人数为 3、等待邀请中的好友。这样即使有人去倒水、切出去回消息,队列也不会因为少点了一次而卡住。相关配置项可以在src/main/shards/auto-gameflow/state.tsAutoGameflowSettings中逐条查看,比如autoAcceptDelaySecondsautoMatchmakingMinimumMembers

19:30 匹配成功——自动接受与自动重开

匹配成功弹窗出现时,程序在设置的延迟后自动点击接受。如果这局有人没进来导致对局重开,它还能按策略自动再次进入队列,选项里有"固定等待时长"和"按预计时长"两种重开策略(对应AutoMatchmakingStrategy),阿岚选了"按预计时长",省心又不会频繁空转。

19:35 选人阶段——战绩情报与自动选人

进入选人,右侧面板实时列出所有玩家的近期战绩、常用英雄和段位信息,阿岚一眼看出对面中单最近在练新英雄,果断按计划禁用。他事先在"自动选择"里为每个位置配了英雄优先级列表,并把策略设为"先展示再锁定",延迟 3 秒——系统先亮出推荐英雄让他确认,3 秒后自动锁定,既快又不至于完全失去控制。相关策略枚举just-showshow-and-lock-inlock-in-immediately定义在src/main/shards/auto-select/setting-schemas.ts

20:00 进入游戏——对局中数据面板与快捷消息

加载进游戏后,对局中面板(src/main/shards/ongoing-game/)会同步展示双方阵容、召唤师技能、补刀与击杀变化。阿岚这局玩的是打野,他用了内置预设一键把"打野路线"发送到聊天框,告诉队友自己前期的刷野计划;预设代码在src/main/shards/in-game-send/presets/里,除了jungle.ts(打野路线),还有premade.ts(开黑队友)和rating.ts(段位展示),也可以自己改文案。

21:00 大乱斗——自动发队伍阵营提示

换到大乱斗,阿岚启用了"自动发送队伍侧提示"。开局时程序自动在聊天里发出一条信息,告知队友本局处于红色方还是蓝色方、出生在右上还是左下——这就是下图展示的功能界面,省去了每次开局手打字的麻烦。

21:40 赛后结算——自动点赞与快速再来一局

对局结束,程序按"优先给组队好友点赞"的策略自动送出荣誉点赞(对应AutoHonorStrategy中的prefer-lobby-member),随后自动返回房间并重新进入队列。阿岚只需要在点赞界面确认一眼,其余时间都在和队友复盘刚才那波团战。

三种配置风格:让工具更懂你的习惯

每个人的玩法不同,League Akari 的模块化设置也允许你按习惯取舍:

配置风格推荐人群建议开关组合预期效果
轻度体验型偶尔上线、求省心的休闲玩家只开自动接受 + 自动点赞,其余保持默认关闭少改动、低风险,先感受自动化带来的轻松
效率优先型连续开黑、多账号轮换的常驻玩家自动接受、自动重开、自动邀请处理、大乱斗阵营提示全开,选人延迟设 3~5 秒每局节省几十秒机械操作,连续游戏时节奏不断档
深度定制型想打磨选人策略与内容的进阶玩家按位置配英雄优先级与禁用列表、使用"直接锁定"策略、自定义游戏内消息预设选人更贴战术,消息文案完全符合自己习惯

对多数人来说,"效率优先型"是性价比最高的起点;等熟悉了每一项的作用,再逐步往深度定制方向调。

疑难速查:五个高频问题一览

现象最可能的原因最简处理步骤
提示无法连接客户端客户端未启动或未登录先登录客户端再启动工具;仍不行就重启两边程序
自动接受没生效功能未开启或延迟过长到自动化设置页确认开关,并把延迟调到 3~5 秒
自动选人没反应优先级列表为空或含无效英雄检查配置里是否填入了有效英雄 ID,并确认当前模式支持自动选人
战绩数据看着偏旧本地缓存或加载时序问题在对局面板点手动刷新,或重启工具清缓存
权限相关的功能用不了未以管理员身份运行右键以管理员身份运行,可解锁额外功能

生态与共建:从使用者到贡献者

League Akari 是开源项目,欢迎任何程度的参与:

  • 反馈问题:遇到 bug 或有功能建议,最直接的方式是去项目的 Issue 区描述现象与复现步骤;项目 README 里也维护了 QQ 群与 Telegram 群,群内会不定期分享带新功能的测试版本。
  • 提交代码:仓库按src/main/shards/组织各功能模块,新功能通常对应新增一个 shard 目录。想从简单开始,可以先看src/main/shards/下现有模块的测试文件(如*.test.ts),了解约定后再提 PR。
  • 值得期待的方向:从代码结构看,项目正持续增强对局中数据面板(ongoing-game下已有analysis-controllermatch-history-loader等模块)和自动化流程的精细度;如果你常玩 ARAM 或开黑,未来大概率能等到更多针对性的小功能。

回到那个排位夜

回到文章开头的小陈——如果他在周五晚上就已经装好 League Akari,那五局游戏的流程会是这样:匹配靠自动接受,选人靠优先级列表,进游戏靠预设消息,赛后靠自动点赞与重新匹配,他真正要做的只剩思考怎么打。现在轮到你了:克隆仓库、跑起yarn dev,或直接下载安装包体验,然后从打开"自动接受"这个最小的开关开始,把本该属于游戏的注意力拿回来。

【免费下载链接】League-ToolkitAn all-in-one toolkit for LeagueClient. Gathering power 🚀.项目地址: https://gitcode.com/gh_mirrors/le/League-Toolkit

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询