dsh-visual-workflow

<h1 align="center">Visual Workflow</h1>

为 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> 量身打造的可视化多 Agent 工作流设计器

<a href="README_EN.md">English</a> · <b>简体中文</b>

---

核心亮点

✦ 拖拽式编排

• 零代码拖拽连线，纯 SVG 画布流畅交互、撤销重做一应俱全；无限画布、一键整理，复杂工作流触手可及。

✦ 双模式架构

• 流程编排模式：长流程多 Agent 智能调度，父代理自主推进，支持断点续跑与运行中实时编辑；
• API服务模式：一键发布为独立 REST API 服务（OpenAI 兼容协议），多租户会话隔离，端口自动分配。

将 DSH 作为独立后端服务部署，持久化 无头Agent 后台运行，可连接外部APP（如QQ机器人、飞书）或自建前端。

✦ 画布双向同步

• 画布修改保存后，编排器实时感知最新拓扑（新增节点/连线即时生效）；运行状态（节点高亮、状态徽标）实时回显画布；双向变更防回环，运行锁保护跨会话冲突，编排与画布始终一致。

✦ 深度自定义

• 每个子代理节点独立配置 system prompt、LLM 模型、思考强度、工具组合（内置预设 / 自定义组合）及 ReAct 迭代上限、回流重试上限；父代理亦可自由选择模型与调度模板，满足精细化编排需求。

工具自由组合分配给各个代理，避免无用工具占据上下文；mcp服务器只需一行配置自动注册并支持热重载即时生效。

✦ 协作组与虚拟节点

• 将多个角色节点拖入协作组，组内 Agent 并行执行并通过 wf_ask_agent 相互通信；虚拟节点作为主节点的别名引用，共享同一执行实例，拓扑复用更灵活。

✦ 定时触发

• 工作台内置定时任务，选择工作流模板配置执行窗口与触发策略，自动创建实例并运行，错过窗口自动挂起/续跑，支持错峰调用api，省钱又省心。

全自动化运维管理，定时自动运行工作流，可支持峰谷时段错时调用，自动暂停，保存流程数据，谷时自动运行。

✦ 零官方包依赖

• 所有 DSH 生态服务（LLM、子代理、工具、用户问题等）均通过 ctx.get() 运行时解析，Host 工具以纯对象定义注册，插件自身无任何官方包编译时依赖，升级兼容性更强。

---

核心概念

概念	说明
模板	角色/文件/数据库/工作流的“蓝图”，存储在 ~/.dsh/visual-workflow/；模板与实例深拷贝解耦，修改模板不影响已生成节点
实例	工作流或服务的具体运行实例（workflows/ 与 services/），只能从工作流模板创建，可在画布中编辑并保存
节点	画布上的卡片，分为父代理、子代理、文件、数据库、阶段（启动/结束/暂停）、协作组、虚拟节点
连线	传递流程方向（流程线）、上下文内容（上下文线）、数据库标识（数据库线）；流程线可带条件标签（通过/不通过/内容），由父代理语义判断
父代理	编排的核心调度者，模式一中负责监督与调度（不执行具体任务），模式二中为最终回答者；可由用户指定调整编排流程
子代理	任务执行者，独立配置角色 Prompt（system prompt）、模型、工具等，由父代理按需创建与调度
编排	主 Agent 使用 wf_run_node / wf_ask / wf_finish 等工具自主推进流程，控制节点状态
模式	插件提供两种运行模式：流程编排模式（模式一）与 API 服务模式（模式二），通过顶栏切换，分别存储于不同目录
断点续跑	流程暂停或宿主意外中断后，已执行节点状态持久化，恢复后不重跑，从断点继续
协作组	将多个角色节点组合为一个并行执行单元，组内 Agent 可自由通信，组整体完成后再触发后续流程
虚拟节点	主节点的别名引用，不存储独立配置，共享主节点的执行实例，用于拓扑复用

区别：不同于官方 subagent 调度只能传递父的工具和模型，wf_run_node 创建的子代理节点可以自由组合任意工具、设定不同模型和系统提示词（system prompt）。

---

节点卡片

1. 角色节点（任务执行单元）

卡片形态（左 3 入、右 2 出）：

        ┌─────────────────────────┐
  左一 ●│  [角色卡片] 标题          │● 右一
（数据库）│  类型徽标 / 模型 /       │（上下文）
  左二 ●│  工具组合徽标            │● 右二
（上下文）│                         │（流程出）
  左三 ●│                         │
（流程入）│                         │
        └─────────────────────────┘

接点	名称	语义
左一	数据库输入	连接数据库节点，注入检索/查询工具
左二	上下文输入	接收上游上下文（不连接则不继承）
左三	流程输入	控制执行顺序
右一	上下文输出	向下游传递本节点产出
右二	流程输出	顺序执行/条件分支（通过/不通过/内容）

属性配置：

配置项	说明
名称	节点名称
system prompt	文本输入或引用 .md，设定角色系统提示词
LLM 模型	独立选择 provider + model
思考强度	与官方下拉一致
工具组合	内置预设（标准/极简/ptc/创造）+ 自定义组合（组合管理中创建）
ReAct 迭代上限	软截停：达上限后强制收尾（不发起新工具调用，输出已有结论），默认 50
回流重试上限	节点级尝试计数护栏，默认 3
输入/输出数据结构	文本/JSON 描述（辅助模型理解）
系统提示词开关	控制官方系统提示词注入（默认开启）；两个开关分别控制官方人设/身份/系统/上下文段（「人设段」）与工具 tool:* 使用指引段（「工具散文段」）的注入。关闭工具散文段不影响工具调用能力（只去掉英文使用指引）；要真正禁用某个工具，请用「组合」管理里的全局工具开关

虚拟节点：点击“复制”可生成虚拟节点（虚线边框 + “↻ 引用”角标），与主节点共享配置与执行实例，删除主节点时级联清除。

2. 文件节点

• 文件内容直接存于模板（文本 / PDF 提取文本 / 图片等非文本文件以受管路径存储）
• 右侧属性面板可上传/替换文件，保存后所有引用节点同步
• 功能：用于给角色节点注入提示词、需求、压缩摘要等上下文
• 文本内容注入上限默认 20000 字符，超出截断并提示；非文本仅注入受管路径，代理通过官方读取工具访问

3. 数据库节点

…