🎵 MusicMate 音乐管家
标签编码修复
修复 ID3/FLAC 标签乱码（GBK/Big5 字节被误读为 Latin-1，如 ÖܽÜÂ× → 周杰伦）。先预览，确认后应用，可随时回滚。
| 文件 | 字段 | 原值 | 修复后 |
|---|
批量标签编辑
修改标签字段（留空表示不改）、从文件名补全缺失字段、嵌入/删除封面、自动补全缺失标签。每步先预览，确认后应用，均可回滚。
下方「手动编辑 / 封面 / 自动补全」均作用于该目录。
| 文件 | 字段 | 原值 | 新值 |
|---|
重复文件扫描
SHA-256 精确去重 + Chromaprint 音频指纹识别同曲不同码率/格式，按音质评分标注建议保留的版本。扫描大库可能需要几分钟。
按标签整理目录
按标签把音乐重排为 {专辑艺术家}/{专辑}/{音轨} {标题}.{扩展名} 结构。先预览，确认后执行（可移动或复制），可回滚。
| 原位置 | 整理后 |
|---|
生成播放列表
为每个包含音频的目录生成 <目录名>.m3u8（UTF-8、相对路径），适合整理后重建每张专辑的播放列表。已存在的会被覆盖重新生成。
| 目录 | 播放列表 | 曲目数 | 状态 |
|---|
文件头修复
部分下载工具在失败重试时会把 JSON 错误响应写进文件头，导致文件开头有多余字节：PotPlayer 等播放器能跳过播放，但 MusicMate 无法读取标签。此功能将剥离垃圾头，恢复文件为标准音频（随后即可正常整理/编辑标签）。修复前会自动备份原始字节，可回滚。
| 文件 | 格式 | 垃圾头偏移 | 大小 | 状态 |
|---|
📝 一键歌词
批量检索并写入内嵌歌词（LRCLIB，免费免 KEY）：扫描目录下没有歌词的歌曲，逐首在线检索，命中后勾选写入（合并备份清单，可整批回滚）。带时间戳的同步歌词支持播放时逐行高亮。
🚀 一键整理
懒人模式：按默认流程自动完成大部分工作 —— 文件修复 → 编码修复 → 标签编辑 → 去重清理 → 整理。每步可独立勾选；执行前必须两步确认（涉及改写标签、移动文件、移入回收站，全部可回滚）。
设置
外部服务配置（保存在本机 config.conf，权限已收紧为仅限本机读取，KEY 由用户自备、不回显）。标签补全默认以 iTunes 为主（免费免 KEY、速度快、华语覆盖好），MusicBrainz 作为兜底；AI 补全为可选增强，未配置时对应功能隐藏。
浏览器直连需要访问令牌；经飞牛桌面/网关访问无需填写。令牌保存在浏览器本地（localStorage），不会上传。
以音频内容识别歌曲，纠正错误标签。三路识别模块可按需配置并勾选启用（按勾选顺序依次尝试，命中即停）：AcoustID（免费非商业，需在 acoustid.org 注册应用 KEY）、ShazamIO（逆向 Shazam API，免费免 KEY，安装应用时自动安装）、ACRCloud（注册后 14 天试用，需配置 Host/Access Key/Access Secret）。至少配置并勾选一个模块后，单曲编辑的「听歌识曲」按钮才可用。
「整理」与「单曲编辑」按目录模板重排文件位置。预设模板可直接选用，也可自定义保存（存本机应用数据目录，各端共享）。