如何 5 分钟跑通 Seraphine：英雄联盟战绩查询工具新手完整上手指南

如何 5 分钟跑通 Seraphine：英雄联盟战绩查询工具新手完整上手指南

【免费下载链接】Seraphine英雄联盟战绩查询工具项目地址: https://gitcode.com/gh_mirrors/se/Seraphine

Seraphine 是一款面向 Windows 的开源英雄联盟战绩查询工具：客户端一启动，它就自动连接 LCU 接口，帮你在 BP 阶段查看队友对手的战绩、浏览生涯数据，还能自动选英雄。如果你是 LOL 玩家，想快速把一个开源工具跑起来，跟着本文 5 分钟就能跑通。

环境准备：先把 Windows 与 Python 3.8 备齐 🪟

先确认两个硬性前提：

• 系统是 Windows。程序靠tasklist命令和 Windows 注册表获取客户端端口与令牌，Linux、macOS 跑不起来。
• Python 3.8。requirements.txt里的依赖版本（PyQt5 5.15.9、qasync、aiohttp、psutil 等）都是按 3.8 锁定的，版本偏高容易在构建时报错。

先确认已装好 conda（没有就装 Miniconda），再打开终端验证：

conda --version

看到类似conda 23.10.0的版本号，说明环境就绪。

从零跑起来：4 步启动战绩查询程序 🚀

第 1 步：拿到源码

git clone https://gitcode.com/gh_mirrors/se/Seraphine cd Seraphine

成功后，当前目录会出现main.py、requirements.txt和app/文件夹。

第 2 步：创建独立环境并安装依赖

conda create -n seraphine python=3.8 -y conda activate seraphine pip install -r requirements.txt

第 3 步：启动程序

python main.py

成功后你会看到Seraphine 主窗口弹出，左侧有首页、战绩查询、生涯、设置等导航项。

第 4 步：启动客户端查战绩

先启动英雄联盟客户端并登录，再切回 Seraphine——它会自动检测客户端进程并连上 LCU 接口。在"战绩查询"页输入召唤师名字，就能看到近期战绩；如果程序没找到客户端，去"设置"页手动选择客户端安装目录。

核心文件速查

想读源码时，先看这 8 个文件就够：

踩坑排查：新手最容易卡住的 3 个问题 ❓

Q1：启动后战绩功能不可用，或提示连不上客户端？Seraphine 本身不产生数据，一切来自客户端的 LCU 接口。先启动并登录客户端，再用程序；仍连不上就去设置页手动指定客户端安装路径。

Q2：生涯页一直转圈，或战绩更新有延迟？多半是 Riot 服务器的问题，不是程序 bug——数据由客户端接口提供。过段时间再试即可，重装程序解决不了。

Q3：pip install 时报构建错误？绝大多数是 Python 版本不对。用conda create -n seraphine python=3.8新建环境，激活后再装依赖，别直接用系统默认 Python 安装。

最后提醒一句：程序只调用客户端官方接口，不改游戏文件与内存，属于常规客户端工具；如仍担心风险，使用前可翻一下readme.md里的免责声明部分。

【免费下载链接】Seraphine英雄联盟战绩查询工具项目地址: https://gitcode.com/gh_mirrors/se/Seraphine