DeepSeek Harness (DSH) 支持本地運行智能體,但在實際使用中,有時並不需要即時響應,而是希望利用系統空閒時段批量處理任務。leisure-time-queue 插件通過隊列機制,允許用戶預先配置任務,並指定每週的執行時間段,在滿足條件時自動調度。
安裝¶
該插件由 fireworksss 維護。安裝前請確保 DeepSeek Harness CLI 版本爲 @deepseek-ai/dsh@0.1.5-rc.1 或更高。
安裝命令如下:
npx @deepseek-ai/dsh plugin --profile web add "$plugin_package"
安裝完成後,必須停止並重新啓動 DeepSeek Harness。插件在運行過程中不會自動重新加載,更新或卸載後同樣需要重啓。
核心功能¶
- 時間配置:在插件界面中配置每週執行時間段,可設置多個不同時段。
- 會話管理:創建任務時可以選擇已有會話,也可以創建新會話(支持配置模型、權限預設和工作區)。
- 全局入口:側邊欄提供「閒時任務」入口,可管理所有會話中的隊列。
- 執行順序:按 FIFO(先進先出)順序執行隊列。
- 任務操作:支持暫停、恢復、取消、重試、編輯、刪除和立即執行。
- 策略覆蓋:支持全局執行策略,以及針對單個會話設置不同的時間段。
- 持久化:支持 Harness 重啓後的隊列持久化和已派發任務恢復。
- 本地運行:插件運行在本地,使用 DeepSeek Harness 中已配置的模型、憑據、權限和工作區。
配置與使用¶
1. 全局配置¶
進入「設置 → 插件 → 插件配置 → 閒時任務隊列」。
- 全局配置:
- 啓用自動執行:關閉後,隊列任務不會按時間段自動開始。
- 時區:默認使用操作系統時區,可手動設置。
- 每週時間段:指定哪些星期、從幾點到幾點允許任務開始。跨午夜時間段按開始日計算(如週一 22:00 → 週二 07:00)。
- 併發限制:設置最大併發任務數和每日創建上限。
- 會話時段與任務隊列:管理具體會話的執行策略,支持爲特定會話單獨設置時區和時間段,覆蓋全局策略。
2. 創建任務¶
在側邊欄點擊「閒時任務」,進入管理頁。
- 從當前會話快速創建:打開任意會話後,點擊會話標題欄中的「閒時執行」。插件會自動使用當前會話作爲目標,讀取輸入框內容作爲任務說明,並複用當前會話的模型、憑據和工作區。
- 新建任務:在「新建任務」頁,選擇任務目標(現有會話或新建會話),填寫標題、任務說明和「不得早於」時間,點擊創建即可。
任務執行機制¶
隊列中的任務只有同時滿足以下條件纔會開始:
- DeepSeek Harness 進程仍在運行。
- 插件的「啓用自動執行」已打開。
- 當前時間位於任務適用的每週執行時間段內。
- 已到達任務設置的「不得早於」時間。
- 目標會話已打開並可用。
- 目標會話的 Agent 當前處於空閒狀態。
- 當前運行數量沒有超過「最大併發任務數」。
- 按 FIFO 順序已經輪到該任務。
「立即執行」操作僅忽略時間段限制,不忽略其他限制(如會話可用性、併發數等)。
任務管理¶
任務加入隊列後,可通過側邊欄進行管理:
- 暫停:暫時阻止任務被調度。
- 恢復:讓暫停的任務重新進入等待狀態。
- 取消:取消等待中或運行中的任務。
- 重試:將失敗或已取消的任務重新加入隊列。
- 編輯:修改標題、任務說明或「不得早於」時間。
- 刪除:從隊列中移除任務記錄。
注意事項¶
- 執行條件:任務不會自動執行,必須滿足上述所有條件。
- 運行環境:插件運行在本地,依賴 DeepSeek Harness 的配置。
- 重啓需求:安裝、更新或卸載插件後必須重啓 Harness,否則插件可能不可用。
- 後臺運行:任務執行依賴 DSH 進程保持運行。如果直接關閉終端或停止 DSH 進程,任務不會在後臺繼續運行。
參考資料¶
- GitHub 倉庫:https://github.com/fireworksss/LeisureTimeQueue
- 生態目錄:https://www.skillhub.cn/plugins/fireworksss/LeisureTimeQueue