目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
同一拓扑层（Layer 8，层次遍历层序）：
插件信息
| 包名 | @deepseek-ai/dsh-tool-workflow |
|---|---|
| 分组 | G49 · 工作流 |
| 拓扑层 | Layer 8（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/workflow/tool-workflow |
① 实现逻辑
注册模型可见的 workflow 工具（默认名 workflow）与使用指引章节 (src/index.ts:315-483)。前台执行把脚本交给 ctx.workflowEngine.start 并 await result，非 completed 停止原因转为工具错误 (src/index.ts:433-479)；run_in_background 则把运行注册为 ctx.jobs 作业并立即返回 jobId (src/index.ts:262-313)。createWorkflowRecorder 把 workflow/* 事件折叠成 tool-workflow/* 会话记录 (src/index.ts:93-151)，record.ts 把进度镜像进作业输出环 (src/record.ts:37-63)，invariant.ts 作为伴生插件校验这些记录的持久化不变量 (src/invariant.ts:132-168)。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- tools.workflow (模型可见的工作流编排工具，前台/后台两态)
- systemPrompt 章节 tool:workflow
- tool-workflow/* 会话事件 (持久化的工作流运行记录)
- invariants 伴生校验 (tool-workflow 记录折叠)
③ 依赖（depends_on · 上游前驱）
dsh-agentE1+E2
取得调用方 Agent 以归属后台作业与工作流运行记录
package.json:41 peerDep + src/index.ts:19 import type { Agent } + src/index.ts:407 exec.agent + src/index.ts:442 parent.session
dsh-invariantsE1+E2
注册 tool-workflow 记录的伴生不变量校验器
package.json:42 peerDep + src/invariant.ts:5 import type { InvariantFailure, InvariantInstaller } + src/invariant.ts:13 static inject ['invariants'] + src/invariant.ts:168 ctx.invariants.register
dsh-llmE1
工具呈现使用 dsh-llm 的内容块类型
package.json:44 peerDep + src/index.ts:20 import type { ContentBlock }
dsh-sessionE1+E2
把运行记录写入会话并订阅会话事件做不变量折叠
package.json:45 peerDep + src/index.ts:22 import type { Session, SessionEventMap } + src/index.ts:102 session.append + src/invariant.ts:4 import type { Session, SessionEvent } + src/invariant.ts:154 ctx.on('session/event')
dsh-system-promptE1+E2
注册 workflow 工具的使用策略提示章节
package.json:46 peerDep + src/index.ts:41 inject 'systemPrompt' + src/index.ts:323 ctx.systemPrompt.section
dsh-toolsE1+E2
注册 workflow 工具定义与呈现
package.json:47 peerDep + src/index.ts:17 import { defineTool } + src/index.ts:41 static inject ['tools','workflowEngine','systemPrompt'] + src/index.ts:328 ctx.tools.register
dsh-workflow-ptcE3
base bundle 中 workflow-ptc 先行装配以提供 ctx.workflowEngine，tool-workflow 随后装配使用该服务
packages/bundle/base/cordis.patch.yml:392-398
④ 被依赖（dependents · 下游消费者）
dsh-client-ui-workflow-run
解析工具侧工作流成员事件数据
src/client/workflow-definition.ts:8 ToolWorkflowAgentStartData/EndData