当前位置：首页 > news >正文

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

news 2026/5/11 15:04:40

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') } } }

性能优化策略

内存管理优化

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

渲染性能优化

虚拟滚动：对局历史列表采用虚拟滚动技术
组件懒加载：非关键组件延迟加载
状态订阅优化：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> }