v0.1.5

v0.1.5 更新

• 新增 macOS Homebrew 安装渠道：可通过 brew install zsxink/tap/musictag 安装；Release 发布且 tap 同步成功后，可使用 brew upgrade --cask musictag 升级。
• 三端新增原生应用菜单（文件/编辑/视图/帮助），更新检查等操作可从「帮助」菜单使用。
• 更新检查新增节流：启动时距上次成功检查至少 7×24 小时才会自动检查；「帮助」菜单手动检查不受限。
• 发行前合规整改：许可统一为个人学习许可并与 EULA 一致，README 增加「外部 API 声明」数据披露，新增第三方归属清单 THIRD-PARTY-NOTICES.md，搜索与封面请求全部使用 HTTPS。

安装包与更新说明见 README；发现新版可通过应用内提示打开 Release 页面手动下载，应用不自动下载或安装更新。

v0.1.4

v0.1.4 更新

• 新增稳定版更新检查，可在启动时检查，也可从“帮助”菜单手动检查；“关于 MusicTag”展示当前版本和最近检查结果。发现新版后，用户可主动打开对应的 GitHub Release 页面查看详情。
• 推荐本地优先的跨平台音乐播放器 Echo，其发行版可在 Echo Releases 获取。
• 修复 PostCSS 间接依赖中的 nanoid 版本问题。

下载

请根据操作系统和处理器架构选择安装包：

• macOS Apple 芯片：aarch64.dmg
• macOS Intel：x64.dmg
• Windows：x64-setup.exe 或 x64_en-US.msi
• Linux：.AppImage、.deb 或 .rpm

v0.1.3

个人学习用途软件：禁止商用、禁止私自销售/转卖、禁止 AI 转写。详见 LICENSE 与 README。

本版新增与改进

• 导出内嵌封面原图（Issue #143）：可将音乐文件中的封面原图保存到磁盘，不重新压缩音频标签中的图片。
• 文件夹自动刷新（Issue #151）：监测当前文件夹内容变化并刷新歌曲列表，保留当前编辑状态。
• 修复搜索源并改善中英文歌曲匹配（Issue #153）：修复 QQ 搜索端点、iTunes 双店面召回和酷狗封面链接，并加入繁简归一化匹配。
• 修复 iTunes 部分超时结果丢失（Issue #156）：一个店面超时时仍保留已完成店面的候选。

平台安装包

• Windows：MusicTag_0.1.3_x64-setup.exe、MusicTag_0.1.3_x64_en-US.msi
• macOS：MusicTag_0.1.3_aarch64.dmg（Apple Silicon）、MusicTag_0.1.3_x64.dmg（Intel）
• Linux：MusicTag_0.1.3_amd64.deb、MusicTag_0.1.3_amd64.AppImage、MusicTag-0.1.3-1.x86_64.rpm

macOS 运行提示

macOS 版本未签名（个人开发者无 Apple Developer 证书），首次打开会触发 Gatekeeper 拦截。
请先移除隔离属性再运行：

xattr -cr /Applications/MusicTag.app

v0.1.2

个人学习用途软件：禁止商用、禁止私自销售/转卖、禁止 AI 转写。详见 LICENSE 与 README。

本版新增功能

• 支持 APE / WAV / M4A 三种格式（Issue #128）：文件夹遍历的音频识别从 FLAC / MP3 扩展到 .ape / .wav / .m4a（扩展名大小写不敏感），并补齐三种容器的标签读写映射——歌名、作者、专辑、专辑作者、音轨号、年份、流派、歌词、封面全字段往返。通用 .mp4 不纳入，避免把视频误列为音频。既有约束不变：一次一首、表单全量覆盖、原文件直接写回、坏标签只读、MP3 仍写 ID3v2.4
• 查漏筛选面板（Issue #121）：只读入口，按勾选的缺失维度（歌名 / 歌手 / 专辑 / 封面 / 歌词）多选，列出「缺其中至少一项」的歌曲，每行标注具体缺哪些字段。歌词维度判定为「无内嵌歌词且无同名 .lrc」，两者有其一不算缺。筛选只做展示，不批量编辑、不批量写盘，点进任何一首仍走现有单曲编辑流程
• 查漏筛选手动刷新（Issue #129）：筛选面板增加「刷新」按钮，目录新增文件后可手动重扫

本版本修复

• WAV 的 RIFF INFO 标签读不到（Issue #138）：此前 WAV 只读写 primary ID3v2 标签，实际很多 WAV 只带 RIFF INFO——这类文件打开时标签显示为空，保存后旧客户端仍看到旧值。现读取时字段级优先 ID3v2、缺失字段回退 RIFF INFO；保存时若原文件含 RIFF INFO 则同步其中可表示的文本字段，避免旧值残留

平台安装包

