Seraphine Save

基于 LCU API 实现的英雄联盟战绩查询工具

快速上手 🤗

直接使用打包好的程序

点击这里进入发布页面，在下方找到资源中的 Seraphine.zip，点击下载并解压至文件夹中，双击运行其中的 Seraphine.exe 即可。

或通过本地构建

下载项目 zip 压缩包解压至文件夹或通过 git

cd Seraphine
git clone https://github.com/Zzaphkiel/Seraphine.git

创建并激活新的 Anaconda 环境

conda create -n seraphine python=3.8
conda activate seraphine

安装依赖

pip install -r requirements.txt

运行 main.py 开始使用

python main.py

功能一览 （持续更新中）🥰

• 战绩查询功能（不支持云顶之弈）

  • 同大区召唤师战绩查询 ✅
  • 进入 BP 后自动查队友战绩 ✅
  • 进入游戏后自动查对手战绩 ✅

• 其他辅助功能

  • 游戏功能

    • 找到对局后自动接受对局 ✅
    • 进入英雄选择后自动选择英雄 ✅
    • 进入禁用环节时自动禁用英雄 ✅
    • 创建 5v5 自定义训练模式房间 ✅
    • 观战同大区玩家正在进行的游戏 ✅
    • 锁定游戏内设置 ✅

  • 客户端功能

    • 退出后自动重新连接 ✅
    • 修复客户端结算时无限转圈和缩成一块 ✅

  • 个性化功能

    • 修改个人主页背景 ✅
    • 修改个人在线状态 ✅
    • 修改个人签名 ✅
    • 伪造个人状态卡片中的段位显示 ✅
    • 一键卸下勋章 ✅
    • 一键卸下头像框 ✅

常见问题 FAQ 🧐

Q：我会因为使用 Seraphine 而被封号吗 😨？

由于本程序的功能完全基于英雄联盟客户端 API 实现，不含任何对客户端以及游戏文件本体、代码以及内存的读取或破坏其完整性的行为（详情见下方套盾环节）。因此仅使用 Seraphine 时极大概率不会被封号，但并不保证一定不会封号。

Q：真的被封号了怎么办？

根据反馈，目前有被封 1 小时的情况发生，申诉或等待解封吧 😭

Q：为什么客户端无法连接 / 功能无法使用 / 生涯界面无限转圈 / 最新战绩更新有延迟？

Seraphine 提供的战绩查询相关功能的数据均是由英雄联盟客户端接口所提供的，程序只是负责将它们显示出来。所以如果遇到功能无法使用或数据更新由延迟的情况，原因基本出在英雄联盟服务器本身，与 Seraphine 大概率没啥关系~

Q：从本地直接运行代码报错怎么办？

换 Python 3.8 试试。

Q：为什么不提供具体某模式 / 某英雄总场次以及总胜率？

英雄联盟客户端没有提供相关数据接口，我们做不到哇~

Q：客户端为什么有时候会闪退？

我们怀疑是由于并发 LCU API 访问导致的，您可以自行在设置中设置这一数量。

帮助我们改进 Seraphine 😘

在您的使用过程中，如果遇到程序的任何 BUG 或不符合预期的行为，欢迎提出 issue。发布 issue 时请按照模板填写哦~

如果您有功能上的添加或修改建议，也非常欢迎提出 issue 进行讨论！PR 也大欢迎！

发布新 issue 前请先善用搜索功能，看看之前是否讨论过相关或类似的问题！ 因开学太忙，后续的功能更新、BUG 修复以及 issue 回复的速度将显著变慢，还请谅解。

您也可以自己打包可执行文件 📂

在 seraphine 虚拟环境下安装 Pyinstaller

pip install pyinstaller==5.13

执行项目中 make.ps1 脚本，通过 -dest 参数传入目标文件夹

.\make -dest .

或直接使用默认值，其为当前目录 .

.\make

命令结束后在目标文件夹获得 Seraphine.zip。

参考资料 👀

• GUI 基于 PyQt5 以及 zhiyiYo/PyQt-Fluent-Widgets 实现

• LCU API 使用方法以及汇总详见官方文档

  • https://riot-api-libraries.readthedocs.io/en/latest/lcu.html#lcu-explorer
  • https://hextechdocs.dev/tag/lcu/
  • https://developer.riotgames.com/docs/lol
  • https://www.mingweisamuel.com/lcu-schema/tool/#/

  以及其他使用 LCU API 的项目

  • https://github.com/KebsCS/KBotExt
  • https://github.com/XHXIAIEIN/LeagueCustomLobby
  • https://github.com/7rebux/league-tools

• 锁定游戏设置相关请见

  • https://www.bilibili.com/video/BV1s84y1x7ub

  修复客户端无限转圈 / 缩成一块 BUG 请见

  • https://www.bilibili.com/video/BV1Cw41147iS
  • https://github.com/LeagueTavern/fix-lcu-window

• 游戏资源获取请见

  • https://raw.communitydragon.org/latest/
  • https://github.com/CommunityDragon/Docs/blob/master/assets.md

• Fluent Icons 资源获取请见

  • https://fluenticons.co/outlined
  • https://github.com/microsoft/fluentui-system-icons/blob/main/icons_regular.md

点个 Star 支持我们 ⭐

感谢所有贡献者 🥳！

Riot 声明 📢

Seraphine is not endorsed by Riot Games and does not reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games and all associated properties are trademarks or registered trademarks of Riot Games, Inc

参考译文：Seraphine 未经 Riot Games 认可，也不代表 Riot Games 或任何官方参与制作或管理 Riot Games 产品的人的观点或意见。Riot Games 及其所有相关产物均为 Riot Games，Inc 的商标或注册商标。

套盾环节 🛡️

本程序为在 GitHub 仓库 Zzaphkiel/Seraphine 开源的代码，以及在 Release 中上传的二进制文件。本环节旨在让用户更加全面详尽地了解本程序以及可能风险，以便用户在使用本程序前及过程中做出充分的风险评估和明智的决策。

1. 本程序的目的是通过为游戏玩家提供游戏外辅助功能，从而给玩家提供更好的游戏体验。我们不鼓励不支持任何违反 Riot 以及腾讯规定或任何可能导致游戏环境不公平的行为。
2. 本程序的代码实现遵守 Riot Policies 的规定，提供的功能符合 《英雄联盟》游戏插件公约 的要求。
3. 本程序是基于 Riot 提供的 League Client Update (LCU) API 开发的工具，其代码与行为均不含任何侵入性的手段，因此在理论上并不会做出任何破坏客户端以及游戏完整性的行为，包括但不限于客户端文件内容的修改或游戏进程内存的读写等。
4. 我们尽力保证本程序软件本体以及使用时游戏客户端的稳定性，但尽管如此，在具体的游戏环境以及 Riot 或腾讯提供的服务更新的过程中（如反作弊系统或其他保护手段的更新），使用本程序可能会对您的游戏体验产生负面影响，如客户端崩溃 (#158)、账号封禁 (#104) 等。
5. 使用本程序所产生的一切后果将由您自行承担，我们不对因使用本程序而产生的任何直接或间接损失负责，用户在决定使用本程序时，应充分考虑并自行承担由此产生的所有风险和后果。
6. 我们保留随时修改本免责声明的权利，请定期查阅此页面以获取最新信息。

在您使用本程序之前，请确保您已经详细阅读、理解并同意免责声明中的条款；同时，请遵守相关游戏规则，共同维护健康和公平的游戏环境。

许可证 ⚖️

• 对于非商用行为，Seraphine 使用 GPLv3 许可证。
• 禁止一切针对代码以及二进制文件的商用行为。