企业官网建设流程全解析

Seraphine 从零跑通：英雄联盟战绩查询工具快速入门

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

Seraphine 是一款基于客户端 LCU API 的英雄联盟战绩查询桌面工具。打开客户端后，你可以查同大区玩家的近期战绩，并自动拉取队友与对手的战绩数据。本文面向想本地跑通这个项目的玩家，讲清安装、启动、验证成功的最短路径，指出入口文件与配置文件的所在位置，并给出后续扩展的方向。

Seraphine 适合解决什么问题

它解决一个很具体的场景：对局期间查看队友或对手的近期表现。没有服务端部署，没有 Web 界面，是纯 Windows 桌面程序，且不支持云顶之弈。

适合你的情况：查同大区玩家战绩；进入 BP 后自动查队友、进入游戏后自动查对手；OPGG 出装与排行榜、大乱斗 Buff、自动 B/P 等辅助需求。 如果你想要的是服务端 API、Web 面板或 Mac/Linux 支持，那它不适合你。

本地运行 Seraphine 的最短路径

前提：英雄联盟客户端已安装并登录。所有数据都从客户端接口取，不开客户端，功能基本全部失效。

1. 获取源码：git clone https://gitcode.com/gh_mirrors/se/Seraphine
2. 建环境（README 推荐 Python 3.8）：conda create -n seraphine python=3.8 && conda activate seraphine
3. 装依赖：pip install -r requirements.txt
4. 启动：python main.py

验证成功的标准：主窗口弹出，客户端开着时窗口能显示账号信息，生涯页能拉出自己的近期对局。界面一直转圈没数据，先回头检查客户端是否已启动。

Seraphine 入口文件怎么读

入口就三层，主线很清晰：

• main.py：唯一启动文件。处理 DPI 缩放和中英文翻译，再用 qasync 把 asyncio 挂到 Qt 事件循环上，最后显示MainWindow。
• app/view/main_window.py：主窗口宿主。装配开始、生涯、搜索、对局信息、设置各页面，同时监听客户端进程，客户端重启后负责重连。
• app/lol/connector.py：项目心脏。从客户端进程读取 LCU 端口和 token，连接127.0.0.1本地服务，所有数据请求——查召唤师、拉战绩、自动 B/P——都走这个类，并用@retry装饰器统一做重试。

想搞懂它"怎么从客户端读数据"，重点看这一个文件即可；自动 B/P 等业务逻辑则组装在app/lol/tools.py。

Seraphine 配置项从哪里改

没有环境变量，也没有密钥，端口不需要你配置——端口和 token 都在运行时从客户端进程取。

• requirements.txt：依赖清单，版本全部锁定。UI 靠 PyQt5 加 PyQt-Fluent-Widgets，异步靠 qasync，网络请求靠 aiohttp 与 requests。
• app/common/config.py：所有配置项的定义处。生涯显示场数、API 并发数、自动 B/P 开关、OPGG 大区等都在这里声明，默认值和校验规则也一目了然。
• 配置的实际存储：首次运行后在%AppData%\Seraphine下生成config.json并加载，想重置配置直接删掉它即可；程序版本号同样写在config.py里。

Seraphine 目录速查

常见卡点与下一步

常见卡点：

1. 窗口能开但数据为空或一直转圈：检查客户端是否开着、是否已登录。数据源是客户端 API，服务器侧拥堵时你这边也会延迟，与程序本身无关。
2. 依赖安装失败：项目推荐 Python 3.8，换更高版本时要留意 PyQt-Fluent-Widgets 是否兼容。
3. 改了配置不生效：部分配置项带restart=True标记，需要重启程序才生效，先看config.py确认。

扩展方向：想加新页面，在app/view/下新增一个界面类，再到main_window.py里注册；想加依赖客户端数据的新功能，先到connector.py里看现有接口覆盖到哪，缺什么就按@retry的写法补新方法。

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