目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
依赖链 · 下游（依赖该插件的节点）：
无下游（叶子/被消费端）
同一拓扑层（Layer 8，层次遍历层序）：
插件信息
| 包名 | @deepseek-ai/dsh-tool-ralph |
|---|---|
| 分组 | G49 · 工作流 |
| 拓扑层 | Layer 8（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/workflow/tool-ralph |
① 实现逻辑
注册模型可见的 ralph 工具与专用 systemPrompt 章节 (src/index.ts:402-477)。execute 先校验调用方 agent，并要求子代理 provider 是「新鲜且支持结构化输出」的 (src/index.ts:218-230)，随后用固定的 RALPH_SCRIPT 通过 ctx.workflowEngine.start 启动工作流 (src/index.ts:445-453)。脚本每轮开一个无父上下文的新子代理，只传不可变目标与受 maxHandoffChars 限制的结构化 handoff，宿主侧再防御性解码每轮报告与终态 (src/index.ts:88-175, 244-331)。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- tools.ralph (模型可见的 fresh-agent Ralph 循环工具)
- systemPrompt 章节 tool:ralph (仅显式请求时使用的使用策略)
③ 依赖（depends_on · 上游前驱）
dsh-llmE1
工具结果呈现使用 dsh-llm 的内容块类型
package.json:31 peerDep + src/index.ts:10 import type { ContentBlock }
dsh-subagentE1+E2
校验并指定每轮新子代理所用的 provider（新鲜、支持结构化输出）
package.json:32 peerDep + src/index.ts:12 import type { SubagentProvider } + src/index.ts:18 inject 'subagents' + src/index.ts:219 ctx.subagents.getProvider
dsh-system-promptE1+E2
注册 ralph 的显式请求使用策略提示章节
package.json:33 peerDep + src/index.ts:18 inject 'systemPrompt' + src/index.ts:405 ctx.systemPrompt.section
dsh-toolsE1+E2
注册 ralph 工具定义与结果呈现
package.json:34 peerDep + src/index.ts:13 import { defineTool } + src/index.ts:18 static inject ['tools','workflowEngine','subagents','systemPrompt'] + src/index.ts:410 ctx.tools.register
dsh-workflow-ptcE3
base bundle 中 workflow-ptc 先行装配以提供 ctx.workflowEngine，tool-ralph 随后装配使用该服务
packages/bundle/base/cordis.patch.yml:392-397, 446-448
④ 被依赖（dependents · 下游消费者）
无下游（叶子/被消费端）