• Windows：MusicTag_0.1.2_x64-setup.exe（安装器）、MusicTag_0.1.2_x64_en-US.msi
• macOS：MusicTag_0.1.2_aarch64.dmg（Apple Silicon）、MusicTag_0.1.2_x64.dmg（Intel）
• Linux：MusicTag_0.1.2_amd64.deb、MusicTag_0.1.2_amd64.AppImage、MusicTag-0.1.2-1.x86_64.rpm

macOS 运行提示

macOS 版本未签名（个人开发者无 Apple Developer 证书），首次打开会触发 Gatekeeper 拦截。
请先移除隔离属性再运行：

# 移除 dmg 挂载/下载后附带的隔离属性（com.apple.quarantine）
xattr -cr /Applications/MusicTag.app

或将 dmg 解压后对 .app 执行 xattr -d com.apple.quarantine /Applications/MusicTag.app。
移除隔离属性后，右键「打开」或在系统设置「隐私与安全性」中允许即可运行。

v0.1.1

MusicTag v0.1.1 — V1 发布

个人学习用途软件：禁止商用、禁止私自销售/转卖、禁止 AI 转写。详见 LICENSE 与 README。

本版新增功能

• 多源候选展示（Issue #115）：候选列表同源去重、跨源不折叠——同一首歌各来源候选并排展示（带来源 badge），每源 TOP 3、来源分组排序（最多 15 条）。封面/歌词候选都能同时看到网易云 / QQ音乐 / 酷狗 / LRCLIB / iTunes 各家结果
• 搜索综合透传专辑（Issue #109）：五源搜索关键词与打分均纳入专辑字段——带专辑名（尤其整张专辑）搜索时匹配更精准，封面/歌词命中率提升

本版本修复

• 网易云封面搜索无结果（Issue #113）：封面 URL 由 http 升级为 https，修复 WKWebView 混合内容拦截导致的封面候选搜不出（如「安泊猜想」整张专辑）
• macOS aarch64 dmg 误报「已损坏」（Issue #111）：关闭 hardenedRuntime，消除 Gatekeeper 打开时的误报

平台安装包

• Windows：MusicTag_0.1.1_x64-setup.exe（安装器）、MusicTag_0.1.1_x64_en-US.msi
• macOS：MusicTag_0.1.1_aarch64.dmg（Apple Silicon）、MusicTag_0.1.1_x64.dmg（Intel）
• Linux：MusicTag_0.1.1_amd64.deb、MusicTag_0.1.1_amd64.AppImage、MusicTag-0.1.1-1.x86_64.rpm

macOS 运行提示

macOS 版本未签名（个人开发者无 Apple Developer 证书），首次打开会触发 Gatekeeper 拦截。
请先移除隔离属性再运行：

# 移除 dmg 挂载/下载后附带的隔离属性（com.apple.quarantine）
xattr -cr /Applications/MusicTag.app

或将 dmg 解压后对 .app 执行 xattr -d com.apple.quarantine /Applications/MusicTag.app。
移除隔离属性后，右键「打开」或在系统设置「隐私与安全性」中允许即可运行。

MusicTag v0.1.0

MusicTag v0.1.0 — V1 发布

个人学习用途软件：禁止商用、禁止私自销售/转卖、禁止 AI 转写。详见 LICENSE 与 README。

功能

• 一次一首补全本地 FLAC/MP3 元数据（歌名、作者、专辑、专辑作者、音轨号、年份、流派）
• 封面嵌入：点选 / 拖拽图片
• 歌词编辑：内嵌歌词 + 同时导出 .lrc
• 多源自动搜索（网易云 / QQ音乐 / 酷狗 / LRCLIB / iTunes），候选手动点选写入
• 记住上次打开目录
• 首次启动授权确认弹窗（同意才可使用）

本版本修复

• 编辑界面无法下拉看歌词框（.editor-slot flex 修复）
• 候选区折叠语义调整（切歌后默认展开）

平台安装包

• Windows：MusicTag_0.1.0_x64-setup.exe（安装器）、MusicTag_0.1.0_x64_en-US.msi
• macOS：MusicTag_0.1.0_aarch64.dmg（Apple Silicon）、MusicTag_0.1.0_x64.dmg（Intel）
• Linux：MusicTag_0.1.0_amd64.deb、MusicTag_0.1.0_amd64.AppImage、MusicTag-0.1.0-1.x86_64.rpm

macOS 运行提示

macOS 版本未签名（个人开发者无 Apple Developer 证书），首次打开会触发 Gatekeeper 拦截。
请先移除隔离属性再运行：

# 移除 dmg 挂载/下载后附带的隔离属性（com.apple.quarantine）
xattr -cr /Applications/MusicTag.app

或将 dmg 解压后对 .app 执行 xattr -d com.apple.quarantine /Applications/MusicTag.app。
移除隔离属性后，右键「打开」或在系统设置「隐私与安全性」中允许即可运行。