dsh-visual-workflow

<h1 align="center">可视化 Agent 编排平台</h1>

基于 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> 打造的可视化 Agent 编排平台<br> 支持固定 Workflow、可视化流程设计、Agent 自主元编排，可在运行过程中实时干预，通过反馈沉淀经验持续演化

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

---

项目定位

这是一个可以“越用越聪明的”的 Agent 编排平台，不再是单纯的 workflow。

项目将 工作流（Workflow）、智能体团队（Agent Team）、元编排（Meta-Orchestration）、人类在环（Human-in-the-loop）和组织记忆（Organizational Memory） 组合在同一个可视化工作台中：

                    ┌─────────────────────┐
                    │      人类设计        │
                    │   固定 Workflow      │
                    └──────────┬──────────┘
                               │
                               ▼
┌─────────────────┐     ┌───────────────┐     ┌──────────────────┐
│ Agent 自主规划   │ ──► │  组织生成/执行 │ ◄── │ 运行中人工干预     │
│Meta-Orchestration│    └───────┬───────┘     └──────────────────┘
└─────────────────┘             │
                                ▼
                         ┌─────────────────┐
                         │  自主经验学习    │
                         │ Experience      │
                         └────────┬────────┘
                                  │
                                  ▼
                         ┌─────────────────┐
                         │  组织记忆        │
                         │Assets + Experience│
                         └────────┬────────┘
                                  │
                                  └──────► 下一次组织生成

因此，项目此刻正式从曾经的 dsh Visual Workflow 重命名为：可视化 Agent 编排平台。

---

核心亮点

✦ Agent 元编排

• Agent 不再只能执行人预先画好的固定 DAG，而可以在编排过程中获取组织资产与经验，并根据当前任务生成、调整组织结构，并通过反馈强化学习持续进步

✦ 人类在环的实时调整

• 人类修改流程后，编排器实时感知最新拓扑动态调整后续编排；Agent 改图后，画布实时显示变化，编排与画布始终一致，运行中 可观察、可纠偏。

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

✦ 深度自定义

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

✦ 定时触发

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

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

✦ 双模式架构

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

✦ 团队（Agent Team）

• 将多个角色节点拖入团队卡片，连通官方 Agent team 机制，将自定义配置连通 teammate，可精确控制其协作行为，使用模型，工具组等，runtime 和协调工具由官方机制负责。
• Agent Team 功能关闭时，降级由本插件通信机制负责组内协作（无任务板），通过 wf_send_message 工具进行组内交流。

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

✦ 零官方包依赖

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

---

核心概念

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

---

节点卡片

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

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

…