排程任務與工作流程

排程任務 面板同時支援傳統步驟模式和流程圖工作流程模式——既可以當作定時執行器，也可以當作一套視覺化自動化工具。

支援的觸發方式

• Cron 表達式
• 固定間隔
• 單次
• 使用者觸發
• KVDB 佇列消費

其中：

• 使用者觸發：不會自動調度，只在你手動執行時執行。
• KVDB 佇列消費：適合做"有任務入隊就消費"的場景。

目標裝置與群組

• 排程任務沿用主介面的裝置 / 群組語義。
• 如果任務裡選擇了群組，執行時會使用這些群組目前綁定的腳本和設定。
• 使用者觸發 類型還可以設定是否顯示到主介面的 更多操作，以及手動觸發前是否必須先選取裝置。

兩種編輯方式

步驟模式

適合簡單串行動作，例如：

• 啟動腳本
• 停止 / 暫停 / 繼續腳本
• 鎖定螢幕 / 解鎖
• 重新啟動 SpringBoard / 重新啟動裝置
• 等待若干秒
• 執行 Lua 程式碼
• 啟用 / 停用 / 觸發其他排程

工作流程模式

適合複雜自動化。工作流程編輯器裡可以直接組合這些常見能力：

• 裝置動作與腳本執行
• 檔案管理中的三類目錄操作
• HTTP 請求、Lua 程式碼
• KVDB 與 TableDB
• 條件分支、變數、流程控制
• 呼叫其他排程任務

編輯工作流程時：

• 在節點面板頂部搜尋動作名稱或分類，找到後拖入畫布；按一下分類標題可以摺疊或展開節點清單。
• 畫布頂部提供 復原、重做、格式化節點 和 符合畫布。選取節點、開啟屬性面板後，這些工具仍可使用。
• 格式化節點 會整理節點位置，支援復原；符合畫布 只調整檢視，保留節點位置。

測試與手動執行

• 工作流程編輯器內建「測試執行」功能，可以在編輯器裡直接檢視測試日誌。
• 儲存後的排程任務支援"立即執行"，並能即時追蹤執行狀態。
• 測試或執行出錯時，面板會直接顯示錯誤位置和訊息，方便回到對應步驟修改。
• 沒有日誌時，執行日誌預設收起；開始測試或執行時自動展開。執行中也可以手動收起，後續日誌不會反覆打開顯示區域。

執行歷史與匯出

• 每個排程任務都保留執行歷史。
• 執行記錄支援檢視狀態、觸發來源、裝置結果統計和日誌內容。
• 執行日誌可匯出到 檔案管理 → 報告目錄。

清單批次操作

• 排程任務清單支援多選和 Shift 連續選擇。
• 可對選取的排程任務批次匯出或批次刪除。
• 刪除選取排程任務前會二次確認；正在執行的排程任務不能被刪除。

匯入與匯出

• 排程任務清單支援匯出全部，也支援只匯出選取的單條或多條排程任務。
• 匯出選取排程任務時，會自動補齊被步驟或工作流程引用的關聯排程，保證匯入包可用。
• 匯入排程 會先預覽 JSON 檔案內的排程任務，可以只匯入其中單條或多條。
• 可以按一下 匯入排程 選擇 JSON 檔案，也可以把 JSON 檔案直接拖入排程任務面板。
• 新的匯入入口預設合併到目前清單，不會替換全部現有排程任務。
• 遇到同名排程任務時，可以選擇覆蓋同名排程或重新命名匯入。