企业官网建设流程全解析

Seraphine 快速上手指南：3 步跑通这款英雄联盟战绩查询工具

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

如果你想在打《英雄联盟》时一眼看到队友和对手的近期战绩、段位与常用英雄，Seraphine 值得试一试。这是一款基于英雄联盟客户端接口（LCU API）开发的战绩查询与对局辅助工具，支持按召唤师名字搜索战绩、进局后自动显示队友/对手信息，还附带 OPGG 出装参考、自动 B/P 等一系列实用功能。本教程面向刚接触该项目的读者，带你从环境准备、目录导览到启动运行完整走一遍，几分钟即可跑起来。

动手之前：环境准备与依赖安装

在开始配置之前，先确认三件事：

拿到源码有两种方式：直接下载仓库压缩包，或者用 git 克隆：

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

接下来用 conda 建一个干净、独立的虚拟环境（虚拟环境相当于一个互不干扰的"沙盒"，避免依赖冲突）：

conda create -n seraphine python=3.8 conda activate seraphine

激活环境后，安装项目依赖。项目的 requirements.txt 列出了全部 Python 包及锁定版本，一条命令即可装齐：

pip install -r requirements.txt

主要依赖一览，方便你了解各库的作用：

• PyQt5+PyQt-Fluent-Widgets：界面框架，负责窗口与按钮等控件的绘制
• qasync：让异步代码（asyncio）能嵌入 PyQt 事件循环
• aiohttp/Requests：发起网络请求，拉取战绩与 OPGG 数据
• psutil：检测英雄联盟客户端进程是否正在运行
• pyperclip：剪贴板操作，py7zr：压缩打包，async-lru：异步缓存

依赖装完，环境就准备好了。

目录结构导览：代码都放在哪

克隆完成后，你可以打开项目根目录，整体结构如下：

Seraphine/ ├── main.py # 启动入口 ├── app/ # 核心源码 │ ├── common/ # 公共基础：配置、图标、日志、样式等 │ ├── components/ # 可复用的界面控件 │ ├── lol/ # 英雄联盟数据层：客户端连接、数据解析 │ └── view/ # 各功能窗口页面 ├── document/ # 项目文档与版本信息 ├── requirements.txt # Python 依赖清单 ├── make.ps1 # 打包可执行文件的脚本 └── Seraphine.pro # 项目工程文件

各部分职责用大白话解释一下：

• app/common/：地基层。config.py 定义所有可配置项，logger.py 负责日志，icons.py 管理图标资源。
• app/lol/：数据层，也是本项目最有特色的一层。connector.py 负责和英雄联盟客户端"对话"，listener.py 监听对局阶段变化（进入选人、开始游戏等），opgg.py 拉取 OPGG 英雄排行与出装数据。
• app/components/：界面零件库，如搜索框、英雄图标、召唤师技能选择器等可复用控件。
• app/view/：页面层。main_window.py 是主窗口骨架，其余每个*_interface.py对应一个功能页：战绩搜索、生涯数据、局内信息、设置等。
• document/：存放公告与版本信息，如 document/notice.md。

入口解读：main.py 启动了什么

项目的启动文件是 main.py，它并不复杂，主要完成四件事：

1. 初始化界面环境：根据你在配置里选择的 DPI 缩放策略（自动或固定倍数）设置高分屏支持，并应用全局字体；
2. 准备异步事件循环：用qasync把 asyncio 循环挂到 Qt 上，这样查询战绩等耗时网络请求才不会卡死窗口；
3. 加载语言包：从app/resource/i18n目录读取翻译文件，界面支持简体中文、英文等；
4. 创建并显示主窗口：实例化MainWindow并进入事件循环，直到你关闭窗口程序才退出。

因此你在终端里只需一条命令即可启动：

python main.py

窗口打开后，先在设置里配置好英雄联盟客户端的安装路径，再启动客户端并登录账号，战绩查询功能就能正常使用了。

配置文件在哪、怎么改

很多新手会问："配置文件在哪里？要不要手改？"

Seraphine 把配置集中在两个地方：

• 配置项定义：app/common/config.py。文件里用ConfigItem一行一个地声明可选项，比如语言language、缩放dpiScale、生涯展示场次careerGamesNumber、自动 B/P 开关等，并给出了默认值；
• 配置数据文件：%AppData%\Seraphine\config.json（Windows 下通常位于C:\Users\你的用户名\AppData\Roaming\Seraphine\）。程序首次运行时自动生成，之后保存的就是你实际改过的值。

修改方式有两条路：

1. 推荐走界面：打开主窗口右侧的"设置"页，语言、缩放、自动重连、OPGG 地区等都可以通过开关和下拉框直接改，改完自动写入config.json，无需手动碰文件；
2. 手动编辑：直接打开上面的config.json，按 JSON 格式修改对应字段后重启程序。注意部分选项（如语言、缩放）标注了restart=True，即修改后需要重启程序才生效。

上手小结与下一步

最后用几句话回顾一下今天的路线：

• 环境：Python 3.8 + conda 虚拟环境，pip install -r requirements.txt装依赖；
• 结构：app/lol管数据、app/view管页面、app/common管基础；
• 启动：python main.py，配置好客户端路径后登录游戏即可查询战绩；
• 配置：日常用设置界面改即可，底层数据落在%AppData%\Seraphine\config.json。

接下来你可以动手试试：查询一位召唤师的近期战绩，进一局大乱斗看看自动弹出的 Buff 信息，或者到 document/ 目录查看项目公告。若过程中遇到疑问，项目 README 的 FAQ 部分也整理了常见问题，值得参考。

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