在 DeepSeek Harness (DSH) 的智能體開發與運維中，長期運行的後臺任務（如 Windows 計劃任務或 KAi cron）往往缺乏可視化的監控入口。除了命令行查看狀態，缺乏一個直觀的看板來統一管理這些載體的調度、依賴腳本及健康狀態。amoss-1/routine-taskboard 插件正是爲此設計，它將 DSH Web GUI 的側邊欄改造爲“例行看板”，爲這些長壽命任務提供了一站式的管理界面。
插件定位¶
該插件由 Amoss-1 維護，是 DeepSeek Harness 插件生態中的一員。它專注於在 Web 界面展示計劃任務、腳本步驟及健康燈。插件自 v0.1.9 起完全自包含，不再依賴官方的 dsh-taskboard 插件或其 /dsh-taskboard/state API。
核心功能¶
- 看板視圖：在 DSH Web 側邊欄點擊“例行看板”，即可在對話列切換到板式視圖。每個長壽命調度任務渲染爲一行，包含計劃名稱、時間、載體、依賴腳本、輸入/輸出文件及健康指示燈。
- 腳本步驟與執行：支持多腳本任務按編號步驟顯示（1. 2. 3.）。每一步均可點擊並在資源管理器中定位，也可單獨點擊 ▶ 運行。支持的腳本後綴包括 py/ps1/bat/vbs/mjs。
- 狀態操作：針對 Windows 計劃任務載體，提供行級操作按鈕。按鈕狀態隨任務狀態變化：運行中顯示“啓動”和“停用”；已停用僅顯示“重新上線”。
- 健康指示：通過三色指示燈展示狀態：運行中（綠）、已停用（琥珀色）、異常（紅）。
安裝與啓用¶
- 在終端執行安裝命令：
dsh plugin --profile web add routine-taskboard
- 重啓
dsh web服務。 - 在側邊欄會出現“例行看板”入口，點擊即可在對話列切換視圖。
配置與數據¶
- 固定裝置註冊表：插件通過
$DSH_HOME/storages/routine-taskboard.json讀取任務卡片數據（包含 id、name、scripts、input、output、healthKey、status 等）。該文件默認爲空數組，需通過主機 API 或直接編輯文件註冊卡片。 - 用戶配置文件：機器特定的路徑映射和 curated 映射存放在
$DSH_HOME/storages/routine-taskboard.config.json。該文件不會在插件升級時被覆蓋，適合存放業務路徑和腳本映射。 - 後備機制：如果未配置文件，插件默認使用正則表達式提取路徑。業務健康臺賬的文件路徑可由環境變量
RTB_PIPELINE_FILE指定。
接口說明¶
插件通過以下主機路由提供數據訪問與操作能力：
| 路由 | 方法 | 功能 |
|---|---|---|
/routine-taskboard/fixtures |
GET | 獲取看板數據 |
/routine-taskboard/pipeline |
GET | 獲取業務健康臺賬內容 |
/routine-taskboard/config |
GET | 獲取用戶配置 |
/routine-taskboard/open |
POST | 在資源管理器中打開指定路徑 |
/routine-taskboard/run |
POST | 執行 schtasks /Run |
/routine-taskboard/state |
POST | 修改任務狀態（/DISABLE 或 /ENABLE） |
/routine-taskboard/run-script |
POST | 後臺運行單個腳本 |
注意事項¶
- 插件自 v0.1.9 起完全自包含，不依賴官方
dsh-taskboard。 - 升級插件時，用戶配置文件（
.config.json）和固定裝置註冊表（.json）不會被覆蓋。 - 插件以 DSH 進程的權限運行，安裝前請檢查源碼與許可證。
總結¶
Routine Taskboard 通過可視化的行視圖和腳本操作能力，降低了長期後臺任務的維護成本。如需瞭解更多或貢獻代碼，可訪問其 GitHub 倉庫。
