40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
# AM Music Deduper
|
|
|
|
轻量级家庭 NAS 音乐库去重服务，面向 `AllMusic/{username}/` 场景。
|
|
|
|
## 设计目标
|
|
|
|
- 本地 SQLite 元数据库
|
|
- L1 极速候选：文件大小 + 头/尾 64 KiB hash
|
|
- Exact Duplicate 最终使用完整 SHA-256 确认
|
|
- L2 使用 Chromaprint 做音频相似度候选
|
|
- duration 预过滤，降低 CPU/I/O
|
|
- 同一版本才允许自动择优
|
|
- loser 进入 `.dedupe/trash/`，默认保留 30 天
|
|
- 不使用软链接；物理去重使用 hard link
|
|
- inotify 增量处理 + 低优先级全量 reconcile
|
|
- 任何不确定或异常默认保留原文件
|
|
|
|
## 当前阶段
|
|
|
|
第一阶段先完成安全的扫描、SQLite 索引、L1/Exact 去重、trash/quarantine 和测试。
|
|
L2 Chromaprint 比对与生产 NAS 监听在后续阶段接入。
|
|
|
|
## 安全原则
|
|
|
|
1. 不修改正在写入的文件。
|
|
2. L1 命中必须再做完整 SHA-256 才能判定 exact duplicate。
|
|
3. 不根据歌名/歌手/专辑单独判重。
|
|
4. 不同格式或音频规格不会因为 metadata 相似而直接合并。
|
|
5. 自动处理前保留可恢复路径；失败不删除原文件。
|
|
6. 数据库只是索引，文件系统才是最终事实。
|
|
|
|
## CLI 预期
|
|
|
|
```bash
|
|
am-deduper scan /music/AllMusic
|
|
am-deduper dedupe /music/AllMusic
|
|
am-deduper reconcile /music/AllMusic
|
|
am-deduper trash-prune /music/AllMusic --days 30
|
|
```
|