前言¶
在使用 DeepSeek Harness(DSH)做日常智能體開發時,常見需求不只是手動發起一次會話:你可能希望每天固定時間生成進展摘要,或在設定時間執行巡檢、生成報告,同時需要查看當前 DSH 進程的系統與 harness 狀態。
csiroqa/dsh-schedule 是一個 DSH 插件,把這兩件事合在一起:按 cron 時間表自動觸發 Agent 執行任務,並通過 /status 命令與設置頁儀表盤查看狀態。
這是什麼¶
csiroqa/dsh-schedule 是 DeepSeek Harness(DSH)的定時任務 + 狀態監控插件,由 csiroqa 維護,許可證爲 MIT。
它主要解決兩類問題:
- 按 cron 時間表自動觸發 Agent 執行任務,例如每日摘要、定時巡檢、自動報告。
- 通過
/status命令和設置頁儀表盤查看系統與 harness 的綜合狀態。
核心能力¶
定時任務¶
插件支持按 5 字段 cron 時間表觸發任務,字段順序爲:
分 時 日 月 周
例如:
0 9 * * *
表示每天 9 點。觸發爲分鐘精度,同一任務不會併發運行。
到點執行時,插件會:
- 創建一次性 Agent;
- 工作目錄歸入對應 workspace;
- 模型跟隨設置頁選擇,或由 config 指定;
- 執行任務內容;
- 會話日誌落盤;
- 將執行結果登記回任務記錄。
任務記錄持久化到:
$DSH_HOME/schedule.json
該文件採用原子寫入,啓動時更安全。
任務管理支持以下命令:
/schedule list
/schedule add
/schedule remove
/schedule pause
/schedule resume
/schedule run
設置頁中的「定時任務」頁籤也提供同功能操作。
單次運行有超時保護,默認 30 分鐘後自動強制停止,避免任務卡死。
狀態監控¶
插件提供 /status 命令,可查看:
- 進程運行時長;
- CPU;
- 內存;
- 磁盤;
- 活躍會話;
- Agent;
- 插件;
- 模型。
設置頁「狀態」頁籤提供即時儀表盤,每 5 秒刷新,也可暫停刷新,並展示 CPU、內存、磁盤佔用條。
安裝與啓用¶
前置要求¶
安裝前需要滿足以下條件:
- Node.js >= 22;
- pnpm;
- 本機
deepseek-harness源碼檢出; - 插件依賴以
link:指向../deepseek-harness。
支持平臺:Windows / macOS / Linux(Node >= 22)。
安裝命令¶
先克隆並構建插件:
git clone https://github.com/csiroqa/dsh-schedule.git
cd dsh-schedule
pnpm install
pnpm build
構建完成後,把當前目錄安裝進 web profile:
# POSIX
dsh plugin --profile web add link:$(pwd)
# Windows
dsh plugin --profile web add link:E:\path\to\dsh-schedule
安裝完成後重啓:
dsh web
然後在瀏覽器中執行硬刷新:
Ctrl+F5
典型用法¶
下面是幾個常見入口。
在側欄管理任務¶
查看任務:
/schedule list
添加一個每天 9 點執行的任務:
/schedule add 0 9 * * * 每天 9 點總結昨天的進展
在設置頁管理任務¶
進入:
設置 > 插件 > 定時任務
可以進行:
- 可視化添加任務;
- 立即運行;
- 暫停;
- 恢復;
- 刪除。
查看狀態¶
會話內查看綜合狀態:
/status
在設置頁查看即時儀表盤:
設置 > 插件 > 狀態
適用場景與注意¶
適合以下場景:
- 需要每天自動總結進展;
- 需要定時執行巡檢或檢查;
- 需要自動生成報告;
- 需要在一個地方查看 DSH 的 CPU、內存、磁盤、會話、Agent、插件和模型狀態。
使用前需要注意:
- 定時任務會在設定時間無人值守自動執行;
- 任務使用 DSH 當前賬號權限,可讀寫文件、執行命令;
- 請只添加你信任的任務內容;
/dsh-schedule/*接口僅監聽本機(DSH 默認迴環綁定),不要把 DSH 端口暴露到公網;- 插件爲 MIT License,使用、修改、引用或收錄時應保留
LICENSE文件與版權聲明,並標明出處(本倉庫鏈接); - 針對 DSH
0.1.1-rc.2源碼檢出開發驗證,並在@deepseek-ai/dsh@0.1.1-rc.2環境實測可用; - 安裝前建議檢查源碼、許可證與依賴指向是否符合你的環境要求。
鏈接¶
倉庫地址:
https://github.com/csiroqa/dsh-schedule
插件線索給出的目錄頁(以實際站點爲準):
https://www.skillhub.cn/plugins/csiroqa/dsh-schedule