▲ Sona 插件面板 — 按 F1 随时呼出，集成战绩查询、秒抢英雄、队友分析等丰富功能
| 功能 | 说明 | |
|---|---|---|
| ⚡ | 自动接受对局 | 匹配到对局时自动点击接受，再也不会错过 |
| 🎯 | 秒抢英雄 | 轮到自己时自动秒锁指定英雄，支持模糊搜索选择；可切换"秒选并锁定"或"仅预选"模式 |
| 🔄 | 大乱斗无CD换英雄 | 移除共享池英雄的切换冷却限制，随时换取心仪英雄 |
| 📊 | 分析友方战力 | 进入英雄选择时自动查询队友近期战绩，计算胜率/KDA 并附带幽默评价，自动发送到队伍聊天框 |
| 🌟 | 英雄选择阶段增强 | 根据胜率为队友头像添加 5 档粒子特效（blazing/strong/normal/shaky/dizzy），底部显示胜率和KDA，点击头像可查看详细战绩 |
| 👍 | 对局结束自动点赞 | 对局结束后自动随机给队友点赞 |
| 功能 | 说明 | |
|---|---|---|
| 🔍 | 任意玩家战绩查询 | 输入召唤师名#Tag，一次性拉取近 100 场对局 |
| 🏷️ | 模式过滤 | 支持按游戏模式下拉筛选（排位/匹配/大乱斗等） |
| 📋 | 详细战报 | 每场显示英雄、KDA、装备、符文、召唤师技能、补刀、金币、伤害 |
| 📎 | Game ID 复制 | 一键复制 Game ID，配合回放功能使用 |
| 功能 | 说明 | |
|---|---|---|
| ✏️ | 解锁自定义签名 | 移除客户端对签名编辑的禁用限制 |
| 🖼️ | 自定义生涯背景 | 可从所有皮肤中选择生涯背景（不限于已拥有），支持搜索和分页懒加载 |
| 👥 | 开黑好友标记 | 同一对局中的好友用相同颜色标记，一眼看出谁在开黑 |
| 🎭 | 段位伪装 | 伪装好友列表中的段位显示，支持黑铁到最强王者任选，一键恢复真实段位 |
| 🚫 | 卸下头像边框 | 一键移除头像框装饰，恢复干净头像 |
| 功能 | 说明 | |
|---|---|---|
| 🎬 | 回放观看 | 输入 Game ID 自动下载并观看对局回放 |
| 💾 | 设置备份/恢复 | 备份客户端设置（常规配置 + 热键），支持多个命名存档，按账号隔离 |
| 🪟 | 窗口特效 | 毛玻璃、亚克力、云母(Win11)等视觉效果 |
| ✨ | 全局粒子美化 | 为客户端添加星光粒子背景效果 |
| 🔧 | 开发者调试面板 | 完整的 LCU API 调试工具，含战绩查询、聊天调试、回放调试、荣誉调试等 |
| 功能 | 说明 | |
|---|---|---|
| 🏠 | Sona 入口 | 客户端 Play 按钮旁的快捷入口 |
| ⌨️ | 快捷键 | 按 F1（可配置 F1~F5）随时呼出/关闭面板 |
| 📱 | 增强在线状态 | 支持手机在线、隐身等额外状态，启动时自动恢复 |
| 🔄 | DOM 自愈 | 客户端 Ember.js 刷新 DOM 后自动补回所有注入功能 |
- Pengu Loader 最新版已安装
Pengu Loader 项目地址,安装方式很简单，在release中下载最新版的setup.exe，直接安装即可。安装完成后打开，如下图启用状态为ready则表示安装成功，后续不再需要打开该软件，正常启动LOL即可。如果需要你选择LOL路径，选择到“英雄联盟”文件夹即可。
接着点击上方右侧的Plugins,打开插件目录，从本项目的release中下载压缩包(不要下载项目源码使用)，解压出sona文件夹并拖动至插件目录，注意，loader不支持直接拖入文件，应该点击右下角打开插件目录，然后将sona文件夹拖动进去。
注意，这里要把sona文件夹拖动进来，并确保里面应该是两个index文件。
操作完成后，回到loader，点刷新，像上图一样就是安装成功了，接着重启客户端即可。
- 启动英雄联盟客户端
- 点击 Play 按钮旁的 Sona 头像图标，或按 F1 打开面板
- 在「工具」页开启/配置各项功能
- 所有设置自动持久化，下次启动自动恢复
┌─────────────────────────────────────────────────────┐
│ League Client (Ember.js) │
│ 内置 Chromium 浏览器环境 │
└──────────────────────┬──────────────────────────────┘
│
┌──────────────────────┴──────────────────────────────┐
│ Pengu Loader v1.1.0+ │
│ init(context) → load() 生命周期 │
└──────────────────────┬──────────────────────────────┘
│
┌──────────────────────┴──────────────────────────────┐
│ Sona Plugin │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌──────────────┐ │
│ │ React App │ │ Features │ │ Injections │ │
│ │ (面板 UI) │ │ (功能逻辑) │ │ (DOM 注入) │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬───────┘ │
│ │ │ │ │
│ ┌──────┴────────────────┴────────────────┴───────┐ │
│ │ LCUManager (单例) │ │
│ │ REST API (fetch) + WebSocket │ │
│ └────────────────────────────────────────────────┘ │
│ │
│ ┌────────────┐ ┌──────────┐ ┌─────────────────┐ │
│ │ SonaStore │ │ Assets │ │ InjectorManager │ │
│ │ (持久配置) │ │ (资源映射)│ │ (DOM 自愈守护) │ │
│ └────────────┘ └──────────┘ └─────────────────┘ │
└─────────────────────────────────────────────────────┘
核心设计理念：
- LCUManager — REST + WebSocket 双通道统一管理，所有 LCU 交互集中在一个单例中
- InjectorManager — 单一 MutationObserver + requestAnimationFrame 节流，注入点被客户端刷掉后自动补回（自愈机制）
- SonaStore — 内存缓存 + DataStore 持久化 + 变化监听，类型安全的配置管理
- 功能驱动 — 所有功能通过 store 配置开关控制，监听变化自动开启/关闭
sona/
├── src/
│ ├── index.tsx # 插件入口（init/load 生命周期）
│ ├── App.tsx # 主应用（侧边栏 + 页面路由）
│ ├── lib/
│ │ ├── lcu.ts # LCU REST API + WebSocket 封装
│ │ ├── features.ts # 所有功能核心实现
│ │ ├── store.ts # 配置管理（持久化 + 监听）
│ │ ├── injections.ts # DOM 注入点注册中心
│ │ ├── InjectorManager.ts # 全局 MutationObserver 守护
│ │ ├── assets.ts # 游戏资源映射（装备/技能/英雄/符文/队列/地图）
│ │ ├── modal.ts # 模态窗口状态 + 快捷键
│ │ ├── hooks.ts # React 自定义 hooks
│ │ ├── logger.ts # 日志系统
│ │ └── utils.ts # 工具函数
│ ├── types/
│ │ └── lcu.ts # LCU API 完整类型定义
│ ├── components/
│ │ ├── pages/
│ │ │ ├── HomePage.tsx # 主页（头像 + 粒子动画）
│ │ │ ├── ToolsPage.tsx # 工具页（核心功能面板）
│ │ │ ├── SettingsPage.tsx # 设置页
│ │ │ ├── AboutPage.tsx # 关于页
│ │ │ └── DebugPage.tsx # 调试页（开发者模式）
│ │ └── ui/
│ │ ├── Modal.tsx # 通用模态窗口（createPortal）
│ │ ├── Sidebar.tsx # 侧边栏导航
│ │ ├── MatchHistoryModal.tsx # 战绩查询弹窗
│ │ ├── ProfileBackgroundPicker.tsx # 生涯背景选择器
│ │ ├── ChampSelectIconEffect.tsx # 选人阶段头像粒子特效
│ │ ├── SettingCard.tsx # 设置卡片
│ │ ├── SonaButton.tsx # 按钮
│ │ ├── SonaSwitch.tsx # 开关
│ │ ├── SonaSelect.tsx # 下拉选择
│ │ ├── SonaInput.tsx # 输入框
│ │ ├── SonaSlider.tsx # 滑块
│ │ ├── SonaCheckbox.tsx # 复选框
│ │ └── icons.tsx # 图标集
│ └── styles/ # 18 个 CSS 文件
├── .github/
│ └── workflows/
│ └── release.yml # CI：推 tag 自动构建 + 发布 Release
├── assets/ # 静态资源（Sona 头像）
├── CHANGELOG.md # 版本变更日志
├── pengu.d.ts # Pengu Loader API 类型声明
├── package.json
├── tsconfig.json
├── vite.config.ts
└── LICENSE # AGPL-3.0
-
需要 Pengu Loader — 本插件运行在 Pengu Loader 之上，不能独立使用。请先安装 Pengu Loader v1.1.0+。
-
客户端环境限制 — 插件运行在英雄联盟客户端内置浏览器中，直接通过 fetch 调用 LCU API，无需额外配置端口或 Token。
-
功能安全性 — 所有功能仅通过官方 LCU API 实现，不修改游戏文件，不注入游戏进程。段位伪装仅影响好友列表名片，不影响实际排位数据。
-
设置备份 — 备份存储在浏览器 localStorage 中，按 PUUID 隔离不同账号。清除浏览器数据会丢失备份。
-
战绩查询 — 单次最多拉取 100 条对局记录（LCU API 限制），模式过滤为客户端筛选。
欢迎加入交流群一起讨论使用技巧、反馈问题或提建议！
- 自动接受对局
- 大乱斗无CD换英雄
- 秒抢英雄（排位/匹配秒锁 + 仅预选模式）
- 队友战力分析（自动查战绩 + 聊天框发送）
- 英雄选择头像粒子特效（5 档胜率视觉反馈）
- 战绩查询系统（100 场贪婪拉取 + 模式过滤）
- 自定义生涯背景（全皮肤选择器）
- 开黑好友标记（同局好友颜色分组）
- 段位伪装
- 回放下载 & 观看
- 设置备份/恢复（常规配置 + 热键双通道）
- 增强在线状态（手机在线/隐身 + 持久化恢复）
- 全局粒子美化
- DOM 自愈注入机制
- 多语言支持
- 自动 Ban 英雄
- 符文推荐 & 自动配置
- 对局数据看板（实时数据统计）
该项目签署了 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 畅所欲言～ ₍ᐢ..ᐢ₎♡