Dynamic Workflow
简体中文 | English
在 Harness 中运行 JSON 工作流，查看阶段进度和节点结果，选择子 Agent 模型，并在继续执行时复用有效的已完成结果。同一个胶囊代理可以跨阶段保留 Agent 会话和历史，每个阶段使用对应的角色提示词和工具策略。
安装
克隆仓库到会话的工作目录，并在 Harness 插件管理中选择克隆后的 dynamic-workflow 目录安装插件包：
git clone https://github.com/orion-nebula-dev/dsh-Dynamic-Workflow.git dynamic-workflow
插件启用后，在会话输入框使用 /workflow。
命令与快速开始
在会话输入框输入 /workflow 查看用法。单独输入该命令会返回帮助；图形面板通过会话右上角的「工作流」入口打开。
| 命令 | 操作 |
|---|
/workflow 或 /workflow help | 查看命令用法 |
/workflow run <JSON文件路径> | 读取文件并启动工作流 |
/workflow list | 查看当前会话的运行记录和 runId |
/workflow status <runId> | 查看阶段进度和节点状态 |
/workflow resume <runId> | 使用保存的定义和进度继续执行 |
/workflow revise <JSON> | 停止旧运行，读取新定义并按条件复用结果 |
/workflow stop <runId> | 停止运行并等待子 Agent 清理 |
/workflow models | 查看可用模型的 provider 和 model 标识 |
安装完成后，在克隆目录的上级工作区运行附带的只读示例：
/workflow run dynamic-workflow/workflow.example.json
示例包含「制定任务方案」「独立检查方案」和「按意见修订并交付」三个节点。路径相对于会话的当前工作目录解析，含空格时可以加引号。运行命令会返回 runId，后续查询、停止和继续操作使用这个标识。
需要指定模型、并发数或节点时，使用 JSON 参数。先运行 /workflow models，再用返回的实际标识替换下面的占位符：
/workflow {"action":"run","workflowPath":"dynamic-workflow/workflow.example.json","provider":"<provider>","model":"<model>","concurrency":2}
/workflow {"action":"resume","runId":"<runId>","provider":"<provider>","model":"<model>"}
/workflow {"action":"status","runId":"<runId>","nodeId":"<nodeId>"}
旧命令 /dynamic-workflow 保留为兼容入口。
查看进度与选择模型
- 点击会话右上角的「工作流」，打开详情面板。
- 打开「运行配置」，填写「工作流文件路径」。可以输入
dynamic-workflow/workflow.example.json 运行附带示例。
- 选择「子 Agent 模型」和「最多同时运行」的数量，再点击「运行工作流」。模型列表来自 Harness 当前配置。
- 在「运行记录」中选择本次运行，查看阶段进度。点击代理行查看节点结果，或点击「查看工作流定义」核对任务。
- 需要换模型时，选择新模型并点击「切换模型并继续」。具体恢复规则见下一节。
助手调用 dynamic_workflow 的 run 或 resume 后，对应消息中会显示工作流卡片。卡片横向展示阶段、状态连线和代理行，完成后在底部提供结果入口。展开后以纵向时间线显示阶段及节点结果。
工作流运行时，卡片定时读取节点状态。显示内容以 Host 返回值为准；读取失败时显示错误。通过命令或助手创建运行后，可以打开面板或点击刷新按钮获取记录。
切换模型并继续
选择新模型，再点击「切换模型并继续」。插件先停止旧运行，等待子 Agent 清理完成，再创建继承原运行的新记录。已完成且有效的节点结果会复用；定义未变、身份及指纹验证通过的未完成节点，会恢复原 Agent 会话，并在第一次新请求前应用所选模型。
恢复使用 Harness 原生子 Agent 续聊能力，保留同一个 Agent 会话 ID，以及已持久化的消息、工具结果和上下文。节点详情显示会话 ID，成功续跑后显示「原会话续跑」。这不迁移模型服务端的 KV 缓存、尚未持久化的流式片段或正在执行的进程状态。
模型选择属于本次运行，不会改变会话的模型设置。选择「沿用已有模型配置」时，继续使用已有运行和节点的模型配置；没有显式配置时沿用会话模型。
原会话验证通过后，未完成节点可以在同一会话内继续，无须将节点标为 retrySafe。续聊提示要求 Agent 先核实中断操作的实际状态，避免重复执行；历史恢复不能保证外部操作恰好执行一次。
如果旧记录没有保存 Agent 身份，只能保留有效的完成结果，未完成节点按原有重试和审核规则处理：可能重复产生影响的中断节点标为 needs_review；确认允许重复执行后，才设置 retrySafe: true。只读示例已设置这个选项。已经保存身份但无法找到原会话时，插件会报错，不会自动创建新 Agent 替代；身份或指纹不匹配也不会绕过审核。
全局自动工作流
插件配置中的「全局自动工作流」默认关闭。打开后，每条主会话用户消息都会先由当前会话模型进行一次轻量判断：普通消息直接交给主会话；多步骤任务会提示主会话创建工作流；已有工作流运行时，改变目标或约束的消息会先停止并等待子 Agent 清理，再提示主会话修订工作流。子 Agent 和工具返回不会再次触发这层判断。
自动判断会增加一次模型请求。插件只负责分类、停止和传递修订上下文，工作流定义仍由主会话模型通过 dynamic_workflow 创建或修订。修订时应保持兼容节点的 id 和工作流 id，以便校验并复用有效结果；阶段角色提示词和 tools 会在每次阶段激活前重新应用。若历史或指纹不兼容，插件不会静默替换 Agent，主会话需要说明触发消息和不可复用原因。
修改任务
新要求改变任务内容时，让助手查询当前状态、停止运行，然后修改工作流 JSON 并重新运行。保持节点 id 稳定，才能复用相应结果。追加阶段可以继续使用原胶囊代理。已经运行过的共享代理阶段保留了真实会话历史，修改该阶段的提示词、角色、工具或依赖后，插件会报告历史不匹配；如需从头执行修改后的流程，应使用新的工作流 id。未配置 agentId 的旧式独立节点仍按原规则使修改节点及其后继缓存失效并重新执行。
「继续工作流」使用运行中保存的定义。修改磁盘上的 JSON 后，应使用「运行工作流」读取新定义。
工作流文件
{
"id": "example",
"title": "方案与评审",
"nodes": [
{
"id": "plan",
"title": "制定方案",
"prompt": "只输出一份简短方案，不调用工具或修改文件。",
"retrySafe": true
},
{
"id": "review",
"title": "检查方案",
"deps": ["plan"],
"prompt": "检查 Dependencies 中的方案，输出一条改进意见。不调用工具或修改文件。",
"retrySafe": true
}
]
}
id 是工作流的稳定标识。nodes 是节点数组，节点 id 必须唯一。deps 填写前置节点的 id。节点可以指定 provider、model 和结构化输出 schema；省略模型时使用运行或会话配置。前置节点的结果会以 JSON 数据传给后继节点。
胶囊代理与阶段角色
每个胶囊代表一个 Agent。agents 定义稳定代理，节点的 agentId 绑定该身份；相同 agentId 的阶段共用同一个原生 Agent 会话 ID、消息历史和工具结果。不同代理可以并行；同一代理的阶段按 DAG 的稳定拓扑顺序串行执行，即使省略前后阶段之间的依赖也不会并发唤醒它。
roles 定义阶段角色。每个角色包含 prompt，可选 title 和 tools。节点用 role 引用角色；执行器在每次唤醒 Agent 前安装当前角色的系统提示词与工具策略，结束后清理，再为下一阶段安装新角色。切换角色保留历史，旧提示词仍可能作为历史上下文存在。胶囊显示当前角色，头像颜色和悬浮信息对应稳定代理。
{
"id": "two-stage-agent",
"agents": { "worker": { "title": "协作代理" } },
"roles": {
"plan": { "title": "方案设计师", "prompt": "先制定方案。", "tools": [] },
"write": { "title": "交付编写者", "prompt": "沿用方案历史，编写交付内容。", "tools": ["read"] }
},
"nodes": [
{ "id": "plan", "agentId": "worker", "role": "plan", "prompt": "提出方案。" },
{ "id": "deliver", "agentId": "worker", "role": "write", "deps": ["plan"], "prompt": "完成交付。" }
]
}
tools 是允许调用的 Harness 工具名称列表，工具必须在当前组合中可用。[] 禁止本阶段所有工具调用；省略则沿用可用工具。节点的 tools 可以覆盖角色的列表。策略会同时限制继承的工具和实际调用，不能借工具封装通道绕过；子 Agent 自己注册的工具可能仍出现在目录中，但未获允许时无法执行。显式工具策略使用原生工具展示。角色不会修改父会话的工具权限。
附带示例使用两个胶囊代理：方案代理在第一阶段担任方案设计师，在第三阶段切换为交付编写者；评审代理独立执行第二阶段。三阶段对应两个 Agent 会话。
没有 agentId 的旧节点保持各自独立的 Agent 会话。agentTitle 只用于旧式显示名称；同名标签不会自动合并身份。新配置应显式填写 agentId 和 role。
助手工具
工具名为 dynamic_workflow。界面通过 /workflow 会话命令调用同一组 Host 操作。
| 操作 | 参数 | 用途 |
|---|
run | workflowPath，可选 model、provider、concurrency | 读取文件并运行，复用有效的既有结果 |
resume | runId，可选 model、provider、concurrency | 停止旧运行并继承保存的定义和进度 |
status | runId，可选 nodeId | 查询状态、定义、节点结果和 Agent 诊断 |
models | 无 | 查询当前可用的模型目录 |
stop | runId | 取消执行并等待子 Agent 清理 |
list | 无 | 查询当前会话的运行历史 |
concurrency 的范围是 1–8。run 默认使用 1；resume 沿用原运行的值，除非显式指定。模型值应使用实际模型列表中的标识，不要将「会话当前模型」等界面文案当成模型标识。
持久化与限制
运行记录、定义、节点快照及节点对应的 Agent 身份保存在 Harness 的 storageDomain 中，并按父会话隔离。Agent 消息历史由 Harness 原生会话持久化服务保存。插件重载或 Harness 重启后可以查看历史；查看历史不会自动执行节点。
status 指定 nodeId 时，agent 返回对应会话最新实际请求的模型，而非仅返回工作流选择值。Agent 仍在运行时还包含有长度上限的最近助手消息。历史运行与后续运行可以引用同一 Agent，因此这里反映该会话的最新请求；读取持久化诊断不会激活 Agent。
工作流文件最多 1 MiB、100 个节点。节点详情会截断较长的展示内容。缓存根据工作流定义和依赖结果判断是否有效；任务依赖的外部资料变化时，应由助手更新相应输入，避免复用过期结果。
阶段按节点展示；依赖关系包含节点的 deps 和共享代理的隐式前置阶段。每次激活会重新安装阶段角色与工具策略，重启后也会在原 Agent 会话恢复前安装。
