更新日志

最近 5 个正式版本的完整更新说明。更早版本见 GitHub 发行版。

v3.11.0

2026-10-10最新正式版查看发行版 ↗

本版增加 WAV 按事件分类输出，修正批量导出的目录层级，并上线文档网站。

音频导出

• 界面在“全局设置 → 基础设置”增加“按事件分类输出”，默认关闭；控制台同步提供 --wav-group-by-event / --no-wav-group-by-event，配置文件使用 [wav] wav_group_by_event。
• 普通 WAV 保存到 wavs/<版本>/<语言>/...，事件分类保存到 wavs_by_event/<版本>/<语言>/...，保留英雄、皮肤、音频类型和原始 ID。
• 有精确映射的音频按事件归类；有映射但未关联的音频放入“未关联事件”，没有可用映射的对象保留普通布局。
• 本轮选择了映射动作时，分类使用本轮完成的映射。界面与控制台共用同一输出逻辑。
• 手动批量导出以所选目录为 WAV 根，完整保留版本、语言、实体和皮肤层级；单条另存为仍使用指定文件位置。
• 切换开关不搬动、删除或整理已有文件。多个事件引用同一音频时分别保存独立 WAV 副本，可直接复制、压缩和分发；WEM 资源库和试听方式保持不变。

界面与版本

• 统一导出确认、结果详情、菜单与浮层的 Fluent 主题，改善深浅主题中的文字和背景显示。
• 将转码参数统一说明为“采样格式”，明确 PCM 位深与浮点格式的含义；输出仍为 WAV。
• 开发版本号支持显式开发周期下限，避免因正式标签只存在于主分支而显示过旧的开发版本。

文档

• 文档网站：lau.oogoo.top。首页提供当前版本下载和开始使用入口。
• README 与网页共用 Markdown；界面、控制台、其他信息、API 和开发文档分别导航。
• 补充界面配图、常见问题、输出目录规则、跨平台源码运行方式及历史音频 ID 与内容的实测。
• 正式发布后自动构建并部署文档，也可手动更新；生成网页不写回仓库。

Windows x64 用户按需下载界面版或控制台版。Linux、macOS 等系统可使用 Python 3.10+ 从仓库运行；macOS 的实际客户端目录与完整流程尚未实测。

v3.10.5

2026-09-25查看发行版 ↗

本版更新 GUI 的任务范围选择和装备事件查找，并为控制台增加映射 JSON 导出与独立 WEM 转码。

GUI

• 英雄、地图分别支持“不处理”“全部”和“指定 ID”；创建任务前显示确认清单，核对后再执行。
• 点击装备卡片可跳转到常规公共资源中查找相关事件；事件搜索增加输入防抖，按 Enter 可立即搜索。
• 多种资源语言尚未选定时显示选择提示，并提供进入语言设置的入口。
• 修复启动扫描线程过早释放导致的崩溃，改善任务确认窗口和新手引导的交互。

控制台

• 新增 export-json --champions ID 或 export-json --maps ID，由程序定位已有映射并完整导出 JSON，无需另装 MSGPACK 读取工具。
• 新增独立 convert-wem，支持单个 WEM、多个路径或每行一个路径的 UTF-8 文本清单，复用并发、格式、重试与报告配置。
• update extract wav mapping 仍可在一条命令中组合使用；只需要 WAV 时可以省略 mapping。
• 补齐随包 README，说明公共装备音效的位置、先映射后解包的操作流程，并单列 AI Agent 使用指引。

新命令属于独立入口，不改变现有配置和音频输出结构。已有准备数据、映射与 WEM 可以继续复用，无需为升级重新解包。

Windows x64 用户按需下载 GUI 或 CLI 程序；CLI 的具体参数与示例见附件 LolAudioUnpack-CLI-README.md。

v3.10.3

2026-09-24查看发行版 ↗

修复浅色主题下全局进度条文字不可读，以及任务完成后音频无法选择导出的问题。

• 全局进度条左侧的标题和说明随深浅主题切换文字颜色，浅色主题下准备中和未填充区域的文字恢复可读。
• 任务产物自动刷新后，“选择导出”、多选和“导出此节点下的音频”恢复正常，无需切换页面或重新选择实体。
• 保留实体预览的异步加载和缓存，不增加界面线程的数据读取。

本版包含已撤下的 v3.10.2 的音频导出修复，不改变配置、音频输出布局或内容库格式，无需重新解包。

v3.10.1

2026-09-23查看发行版 ↗

本版新增共享音频内容库与 Windows 独立 CLI 程序，完善资源检查、大厅音频和实体预览。

音频处理

• 相同 WEM 内容按 SHA-256 共享保存，可见音频目录使用硬链接，减少跨皮肤、实体和版本的重复占用。
• 转码复用输入内容与格式均匹配的已有 WAV，批量处理相同输入时减少重复转换。
• 英雄解包默认附带选人语音、禁用语音和选人音效；缺少缓存时从本地客户端补齐，可用 --no-lobby-audio 关闭。
• 执行前检查所选资源、语言和工具可用性，提供分阶段诊断与独立工具自检。

使用体验

• 同时提供 GUI 与 CLI 两份 Windows x64 单文件程序、各自 SHA256 校验文件及 CLI 使用说明。
• 改善实体预览加载和缓存复用，减少切换闪屏与重复扫描。
• 完善任务进度、耗时、结果详情和失败恢复的展示。

升级说明

• 应用只读取本地客户端或外部准备的等价目录，不提供客户端下载或远端回退。
• 首次打开既有输出时会归档旧 WEM 并建立内容索引；原有 OGG、WAV 保留。移动或备份时请同时保留整个输出目录。
• 可见 WEM 与内容库共享底层文件，需要编辑音频时请先导出独立副本；输出盘必须支持硬链接。
• 内部结构化数据统一保存为 MessagePack，离线 JSON/YAML 转换可使用 scripts/convert_data.py。
• 旧 INI 大厅音频配置会自动迁移为 lobby_audio；旧 CLI 参数会提示新用法，Python 调用方需同步字段与模块名称。
• 特殊内容是否具有大厅语音取决于客户端实际资源，缺失时会提示，不会使用其他英雄或语言的音频替代。

发布修正

• 修复非中文 Windows 环境中 CLI 重定向中文帮助或诊断时的编码失败。
• v3.10.0 在发布自检阶段中止，未上传正式附件；本版包含其全部功能与该修复。

v3.9.2

2026-09-11查看发行版 ↗

v3.9.2 优化了新手引导，用更简短的说明帮助用户设置游戏目录、认识常用页面并开始提取音频。

使用体验

• 精简基础引导，直接说明页面用途与操作步骤，减少内部术语和重复跳转。
• 说明工具路径无需填写、提前准备数据通常无需开启，以及试听和挑选导出时无需勾选音频转码的原因。
• 执行中心补充手动填写英雄 ID 的说明；总览介绍同步当前的试听与选择导出入口。
• 引导结束时回到执行中心，显示“可以开始使用了”。

升级说明

• 沿用现有配置和引导完成状态。已完成或跳过引导的用户，可在“全局设置 → 重置引导”后重启查看。
• 本版提供 Windows x64 GUI 单文件程序及 SHA256 校验文件。