前言¶
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 提供。
