扫描、刷新和整理资料库

前提

• 已添加至少一个音乐源，并在 扫描目录 中选择了目录（连接后选择要扫描音乐文件的目录）。见 添加和管理音乐源：类型总览、入口与日常操作。
• 需要验证码的来源要先完成登录，否则会提示「请先连接（需要验证码）」。

首次扫描和后续刷新

• 首次扫描：完整遍历所选目录，建立歌曲索引。扫描时显示「正在扫描音乐文件...」，可以离开此页继续使用，扫描会在后台进行
• 后续刷新：只要来源支持，Primuse 会只读取上次之后的变化，比完整遍历快得多。
• 深度扫描：在 音乐源管理 中长按来源选择「深度扫描」，会重新完整遍历目录。适合怀疑漏歌、改过大量文件或目录结构时使用。
• 只想刷新一个文件夹时，在资料库的目录视图中对文件夹选择「重新扫描此文件夹」。

媒体服务器在自己扫描曲库时，Primuse 会显示「服务器正在扫描曲库，完成后自动继续...」，等它完成后自动继续。

扫描后歌曲变少了

如果一次扫描比上次少了很多歌，Primuse 不会立刻删除，而是提示：「这次扫描比上次少了 N 首歌，可能是硬盘或共享文件夹暂时没挂上。为防误删先保留，再完整扫描 M 次仍然不在才会移除。」。这样可以避免硬盘或共享文件夹临时没挂载时误删资料库。确认文件确实已删除后，多扫描几次就会移除。

歌曲详情的加载

云盘扫描时先读取文件名，歌手、专辑、封面和时长在后台分批补全。相关选项在 设置 › 存储管理：

选项	作用
仅在 Wi-Fi 下加载云盘详情	扫描云盘时只读取文件名，详情（歌手/专辑/封面/时长）会在后台分批加载。一首歌大约消耗 256KB 流量。开启此项后，遇到蜂窝网络会自动暂停，连上 Wi-Fi 自动继续。
长任务完成时通知我	你发起的扫描、标签读取和刮削在后台完成时提醒你。扫描失败、iCloud 空间已满这类需要你处理的问题不受此开关影响；App 在前台时不会发通知。

标签读取默认较温和。如果设备和服务器能承受，可以开启「高性能读取标签」：默认关闭，以单线程小批次温和读取标签。开启后，前台扫描最多使用 3 路并发且不做请求节流，可能增加发热、耗电、网络流量和界面卡顿。

重复歌曲

设置 › 重复歌曲：按标题 + 艺术家 + 时长±1s 分组,标记最高音质版本为推荐保留。清理重复项只删冗余音频；同名歌词/封面仍被保留版本使用时不会删除。

• 每组标记「推荐」的版本为建议保留。
• 可选择「保留最佳」「保留最高码率」「保留最大文件」「保留最新加入」，或用「一键智能保留 (删除所有冗余)」一次处理全部。
• 清理前会确认数量。是否会删除来源中的原始文件，请先阅读下方相关问答。

艺术家名称

设置 › 艺术家名称 可设置「拆分分隔符」（把「A / B」拆成两位艺术家）、「受保护的艺术家名」（名字本身含分隔符时不拆分）和「展示连接符」。

资料库分类和显示

设置 › 资料库显示 › 资料库分类：拖动调整顺序；分类的显示、隐藏和顺序同时应用于资料库、侧栏与极简模式标签。 也可以开启「默认平铺显示歌曲」。

最近删除

删除的歌单、音乐源和刮削配置会进入 最近删除：歌单、音乐源和刮削配置删除后会在此保留 30 天。

相关文章

• 资料库里少了歌曲或找不到某首歌怎么办
• 补全歌曲信息、封面和歌词：刮削与标签整理
• 音乐源连不上、登录失败或扫描不到歌曲怎么办
• 相关问答：「清理重复歌曲会删除源文件，还是只从本机移除？」、「“重复歌曲”按什么判断？不同专辑里的同一首会算重复吗？」、「多个歌手没有拆开，或者乐队名被拆错，怎么办？」、「目录明明有很多文件，为什么扫描出来的歌曲数更少？」、「切到后台后扫描暂停，音乐还在播为什么也不能一直扫描？」、「WebDAV 新增歌曲后，怎么自动刷新曲库？」、「Emby 或 Navidrome 新增歌曲后，需要每次手动扫描吗？」