目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
同一拓扑层（Layer 7，层次遍历层序）：
dsh-acpdsh-api-session-controllerdsh-experimental-browser-use-stagehand-nativedsh-experimental-computer-use-cua-driver-mcpdsh-experimental-computer-use-cua-driver-nativedsh-hooks-claude-codedsh-plugin-managerdsh-subagent-acpdsh-subagent-claude-codedsh-subagent-codexdsh-subagent-dsh-sdkdsh-subagent-fork-in-processdsh-subagent-spawn-in-processdsh-tool-subagentdsh-tool-subagent-controldsh-workflow-ptc
插件信息
| 包名 | @deepseek-ai/dsh-workflow-ptc |
|---|---|
| 分组 | G49 · 工作流 |
| 拓扑层 | Layer 7（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/workflow/workflow-ptc |
① 实现逻辑
PtcWorkflowEngine 继承 dsh-workflow 的 WorkflowEngine 并注册为 ctx.workflowEngine (src/index.ts:102-189)。start() 先校验 meta（src/meta.ts:76-82）与脚本体可解析，再解析子代理 provider 与总子代理上限，构造 WorkerInit 与 PtcWorkflowRun (src/index.ts:133-174)。PtcWorkflowRun 通过注入的 ctx.ptcRuntime 在沙箱 Node 进程中执行脚本，VM 提供 agent/parallel/pipeline/phase/log 钩子并按调用方 Session 的文件策略约束 (src/host.ts:112-306, src/runtime.ts:56-367)。运行管理子代理的启动、结果、取消与释放，并在 start() 后发出 workflow/* 事件。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- ctx.workflowEngine (基于共享沙箱 PTC 执行器的工作流引擎实现)
③ 依赖（depends_on · 上游前驱）
dsh-llmE1
把子代理最终输出块展平为文本作为 agent() 结果
package.json:32 peerDep + src/runtime.ts:10 import type { ContentBlock } + src/types.ts:7 import type { ContentBlock }
dsh-sandbox-policyE1+E2
按调用方 Session 解析文件/沙箱策略并施加于运行
package.json:39 peerDep + src/index.ts:12 import type {} from dsh-sandbox-policy + src/index.ts:103 inject 'sandboxPolicy' + src/index.ts:166 ctx.sandboxPolicy.resolve
dsh-sessionE1
以 SessionId 标识子代理会话身份
package.json:33 peerDep + src/host.ts:6 import { SessionId } + src/runtime.ts:11 import type { SessionId }
dsh-subagentE1+E2
为脚本的 agent() 钩子启动/等待/释放子代理
package.json:34 peerDep + src/host.ts:7-8 import SubagentRuntime/SubagentRun + src/index.ts:103 inject 'subagents' + src/host.ts:200 subagents.start
dsh-toolsE1
校验 agent() 的结构化输出 schema 是否在支持子集内
package.json:35 peerDep + src/host.ts:9 import { assertObjectJsonSchema } + src/runtime.ts:12 import { assertObjectJsonSchema, JsonSchemaError }
④ 被依赖（dependents · 下游消费者）
dsh-tool-ralph
base bundle 中 workflow-ptc 先行装配以提供 ctx.workflowEngine，tool-ralph 随后装配使用该服务
packages/bundle/base/cordis.patch.yml:392-397, 446-448
dsh-tool-workflow
base bundle 中 workflow-ptc 先行装配以提供 ctx.workflowEngine，tool-workflow 随后装配使用该服务
packages/bundle/base/cordis.patch.yml:392-398