可视化 Agent 编排平台

基于 DeepSeek Harness 打造的可视化 Agent 编排平台
支持固定 Workflow、可视化流程设计、Agent 自主元编排，可在运行过程中实时干预，通过反馈沉淀经验持续自进化

English · 简体中文

项目定位

这是一个可以“越用越聪明的”的 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 改图后，画布实时显示变化，编排与画布始终一致，运行中 可观察、可纠偏。

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

✦ 双模式架构

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

✦ 深度自定义

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

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

✦ 协作组与 Agent Team

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

✦ 定时触发

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

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

✦ 零官方包依赖

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

核心概念

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

节点卡片

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

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

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

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

属性配置：

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

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

2. 任务节点

任务以文本描述（内容直接存于模板/节点，运行期作为下游角色节点的上下文）
右侧属性面板可编辑任务名称与任务描述；文本框下方的「选择文件」只把所选文件路径追加进描述，不上传文件
功能：给角色节点注入任务说明、需求、验收标准等上下文

3. 数据库节点

本地类型：支持 SQLite 文件，内置向量检索（bge-small-zh-v1.5，CPU 推理；模型资产缺失/加载失败自动降级 BM25）
服务器类型：支持 MySQL / PostgreSQL，提供结构化只读查询与向量检索（本地构建索引）
右侧面板可配置连接信息、测试连接，并调整检索高级选项（召回条数、分块窗口、相似度阈值、索引容量）
功能：连接企业/个人知识库调用相关信息和查询检索

4. 阶段节点

启动（模式一） / 输入（模式二）：流程入口；模式二下自动接收外部用户问题作为初始上下文
结束（模式一） / 输出（模式二）：流程终点；模式二下汇聚父代理最终输出并流式返回
暂停（模式一）：流程门，运行至此暂停并保存断点（人工审查点），再次运行从右出继续

5. 协作组节点（Agent Team）

将多个角色节点拖入协作组，组内角色登记为 Teammate 并行启动并参与协作
协作 Prompt 追加到每个成员的首条用户消息末尾，并自动列出所有成员的 ID 与角色名称（插件协作机制，现已被官方取代，保留降级）
组内 Agent 通过 wf_ask_agent 异步通信、通过 wf_ask 向用户交流提问（保留降级）
卡片支持拉伸扩展，内部成员列表可滚动

连线

连线类型与颜色：

连线类型	语义说明	颜色
流程连线	控制执行顺序	⚪ 冷灰 / 银白
上下文连线	传递任务描述等文本内容	🟡 琥珀金
数据库连线	传递数据库服务标识	🔵 天蓝
条件：通过	条件判断为真，执行该分支	🟢 翠绿
条件：不通过	条件判断为假，执行该分支或回流	🔴 珊瑚红
条件：内容	自定义语义判断（路由标签）	🟣 紫罗兰

编辑条件后，条件颜色覆盖初始颜色；条件判断由父代理进行语义判断。

编排工具

以下工具构成当前编排层的主要控制面：

工具	用途
`wf_run_node`	Mode 1 异步启动一个 Agent 节点或整个协作组；立即返回，不阻塞父代理等待
`wf_run_node_wait`	Mode 2 启动 Agent 节点并阻塞等待，返回 `ok / fail` 与最终输出
`wf_finish`	标记本次编排完成/失败、持久化运行记录并释放运行锁；幂等
`wf_ask`	向用户发起官方提问卡片并等待回答，一次可批量提问；任何代理可用（子代理自动借其会话根代理身份）
`wf_ask_agent`	协作组内 Agent 间非阻塞 `ask / reply` 消息通信；目标离线时可冷恢复
`wf_db_query`	数据库 `search / query / schema` 三模式只读访问
`wf_org_catalog`	召回组织资产、工具组合、preset、模型与编排规则；父代理专用
`wf_graph_patch`	对工作流模板或运行实例进行受控图修改；支持创建、更新、删除、连线调整等操作
`wf_experience_learn`	主体自己的经验入库：空数组调用取得经验生成 Prompt，传候选即校验后入库（所有代理可用）
`wf_experience_recall`	按主体类型语义召回既有经验：先取候选摘要，再按 id 取完整内容（所有代理可用）

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

安装（Windows）

版本适配：本插件适配 DeepSeek Harness 0.2.0-rc.2。请先安装或升级宿主（升级前先在外部终端完全停止 dsh 进程）：
npm install -g @deepseek-ai/dsh@0.2.0-rc.2
tips：可直接将以下段落复制给 Claude Codex 等 AI 助手安装该插件。

文件管理器定位：%USERPROFILE%\.dsh\profiles\web\pnpm-workspace.yaml,在其中添加：

allowBuilds:
  onnxruntime-node: true
  protobufjs: true
  sharp: true

运行插件安装命令:

