Skip to content
sunerpyPublic

About

英雄联盟(国服)客户端助手:选人时看队友战绩与损友式评级、一键战力喊话,支持战绩查询成就设置,自动接受和选禁英雄,内置 Pengu Loader 增强客户端界面。League of Legends client companion for Windows.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

41 Commits

Folders and files

Repository files navigation

winer

winer

英雄联盟客户端助手:队友战绩、对局评级、配装推荐与自动化,直接读客户端自己的接口

CI Release License: MIT

亮点 · 安装 · 功能 · 评分与评级 · 开发 · 交流群 · 微信公众号 · 致谢 · 免责声明 · 使用文档

English documentation: firlab.app/winer/en

选人时看清每位队友的近期战绩和档位,按名称翻完任何人的战绩,在客户端里直接看配装、强化符文和队友战绩, 把接受对局、选用英雄、符文和开局喊话交给它。只做 Windows 版,在腾讯客户端(国服)上实测。

选人阶段的对局分析:每位队友一行,左边是档位、称号、段位、胜率和 KDA,右边是最近的每一局

亮点

选人时一眼看清队友

  • 每位队友一行:段位、近期胜率与 KDA、最近每一局;按近期战力排成峡谷五档(峡谷通天代、人形防御塔、峡谷公务员、 移动眼位、纯正牛马),配毒舌称号和评语;标出红蓝方,一起排队的队友同色分组。
  • 战力喊话:按选人楼层(1L–5L)和名字排好,一键发到队伍、每局自动发送,或用快捷键发送;游戏中按快捷键还能提醒 队友提防对面最强的人(可选,默认关闭)。
  • 反击:按快捷键随机发一句自己写的反击语句,选人时发到选人聊天,游戏中输入队伍或全体聊天(可选,默认关闭); 选人时点一下快捷语,楼层和英雄自动填好发给某位队友(「5L大佬,小弟想玩下龙王,给您磕一个了」),也可以先在客户端 对他点「交换」再按快捷键发出;开源的在线语录要你自己下载、确认并打开才会使用。

配装推荐

  • 选人、游戏中和空闲时都能看英雄的出装、符文、召唤师技能、技能加点和对位:召唤师峡谷用腾讯 101 的国服数据, 大乱斗和斗魂竞技场用 OP.GG;海克斯大乱斗和斗魂竞技场另有强化符文的强弱排行。
  • 一键应用符文页和召唤师技能、写入装备方案;还能按英雄和模式记住你最后用的符文和召唤师技能,下次锁定英雄时 自动换上。

战绩与评分

  • 按 Riot ID 查任何人,经大区的战绩服务器翻完整个历史;刚看过的页和记分板直接从缓存里出来。
  • 每局 0–10 分的单局评分与 S+ 到 F 的评级;MVP、SVP 的权重对照 WeGame 校准过(召唤师峡谷 85% / 83%、 海克斯大乱斗 80% / 73% 与 WeGame 一致);记分板标出全场最高的各项数据。
  • 写明近期战绩统计的是哪些对局(近 N 场 · 所有模式),自定义、人机和重开局不计入,自定义对局可以隐藏。

在客户端里直接用

  • 自带 Pengu Loader,连上客户端时自动激活并装好插件,不用另外安装。
  • 选人界面的队友战绩和档位、组队房间每位成员的近期表现、好友列表里好友对局的模式和已进行时间;点任何一名 玩家,在客户端里弹出他最近的 10 局。
  • 大乱斗备选席上的英雄点一下就换,不等冷却;可以隐藏首页推广和赛事弹窗。

工具与自动化

  • 自动接受对局、按分路自动选用和禁用英雄、对局结束返回房间;每一项都默认关闭,并且可以限定在哪些模式里生效。
  • 一键领取客户端里等你领的奖励(活动通行证奖励、蓝色精萃、图标、表情等),要选择的只领你勾选的;也可以打开 自动领取,连上客户端时和每局结束后各领一次,默认关闭。
  • 生涯背景(全部皮肤可选)、挑战徽章与称号和旗帜、段位伪装、手机在线和隐身、游戏设置与按键的备份和恢复; 一键换回默认头像和朴素边框,都能撤销。
  • 全局快捷键唤起 winer(默认 Alt+`),游戏中唤出时保持在游戏上方。

安全与隐私

  • 只使用客户端在本机开放的接口,不读取游戏内存,不修改游戏文件;客户端的凭证只在内存里使用。联网的只有大区 的战绩服务器、配装数据、强化符文说明、软件更新,以及你点了下载时的在线语录,见 数据与隐私。
战绩页:按模式筛选的对局列表,每局的评级、MVP 和成就徽章

战绩:每局的评级、MVP/SVP 和成就徽章,展开就是记分板

设置里的评级方案:峡谷五档、峡谷八档、马系和自定义档位

评级:峡谷五档、峡谷八档、马系或自己写的档位

截图来自演示数据,不含真实玩家。

安装

需要 64 位 Windows 10 或 11(系统自带 WebView2)。安装只装到当前用户,不需要管理员权限。

一行命令(PowerShell):下载最新版的安装包,按发布里的 SHA256SUMS 校验通过后静默安装。

irm https://github.com/sunerpy/winer/releases/latest/download/install.ps1 | iex

指定版本时设置 WINER_VERSION,脚本也取同一个版本里的那份:

$env:WINER_VERSION = "0.0.1"; irm https://github.com/sunerpy/winer/releases/download/v0.0.1/install.ps1 | iex

安装包:在 Releases 下载 winer_<版本>_x64-setup.exe 双击运行。 安装包没有代码签名证书,SmartScreen 会提示「已保护你的电脑」,点「更多信息 → 仍要运行」。原因和校验办法见 docs/accepted-tradeoffs.md;每个发布文件都可以对照 SHA256SUMS,或用 GitHub 的构建证明核对来源:

gh attestation verify winer_0.0.1_x64-setup.exe --repo sunerpy/winer \
  --signer-workflow sunerpy/winer/.github/workflows/release.yml

装好以后打开 winer 即可,其余它自己完成:国服客户端以管理员身份运行时,它请求以管理员身份重启(只有系统的确认 提示);连上客户端后装好自带的 Pengu Loader 和客户端插件 (第一次激活要在客户端目录里创建链接,Windows 只允许管理员创建,winer 没有管理员权限时同样请求以管理员身份 重启一次),Pengu 自己的弹窗不会出现;启动后和运行期间自动检查更新,有新版本时标题栏出现按钮,一键升级。

功能

页面 能做什么
概览 召唤师、段位、近期状态(胜率、KDA、连胜、常用英雄)、自动化开关、动态、好友动态(正在选人或游戏中的好友,模式与已进行时间,一起玩的好友同色标出,点好友进入战绩)、最近对局
对局 对局分析:选人与对局中按队伍逐行列出每位玩家的段位、近期胜率与 KDA,以及最近 6–12 局(胜负、战绩、模式),点玩家进入战绩;我方/敌方切换与红蓝方;开黑标记(每组一种颜色并保留编号,选人时标出同一房间进来的队友,并按近期同队战绩推断“疑似开黑”);补位标记;选人推荐(峡谷按对位、强度和你在这个分路的战绩推荐 3 个英雄,只显示);读取失败可重试;战力评级、毒舌称号与评语;战力喊话(首行带红蓝方和 winer 署名,每行写选人位置 1L–5L 和名称);大乱斗备选席一键换、重随;配装推荐(选人与游戏中按英雄、模式和分路给出出装、符文、召唤师技能、技能加点和对位,斗魂竞技场与海克斯大乱斗给出强化符文排行,可一键应用符文和召唤师技能、写入装备方案;空闲时可按英雄查询);组队房间里列出每位成员的段位、近期战绩与战力分
战绩 按 Riot ID 查询任意玩家;玩家资料写明近期战绩数的是哪些对局(近 N 场 · 所有模式,不含自定义、人机和重开局),并显示与选人时相同的战力档位、毒舌称号和评语;分页浏览全部战绩(每页 10/15/25/50),默认隐藏自定义对局(可关);刚看过的玩家和记分板再次打开立即显示;头像上标出 MVP/SVP,时间后面是本局成就(多杀、超神、一血、各项最多、逃兵);按模式筛选;按英雄汇总(场次、胜率、KDA、平均评分、MVP/SVP);导出 CSV/JSON 到下载文件夹;给玩家写备注(靠谱/坑/喷子/演员,只存本机,在选人、对局和房间里显示);海克斯大乱斗等模式显示每人的海克斯符文(稀有度与效果说明);展开对局记分板:winer 评分与单局评级、MVP/SVP、成就小图标、单局称号、伤害与伤害占比、承伤、参团率、经济、补刀、装备,全场伤害/承伤/经济最高、死亡最少、评分最高单独标出
自动化 每项都可限定适用模式(排位、匹配、极地大乱斗、海克斯大乱斗、斗魂竞技场、其他),按模式查看各模式下生效的项目;自动接受(可设等待);按分路的英雄顺序自动选择/禁用,规划阶段亮出意向,补位时只用该分路的列表;对局结束自动返回房间;进入选人自动喊话(开场白、每行内容可自定义,带实时预览);喊话快捷键(默认不设置:选人时按一下发到队伍,打开「游戏内发送」后在游戏里把敌方最该提防和最好针对的人输入游戏聊天,属于模拟按键,默认关闭);大乱斗心愿英雄自动换;锁定英雄后自动配置记住的符文和召唤师技能(按英雄和模式记忆,没有记录时用客户端推荐);自动写入装备方案(实验性)
反击 自己写的反击语句(最多 100 句,按一次随机发一句,不连着两次发同一句);发到队伍、发到全体两个快捷键(选人时发到选人聊天,打开「游戏内发送」后在游戏里输入队伍聊天或加 /all 输入全体聊天,属于模拟按键,默认关闭;两次发送至少隔 3 秒);选人快捷语(对局页每位队友旁的菜单,楼层和英雄自动填好发到选人聊天;也可以先在客户端对队友点「交换」,再按「发给交换的队友」快捷键);在线语录(开源祖安语录,下载前要确认,下载后还要自己打开,可移除);游戏以管理员身份运行而 winer 没有时,提示并可以以管理员身份重启
工具 在线状态(在线、离开、手机在线、隐身,和客户端里切换的效果相同;手机在线时可把个性签名设为“手机在线”),可记住并在客户端重置后改回;个性签名;重启客户端界面;生涯背景(全部皮肤可选,含未拥有的);挑战徽章、称号与旗帜;段位伪装(只改变好友看到的段位,默认关闭);游戏设置与按键备份、恢复(最多 10 份,可导入);我的备注(搜索、删除);奖励领取(列出客户端里待领的奖励,一键领取,几选一的奖励只领你勾选的;可打开自动领取,连上客户端时和每局结束后各领一次,默认关闭,排队、选人和对局期间不领);头像与边框(一键恢复默认头像、换成朴素边框,都能撤销)
客户端增强 自带 Pengu Loader,连上客户端时自动激活并装好插件,可停用;检测到 Pengu Loader 1.2 等通过 IFEO 接管客户端时提醒,可打开实验开关让 winer 让路以免重复加载;选人界面队友战绩、评级与称号、自己所在的红蓝方和开黑编号;在客户端里直接点备选席英雄秒换(开关,不等冷却);好友列表里好友对局的模式与已进行时间,一起玩的好友同色竖条;组队房间成员横幅上方的近期胜率、KDA 与战力分;在房间或选人界面点玩家,直接在客户端里弹出他最近 10 局的战绩卡片(也可以改为在 winer 里打开);隐藏首页推广
设置 五套主题(含海克斯)、强调色、密度、字号、减少动态、语言、关闭到托盘、唤起 winer 的全局快捷键(默认 Alt+`,游戏中唤出时置顶)、配装推荐、选人推荐与各模式的数据源(峡谷腾讯 101 或 OP.GG,大乱斗、斗魂竞技场 OP.GG 或关闭,海克斯 ARAM.GG 兜底与符文说明可关)、开机自启、软件更新、诊断(检查客户端接口、战绩服务器、数据源、插件、快捷键和更新,可复制结果,客户端更新后自动检查一次);评级方案、自定义档位、毒舌称号开关与评价依据

评分与评级

两个数字都是 winer 自己的公式,写在 crates/core/src/rating.rs,不复刻客户端、WeGame 或其他工具的算法;对局评分的权重对照 WeGame 的 MVP、SVP 校准过。 完整规则见评级说明(源文件 docs/site/rating.md),窗口里在 设置 › 评级。

  • 对局评分(0–10):把经济、存活、击杀、助攻、对英雄伤害、承伤,以及峡谷里的补刀和视野,分别与本局十人的 平均值相比(每项最多计三倍),加权平均后经逻辑曲线映射。全场平均为 6.0,1.25 倍平均为 8.0,0.75 倍为 3.6。 胜方最高分为 MVP,败方最高分为 SVP。WeGame 不公开它的评分方法,这组权重是拿 WeGame 打过分的对局拟合的: 峡谷 126 局里 MVP、SVP 与 WeGame 一致的分别有 85% 和 83%,海克斯大乱斗 139 局里是 80% 和 73%(大乱斗按英雄定位分别计权)。单局评级 S+ 到 F,平均水平是 B;重开局不评分。
  • 近期战力(0–10):取近二十场(不含自定义、人机和重开局;选人时只取当前模式)每一局的对局评分,峡谷按分路、 大乱斗按英雄定位拉齐,越近的局权重越高,场次少时向平均水平收拢,胜率只占 5%;最后换算成在玩家中的位置,5.0 是 平均水平。各项参数用 70 名真实玩家各 20 场的数据实测标定。默认的峡谷五档把一队五人从好到差排成峡谷通天代 / 人形防御塔 / 峡谷公务员 / 移动眼位 / 纯正牛马,每档配一句毒舌评语;也可以换成按固定分段定级的峡谷八档(S+ 到 F)、 马系宇宙、赛马五档、赛马三档、峡谷食物链,或者自己写 2–5 个档位名称。战绩页只看一位玩家,没有队友可比, 就按峡谷八档的固定分段换算成当前方案的档位。
  • 毒舌称号:按数据特征给出,比如三连胜是“版本答案”,输了但伤害占全队三成以上是“院长”;可以在设置里关掉。

战绩从哪里来

腾讯客户端自己的战绩接口(LCU)只给最近 20 场,而且不管请求第几页都返回同一批;分页靠的是所在大区的 战绩服务器(SGP),用客户端自己的登录令牌访问,可以翻完整个战绩(实测 160 场)。连不上 SGP 时退回 客户端的 20 场,并在列表下方说明。实测细节见 docs/platform-notes.md。

结构

路径 内容
crates/lcu LCU 传输:凭据发现(进程命令行,lockfile 兜底)、TLS 校验、REST、WAMP 事件
crates/core 领域内核:快照与增量、选人/对局视图、自动化决策、评分、喊话、插件桥、设置
app/src-tauri Tauri 外壳:命令、托盘、窗口、lcu 资源协议、提权重启、日志、更新
app/frontend 桌面窗口(React 19 + Tailwind v4)
plugin Pengu Loader 插件(纯 TypeScript DOM,适配客户端的 Chromium 108)
packages/shared ts-rs 生成的类型(bindings.ts)与共享格式化函数
fixtures 从真实客户端抓取的 LCU 响应,供测试使用
scripts/windows Windows 真机验收脚本

设计规范见 DESIGN.md;实测的平台事实见 docs/platform-notes.md。

开发

pnpm install
pnpm dev                     # 浏览器预览,使用内置演示数据
cargo test --workspace       # Rust 全部测试(含 TypeScript 类型漂移检查)
pnpm test                    # 前端、插件、共享包测试
pnpm lint && pnpm typecheck && pnpm format:check
cargo clippy --workspace --all-targets -- -D warnings

Rust 侧的视图类型改动后,用 UPDATE_BINDINGS=1 cargo test -p winer-core bindings 重新生成 packages/shared/src/bindings.ts。

构建 Windows 版本

pnpm build
cargo xwin build --release --target x86_64-pc-windows-msvc -p winer --features custom-protocol

custom-protocol 不能省:没有它,前端资源不会嵌入,窗口会是空白的。安装包由发布流程在 Windows 上用 pnpm tauri build 和 pnpm tauri bundle 生成。

发布

版本号只写在根目录的 package.json(tauri.conf.json 和 app/src-tauri/build.rs 都读它),由 release-please 维护:改动经 squash 合并进 main 后,它开出 chore: release X.Y.Z 的发布 PR,合并后 .github/workflows/release.yml 在 Windows 上构建安装包,校验更新签名,生成 latest.json、SHA256SUMS 和构建证明,全部核对无误才公开发布。0.1.0 之前每次只增加最后一位版本号。规则写在 AGENTS.md。

真机验收

scripts/windows/qa.sh 在 Linux 上交叉编译带 qa 特性的版本,部署到 Windows 主机,在控制台会话中启动, 再经 WebView2 的调试端口截图、执行脚本,不注入任何键鼠输入:

scripts/windows/qa.sh build && scripts/windows/qa.sh deploy
scripts/windows/qa.sh shot overview          # target/qa/overview.png
scripts/windows/qa.sh log 40                 # 当天日志末尾

