League Akari技术架构解析：基于LCU API的英雄联盟客户端自动化工具实现

League Akari技术架构解析：基于LCU API的英雄联盟客户端自动化工具实现

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

League Akari是一个基于官方LCU API构建的英雄联盟客户端自动化工具，采用模块化架构设计，提供游戏流程自动化、数据分析和界面增强功能。该项目基于Electron + Vue 3技术栈，实现了多进程架构和插件化系统，为英雄联盟玩家提供全面的游戏辅助解决方案。

技术架构概述

League Akari采用现代化的桌面应用架构，核心设计理念基于模块化插件系统。项目采用TypeScript作为主要开发语言，结合Electron框架实现跨平台桌面应用，Vue 3作为前端渲染框架，MobX和Pinia进行状态管理。

架构核心：Akari Shard系统

项目核心架构围绕Akari Shard系统构建，这是一个依赖注入和生命周期管理框架。每个功能模块被封装为独立的Shard，通过装饰器模式进行注册和管理：

@Shard(LeagueClientMain.id) export class LeagueClientMain implements IAkariShardInitDispose { static id = 'league-client-main' public readonly settings = new LeagueClientSettings() public readonly state = new LeagueClientState() async onInit() { // 模块初始化逻辑 this._connectToLeagueClient() } async onDispose() { // 资源清理逻辑 this._disconnect() } }

Shard系统支持优先级控制和依赖解析，确保模块按正确顺序初始化和销毁。配置文件electron.vite.config.ts定义了多窗口构建策略，支持主窗口、辅助窗口、OP.GG窗口等五个独立渲染进程。

多进程通信架构

应用采用主进程-渲染进程分离架构，通过IPC进行通信：

主进程 (Node.js) ├── 核心模块管理 ├── LCU API连接管理 ├── 系统级操作 └── IPC通信中心 渲染进程 (Vue 3) ├── 主界面窗口 ├── 辅助功能窗口 ├── OP.GG数据窗口 └── 游戏内计时器窗口

图：League Akari多窗口架构设计，支持独立的功能窗口分离

核心模块实现

LCU API集成层

League Akari的核心是与英雄联盟客户端通信的LCU API层。在src/main/shards/league-client/index.ts中实现了完整的HTTP和WebSocket通信机制：

export class LeagueClientMain implements IAkariShardInitDispose { private _http: AxiosInstance | null = null private _ws: WebSocket | null = null private _api: LeagueClientHttpApiAxiosHelper | null = null private async _connectToLeagueClient() { // 自动发现LeagueClient进程 const processes = await tools.findLeagueClientProcess() if (processes.length > 0) { const process = processes[0] // 建立HTTP连接 this._http = axios.create({ baseURL: `https://127.0.0.1:${process.port}`, auth: { username: 'riot', password: process.password }, httpsAgent: new https.Agent({ rejectUnauthorized: false }) }) // 建立WebSocket连接 this._ws = new WebSocket(`wss://riot:${process.password}@127.0.0.1:${process.port}`) } } }

该模块实现了自动重连机制、请求队列管理和错误恢复策略，确保与游戏客户端的稳定连接。

数据存储与状态管理

项目采用SQLite作为本地数据存储，结合TypeORM进行数据持久化。在src/main/shards/storage/目录下实现了多层数据存储架构：

• 实体层：定义数据模型和关系映射
• 仓库层：提供数据访问接口
• 迁移层：支持数据库版本升级

状态管理采用响应式编程模式，结合MobX的observable系统实现自动状态同步：

export class LeagueClientState { @observable accessor connected = false @observable accessor summonerInfo: SummonerInfo | null = null @observable accessor currentPhase: GamePhase = GamePhase.None }

自动化功能模块

自动对局接受

在src/main/shards/auto-gameflow/index.ts中实现了智能对局接受逻辑：

export class AutoGameflowMain implements IAkariShardInitDispose { private _handleMatchFound(phase: GamePhase) { if (phase === GamePhase.ReadyCheck && this.settings.autoAcceptEnabled) { // 计算延迟时间 const delay = this.settings.acceptDelaySeconds * 1000 setTimeout(() => { this._acceptMatch() }, delay) } } }

智能英雄选择

src/main/shards/auto-select/index.ts实现了基于优先级列表的英雄选择算法：

private async _autoSelectChampion() { const session = await this._getChampSelectSession() const availableChampions = this._getAvailableChampions(session) // 根据配置策略选择英雄 const strategy = this.settings.selectionStrategy const selected = this._applySelectionStrategy(strategy, availableChampions) if (selected) { await this._lockInChampion(selected.id) } }

数据可视化与UI组件

前端采用Vue 3 + Naive UI构建，支持响应式设计和主题切换。在src/renderer-shared/components/目录下实现了可复用的游戏数据展示组件：

• MatchHistoryCard.vue：对局历史卡片组件
• OngoingGamePanel.vue：实时游戏面板
• ChampionIcon.vue：英雄图标组件
• RankedTable.vue：排位数据表格

图：League Akari使用的游戏段位图标系统，支持多分辨率适配

集成部署指南

开发环境配置

项目使用electron-vite作为构建工具，支持热重载和TypeScript类型检查：

# 克隆项目 git clone https://gitcode.com/gh_mirrors/le/League-Toolkit # 安装依赖 yarn install # 开发模式运行 yarn dev # 构建生产版本 yarn build # Windows平台构建 yarn build:win

配置文件说明

主要配置文件包括：

• electron.vite.config.ts：构建配置
• tsconfig.json：TypeScript配置
• package.json：项目依赖和脚本

多窗口配置

应用支持五个独立窗口，每个窗口有独立的入口点和构建配置：

// electron.vite.config.ts 中的多窗口配置 build: { rollupOptions: { input: { mainWindow: resolve(__dirname, 'src/renderer/main-window.html'), auxWindow: resolve(__dirname, 'src/renderer/aux-window.html'), opggWindow: resolve(__dirname, 'src/renderer/opgg-window.html'), ongoingGameWindow: resolve(__dirname, 'src/renderer/ongoing-game-window.html'), cdTimerWindow: resolve(__dirname, 'src/renderer/cd-timer-window.html') } } }

性能优化策略

内存管理优化

1. WebSocket连接复用：所有LCU API请求共享同一WebSocket连接
2. 数据缓存机制：频繁访问的数据进行本地缓存
3. 请求队列管理：避免并发请求过多导致客户端崩溃

渲染性能优化

1. 虚拟滚动：对局历史列表采用虚拟滚动技术
2. 组件懒加载：非关键组件延迟加载
3. 状态订阅优化：MobX的精细粒度观察者模式

网络通信优化

// 请求重试和超时配置 const axiosRetry = require('axios-retry').default as AxiosRetry axiosRetry(this._http!, { retries: 3, retryDelay: (retryCount) => retryCount * 1000, retryCondition: (error) => { return isAxiosError(error) && (error.response?.status === 429 || error.code === 'ECONNABORTED') } })

扩展开发接口

自定义Shard开发

开发者可以通过实现IAkariShardInitDispose接口创建新功能模块：

@Shard('custom-module') export class CustomModule implements IAkariShardInitDispose { static id = 'custom-module' static priority = 100 static dependencies = ['league-client-main'] constructor( private lc: LeagueClientMain, private ipc: AkariIpcMain ) {} async onInit() { // 模块初始化 } async onDispose() { // 资源清理 } }

IPC通信接口

主进程和渲染进程通过类型安全的IPC接口通信：

// 在shared/types/ipc/index.ts中定义接口 export interface IpcChannels { 'league-client:connect': () => Promise<boolean> 'league-client:disconnect': () => Promise<void> 'auto-select:set-priority': (championIds: number[]) => Promise<void> }

插件系统架构

项目支持通过Addon系统进行功能扩展，在package.json中可以看到@leagueakari/league-akari-addons依赖，提供了核心工具函数和扩展点。

技术路线图

短期目标（v1.4）

1. 性能监控：添加应用性能指标收集和分析
2. 插件市场：建立第三方插件生态系统
3. 多语言支持：完善i18n国际化框架

中期规划（v2.0）

1. 微服务架构：将核心功能拆分为独立服务进程
2. 云端同步：用户配置和数据的跨设备同步
3. AI辅助：集成机器学习模型优化英雄选择策略

长期愿景

1. 开放平台：提供完整的SDK和API文档
2. 生态建设：建立开发者社区和插件市场
3. 跨游戏支持：扩展支持其他游戏的客户端自动化

技术挑战与解决方案

挑战1：LCU API稳定性

问题：英雄联盟客户端API接口可能随版本更新而变化

解决方案：

• 实现API版本检测和兼容性适配层
• 建立端点订阅系统，动态监听可用接口
• 提供降级策略，当主要API不可用时使用备用方案

挑战2：内存占用控制

问题：Electron应用通常内存占用较高

解决方案：

• 采用模块懒加载策略
• 实现内存泄漏检测机制
• 优化图像资源加载和缓存策略

挑战3：跨平台兼容性

问题：不同操作系统下的权限和API差异

解决方案：

• 使用条件编译处理平台特定代码
• 实现抽象层封装系统级操作
• 提供配置适配机制处理平台差异

League Akari通过模块化架构和精心设计的技术方案，为英雄联盟玩家提供了稳定可靠的自动化工具。项目代码结构清晰，扩展性强，为开发者提供了良好的二次开发基础。随着技术生态的不断完善，该项目有望成为游戏客户端自动化领域的标杆解决方案。

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