前言¶

在 DeepSeek Harness（dsh web）中做定時任務時，常見需求不只是讓腳本到點運行，還包括執行結果可查、輸出可回看、任務完成後可推送，以及 Agent / Skill 會話能集中整理。已有做法往往要在系統 crontab 或外部任務調度中配置，再單獨處理輸出和通知。chicheng-cron 把這類定時任務放進 dsh web 的側欄入口裏配置和查看。

這是什麼¶

chicheng-cron 是 DeepSeek Harness（dsh web）的定時任務插件，維護者爲 534119219，許可證爲 MIT。它用 cron 表達式定時執行 Shell / Python / Node.js 腳本、Skill 或 Agent 任務，並支持推送通知、會話整理與移動端適配。

核心功能¶

側欄入口位於「新會話」按鈕下方，名爲「定時任務」。

任務類型包括：

1、Shell 腳本：Windows 使用 cmd.exe，其他平臺使用 /bin/sh。
2、Python 腳本：自動探測 python / py / python3。
3、Node.js 腳本：使用當前 Node 運行時。
4、Skill 任務。
5、交給 Agent 的任務。

調度支持標準 5/6 字段 cron、@hourly 到 @yearly 與 @every，使用本地時間計算，並在重啓後自動恢復。

推送通知可對接 chicheng-push 與 messaging-core，並支持模板佔位符。

Agent / Skill 的運行會話可歸入「定時任務」工作區；也可配置成功後自動歸檔會話。

執行歷史會記錄狀態、退出碼、耗時、推送結果與歸檔標記，並支持通過彈窗查看輸出。

移動端適配包括窄屏單頁導航、執行歷史默認收起、16px 輸入防 iOS 縮放與安全區適配。

安裝與啓用¶

先安裝插件：

dsh plugin --profile web add github:534119219/chicheng-cron

安裝後重啓 dsh web，左側欄「新會話」下方會出現「定時任務」按鈕。

典型用法¶

1、點擊側欄「定時任務」，新建任務。
2、選擇任務類型，填寫名稱、cron 表達式、腳本或提示詞、工作目錄和超時。
3、按需配置完成後推送通知、Agent / Skill 會話歸入「定時任務」分組、成功後自動歸檔會話。
4、保存後按 cron 自動執行；也可使用「立即執行」手動觸發，並在執行歷史中查看結果與輸出。

數據與限制¶

任務與歷史保存在：

$DSH_HOME/cron/store.json

運行輸出保存在：

$DSH_HOME/cron/runs/

Agent / Skill 任務通過以下命令執行：

dsh --profile headless

它會複用：

$DSH_HOME/settings.yaml

中的模型配置。

如果 dsh web 未運行時錯過了某個調度時間點，不會補跑。

適用場景與注意¶

適合需要在 dsh web 中維護定時腳本、Skill 或 Agent 任務，並查看執行歷史與輸出的開發者。

插件會執行 Shell / Python / Node.js 腳本、Skill 或 Agent 任務，並以當前 dsh 進程權限運行；安裝前應檢查源碼與 MIT 許可證，再確認任務內容、工作目錄和超時設置。

鏈接¶

GitHub：https://github.com/534119219/chicheng-cron