前言¶
DeepSeek Harness (DSH) Web GUI 提供了插件扩展能力，用于丰富官方界面功能。在开发复杂的多智能体应用时，编写固定的 DAG 流程难以应对动态任务。dsh-visual-workflow 插件专为 DSH Web GUI 打造，提供了一套可视化的多 Agent 工作流编排方案。
核心功能¶
该插件旨在解决复杂任务下的流程编排问题，核心能力包括：
- 可视化流程设计：提供画布界面，支持节点拖拽、连线配置，运行时可实时观察与纠偏。
- Agent 自主元编排：Agent 不再仅执行预设流程，可在编排过程中获取组织资产与经验，自主生成或调整组织结构。
- 双模式架构：
- 流程编排模式：支持长流程多 Agent 智能调度，可随时暂停、断点续跑。
- API 服务模式：一键发布为独立 REST API 服务（OpenAI 兼容协议），支持多租户会话隔离。
- 人类在环：支持运行中的人工干预，修改流程后实时感知拓扑动态调整。
- 定时触发：内置定时任务，支持配置执行窗口与触发策略，错过窗口自动挂起或续跑。
- 零官方包依赖：所有 DSH 生态服务（LLM、子代理、工具等）均通过
ctx.get()运行时解析，插件自身无任何官方包编译时依赖。 - 数据库支持：支持 SQLite、MySQL、PostgreSQL，提供向量检索与结构化查询能力。
架构与概念¶
插件引入了“元编排”概念，将工作流、智能体团队、组织记忆组合在同一个工作台中。
- 节点类型：包括父代理（核心调度者）、子代理（任务执行者）、文件、数据库、阶段（启动/结束/暂停）、协作组、虚拟节点。
- 连线类型：
- 流程连线：控制执行顺序（冷灰）。
- 上下文连线：传递文本内容与文件索引（琥珀金）。
- 数据库连线：传递数据库服务标识（天蓝）。
- 条件连线：通过（翠绿）、不通过（珊瑚红）、内容（紫罗兰）。
典型用法¶
- MCP 配置：mcp 服务器只需一行配置即可自动注册并支持热重载。
- 断点续跑：流程运行至“暂停”节点或意外中断后，状态持久化，恢复后从断点继续执行，不重跑已完成的节点。
- 独立部署：将 DSH 作为独立后端服务部署，实现无头 Agent 后台运行，可连接外部 APP（如 QQ 机器人、飞书）。
注意事项¶
- 不适配 Alpha 版（对齐最新候选版 dsh v0.1.5-rc.1）。
- 对于强破坏性变更的版本不准备适配。
- 关闭工具散文段不影响工具调用能力。
- 插件编排层依赖官方父子代理交互规则。
