QM Unlock 2.2.0

⚠️ 升级须知（macOS 用户必读）

发布包使用 ad-hoc 签名，每个版本的签名都不同，旧版本的「完全磁盘访问权限」授权在更新后会失效：列表里的开关看起来仍是打开的，但已经不起作用，自动获取 ekey 会失败。更新到 2.2.0 后请：

1. 打开「系统设置 → 隐私与安全性 → 完全磁盘访问权限」。
2. 在列表中选中旧的 QM Unlock，点击左下角 − 删除。
3. 点击 +，重新选择「应用程序」中的 QM Unlock.app，打开右侧开关。
4. 退出并重新打开 QM Unlock。

新功能

• 监听下载目录：选择 QQ 音乐的下载文件夹后，新下载或变更的文件在连续两次检查大小不变后自动加入队列并处理；输出写到独立目录（默认为下载目录下的「QM Unlock 输出」），产物不会被重复处理。
• 跳过已转换文件（默认开启）：按本机处理记录和输出是否存在跳过重复文件，结果显示「已跳过」，可在侧栏关闭以强制重做，也可一键清除处理记录。
• 输出命名模板：内置 5 种预设；选「自定义…」后可点按钮插入标签，实时预览示例文件名，写错会即时提示，无效模板无法开始处理。可用标签：
  {artist} 歌手、{title} 歌名、{album} 专辑、{albumartist} 专辑艺人、{year} 年份、{disc} 碟号、{track} 曲序、{filename} 原文件名，/ 创建子目录。缺失字段自动回退，命名始终生成副本、不改动源文件。
• 打开输出目录：输出卡片里新增按钮，一键在文件管理器中打开；未指定输出目录时打开最近一次产物所在的文件夹。
• 目录偏好会保留（不保存 ekey 或登录信息）。

改进与修复

• 监听大文件夹不再卡死：监听只扫描 2 层子目录、2000 个条目，跳过隐藏目录和 Library、node_modules、*.app 等系统目录，磁盘根目录和用户主目录会被直接拒绝。超限时提示「目录过大」并自动停止监听，请选择具体的下载文件夹。
• 移除了顶栏没有实际用途的「设置」按钮。
• 修复「自定义」命名选项选中后立刻跳回预设、无法输入的问题。
• 监听过程中遇到临时的目录读取错误会继续重试；文件成功入队后才确认，不会丢失或重复；未下载完整的加密文件会继续等待，不提前报错。
• 命名模板的文件名按 UTF-8 字节截断且不会切断字符；仅含加密文件的批次开始前会检查登录凭据。

隐私说明

处理记录包含输入、输出的完整路径，仅保存在本机应用数据目录，最多 10,000 条。命名所需的歌曲信息、封面和歌词会向 QQ 音乐服务发起请求，音频文件本身不会上传。

下载

• macOS Apple 芯片（M1–M6）：aarch64 / arm64 DMG
• macOS Intel：x64 DMG
• Windows x64：.exe 或 .msi

完整变更见 CHANGELOG。

Full Changelog: v2.1.0...v2.2.0

v2.1.0

⚠️ 升级须知（macOS 用户必读）

发布包使用 ad-hoc 签名，每个版本的签名都不同，旧版本的「完全磁盘访问权限」授权在更新后会失效：列表里的开关看起来仍是打开的，但已经不起作用，自动获取 ekey 会失败。更新到 2.1.0 后请：

1. 打开「系统设置 → 隐私与安全性 → 完全磁盘访问权限」。
2. 在列表中选中旧的 QM Unlock，点击左下角 − 删除。
3. 点击 +，重新选择「应用程序」中的 QM Unlock.app，打开右侧开关。
4. 退出并重新打开 QM Unlock。

修复

• 转出的 MP3 在约 2 秒处跳音（#11）：桌面端解密在偏移 0x7fff 处错了一个字节，导致该处的 Ogg 页校验失败、被 FFmpeg 丢弃。现已修正，与 Python 版行为一致。
• OGG 转 MP3 后歌名、歌手丢失：Ogg Vorbis 的标签挂在音轨上，FFmpeg 默认不复制。现在会一并带入 MP3 的 ID3 标签，曲库匹配也更准确。加密 .mgg 转 MP3 同样受益。
• FFmpeg 转码失败时不再留下写了一半的 MP3 文件。

新功能

• 未加密的 OGG 也能转 MP3（#11）：QQ 音乐直接下载的 .ogg（以及未加密的 .flac、.m4a）选择 MP3 后会直接转换，并写入封面、歌词和标签。
  • 转出的 MP3 总是新文件，写到输出目录（未选择时为源文件目录），重名时自动命名为 歌名 (1).mp3，原文件不动。
  • .mp3 源文件不会重复转码，只补全信息。
  • .opus、.wav 暂不支持转 MP3（内置 FFmpeg 不含其解码器），可选「原格式」只补封面和歌词。
• 一个队列，自动识别：去掉了「加密 / 普通」两个标签页。加密和未加密文件可以一起拖进来，共用「原格式 / MP3」选项，应用按文件内容自动处理：未加密的直接转换并补全信息，加密的先解密再做同样的事。
  • 只有队列里全是加密文件时，缺少 ekey 才会阻止开始；混合队列中未加密文件照常处理。
  • 扩展名是 .mgg / .mflac 但实际没有加密的文件，会按真实格式（如 .ogg）另存后处理。
• 转换成功但没匹配到 QQ 音乐曲库时，只记一条备注，不再把整个任务判为失败。

下载

• macOS Apple 芯片（M1–M6）：aarch64 / arm64 DMG
• macOS Intel：x64 DMG
• Windows x64：.exe 或 .msi

完整变更见 CHANGELOG。

v2.0.0

What's Changed

• feat: plain-audio enhancement channel and headless styled DMG packaging by @AllenCheng329 in #10

New Contributors

• @AllenCheng329 made their first contribution in #10

Full Changelog: v1.0.0...v2.0.0

v1.0.0

Full Changelog: v0.1.0...v1.0.0

v0.1.0

Full Changelog: https://github.com/fjd2004711/qmunlock/commits/v0.1.0