NAS Music Cleaner 🎵

纯终端命令的音乐去重工具，专为飞牛 NAS 等 Linux 环境设计。零依赖、无需安装 Python / FFmpeg，SSH 连上去两条命令直接搞定。

开源地址：https://github.com/liudali333/music-cleaner

✨ 特点

• 🚫 零依赖：只用到 find、sed、sort、uniq、mv、rm，系统自带
• ⚡ 极简：两条命令，复制粘贴即可运行
• 🧹 去序号：自动清除文件名开头的 001. 02- 026. 等编号
• 🗑️ 去重复：同歌名只保留一份，其余直接清理

📋 适用场景

• 飞牛 NAS / 群晖 / 威联通 / 任何 Linux 服务器
• 从网盘、BT 下载了几十 T 音乐资源，不知道有多少重复
• 文件名有歌名但带了一堆编号、码率标注等杂质

⚠️ 重要提醒

本工具直接删除文件，没有回收站！

强烈建议在执行前先备份你的音乐目录：

cp -r /vol1/1000/music /vol1/1000/music_bak

确认清理结果无误后再删除备份。

🚀 使用方法

将下方命令中的 /vol1/1000/music 替换为你的实际音乐目录路径。

🧠 去重规则

同一首歌出现多个文件时：
  1️⃣  有无损 (FLAC/APE/WAV) → 留体积最大的无损
  2️⃣  全是有损 (MP3/AAC/M4A) → 用 ffprobe 读真实码率，留最高的
  3️⃣  唯一文件 → 不动

🎯 文件名清洗规则

📁 推荐目录结构

music/
**── 华语流行/
**   **── 2000s/      ← 欢子、许嵩、**、六哲
**   **── 2010s/
**── 抖音热歌/
**── 无损合集/
**── incoming/       ← 新下载的先放这里，定期跑脚本清理

⚠️ 注意事项

1. 先跑 --dry-run 预览，确认无误再正式执行
2. 建议加 --trash 把删除的文件移到回收站，确认没问题再手动清空
3. DJ版/伴奏版/Remix 目前会被视为与原唱同一首歌而删除，如需保留请提 Issue
4. 文件名中完全没有歌名信息的文件（如 track01.mp3）无法正确匹配，建议手动处理

🗺️ Roadmap

• 支持 MusicBrainz AcoustID 声纹识别（终极去重方案）
• 支持更多音频格式（opus、tta、tak）
• Docker 镜像一键部署
• Web UI 界面（飞牛 Docker 友好）
• 自动补全 ID3 标签（集成 Beets）
• 支持按「播放次数」筛出从未听过的歌

📜 License

MIT License — 随便用、随便改、随便商用。

🙏 致谢

• 飞牛 NAS 社区
• 所有和我一样 NAS 里堆了几万首歌的 90 后

⭐ 如果这个脚本帮你清出了几十 G 空间，请给个 Star！