LeagueAkari：英雄联盟工具集全功能指南

🚀 核心功能矩阵

⚡ 自动操作套件

自动选择 ☑️

• 支持常规模式/随机模式双场景英雄选择
• 自定义预选优先级列表与禁用策略
• 支持队友意图检测与冲突避免

自动流程 ☑️

• 对局自动接受（可配置延迟0-5秒）
• 结算页面自动返回房间
• 智能匹配重连（支持惩罚时间检测）

自动回复 ☑️

• 离线状态智能应答
• 自定义回复模板
• 支持多场景触发条件

📊 游戏分析工具

战绩查询 ☑️

• 同大区完整战绩展示
• 跨区玩家信息查询
• 近期KDA趋势分析

对局数据 ☑️

• 实时队友/对手战绩对比
• 开黑组队历史检测
• 胜率与常用英雄分析

重生计时 ⏹️

• 实时死亡倒计时
• 小地图重生提醒
• 自定义预警音效

⚙️ 辅助功能集

自定义宏 ☑️

• 多键位组合录制
• 游戏内快捷发送
• 延迟精准控制（65ms步进）

智能喊话 ☑️

• 预设文本快速发送
• 战绩数据自动整合
• 开黑组队标记提醒

🛠️ 环境搭建指南

🔧 开发环境配置

目标：在本地搭建可编译运行的开发环境
方法：

# 1. 克隆仓库（确保已安装Git）
git clone https://gitcode.com/gh_mirrors/le/LeagueAkari

# 2. 进入项目目录
cd LeagueAkari

# 3. 安装依赖（需Node.js 16+和Yarn）
yarn install # 自动处理Electron依赖与Node Addon编译

# 4. 启动开发模式
yarn dev # 启动带调试功能的开发服务器，监听端口4396

验证：应用窗口正常启动且控制台无致命错误

📦 生产构建流程

目标：生成Windows平台可执行程序
方法：

# 1. 类型检查（确保代码类型安全）
yarn typecheck # 同时验证主进程与渲染进程类型定义

# 2. 构建项目
yarn build # 编译TypeScript并打包资源

# 3. 生成安装包（仅支持Windows平台）
yarn build:win # 使用electron-builder构建64位Windows安装程序

验证：dist目录下生成可执行安装文件

[!NOTE] Node Addon编译会自动处理addons/目录下的输入模块和工具模块，修改这些目录后需重新执行yarn install触发增量编译

🔥 实战场景演示

🎮 排位赛全流程自动化

场景：单排上分高效流程
操作序列：

1. 匹配准备

   • 启用「自动接受」（设置1秒延迟）
   • 配置「自动选择」优先级列表（按当前版本强度排序）
   • 开启「战绩查询」自动展示功能

2. 英雄选择

   • 系统自动预选配置的前3位英雄
   • 检测队友意图并避免冲突选择
   • 禁用敌方高优先级英雄

3. 对局中

   • 使用「自定义宏」快速发送预设战术指令
   • 通过快捷键（PageUp/PageDown）发送队友战绩
   • 启用「重生计时」掌握团战时机

4. 结算阶段

   • 自动点赞预设类别（如"指挥"或"友好"）
   • 自动返回房间并开始新一轮匹配
   • 记录对局数据用于后续分析

👥 五排开黑协作方案

场景：固定队伍高效配合
特色功能：

• 开黑检测：自动识别组队历史超过5场的队友
• 战术板：预设多套战术喊话模板
• 英雄池共享：展示队友近20场常用英雄
• 实时数据：游戏内发送当前胜率对比

图1：五排开黑工具面板，显示队友战绩与英雄池分布

❓ 常见问题排查

🔄 自动选择失效

• 症状：英雄选择阶段无反应
• 排查步骤：
  1. 检查LCU连接状态（设置→系统→LCU连接）
  2. 验证英雄ID列表是否有效（设置→自动选择→英雄列表）
  3. 确认是否处于自定义游戏模式（部分功能禁用）

⏳ 匹配接受延迟

• 症状：自动接受反应慢于设置值
• 解决方案：

  // 调整主进程配置文件 src/main/modules/auto-gameflow/state.ts
  autoAcceptDelaySeconds: number = 1 // 减少为1秒（默认值）
  

📡 LCU连接失败

• 症状：应用启动后显示"未连接到客户端"
• 修复流程：
  1. 重启英雄联盟客户端
  2. 以管理员身份运行LeagueAkari
  3. 检查防火墙设置是否阻止连接

📌 技术选型对比

功能需求	LeagueAkari	Seraphine	lol-helper
LCU API支持	✅ 完整实现	✅ 基础支持	⚠️ 部分实现
跨平台兼容性	⚠️ Windows专用	✅ 全平台	⚠️ Windows专用
性能占用	低（~30MB内存）	中（~80MB内存）	中高（~120MB内存）
扩展性	高（模块化设计）	中（插件系统）	低（硬编码功能）
自动操作功能	全面（7+模块）	基础（3个模块）	单一（仅喊话）
社区活跃度	高（持续更新）	中（季度更新）	低（年更）

[!TIP] 开发自定义模块时，推荐参考src/main/modules/auto-select的实现模式，该模块展示了完整的：

• 状态管理（MobX）
• LCU事件订阅
• 渲染进程通信
• 用户配置持久化

🗳️ 功能投票

哪个功能是你最需要的？（模拟投票）

• ⭐ 增强型战绩分析（含对位压制率）
• ⭐ 智能符文推荐（基于近期胜率）
• ⭐ 游戏内事件提醒（大小龙刷新）
• ⭐ 自定义皮肤加载器

📚 术语解析

LCU：League Client Update的缩写，指英雄联盟客户端更新系统，提供了丰富的API接口用于获取游戏状态和执行操作。

Node Addon：使用C++编写的Node.js扩展模块，本项目中用于实现底层键盘输入模拟和窗口管理功能，位于addons/目录下。

MobX：一种响应式状态管理库，在项目中用于连接LCU状态与UI展示，实现数据的自动同步更新。

Electron：跨平台桌面应用开发框架，本项目使用Electron 31.0.2版本，结合Vue 3构建用户界面。