Overview
前提
- 已新增至少一個音樂來源，並在 掃描目錄 中選擇了目錄（連線後選擇要掃描音樂檔案的目錄）。見 新增和管理音樂來源：類型總覽、入口與日常操作。
- 需要驗證碼的來源要先完成登入，否則會提示「請先連線（需要驗證碼）」。
首次掃描和後續重新整理
- 首次掃描：完整遍歷所選目錄，建立歌曲索引。掃描時顯示「正在掃描音樂檔案...」，可以離開此頁繼續使用，掃描會在背景進行
- 後續重新整理：只要來源支援，Primuse 會只讀取上次之後的變化，比完整遍歷快得多。
- 深度掃描：在 音樂來源管理 中長按來源選擇「深度掃描」，會重新完整遍歷目錄。適合懷疑漏歌、改過大量檔案或目錄結構時使用。
- 只想重新整理一個資料夾時，在資料庫的目錄檢視中對資料夾選擇「重新掃描此資料夾」。
媒體伺服器在自己掃描資料庫時，Primuse 會顯示「伺服器正在掃描曲庫，完成後自動繼續...」，等它完成後自動繼續。
掃描後歌曲變少了
如果一次掃描比上次少了很多歌，Primuse 不會立刻刪除，而是提示：「這次掃描比上次少了 N 首歌，可能是硬碟或共享資料夾暫時沒掛上。為防誤刪先保留，再完整掃描 M 次仍然不在才會移除。」。這樣可以避免硬碟或共享資料夾臨時沒掛載時誤刪資料庫。確認檔案確實已刪除後，多掃描幾次就會移除。
歌曲詳情的載入
雲端硬碟掃描時先讀取檔名，歌手、專輯、封面和時長在背景分批補全。相關選項在 設定 › 儲存空間管理：
| 選項 | 作用 |
|---|---|
| 僅在 Wi-Fi 下載入雲端硬碟詳情 | 掃描雲端硬碟時只讀取檔名，詳情（歌手/專輯/封面/時長）會在背景分批載入。一首歌大約消耗 256KB 流量。開啟此項後，遇到行動網路會自動暫停，連上 Wi-Fi 自動繼續。 |
| 長任務完成時通知我 | 你發起的掃描、標籤讀取和刮削在背景完成時提醒你。掃描失敗、iCloud 空間已滿這類需要你處理的問題不受此開關影響；App 在前景時不會發通知。 |
標籤讀取預設較溫和。如果裝置和伺服器能承受，可以開啟「高效能讀取標籤」：預設關閉，以單執行緒小批次溫和讀取標籤。開啟後，前景掃描最多使用 3 路並行且不限制請求間隔，可能增加發熱、耗電、網路流量與介面卡頓。
重複歌曲
設定 › 重複歌曲：按標題 + 演出者 + 時長±1s 分組,標記最高音質版本為推薦保留。清理重複項只刪冗餘音訊；同名歌詞/封面仍被保留版本使用時不會刪除。
- 每組標記「推薦」的版本為建議保留。
- 可選擇「保留最佳」「保留最高位元率」「保留最大檔案」「保留最新加入」，或用「一鍵智慧保留 (刪除所有冗餘)」一次處理全部。
- 清理前會確認數量。是否會刪除來源中的原始檔案，請先閱讀下方相關問答。
演出者名稱
設定 › 藝人名稱 可設定「拆分分隔符」（把「A / B」拆成兩位演出者）、「受保護的藝人名稱」（名字本身含分隔符時不拆分）和「顯示連接符」。
資料庫分類和顯示
設定 › 資料庫顯示 › 資料庫分類：拖移以調整順序；分類的顯示、隱藏與順序會同步套用至資料庫、側邊欄及極簡模式標籤。 也可以開啟「預設平鋪顯示歌曲」。
最近刪除
刪除的播放清單、音樂來源和刮削設定會進入 最近刪除：歌單、音樂來源和刮削設定刪除後會在此保留 30 天。
相關文章
- 資料庫裡少了歌曲或找不到某首歌怎麼辦
- 補全歌曲資訊、封面和歌詞：刮削與標籤整理
- 音樂來源連不上、登入失敗或掃描不到歌曲怎麼辦
- 相關問答：「清理重複歌曲會刪除原始檔，還是只從本機移除？」、「“重複歌曲”按什麼判斷？不同專輯裡的同一首會算重複嗎？」、「多個歌手沒有拆開，或者樂隊名被拆錯，怎麼辦？」、「目錄明明有很多檔案，為什麼掃描出來的歌曲數更少？」、「切到背景後掃描暫停，音樂還在播為什麼也不能一直掃描？」、「WebDAV 新增歌曲後，怎麼自動重新整理資料庫？」、「Emby 或 Navidrome 新增歌曲後，需要每次手動掃描嗎？」