前言¶
DeepSeek Harness 的設計理念是「一切皆插件」。在實際開發智能體工作流時，如果希望將任務調度在谷時執行以節省成本，或者避免在高峯期佔用資源，需要手動控制發送時機。dsh-offpeak-job 插件提供了自動化的谷時調度能力，能夠將消息排隊，並在滿足配置的谷時窗口時自動執行。
插件簡介¶
該插件是 ganningniang 開發的 DeepSeek Harness 工作流插件。它通過在提供方配置峯/谷時段與策略，支持自定義運行窗口（每日/工作日/週末/跨日），並在 Composer 中控制運行時機。插件使用 TypeScript + React 構建 UI，狀態持久化存儲於 $DSH_HOME/offpeak-job/。
核心功能¶
- 提供方配置：支持按提供方配置峯/谷時段與審批策略。
- 自定義窗口：支持自定義運行窗口（每日/工作日/週末/跨日）。
- 策略控制：支持可選暫停策略與夜間升級策略。
- Composer 控制：在 Composer 中控制運行時機。
- 等待反饋：對話中顯示等待條。
- 概覽面板：側邊欄 Off-peak 概覽面板。
- 狀態存儲：狀態持久化存儲於
$DSH_HOME/offpeak-job/。 - UI 技術棧：TypeScript + React UI。
安裝與啓用¶
安裝插件需要使用官方提供的安裝命令。安裝後必須重啓 DSH web 進程以應用配置。
dsh plugin --profile web add "https://github.com/ganningniang/dsh-offpeak-job/releases/latest/download/dsh-offpeak-job.tgz"
安裝完成後，重啓 DSH web 進程，刷新前端界面。
典型用法¶
- 配置提供方：進入提供方設置，開啓 Peak / off-peak，配置窗口和審批策略，保存。
- 發送消息：在 Composer 中選擇“Off-peak run”發送消息，消息會進入等待隊列。
- 立即運行：使用“Start now”按鈕立即運行等待中的任務。
- 查看狀態：通過側邊欄 Off-peak 概覽面板查看所有等待中的任務。
注意事項¶
- 主機狀態：主機必須在谷時保持開啓狀態，否則排隊任務不會自動運行。
- 檢查點機制：暫停和繼續並非精確的工具檢查點，而是任務繼續。
- 默認策略：默認夜間升級策略爲“拒絕並繼續”。
- 聊天限制：僅 Off-peak run 聊天遵循日曆和谷時審批策略，Run now 不受影響。
- 恢復機制：發送新消息時若恢復正在等待，需先完成恢復或放棄。
- 隱私：無遙測數據，配置和等待隊列存儲在本地。
總結¶
該插件解決了在 DSH 中自動控制任務運行時機的問題，適合需要在特定時段執行任務以控制成本或資源的場景。配置和狀態均存儲在本地，不涉及網絡上報。
項目地址¶
- GitHub: https://github.com/ganningniang/dsh-offpeak-job
- 目錄: https://www.skillhub.cn/plugins/ganningniang/dsh-offpeak-job
