简体中文
·
English
快速开始
·
报告 Bug
·
提出新特性
▲ Sona 插件面板 — 按 F1 随时呼出,集成战绩查询、秒抢英雄、队友分析等丰富功能
共 58 项功能,按分类折叠,点击展开查看 👇
🎮 对局增强(14 项)
| 功能 | 说明 | |
|---|---|---|
| ⚡ | 自动接受对局 | 匹配到对局时自动接受,可配置随机延迟,并可在接受后继续点击拒绝 |
| 🎯 | 秒选 / 自动 Ban 英雄队列 | 支持配置多个候选英雄,按优先级自动跳过不可用英雄;秒选可选「秒选并锁定」或「仅预选」,排位被系统补位时自动跳过 |
| 🔄 | 大乱斗无CD换英雄 | 移除共享池英雄的切换冷却限制,随时换取心仪英雄 |
| 🔵 | 红蓝方提示 | 进入英雄选择时在队伍聊天中提示本局所在阵营 |
| 📊 | 牛马检测器 | 按当前模式查询队友近期战绩,计算胜率、KDA 与 3.0~16.0 综合评分,按队内排名给出「千里马 / 上等马 / 中等马 / 下等马 / 纯牛马」评级并发送到聊天框,可选仅自己可见或全队可见 |
| 🌟 | 英雄选择阶段增强 | 根据胜率为队友头像添加 5 档粒子特效,底部显示胜率和 KDA;点击队友头像可查看详细战绩 |
| 🔒 | 隐私 / 主播模式兼容 | 隐藏队友名称时仍可分析战绩;选人界面补全真实名称,并保留客户端匿名代号和锁标识,换楼后自动同步 |
| 🏷️ | 英雄 T 级角标 | 在英雄选择列表、备选席和左侧队友头像上展示 OP.GG 英雄 T 级角标(海克斯大乱斗使用 ARAM.GG 数据,默认关闭) |
| 📈 | 全局战力分析弹窗 | 进入游戏后自动弹窗展示双方队伍胜率、KDA、段位、开黑分组;「游戏仍在进行中」面板内嵌「对局分析」按钮,可随时重新打开 |
| 🚪 | 选人阶段退出按钮 | 非自定义对局的英雄选择界面右下角提供快捷退出按钮,可直接返回组队界面 |
| 🔁 | 对局结束自动返回房间 | 对局结束后自动返回房间,保留开黑车队;支持「自动排队」和「仅返回房间」两种模式,内置重试机制 |
| 🛡️ | 平衡性调整 buff 提示 | 在大乱斗(含海克斯大乱斗)、无限火力、克隆、极限闪击、斗魂竞技场、终极魔咒书中,悬停英雄头像显示该模式的平衡性数值调整;数据每周自动同步 |
| 👍 | 对局结束自动点赞 | 对局结束后自动随机给队友点赞 |
| 🧩 | 组队界面增强 | 在组队界面点击成员头像区域查看战绩,并在旗帜上方展示该模式近期胜率、KDA 和综合评分 |
🧠 智能配装(6 项)
| 功能 | 说明 | |
|---|---|---|
| 🧰 | OP.GG 配装推荐面板 | 锁定英雄后点击皮肤选择下方的按钮打开,展示当前英雄与模式的核心装备、符文、召唤师技能、出装趋势和优势 / 劣势对局;斗魂、海斗额外展示海克斯推荐 |
| 🎮 | 游戏中查看配装 | 进入游戏后,「游戏仍在进行中」面板内嵌「配装推荐」按钮,切回客户端即可查看本局配装 |
| 🧭 | 智能分路推荐 | 排位优先使用本局分配位置,普通模式自动选择英雄最常见分路,也可在面板中手动切换上野中下辅 |
| 🧠 | 自动配置符文 & 召唤师技能 | 按「英雄 + 模式」自动记忆并恢复玩家手动保存过的符文与召唤师技能;首次游玩会在进入游戏前记录最终配置(默认关闭) |
| 📦 | 自动配装 | 锁定英雄后按模式和分路写入 Sona 管理的客户端装备集,按胜率排序出门装、鞋子、核心装和后续装备,并保留玩家自建装备集(默认关闭,暂不推荐使用,可能导致配装错乱) |
| 🛟 | 多模式数据兜底 | 适配排位、普通、大乱斗、斗魂和特殊模式;推荐分段缺失时自动使用可用数据补全 |
🔍 战绩查询(4 项)
| 功能 | 说明 | |
|---|---|---|
| 🔍 | 任意玩家战绩查询 | 输入召唤师名#Tag 查询近期战绩,首屏加载 20 场,可点「加载更多」继续翻页;不支持跨联盟大区查询 |
| 🏷️ | 模式过滤 | 支持按游戏模式下拉筛选(排位/匹配/大乱斗/斗魂等),使用 SGP 接口按队列过滤 |
| 📋 | 详细战报 | 每场显示英雄、KDA、装备、符文、召唤师技能、补刀、金币、伤害,点击可展开整局十人详情 |
| 📎 | Game ID 复制 | 一键复制 Game ID,配合回放功能使用 |
👥 社交(10 项)
| 功能 | 说明 | |
|---|---|---|
| ✏️ | 解锁自定义签名 | 移除客户端对签名编辑的禁用限制 |
| 📱 | 增强在线状态 | 支持手机在线、隐身等额外状态,并在客户端启动时恢复上次选择 |
| 🖼️ | 自定义生涯背景 | 可从所有皮肤中选择生涯背景(不限于已拥有,好友可见),支持搜索和分页懒加载 |
| 🎏 | 自定义挑战旗帜 | 在挑战身份页面选择任意旗帜作为本地展示(仅自己可见),支持段位旗帜与未拥有旗帜 |
| 👥 | 开黑好友标记 | 同一对局中的好友用相同颜色标记,一眼看出谁在开黑 |
| ⏱️ | 增强游戏中好友状态 | 右侧好友列表显示游戏中好友的模式和实时对局时长 |
| 🎭 | 段位伪装 | 伪装好友列表名片中显示的段位(好友可见),支持黑铁到最强王者任选,一键恢复真实段位 |
| 🚫 | 卸下头像边框 | 一键移除头像框装饰,恢复干净头像 |
| 🏅 | 卸下身份徽章 | 一键清空头像下方的三个挑战徽章展示位 |
| 🧹 | 卸下头像 | 一键恢复客户端默认召唤师头像 |
🎨 美化(9 项)
| 功能 | 说明 | |
|---|---|---|
| 🎨 | 美化页面 | 侧边栏「美化」分页,集中管理客户端视觉美化功能 |
| 🖼️ | 自定义主页壁纸 | 支持将 assets 中的图片 / 视频设为主页背景,可拖动、缩放调整取景,并调节模糊和底色 |
| 🪄 | 壁纸模式与场景毛玻璃 | 隐藏首页活动中心、清空右侧栏背景,并单独调节模式选择、组队大厅等场景的毛玻璃强度 |
| 🎲 | 随机壁纸 | 客户端启动时从主页壁纸列表随机应用一张,并尽量避免和上次重复 |
| 🧊 | 好友栏毛玻璃 | 独立调节右侧好友栏和壁纸模式侧栏的模糊与底色强度 |
| 🧭 | 顶部导航栏美化 | 支持调节导航栏模糊强度,并可隐藏图标分隔线与底部边框 |
| 🧑🎤 | 自定义头像 | 支持多头像列表与点击切换;双方安装 Sona 时可同步显示,并为离线好友保留本地缓存 |
| 🌈 | 流光召唤师名 | 自定义渐变起止色和角度,平滑循环流动,并同步到好友栏、组队大厅与英雄选择界面 |
| 📦 | 资源管理 | 一键打开 assets 目录;输入文件名即可录入,可省略 .png / .mp4 等后缀并支持子目录,从资源列表拖到壁纸或头像区即可使用 |
🧰 工具(7 项)
| 功能 | 说明 | |
|---|---|---|
| 🎬 | 回放观看 | 输入 Game ID 下载或直接观看对局回放 |
| 💾 | 设置备份/恢复 | 备份客户端设置(常规配置 + 热键),按账号保存多个命名存档 |
| 🎁 | 通行证奖励领取 | 展示所有待选择奖励,可按奖励规则勾选领取,也可「一键领取」全部 |
| 🪟 | 窗口特效 | 毛玻璃、亚克力、混合、云母(Win11)、透明等窗口视觉效果 |
| ✨ | 全局粒子美化 | 为客户端添加星光粒子背景效果 |
| 🔔 | 版本更新检查 | 启动时检查新版本,可查看发布说明、前往 Release 或暂时跳过该版本 |
| 🔧 | 开发者调试面板 | 完整的 LCU API 调试工具,含战绩、聊天、回放、配装、签名解析和对局分析模拟等 |
🖥️ 界面(8 项)
| 功能 | 说明 | |
|---|---|---|
| 🏠 | Sona 入口 | 客户端 Play 按钮旁的快捷入口,可在设置中隐藏(隐藏后仍可用快捷键呼出面板) |
| ⌨️ | 快捷键 | 按 F1(可配置 F1~F5)随时呼出/关闭面板 |
| 🚀 | 快速大厅模式 | 点击 Play 时跳过模式选择,直接进入预设队列的组队大厅 |
| 🗂️ | 游戏模式过滤 | 在玩家对战页面按需隐藏不常玩的队列入口 |
| 🧹 | 客户端界面精简 | 可隐藏首页云顶之弈、经典模式入口、顶部右侧导航文字和赛事直播浮窗 |
| 🎨 | 恢复炫彩分页 | 在国服藏品页面恢复被隐藏的「炫彩」子分页 |
| 🌐 | 多语言界面 | 支持简体中文、英文和自动跟随客户端语言 |
| 🔄 | DOM 自愈 | 客户端 Ember.js 刷新 DOM 后自动补回所有注入功能 |
- 已安装 Pengu Loader v1.1.0 及以上版本(建议使用最新版)
- 前往 Pengu Loader 项目地址,在 Release 中下载最新版
setup.exe并安装。打开后如下图显示 ready 即表示安装成功,之后不再需要打开该软件,正常启动 LOL 即可。如果需要你选择 LOL 路径,选择到「英雄联盟」文件夹即可。
-
从本项目的 Releases 下载最新的
sona-vX.Y.Z.zip(不要下载项目源码使用),解压得到sona文件夹。文件夹里应该有index.js、index.css和assets文件夹。 -
在 Pengu Loader 中点击上方的 Plugins,再点右下角「打开插件目录」,把
sona文件夹整个拖进去(Loader 不支持直接拖入文件)。
- 回到 Loader 点「刷新」,像下图一样看到 sona 被勾选就是安装成功了,接着重启客户端即可。
💡 升级新版本:下载新的压缩包直接覆盖解压即可,不要先删除整个
sona文件夹,否则assets里你放的壁纸、头像等自定义资源会一起丢失。插件设置保存在 Pengu Loader 的 DataStore 中,升级不受影响。Sona 启动时也会自动检查新版本并提示。
- 启动英雄联盟客户端
- 点击 Play 按钮旁的 Sona 头像图标,或按 F1(可在设置页改为 F1~F5)打开面板
- 在侧边栏切换页面:
- 工具 — 对局、配装、战绩、社交、界面相关的功能开关与配置
- 美化 — 主页壁纸、毛玻璃、导航栏、自定义头像、流光昵称、资源管理
- 领取 — 通行证待选奖励领取
- 设置 — 界面语言、面板快捷键、隐藏入口图标、全局粒子、开发者模式
- 所有设置自动持久化,下次启动自动恢复
-
需要 Pengu Loader — 本插件运行在 Pengu Loader 之上,不能独立使用。请先安装 Pengu Loader v1.1.0+。
-
客户端环境限制 — 插件运行在英雄联盟客户端内置浏览器中,直接通过 fetch 调用 LCU API,无需额外配置端口或 Token。
-
工作方式 — 客户端控制通过 LCU API 与 DOM 注入完成,不注入游戏进程;配装数据会使用 OP.GG、ARAM.GG 等外部数据源。段位伪装仅影响好友列表名片,不影响实际排位数据。
-
设置备份 — 备份存储在 Sona DataStore 中,按 PUUID 隔离不同账号,避免客户端重启后丢失。
-
战绩查询 — 战绩查询优先使用 SGP 接口,支持按队列模式过滤;部分大区、网络或客户端状态异常时会回退到客户端原生接口,仍可能查询失败。
-
好友同步 — 自定义头像与流光昵称通过签名中的隐藏配置同步,双方均安装并启用 Sona 时才能互相显示。
点击展开
flowchart TD
Client["League Client<br/>Ember.js + 内置 Chromium"] --> Pengu["Pengu Loader v1.1.0+<br/>init(context) → load()"]
subgraph Sona["Sona Plugin"]
direction TB
UI["React App<br/>面板 UI"]
Features["Features<br/>功能模块"]
Injections["Injections<br/>DOM 注入"]
Hooks["Ember Hook / XHR 规则<br/>init 阶段挂载"]
LCU["LCUManager<br/>REST + WebSocket"]
Store["SonaStore<br/>持久配置"]
Injector["InjectorManager<br/>DOM 自愈守护"]
UI --> LCU
Features --> LCU
Injections --> Injector
UI & Features & Injections --> Store
end
Pengu --> Sona
LCU --> LCUAPI["LCU API"]
Features --> Ext["外部数据源<br/>OP.GG · ARAM.GG · SGP 战绩"]
核心设计理念:
- LCUManager — REST + WebSocket 双通道统一管理,所有 LCU 交互集中在一个单例中;战绩查询优先走 SGP,失败时回退客户端原生接口
- InjectorManager — 单一 MutationObserver + requestAnimationFrame 节流,注入点被客户端刷掉后自动补回(自愈机制)
- Ember Hook — 在
init阶段通过 Pengu 的 RCP API 拦截getEmber(),从组件层面修改客户端行为 - XHR 规则 — 在
init阶段挂载请求改写规则,例如屏蔽客户端的广告弹窗请求 - SonaStore — 内存缓存 + DataStore 持久化 + 变化监听,类型安全的配置管理
- 功能驱动 — 所有功能通过 store 配置开关控制,监听变化自动开启/关闭
- 轻量 i18n — 字典式中英文翻译,
auto模式跟随客户端html lang
点击展开
sona/
├── src/
│ ├── index.tsx # 插件入口(init / load 生命周期)
│ ├── App.tsx # 主应用(侧边栏 + 页面路由)
│ ├── i18n/ # 轻量多语言(中 / 英 / 跟随客户端)
│ ├── data/
│ │ └── champion-balance.json # 各模式英雄平衡数据(CI 定期自动同步)
│ ├── lib/
│ │ ├── lcu.ts # LCU REST + WebSocket 封装、SGP 战绩查询
│ │ ├── store.ts # 配置管理(DataStore 持久化 + 变化监听)
│ │ ├── features.ts # 功能开关的生命周期注册
│ │ ├── features/ # 独立功能模块(自动接受、秒选 / Ban、配装推荐、对局分析……)
│ │ │ └── beautify-client/ # 客户端美化(壁纸、毛玻璃、导航栏、自定义头像、流光昵称)
│ │ ├── injections.ts # DOM 注入点注册中心
│ │ ├── InjectorManager.ts # 全局 MutationObserver 守护(DOM 自愈)
│ │ ├── ember-hook.ts # 基于 RCP API 的 Ember 组件 Hook
│ │ ├── xhr/ # XHR 请求改写规则
│ │ ├── opgg-api.ts # OP.GG 配装 / 符文 / T 级数据
│ │ ├── aramgg-api.ts # ARAM.GG 海克斯大乱斗数据
│ │ ├── player-strength-score.ts # 牛马检测器 / 对局分析的评分算法
│ │ ├── champ-select-puuid.ts # 匿名选人模式的 PUUID 还原
│ │ ├── image-hosting-service.ts # 自定义头像图床上传
│ │ ├── update-checker.ts # 版本更新检查
│ │ ├── plugin-resolver.ts # 插件资源路径解析
│ │ ├── assets.ts # 游戏资源映射(装备 / 技能 / 英雄 / 符文 / 队列 / 地图)
│ │ ├── modal.ts # 面板显隐 + 快捷键
│ │ ├── hooks.ts # React 自定义 hooks
│ │ ├── logger.ts # 日志系统
│ │ └── utils.ts # 工具函数
│ ├── types/
│ │ ├── lcu.ts # LCU API 类型定义
│ │ └── sgp.ts # SGP 战绩接口类型定义
│ ├── components/
│ │ ├── pages/ # 主页 / 工具 / 美化 / 领取 / 更新 / 设置 / 关于 / 调试
│ │ └── ui/ # 通用组件与弹窗(战绩、整局详情、对局分析、配装推荐、生涯背景、旗帜……)
│ └── styles/ # 页面与组件样式
├── scripts/
│ └── update-champion-balance.ts # 从 Fandom LoL Wiki 抓取模式平衡数据
├── .github/
│ └── workflows/
│ ├── release.yml # 推 v* tag 自动构建并发布 Release
│ └── update-balance.yml # 每周定时同步平衡数据并自动发布补丁版本
├── assets/ # 静态资源(Sona 头像)
├── markdown/ # README 配图
├── CHANGELOG.md # 版本变更日志
├── pengu.yml # Pengu 插件元信息
├── pengu.d.ts # Pengu Loader API 类型声明
├── package.json
├── tsconfig.json
├── vite.config.ts
└── LICENSE # AGPL-3.0
欢迎加入交流群一起讨论使用技巧、反馈问题或提建议!
- 对局数据看板(实时数据统计)
已完成(32 项)
- 自动接受对局
- 大乱斗无CD换英雄
- 秒选 / 自动 Ban 英雄队列(按优先级跳过不可用英雄)
- 牛马检测器(自动查战绩 + 综合评分 + 队内评级 + 聊天框发送)
- 英雄选择头像粒子特效(5 档胜率视觉反馈)
- 战绩查询系统(分页加载 + 模式过滤 + 整局详情)
- 自动配置符文 & 召唤师技能(按英雄和模式自动记忆与恢复)
- 自动配装(按模式和分路写入推荐装备集,暂不推荐使用)
- OP.GG 配装推荐面板(装备/符文/召唤师技能/海克斯/matchup,游戏中也可查看)
- 自定义生涯背景(全皮肤选择器)
- 自定义挑战旗帜
- 开黑好友标记(同局好友颜色分组)
- 增强游戏中好友状态(模式 + 实时对局时长)
- 组队界面增强(点击头像看战绩 + 近期表现)
- 段位伪装
- 回放下载 & 观看
- 设置备份/恢复(常规配置 + 热键双通道,DataStore 持久化)
- 增强在线状态(手机在线/隐身 + 持久化恢复)
- 全局粒子美化
- 全局战力分析弹窗(双方胜率/KDA/段位/开黑分组 + 客户端内嵌按钮)
- 对局结束自动返回房间(自动排队/仅返回房间 + 开黑车队保留 + 重试机制)
- 平衡性调整 buff 提示(六种特殊模式数值调整悬停展示 + 每周自动同步)
- 隐私 / 主播模式队友分析(匿名身份匹配 + 真实昵称回填 + 换楼同步)
- 智能分路配装(排位分配位置/英雄常见分路/手动切换)
- 选人阶段快捷退出与红蓝方提示
- 快速大厅与游戏模式过滤
- 通行证奖励领取(按需勾选 + 一键领取)
- 客户端界面精简(隐藏云顶之弈 / 经典模式 / 右侧导航文字 / 赛事直播浮窗)
- 客户端美化(主页壁纸/随机壁纸/毛玻璃/导航栏/自定义头像/流光昵称)
- 好友可见自定义头像(图床上传 + 签名零宽字符同步 + 离线缓存)
- 多语言支持(简体中文/英文/自动跟随客户端语言)
- DOM 自愈注入机制
该项目签署了 AGPL-3.0 授权许可,详情请参阅 LICENSE
Made by WJZ_P with love ❤
本项目支持 LINUX DO 社区
Sona 能走到今天,离不开这些前辈们的无私开源。站在前人的肩膀上,我才能看得更远。在此郑重感谢这些项目,我从它们的代码里学到了很多,真的超级感谢大家~ ₍ᐢ..ᐢ₎♡
- BakaFT / BetterTencentLCU
- imunproductive / upl
- BakaFT / CustomHookLoader
- nomi-san / balance-buff-viewer
- LeagueAkari / LeagueAkari
每一个 commit、每一行注释、每一个巧妙的设计,都是前辈们留给社区的珍贵财富。Sona 只是一个小小的学习者,未来也会把自己学到的东西继续开源回馈出去。感谢每一位奉献者 ✨
由于项目的特殊性,本项目 不接受任何形式的赞助 ᕙ(⇀‸↼‶)ᕗ
也 不接受 Pull Request (。•́︿•̀。)
但是非常欢迎提出建议和反馈!请到 Issues 畅所欲言~ ₍ᐢ..ᐢ₎♡