一篇读懂 Seraphine：英雄联盟战绩查询工具新手上手导览

一篇读懂 Seraphine英雄联盟战绩查询工具新手上手导览【免费下载链接】Seraphine英雄联盟战绩查询工具项目地址: https://gitcode.com/gh_mirrors/se/SeraphineSeraphine 是一款基于 LCU API 的英雄联盟战绩查询工具它通过读取英雄联盟客户端本地接口帮你查询同大区召唤师战绩并在进入 BP 或开局后自动拉取队友、对手的近期战绩。它还会附带自动 BP、大乱斗 Buff 显示、OPGG 出装一键设置等辅助功能。如果你既想在游戏里快速查看队友水平又不想自己研究 LCU 接口协议这个项目值得跑起来试试。跑起来之前环境准备与依赖安装清单先别急着翻代码把环境备齐更省事。Seraphine 是 Windows 桌面程序强依赖客户端运行状态以下每一项都建议逐一核对☐ Windows 系统已安装并登录英雄联盟客户端没有客户端LCU API 无法连接核心功能全部失效☐ Python 3.8README 建议用 conda 建独立环境conda create -n seraphine python3.8✅ 克隆代码git clone https://gitcode.com/gh_mirrors/se/Seraphine✅ 安装依赖pip install -r requirements.txtPyQt5、qasync、aiohttp、requests 等约 10 个包⚠️ 依赖清单见 requirements.txt版本均锁死不要随意升级5 分钟看懂目录分工代码地图Seraphine 没有 src/tests 那种经典分层而是全部收在 app/ 下按界面 → 组件 → 逻辑 → 支撑切分Seraphine/ ├── main.py # 程序入口Qt 事件循环与主窗口启动 ├── app/ │ ├── common/ # 支撑层配置、日志、信号总线、样式、更新检查 │ ├── components/ # UI 组件层按钮、弹窗、英雄图标等复用控件 │ ├── view/ # 界面层主窗口与查询、生涯、设置等各功能页 │ └── lol/ # 核心逻辑层LCU 连接、战绩解析、自动 BP ├── document/ # 版本公告等文档 ├── make.ps1 # 打包脚本产出 Seraphine.7z 发布包 └── requirements.txt # 依赖版本清单新手建议的阅读顺序是main.py → view → lol → common先看窗口怎么组装再看 LCU 请求怎么发最后才关心配置和日志这些支撑细节。程序从哪里开始main.py 的三步启动时序入口 main.py 很短核心执行流程分三段初始化切换工作目录按配置项DpiScale决定高清缩放策略设置全局字体加载app/resource/i18n下的语言包核心任务创建 QApplication用 qasync 的 QEventLoop 把 Qt 事件循环接入 asyncio后续 LCU 的异步请求全靠它然后实例化MainWindow并show()。主窗口内部会注册各功能页、启动客户端进程监听、必要时自动拉起客户端退出事件循环阻塞在appCloseEvent上窗口关闭时该事件触发循环退出并close()。关键片段app QApplication(sys.argv) eventLoop QEventLoop(app) asyncio.set_event_loop(eventLoop) w MainWindow() w.show() eventLoop.run_until_complete(appCloseEvent.wait()) eventLoop.close()配置改哪里最常改的 3 个配置项Seraphine 没有项目内配置文件所有运行时配置存放在%AppData%\Seraphine\config.json首次启动自动生成配置项本身在 app/common/config.py 中用 QConfig 声明也可以直接在设置界面里改。新手最常动的三项配置项作用示例值LolPath英雄联盟客户端安装目录LCU 连接与大乱斗 Buff 解析都依赖它C:\Riot Games\League of LegendsCareerGamesNumber生涯战绩页拉取的场次数范围 10~100越大加载越慢20LogLevel日志级别10DEBUG … 40WARNING排障时调低40⚠️ 标了restartTrue的项如LogLevel、DpiScale改完需要重启程序才生效。下一步跑通后的 3 件事运行python main.py在设置里填好客户端路径登录客户端后进入 BP验证队友战绩自动加载这条主链路精读 app/lol/ 下的connector.pyLCU 请求与 WebSocket 订阅和tools.py战绩数据解析这是理解项目数据流的关键遇到数据不更新或连接失败先看 README 的 FAQ——大多与客户端本身有关而非 Seraphine确认是程序 bug 再提 issue发布前先搜索是否已有人讨论过。【免费下载链接】Seraphine英雄联盟战绩查询工具项目地址: https://gitcode.com/gh_mirrors/se/Seraphine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考