dsh plugin --profile web add "github:GZX2211/dsh-Visual-Workflow#main"

桌面端可直接在左上角插件页面内添加：

输入然后点击安装即可：

github:GZX2211/dsh-Visual-Workflow#main

验证挂载：（可选）

dsh --profile web --dump-config | findstr "visual-workflow"

重启 dsh web。打开工作台：点击官方左侧边栏底部的「工作流」入口（在官方「设置」旁）→ 官方右侧 Sidebar 打开「工作流」标签页即完整工作台。

安装问题速查

出现 Host key verification failed 报错

在 PowerShell 或 CMD 中执行：

git config --global url."https://github.com/".insteadOf "git@github.com:"

pnpm 拦截提示：声明了 prepare，需要allowBuilds（常见）

文件管理器定位：%USERPROFILE%\.dsh\profiles\web\pnpm-workspace.yaml，把报错中给出的包名添加到 allowBuilds 列表里，保存再重新安装。

卸载

dsh plugin --profile web remove dsh-visual-workflow

如不再使用可同步清理：~/.dsh/visual-workflow/ 文件夹。

快速开始

方式一：人工设计 Workflow

打开「工作流」工作台。
创建工作流模板。
创建角色模板。
将角色、文件、数据库、阶段、协作组拖入画布。
使用 flow / ctx / db 连线。
配置各 Agent 的模型、Prompt 与工具组合。
创建实例。
点击运行。

方式二：让 Agent 设计组织

在主会话中输入：

/arrange <你的规划意图>

例如：

/arrange 做一个内容生产流水线，包含选题、资料收集、成稿、审核和发布五个阶段

Agent 会：

自然语言意图
    ↓
wf_org_catalog
    ↓
读取相关资产 / 经验 / 规则
    ↓
生成组织方案
    ↓
wf_graph_patch
    ↓
创建 / 修改工作流模板
    ↓
用户确认
    ↓
运行

/arrange 本身只负责注入规划指令，不会因为规划完成而自动运行工作流。

方式三：运行中人工调整

运行 Workflow 后：

观察画布中的实时节点状态。
直接修改画布中的节点或连线。
保存修改。
编排器感知最新拓扑。
后续调度基于最新组织继续执行。

也可以在流程中使用 暂停/pause 节点建立人工审查点。

方式四：Agent 在运行中自动调整组织

父代理根据运行事实发现当前组织不再合适时会自己调用 wf_graph_patch 修改当前实例：

例如：

当前组织
A → B → C

发现 B 不适合当前任务

动态调整
A → D → C

修改会经过图校验、组织预算与 revision 检查后落盘，并同步到运行事实源。也可在 组合管理 界面禁用该工具阻止代理自行调整，同理其他功能都可以直接通过工具管理调整运行时能力。

组合管理：顶栏「组合」按钮可创建自定义工具组合（官方工具/自建工具 + MCP 服务器），可在角色模式中选用。

定时任务：顶栏「定时任务」入口，选择工作流模板，配置执行窗口与触发策略，即可自动调度运行。

冷启动：资产与经验没办法在初次使用时即生成，如果希望 Agent 在初期就有优秀的组织能力，最好引入外部优质 prompt。

数据存储

所有文件位于 ~/.dsh/visual-workflow/，人可读 JSON：

workflows/                  # Mode 1 工作流实例
services/                   # Mode 2 服务实例
flow-templates/             # 可编辑 Workflow 模板
roles/                      # 可编辑角色模板
files/                      # 文件模板
databases/                  # 数据库模板
combos.json                 # 自定义工具组合

runs/                       # 运行快照与历史
orchestrations/             # 运行期间的编排事实源

assets.db                   # 正式角色/工作流资产 + Experience
data/files/                 # 受管非文本文件
data/vector/                # 数据库向量索引
scheduler/                  # 定时任务定义与触发记录

配置

在 cordis.patch.yml 中可覆盖默认值：

- insert:
    - id: visual-workflow
      name: dsh-visual-workflow
      config:
        dataDir: !!js dshHomePath('visual-workflow')
        servicePortBase: 7860
        apiKey: null
        maxConcurrentPerService: 50
        wfAskAgentTtlMs: 120000
        runIdleTimeoutMs: 1800000
        reactIterationLimitDefault: 0
        retryLimitDefault: 3
        outputFullLimit: 102400
        documentTextLimit: 20000
        embeddingModelDir: null
        embeddingEndpoint: null
        runPollMs: 2000

本地开发

git clone https://github.com/GZX2211/dsh-Visual-Workflow.git
cd dsh-visual-workflow
pnpm install
dsh plugin --profile web add "link:$PWD"

常用命令：