qa 特性会打开调试端口,任何本机进程都能借此操控窗口,因此只用于验收,不得进入发布版本。

交流群

QQ 群「winer交流群」,群号 1109319256,反馈问题、交流使用:点这里加入,或用 QQ 扫码。winer 的 设置 › 关于 里也能直接加入。

QQ 群「winer交流群」的二维码,群号 1109319256

微信公众号

作者的微信公众号「六月水蓝」,微信扫码关注:

微信公众号「六月水蓝」的二维码

致谢

  • Pengu Loader(MIT):把插件载入客户端界面。winer 内置了它的 core.dll,许可原文见 THIRD_PARTY_NOTICES.md。
  • Tauri、Rust 与 React 的开源生态:窗口与内核建立在它们之上,完整依赖见 Cargo.lock 与 pnpm-lock.yaml。
  • ARAM.GG:海克斯大乱斗强化符文的效果说明,以及腾讯数据取不到时的海克斯大乱斗强化符文统计。
  • 腾讯掌上英雄联盟的公开对局统计:召唤师峡谷和海克斯大乱斗的出装、符文、召唤师技能、技能加点、对位与强化符文推荐, 数据来自国服对局。
  • OP.GG:极地大乱斗与斗魂竞技场的出装和强化符文统计,以及可选的召唤师峡谷数据来源。
  • WeGame:对局评分的权重拿 WeGame 公开的 MVP、SVP 结果校准过,没有使用它的算法。
  • ZuAnBot:游戏内输入要以管理员身份运行,是参考它的做法确认的;没有使用它的 代码和语录。
  • 祖安语录(Apache-2.0):反击的在线语录在你下载时取自它的词库,winer 不附带,也不修改其内容。

免责声明

  • winer 是非官方的第三方工具,与 Riot Games、腾讯及 WeGame 没有任何关联,未获它们认可、赞助或支持。英雄联盟 (League of Legends)及相关名称、标志和图片是 Riot Games, Inc. 的商标或财产。
  • winer 只使用客户端在本机开放的接口(LCU),不读取或修改游戏进程的内存,不修改游戏文件,也不在对局中替你操作。 唯一的例外是默认关闭的「游戏内发送」(战力喊话和反击各有一个):打开后,在游戏中按下对应的快捷键时,winer 向游戏 窗口模拟键盘输入,把内容打进聊天,这属于第三方输入。游戏在前台时系统快捷键传不到 winer,所以游戏进行中 winer 用 键盘钩子听你设置的快捷键:只接手这几个组合键,别的按键原样交给游戏,也不记录。 客户端增强经由 Pengu Loader 在客户端界面里运行插件,会改变客户端界面的显示。
  • 第三方工具都可能违反游戏的服务条款,使用 winer 可能使账号受到限制,风险由使用者自行承担。
  • 评分、评级、称号和喊话只是基于战绩数据的娱乐性参考,不代表任何人的真实水平;请勿用来辱骂或骚扰其他玩家。
  • 反击的语句由你自己编写,或从第三方开源词库下载;winer 不编写、不审核这些内容,只在你按下快捷键或点击快捷语时替你 发送。在游戏中辱骂他人可能违反游戏规则,被举报后可能禁言或封号,后果由使用者自行承担。
  • 段位伪装只改变好友在好友列表和资料卡里看到的段位,不改变真实段位、匹配和客户端里你自己的资料;好友看到的并不是 你的真实段位,请勿用它误导他人。
  • 配装、符文、召唤师技能、技能加点和强化符文推荐来自上面列出的第三方公开统计,winer 不保证它们准确或及时。这些接口 并不是为第三方工具提供的,随时可能变化或停用,那时相应的面板会显示取不到数据。
  • 自动配置符文与召唤师技能、自动写入装备方案只在你打开对应规则后才会修改客户端里的内容,默认都是关闭的。
  • 软件按 MIT 许可「按原样」提供,不附带任何担保,作者不对使用造成的损失负责。

许可

MIT,见 LICENSE。随附的第三方组件及其许可见 THIRD_PARTY_NOTICES.md。

About

英雄联盟(国服)客户端助手:选人时看队友战绩与损友式评级、一键战力喊话,支持战绩查询成就设置,自动接受和选禁英雄,内置 Pengu Loader 增强客户端界面。League of Legends client companion for Windows.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages