01快速开始
桌面版是免安装单文件，内置 Electron 运行时与换肤服务，不需要安装 Node.js，也不需要打开浏览器。
运行环境
| 项目 | 要求 |
|---|---|
| 系统 | Windows 10 / 11，x64 |
| 权限 | 管理员权限（注入需要，启动时会弹 UAC） |
| 依赖 | 无需 Node.js、无需浏览器、无需客户端插件 |
| 文件 | LeagueAhbvc.exe（固定文件名） |
启动步骤
- 下载
LeagueAhbvc.exe，放到任意目录；更新时直接覆盖同名文件即可。 - 双击运行，在 UAC 弹窗点「是」。首次启动会申请管理员权限。
- 启动后出现桌面窗口，内置换肤服务默认监听
51337端口。 - 托盘会常驻图标；右键托盘图标 →「退出 League Ahbvc」会真正停止服务。
这是未签名的注入类工具，可能被 SmartScreen 拦截或被杀毒软件误报。将 EXE 加入信任 / 排除项即可；如果双击没有反应，先看常见问题。
02换肤流程
皮肤库当前包含 9,096 款皮肤。支持按英雄名（如 annie / yasuo / ahri）、皮肤名或皮肤 ID 搜索。
应用一款皮肤
- 打开左侧「皮肤库」，搜索英雄或皮肤名。
- 在卡片上点「应用」。第一次会自动从远程服务器下载，之后走本机缓存。
- 进入对局，在加载界面 / 游戏内生效。
换肤只在对局加载时生效，大厅里看不到。已经开着的对局不会变——注入必须在开局前就位。要换皮肤：选人时应用，或打完这局再应用。
更换与还原
- 换别的皮肤：直接点另一个皮肤的「应用」，会自动替换当前皮肤。
- 还原原皮：进入「已应用」页，点「还原（停止注入）」。
- 客户端重启后：需要重新「应用」一次。
应用后的皮肤缓存在 %APPDATA%\leagueAhbvc\skins-remote\，原画缓存在 preview-cache\。
03界面说明
| 页面 | 作用 |
|---|---|
| 战绩 | SGP 优先获取对局，失败自动回落 LCU；卡片可展开「摘要 / 详细」 |
| 对局助手 | 开局前查看十名玩家的段位、胜率、常用英雄、近期战绩与标签 |
| 皮肤库 | 9,096 款皮肤，搜索 + 原画预览 + 一键应用 |
| 已应用 | 查看注入状态、已导入皮肤，可一键还原 |
| 工具 | 服务、游戏目录、工具目录、皮肤源、远程清单状态；可「重启客户端」 |
| 设置 | 皮肤源与 Token、数据目录、启动检查更新、关闭行为、检查更新、同步清单 |
| 关于 | 组件来源与许可说明 |
标题栏
右上角依次是连接状态、公告铃铛、主题切换与「自动接受对局」开关。主题共有 8 套：云白、暗夜、石墨、赛博、极光、暖阳、樱粉、薄荷，切换后全局生效。
常用操作
- 还原原皮：「已应用」→「还原（停止注入）」
- 换别的皮肤：直接点另一个皮肤的「应用」，会自动替换
- 同步清单：设置页 →「同步远程清单」
- 重启客户端：「工具」→「重启客户端」
04公告与更新
公告弹窗
启动后以弹窗显示远程公告，标题为「公告」，正文按 Markdown 渲染，内容区最高 60vh 可滚动。标题栏铃铛按钮可随时打开最新公告，有未读公告时铃铛高亮。
- 高优先级：弹窗边框 / 标题为黄色，需要点「已读」；点 × 或 Esc 关闭则下次启动仍会弹出。
- 中 / 低优先级：打开弹窗即视为已读，按钮显示「关闭」。
- 已读记录按公告内容生成的唯一 ID 保存在本机，内容一变就会重新弹出。
公告地址：https://lol.loveb.xyz/leagueAHBVC/notice.json，也可用环境变量 AATROX_NOTICE 覆盖。
公告文件格式：
content 支持 Markdown 的标题、列表、粗体、链接、行内代码与代码块。alertLevel 可选 high / medium / low，缺省按 low 处理；也可用 level（warning 视为 high）。
软件更新
- 手动检查：设置页 →「检查更新」只查询版本；发现新版本后才显示「下载更新包」，点击后才开始差分下载。
- 启动自动检查：设置页可开启，同样只检查版本，不会在后台自动下载；发现新版本会弹窗，确认后才下载。
- 下载完成后点「立即重启生效」。
更新源：https://lol.loveb.xyz/leagueAHBVC/app/latest.json
05设置与数据
| 设置项 | 说明 |
|---|---|
| 皮肤源地址 / Token | 默认 https://lol.loveb.xyz/skins，Token 已内置在软件中；提示 401 时才需要更新 |
| 软件数据目录 | 默认 %APPDATA%\leagueAhbvc，修改后重启软件生效 |
| 启动时自动检查更新 | 只检查版本，不自动下载 |
| 点击窗口 X | 每次询问 / 最小化到托盘 / 退出程序；询问时勾选「记住我的选择」会写入配置 |
| 检查更新 | 查询版本，发现新版本后可下载更新包 |
| 同步远程清单 | 重新拉取皮肤清单（当前 9,096 个包） |
| 主题 | 8 套配色，标题栏可快速切换 |
「启动与关闭」分组包含启动自动检查更新与点击窗口 X 行为。皮肤源在启动时自动拉取清单，应用时按需下载并缓存；请求使用内置 Token 鉴权，不需要手动填写。
数据保存位置
皮肤不再使用本地皮肤包目录，应用时直接从远程下载并缓存到 skins-remote\。
06常见问题
双击 EXE 没反应 / 提示启动失败
1. 确认 UAC 点了「是」。
2. 检查 51337 端口是否被其他程序占用：netstat -ano | findstr :51337。
3. 查看日志：%APPDATA%\leagueAhbvc\data\skin-server.log。
界面打不开 / 显示「服务离线」
先确认 EXE 还在托盘运行；如果已退出，重新打开 EXE 即可。
选了皮肤，但游戏里没变化
1. 换肤只在开局时生效，进行中的对局不会变。
2. 「已应用」页应显示「runoverlay 运行中」。
3. 客户端重启后需要重新「应用」一次。
点应用提示「下载失败 HTTP 401」
Token 失效。到设置页更新 Token → 保存 →「同步远程清单」。
换完想恢复原样
进入「已应用」→「还原（停止注入）」。
还需要装 Node / Pengu / 插件 / sona 吗
不需要。EXE 已内置运行环境；客户端插件那套已完全移除。
杀毒软件报毒 / SmartScreen 拦截
这是未签名的注入类工具，容易被误报。将 EXE 和工具目录加入信任 / 排除项即可。
战绩查询失败 / 晚间查不到
腾讯服务器战绩接口存在阶段性故障，晚间可能无法查询，这不是客户端问题。WeGame 与掌盟使用另一套数据库，因此不受影响；League Ahbvc 不会接入这两者。
07注意事项
反作弊风险：换肤属于客户端注入，腾讯 ACE 在监控范围内。排位存在风险，建议先在人机 / 训练房验证。
- 不要同时运行其他占用
51337端口的换肤服务，否则会启动失败。 - 不要同时安装其他换肤工具，容易冲突。
- 磁盘占用：overlay 单个可能几百 MB，可「还原」后清理
%APPDATA%\leagueAhbvc\injection\overlay。 - League Ahbvc 与 Riot Games、腾讯无关。使用即表示你了解并自行承担相关风险。
08组件来源
| 组件 | 来源 | 许可 |
|---|---|---|
| 换肤引擎 | CSLOL Manager（mod-tools.exe / cslol-dll.dll） | 开源 |
| 桌面运行时 | Electron | 开源 |
| 皮肤资源 | 自建服务器 | — |
不含卡密系统，不依赖原作者授权服务器，也不加载任何客户端插件。皮肤数据与战绩方案参考 LeagueAkari 的实现。