Hoyo-MiX v0.1.4 更新日志

🎈 v0.1.4 体验优化版本发布！

本版本聚焦首次启动体验与新手上手：带来全新设计的沉浸式欢迎窗口，并首次内置交互式使用手册；同时补齐了下载任务重启续传、播放记录自动清理等链路细节，并修复在线更新过程中安装包被占用导致更新失败、下载进度不显示等问题。v0.1.0 用户可直接通过差量更新升级，仅下载发生变化的文件。

✨ 新增内容

📖 内置交互式使用手册

• 随包分发：使用手册随程序一同安装到安装目录的 Help 文件夹（HoyoMix.html），双击即可用浏览器打开，无需联网
• 13 个章节：覆盖软件简介、安装与首次启动、主界面导览、首页与专辑、歌单与收藏、搜索音乐、本地音乐、播放记录、下载管理、播放控制、登录与账号、设置与数据目录、常见问题
• 界面模拟演示：手册内嵌高保真界面演示，下载、设置、欢迎选目录等流程均可在页面内交互预览，帮助新用户快速上手

🪟 全新首次启动欢迎窗口

• 沉浸式视觉：全幅暗色背景图配合由深到浅的渐变压暗遮罩，背景延伸进自定义标题栏，整体更具氛围感
• 左对齐排版：标题、说明、数据目录与注意事项统一左侧 48px 边距、640px 内容栏，视觉节奏对标 AetherGate
• 高 DPI 自适应：固定 1200×676 逻辑尺寸，按显示器 DPI 缩放物理像素，修复 150% 等缩放下窗口显示偏小的问题
• 小屏友好：屏幕工作区不足以完整显示时，窗口自动等比收缩并保持屏幕居中

🔧 优化与修复

⬇️ 下载与数据

• 重启自动续传：补齐启动恢复链路——上次退出时正在下载、异常中断或失败的任务，下次启动自动重新排队并从断点续传；.part 残片与记录不一致时自动丢弃重下，最终文件已存在则直接标记完成
• 退出收尾一致化：从系统托盘退出时与关闭主窗口执行相同的收尾流程（下载任务落盘为排队状态、保存播放进度、刷回数据库），杜绝任务状态丢失
• 托盘状态提示：托盘提示同步下载状态变化，下载完成或失败时弹出气泡通知

🕘 播放记录

• 自动清理上线：启动时自动裁剪本地播放流水——默认清除 90 天前的记录（可在「播放记录」页开关），并强制保留上限 10000 条，防止数据库无限膨胀

💾 数据目录

• 默认目录调整：全新安装的默认用户数据目录由 %LocalAppData%\HoyoMix 调整为「我的文档\Hoyo-MiX」，更便于用户查找与备份；已安装用户继续沿用注册表中记录的原目录，升级不受影响

🔄 在线更新

• 修复重复更新报错：修复上一次更新启动的安装程序仍在运行时，再次点击「立即更新」会因临时安装包被系统占用而弹出英文错误的问题；现在会先检测安装程序状态并给出中文提示，引导用户先完成或关闭已打开的安装窗口
• 修复下载进度不显示：修复更新窗口中进度条与已下载大小始终不可见的问题（进度容器被折叠所致），下载期间实时展示进度条、百分比与已下载/总大小
• 新增下载速度显示：进度区实时显示下载速度（自动 B/KB/MB 单位换算并做平滑处理）；服务器未返回文件大小时进度条切换为不确定动画，仍可查看已下载量与速度
• 安装包临时文件隔离：下载的安装包按目标版本命名（如 HoyoMix.Setup_0.1.1.exe），不再与残留的旧版安装映像共用同一文件名，并在每次下载前自动清理历次更新遗留的安装包

🛠 发布链路

• 修复构建工具启用 MSIX 资源工具链，确保 HoyoMix.pri 资源包正确随发布产物输出
• 修复差量更新包生成工具链的文件占用与清单格式问题，v0.1.0 → v0.1.1 差量包可正常生成与校验，本次更新即通过差量方式推送

🔄 升级说明

• v0.1.0 用户：启动主程序后自动收到更新提示，本次为差量更新，仅下载 8 个发生变化的文件，更快更省流量
• 其他来源：如未收到提示，可前往下载页获取完整安装包覆盖安装，本地数据与设置不受影响
• 系统要求与运行环境与 v0.1.0 一致：Windows 10 2004（19041）及以上版本，x64；运行时与 WebView2 引导均已随安装包提供

💡 如更新过程中遇到异常，可通过「设置 → 打开日志目录」获取运行日志并通过反馈渠道提交。