前言¶
在 DeepSeek Harness (DSH) 的使用中，自動化工作流是提升效率的關鍵。現有方案往往需要手動觸發，或者依賴複雜的腳本。dsh-tasks 插件通過 cron 表達式解決了這個問題，它將“定時執行提示詞”的能力下沉到插件層，讓用戶可以像管理普通任務一樣管理 AI 工作流。
是什麼¶
dsh-tasks 是由用戶 weibaohui 維護的 DSH 工作流插件。它的核心作用是：利用 cron 表達式定時執行提示詞，到點自動創建一個新的 agent 會話並執行，用戶也可以隨時手動立即執行該任務。
核心功能¶
插件提供了以下能力：
* cron 定時執行：每個任務由標題、提示詞和 cron 表達式構成，到點自動創建會話。
* 可視化定時選擇器：提供快捷模板（如“工作日每天 9:00”）或逐級選擇器，選定後實時預覽最近 5 次執行時間，確保週期配置正確。
* 手動立即執行：列表中的任務可一鍵“立即運行”，無需等待 cron 到點。
* 綁定工作區與指定模型：任務可選擇綁定特定工作區（會話繼承目錄），也可指定執行模型（默認跟隨全局）。
* 會話自動命名：執行出的會話以“任務標題 · 時間”命名，便於在側欄區分。
* 管理界面：提供全屏管理頁，支持新建、編輯、啓用/停用、刪除。
* 執行記錄：保留最近 20 次執行歷史，支持展開追溯，成功記錄可一鍵“打開對話”回看。
* 通知推送：支持在任務開始/完成/失敗時推送到 IM（需依賴 dsh-im 等插件），完成通知可附帶執行結論（截取末尾 1000 字）。
* 免打擾時段：支持配置起止時間，跨零點友好，時段內推送自動跳過。
安裝與啓用¶
通過 npm 包安裝：
dsh plugin --profile web add @weibaohui/dsh-tasks -w
安裝完成後，需要重啓 dsh web 進程才能生效。
使用方法¶
- 打開 Web UI，進入 設置 頁面，左側點擊 定時任務 section 即可進入管理面板。
- 點擊新建任務，依次填寫：
- 標題：任務名稱。
- 提示詞：需要 AI 執行的具體指令。
- cron 表達式：如0 9 * * 1-5表示工作日每天 9 點。
- 綁定工作區（可選）：指定會話掛載的目錄。 - 保存後，任務將按 cron 規律執行。在列表頁，可以隨時進行 立即執行、編輯、停用或刪除操作。
通知與免打擾¶
任務執行結果支持推送到 IM 渠道，但需要先安裝 IM 投遞插件（如 dsh-im）。
1. 在 IM 投遞插件中配置至少一個目標。
2. 回到定時任務設置頁底部，啓用通知並勾選事件（開始/完成/失敗）。
3. 勾選“完成通知附帶執行結論”，推送將包含 agent 的最終回覆內容。
4. 開啓“免打擾”並設置起止時間，可過濾時段內的通知。
適用場景與注意¶
該插件適合需要定期整理待辦、生成日報或沉澱知識的場景。
注意：插件以當前 DSH 進程的權限運行。安裝前建議檢查其源碼與許可證（MIT），確保符合你的使用規範。
後記¶
經過上面的步驟，你已經完成了定時任務的配置。這個插件通過 cron 表達式和可視化工具，將 DSH 的 Agent 能力從“即時響應”擴展到了“定時響應”，是構建自動化工作流的基礎組件。
