媒體庫資料夾

設定

告訴 HolyArrs 你完成的電影、影集和音樂放在哪裡。

你需要 Change settings（變更設定）權限。首次執行的設定會新增一個資料夾；其餘的在這裡新增。

開始之前

資料夾已經存在，而且 HolyArrs 可以寫入。
在 Docker 中，你要知道 container 內的路徑，例如 /movies。主機上的路徑無法使用。

新增資料夾

開啟 Settings > Library folders（設定 > 媒體庫資料夾）。
按下 Add a folder（新增資料夾）。Add a Library folder 卡片會開啟。
在 Holds（存放內容）下選擇 Movies（電影）、Shows（影集）或 Music（音樂）。
在 Folder path（資料夾路徑）輸入 HolyArrs 看到的完整路徑。
輸入 Name（名稱），或留空，改用路徑的最後一段，例如 movies。
按下 Add（新增）。你應該會在對應的群組中看到這個資料夾，並顯示可用空間和健康狀態。

檢查會告訴你什麼

檢查會確認資料夾存在、寫入並移除一個小的測試檔案、從每個啟用中的下載器資料夾嘗試建立硬連結（hardlink），並確認至少有 100 MB 的可用空間。每一列上的重新整理按鈕會再執行一次。

hardlink 是同一個磁碟上同一個檔案的第二個名稱。它立刻完成，而且不佔額外空間。

顯示的狀態	意思	匯入
Healthy（健康）	所有檢查都通過	立刻搬移
Folder not found（找不到資料夾）或 Cannot write here（無法在這裡寫入）	資料夾不見了，或無法寫入	停止，直到你修復為止
Works, but files are copied (no hardlinks)（可以運作，但檔案是複製的，沒有 hardlink）	下載位於另一個磁碟或掛載上	可以運作，但會複製檔案：比較慢，而且在下載器刪除它的那份之前會佔雙倍空間

可用空間低於 100 MB 時，會多一則空間不足的附註。在磁碟寫滿之前，匯入都還能運作。

重新命名或移除資料夾

Rename（重新命名）會變更你看到的名稱。磁碟上不會有任何東西移動。

垃圾桶按鈕會把資料夾從 HolyArrs 移除，所有檔案都留在原處。只要媒體庫裡還有作品使用這個資料夾，HolyArrs 就會拒絕。請先移動那些作品。你已從媒體庫刪除的作品不算，它們會留在歷史記錄裡。

如果資料夾裡已刪除的檔案還能從 Recently deleted（最近刪除）還原，HolyArrs 也會保留這個資料夾。等它們的保留天數過了再移除，或是在磁碟上刪除它的 .holyarrs-replaced 資料夾。如果資料夾已經從磁碟上消失，就沒有東西可以還原，所以只要媒體庫裡沒有作品使用它，就一定可以移除。

如果沒有成功

症狀： 狀態顯示檔案是用複製的（沒有 hardlink）。 原因： 下載和媒體位於不同的掛載上。 解決方式： 掛載一個同時包含兩者的共用上層資料夾，並且在每個 container 中使用相同的路徑。

症狀： 匯入顯示不允許這個路徑。 原因： 這個路徑不在任何允許的位置內（請看下方的 Extra import folders）。訊息會列出允許的位置。含有 .. 的路徑、\\server\share 這類網路共用資料夾，以及指向外部的連結或 junction，也一樣會被拒絕。

症狀： 匯入看不到下載資料夾。 原因： 沒有設定 HOLYARRS_SAVE_PATH，而且沒有下載器設定路徑對應。 解決方式： 設定 HOLYARRS_SAVE_PATH，或是把下載資料夾，例如 /downloads，加到 Extra import folders（額外的匯入資料夾）下。

症狀： 無法移除資料夾。 解決方式： 先把它的作品移到另一個資料夾。如果訊息說已刪除的檔案還能還原，就等它們的保留天數過了，或是在磁碟上刪除那個資料夾的 .holyarrs-replaced 資料夾。如果有外部清單會加入作品到這個資料夾，請把那份清單指向另一個資料夾。

給進階使用者

資料夾規則

媒體庫資料夾必須存在、必須是資料夾、必須是完整路徑、必須可寫入，而且不能位於另一個媒體庫資料夾之內或包住它。每一種類型（Movies、Shows、Music）使用自己的資料夾。

額外的匯入資料夾

Library > Import files by hand（媒體庫 > 手動匯入檔案）只會在下列位置內讀取、複製和移動檔案：

你的媒體庫資料夾，
你的下載器儲存檔案的資料夾（以 HolyArrs 看到的路徑為準）：HOLYARRS_SAVE_PATH，以及每個下載器路徑對應中屬於 HolyArrs 的那一邊，
Settings > Library folders 上的 Extra import folders。

每行輸入一個完整路徑，例如 /imports 或 D:\Imports。最多 32 個。/ 或 C:\ 這種整顆磁碟會被拒絕。

只有擁有者，或是以密碼登入的管理員，才能變更這份清單。API 金鑰還需要 admin 範圍。其他人會看到 Owner and admins only（僅限擁有者和管理員）。