pnpm typecheck      # Host / Client / Test 类型检查
pnpm build          # 构建 Host + Client
pnpm test           # 单元测试
pnpm gates          # Contract / 门禁测试
pnpm client-smoke   # Client 冒烟测试
pnpm check          # 类型检查 + 测试 + 构建 + smoke

修改 Client 需重新构建并硬刷新浏览器；修改 Host 需重启 dsh web。

目录结构（核心）

dsh-visual-workflow/
├── src/
│   ├── host/
│   │   ├── shared/               # 前后端共享纯类型契约
│   │   ├── agent/                # Agent 创建、模型选择、Prompt 注入、执行护栏
│   │   ├── assets/               # SQLite 资产库与经验持久化
│   │   ├── experience/           # 经验域（校验/投影/向量/判重/召回/主体解析）
│   │   ├── orchestrator/         # 运行时、状态机、动态编排、运行事实、团队经验注入
│   │   ├── tools/                # wf_* 编排工具
│   │   ├── graph/                # 图模型、结构校验、组织约束与预算
│   │   ├── team/                 # Agent Team 能力适配
│   │   ├── storage/              # 模板/实例/运行记录等文件存储
│   │   ├── embedding/            # 向量嵌入与索引
│   │   ├── mcp/                  # MCP 注册与配置
│   │   ├── scheduler/            # 定时任务
│   │   ├── service/              # Mode 2 服务管理
│   │   ├── api/                  # GUI API
│   │   ├── commands/             # /arrange 等命令
│   │   └── prompts/              # 编排、规划、团队经验 Prompt
│   │
│   └── client/
│       ├── sidebar/              # 官方 Sidebar 插槽与工作台入口
│       ├── studio/               # 工作台主状态与状态机
│       ├── components/           # 画布、资产、历史、定时任务等 UI
│       ├── hooks/                # UI / 数据职责单一 hooks
│       ├── styles/               # 样式文件
│       └── lib/                  # graph / remote / storage 等纯逻辑
│
├── tests/                        # 单元、集成与 contract 测试
├── scripts/                      # 构建、冒烟与开发脚本
├── assets/models/                # BGE-small-zh-v1.5 等模型资产
├── docs/                         # 架构文档与归档文件
├── cordis.patch.yml              # Web profile 挂载层
├── serve.patch.yml               # Mode 2 服务进程组合层
└── package.json

本项目核心研究方向（未来规划）

项目目前的研究方向已经从“如何设计一个更好的 Workflow”进一步转向：

如何让 Agent 根据任务动态形成、调整并持续利用一个适合当前目标的智能组织

项目的长期目标是：探索元编排架构的最终实现方式和边界。制作一个可以持续进化的 AI 系统。而依附于一个成熟的 Harness 插件框架是一个非常好的起点，希望可以持续进步，也为 dsh 插件生态做出一个优质的“产品”。

Name		Name	Last commit message	Last commit date
.githooks		.githooks
.github/workflows		.github/workflows
assets		assets
docs		docs
guardian		guardian
lib		lib
prompt		prompt
scripts		scripts
src		src
tests		tests
.gitattributes		.gitattributes
.gitignore		.gitignore
AGENTS.md		AGENTS.md
LICENSE		LICENSE
MCP注册指南.md		MCP注册指南.md
README.md		README.md
README_EN.md		README_EN.md
cordis.patch.yml		cordis.patch.yml
logs.md		logs.md
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
serve.patch.yml		serve.patch.yml
tsconfig.client.emit.json		tsconfig.client.emit.json
tsconfig.client.json		tsconfig.client.json
tsconfig.host.json		tsconfig.host.json
tsconfig.test.client.json		tsconfig.test.client.json
tsconfig.test.json		tsconfig.test.json
vitest.config.ts		vitest.config.ts

Navigation Menu

Repository navigation

About

Repository files navigation

可视化 Agent 编排平台

项目定位

核心亮点

核心概念

节点卡片

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

2. 任务节点

3. 数据库节点

4. 阶段节点

5. 协作组节点（Agent Team）

连线

编排工具

安装（Windows）

安装问题速查

卸载

快速开始

方式一：人工设计 Workflow

方式二：让 Agent 设计组织

方式三：运行中人工调整

方式四：Agent 在运行中自动调整组织

数据存储

配置

本地开发

目录结构（核心）

本项目核心研究方向（未来规划）

许可

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

可视化 Agent 编排平台

项目定位

核心亮点

核心概念

节点卡片

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

2. 任务节点

3. 数据库节点

4. 阶段节点

5. 协作组节点（Agent Team）

连线

编排工具

安装（Windows）

安装问题速查

卸载

快速开始

方式一：人工设计 Workflow

方式二：让 Agent 设计组织

方式三：运行中人工调整

方式四：Agent 在运行中自动调整组织

数据存储

配置

本地开发

目录结构（核心）

本项目核心研究方向（未来规划）

许可

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages