前言¶

在 DSH 插件生態裏，定時觸發通常需要把到點的計劃事件轉換成後續可執行的會話 Run。dsh-cron 面向這個問題：它爲 DSH Automation 提供持久化 calendar 觸發器，把一次性或重複計劃轉換爲冪等的新會話 Runs，但自身不執行 Agent 回合。

這是什麼¶

omdsh-dev/dsh-cron 是一個 MIT 許可證的 DSH 插件，定位爲 DSH Automation 的持久化 calendar 觸發器。

它處理計劃解析、時區計算、持久化 occurrence 記錄、冪等提交和任務中心 UI，並依賴 dsh-automation 的公共服務合同。

核心能力¶

下面介紹已覈實的插件能力：

• 支持五分鐘字段 cron。
• 支持一次性 RFC 3339 at 時間戳。
• 支持 IANA 時區及 daylight-saving-aware occurrence calculation。
• 爲每次計劃 occurrence 生成持久化記錄與冪等提交。
• 錯過的重複任務採用 latest-only catch-up，不重放更早積壓。
• 通過 dsh.client manifest 提供瀏覽器任務中心。
• 支持 headless profiles 的 tools、commands 和 RPC。
• 提供模型工具 cron_add、cron_update、cron_list、cron_remove。
• 提供 /cron 命令，用於添加、一次性添加、暫停、恢復和刪除任務。
• 依賴 dsh-automation 的公共服務合同。

安裝與啓用¶

本插件要求 dsh-automation >=0.2.0-alpha.0 <0.3.0 服務合同。安裝命令如下：

dsh plugin --profile web add github:omdsh-dev/dsh-cron

安裝後，插件可通過 dsh.client manifest 提供瀏覽器任務中心，並可在 headless profiles 中通過 tools、commands 和 RPC 使用。

典型用法¶

模型工具¶

dsh-cron 提供以下模型工具：

1. cron_add：創建重複或一次性任務。
2. cron_update：暫停或恢復任務。
3. cron_list：查看 schedules、occurrences、linked Runs 和 outcomes。
4. cron_remove：刪除任務。

/cron 命令¶

可以用 /cron 命令管理任務。示例如下：

/cron add 0 9 * * 1-5 Summarize the project status
/cron add tz=Asia/Shanghai 30 18 * * 5 Prepare the weekly report
/cron add-at 2026-09-01T09:00:00+08:00 Run the release checklist
/cron pause cron-1
/cron resume cron-1
/cron remove cron-1

這些命令分別用於添加重複任務、添加一次性任務、暫停任務、恢復任務和刪除任務。

適用場景與注意¶

適合需要把日曆計劃轉成 DSH Automation Runs 的 DSH 工作流，尤其是重複計劃、一次性計劃、跨時區計劃和 headless 管理場景。

使用注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 本插件要求 dsh-automation >=0.2.0-alpha.0 <0.3.0 服務合同。
• 插件自身不執行 Agent turn。
• 錯過的重複任務只補跑最新一次，舊積壓不重放。
• 暫停會保留計劃；恢復會讓重複計劃跳過當前時間之前的 occurrence。
• 瀏覽器/API 任務必須發送 cwd 或繼承 defaultCwd。
• 無 cwd 或 defaultCwd 的 legacy 任務會被安全暫停並標記 migrationIssue。
• 不導入私有 dsh-automation 源碼，也不需要修改 deepseek-harness。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/omdsh-dev/dsh-cron
• GitHub：https://github.com/omdsh-dev/dsh-cron