前言¶
DeepSeek Harness (DSH) 的理念是“一切皆插件”。在開發多步驟的自動化任務或複雜 Agent 流程時，純代碼拼接往往缺乏直觀性，且維護成本較高。下面介紹 DeepSeek Harness Node Flow，這是一個面向 DSH 的可視化工作流插件，提供拖拽畫布以編排子代理、代碼、條件與定時任務。
插件定位¶
該插件由 CodermanYHZ 維護，基於 MIT 協議開源。它把 Agent 調用、TypeScript / Python 代碼、條件判斷和循環控制組合成一張可直接執行的流程圖，適合快速搭建自動化任務和多步驟 Agent 流程。
核心能力¶
可視化編排¶
通過拖拽節點和連接端口，在畫布上直觀展示數據和執行路徑。選中節點後，可在右側屬性面板配置名稱、模型、提示詞、超時和失敗處理策略。
節點類型¶
畫布支持多種節點：
* Trigger：工作流入口，傳遞觸發內容。
* Schedule：使用 5 段 Cron 表達式定時運行。
* Agent：調用 DSH 子 Agent，支持繼承當前模型或指定模型路由。
* Code：在宿主運行 TypeScript 或 Python。
* If / Switch / Loop / While：處理分支、循環與分發。
* Output / Note：展示結果或添加說明。
執行反饋與失敗策略¶
節點展示運行狀態，實際經過的連接路徑會高亮。Code / Agent 節點可設置超時，以及“停止分支”或“繼續使用空值”兩種失敗策略。
定時任務與導入導出¶
支持 Cron 調度，在任務面板中查看、立即運行或取消。工作流支持導出爲文件，便於備份和複用。
安裝與啓用¶
項目尚未發佈到 npm，請直接從公開 GitHub 倉庫安裝：
dsh plugin --profile web add git+https://github.com/CodermanYHZ/dsh-node-flow.git
安裝完成後重啓 Web UI：
dsh web
進入 DSH 後，從側邊欄打開 節點模式 即可使用。
典型用法¶
- 點擊 添加節點，從左側面板選擇節點或內置示例。
- 拖動節點端口建立連接，並在右側屬性面板填寫參數。
- 點擊頂部 ▶ 運行，觀察節點狀態與實際執行路徑。
- 使用 導出 將工作流保存爲文件，或通過 定時任務 創建 Cron 調度。
注意事項¶
Code Runtime 綁定調用¶
DSH Code Runtime 的綁定調用必須傳入可無損 JSON 序列化的參數，因此應寫成 dsh.input(null) 和 dsh.now(null)，不能省略參數。
依賴宿主服務¶
插件依賴 DSH 宿主提供 ctx.webServer、ctx.codeRuntime、ctx.agents 與 ctx.subagents、ctx.llm 等服務。React、ReactDOM 和 @deepseek-ai/cordis 由 DSH 作爲 Peer Dependencies 提供。
