AetherGate v0.13.0 更新日志

⚠️ 重要：此版本为全量更新，包含米哈游音乐模块的架构级改造与多项关键修复，请所有用户升级！

本次更新主要围绕 米哈游音乐模块 展开：鉴权体系从 Bearer Token 迁移到 PHP Session Cookie（与服务端最新 API 对齐）、修复歌曲封面不显示、修复退出后进程残留等问题。同时对侧边栏音乐图标进行了更新。正在使用 v0.12.x 的用户请升级至 v0.13.0 以获得完整的音乐播放体验。

✨ 新功能

🎵 米哈游音乐

鉴权体系全面适配服务端最新 API（2026-09-07 版），与 Web 前端共用会话。

• Session Cookie 自动管理：登录后服务端下发的 PHPSESSID 由 CookieContainer 自动持有并随请求携带，无需手动附加 Authorization 头
• 跨重启会话恢复：登录成功后将 Session Cookie 序列化持久化到本地配置，下次启动时自动恢复并调用 auth/user 验证登录态
• 会话失效检测：服务端返回 1003（未登录）/ 1005（凭据无效）时清除本地会话并提示重新登录；网络抖动 / 5xx / 限流等瞬时错误不会误判为掉线

🔧 功能调整

🎵 米哈游音乐：模型与接口对齐最新 API

根据服务端最新 API 文档对数据模型与接口调用进行全面对齐。

• MusicSource 模型补齐：新增 id、priority、supportedQualities、isEnabled 字段，与 /app-config 接口返回结构一致
• SongListResponse 增加 playlist 字段：歌单详情接口返回的歌单元数据（名称、封面等）现可正确接收
• UpdatePlaylistAsync 精简：请求体移除不支持的 description 字段，仅保留 name 与 is_public
• 专辑排序参数修正：首页"最新专辑"的 sort 参数从无效的 publish_date 修正为文档合法值 latest，确保专辑按发布时间倒序排列

🎨 侧边栏图标更新

• 主导航中“USM导出”、“MBTI”、"米哈游音乐" 的图标，功能语义更贴合。

🐛 Bug 修复

🔴 程序退出后进程残留挂起

修复关闭程序后，任务管理器中仍残留 AetherGate.exe 进程，导致无法重新编译或启动的问题。

• 根因：MihoyoMusicPlayer 启用了 SystemMediaTransportControls（SMTC），退出时未调用 Dispose()，其持有的前台线程 / COM 对象阻止进程终止；SystemTrayWindow 拦截了自身 Closing 事件导致窗口无法真正关闭
• 修复：
  • App.Exit() 中调用 MihoyoMusicPlayer.Dispose() 释放播放器与 SMTC
  • SystemTrayWindow 新增 ForceClose() 方法，退出流程中先解除 Closing 拦截再关闭窗口
  • 释放 _gcTimer（GC 定时器）
  • 兜底调用 Environment.Exit(0) 确保进程一定终止

📦 安装与升级

• 下载地址：https://www.aethergate.cn
• 安装方式：本次为全量更新，请下载完整安装包 AetherGate.Setup.exe 重新安装；已安装旧版本直接更新安装即可
• 系统要求：Windows 10 1809（17763）及以上版本
• 迁移说明：
  • 无数据库迁移

💡 v0.13.0 是一次以米哈游音乐模块改造为核心的全量更新。如遇任何异常，欢迎通过「反馈问题」渠道提交日志以便快速定位。