排程

設定

所有定時工作都在 Settings > Schedules（設定 > 排程）裡。

立即執行工作

找到那項工作所在的那一列。
按下 Run now（立即執行）。你應該會看到它的狀態變成 Queued（已排入佇列）。

下一次的定時執行時間不會改變。已經在等待或執行中的工作不會重複啟動，HolyArrs 會告訴你。

變更工作的執行頻率

在那一列按下 Change（變更）。這需要 Change settings（變更設定）權限。
在允許的範圍內選擇間隔並儲存。你應該會看到下一次執行時間變成現在加上新的間隔。

每一列會顯示什麼

這項工作做什麼，用一行說明。
多久執行一次、上次執行時間和失敗原因（如果有），以及下一次執行時間。
它的狀態：Waiting（等待中）、Queued（已排入佇列）、Running（執行中）、Turned off（已關閉）、Part is off（功能區塊已關閉）或 Safe mode（安全模式）。
一個連結，指向另一個也能設定它的設定頁面。

選項

預設範圍

工作	允許範圍	也可在此設定
Feed check（Feed 檢查）	10 分鐘到 2 小時	Settings > Search
Try Held releases again（重試保留中的發行版）	1 分鐘到 1 小時
Read Plex watchlists（讀取 Plex 待看清單）	3 分鐘到 1 小時	Settings > Request rules
Read Outside lists（讀取外部清單）	15 分鐘到 1 天，每次調整 5 分鐘
Health checks（健康檢查）	1 分鐘到 1 天	Settings > This app
Check Library folders（檢查媒體庫資料夾）	1 小時到 1 天
Find artist pictures（尋找藝人圖片）	1 小時到 7 天
Look for missing subtitles（尋找缺少的字幕）	1 小時到 7 天	Settings > Subtitles
Look for better subtitles（尋找更好的字幕）	6 小時到 7 天	Settings > Subtitles
Check Jackett（檢查 Jackett）	6 小時到 7 天	Settings > Sources
Refresh movie details（重新整理電影詳細資料）	6 小時到 7 天
Refresh show details（重新整理影集詳細資料）	6 小時到 7 天
Refresh artist details（重新整理藝人詳細資料）	6 小時到 7 天
Search for missing（搜尋缺少的作品）	6 小時到 7 天	Settings > Search
Rescan the Library（重新掃描媒體庫）	6 小時到 7 天
Clean the holding folder（清理保留資料夾）	6 小時到 7 天
Clean up History（清理歷史記錄）	6 小時到 7 天	Settings > This app

關閉排程

有兩個排程可以關閉：Refresh movie details 和 Rescan the Library，例如想讓 NAS 的磁碟休眠時。關閉的狀態在重新啟動後仍會保留，其他工作照常執行。

關閉項目	代價
Rescan the Library	你手動加入的檔案，要按 Run now 之後才會出現
Refresh movie details	已排入佇列但還沒開始的執行會被取消。名稱、日期和圖片可能會過時。手動重新整理仍然可用

重新開啟後，會排定在現在加上間隔的時間執行。錯過的執行不會補跑。

背景迴圈

工作下方是自行執行的迴圈，例如 Download sync（下載同步）、Backups（備份）和 Log masking（log 遮蔽）。每個迴圈都會顯示它的狀態、間隔、上次和下次執行時間，以及重試的原因。要暫停、繼續或重新啟動迴圈，請到 Settings > Parts（設定 > 功能區塊）。

如果沒有成功

症狀： Run now 顯示功能區塊已關閉。 原因： 這項工作的功能區塊在 Settings > Parts 中是關閉的，或是 HolyArrs 處於安全模式，而這項工作不屬於核心。 解決方式： 開啟該功能區塊，或離開安全模式。請看功能區塊與安全模式。

症狀： 已關閉的排程上沒有 Run now。 原因： 只有擁有 Change settings 權限的人，才能手動執行已關閉的排程。 解決方式： 請有這個權限的人來做。

症狀： 某項工作失敗了。 原因： 原因會顯示在那一列的上次執行欄位，內容會像 log 一樣遮蔽敏感資訊。 解決方式： 依照那個原因處理，然後按下 Run now。

給進階使用者

API

Route	誰可以用	用途
`GET /api/v1/schedules`	Run the Library（管理媒體庫），讀取範圍	排程與迴圈
`POST /api/v1/schedules/{kind}/run`	Run the Library，寫入範圍	立即排入佇列。回傳 202；如果它的功能區塊已關閉或處於安全模式，則回傳 409
`PUT /api/v1/schedules/{kind}`	Change settings，寫入範圍	任何排程都可用 `{"every_s": 1800}`；只有 `refresh_titles` 和 `rescan_library` 可用 `{"enabled": false}`。超出範圍會回傳 400

排程