目录:ACP 协议API 网关与控制器附件启动与插件管理客户端运行时客户端 UI 包上下文压缩上下文注入核心运行时凭据与授权交付物文档处理实验特性宿主扩展反馈通道文件系统目标与计划工具守卫Hooks 扩展宿主服务交互命令作业调度LLM 适配LSP 集成MCP 协议规划模式Agent 预设代码执行运行时运行时诊断沙箱定时调度SDK 与协议会话核心会话检索设置Shell 执行技能溢出存储SSH 远程执行存储子代理子进程终端待办类型契约框架 vendorWeb 访问Webhook工作流工作区
依赖链 · 上游（该插件依赖的前驱）：
dsh-agentdsh-commandsdsh-invariantsdsh-llmdsh-sessiondsh-session-projectiondsh-toolsdsh-user-questions
依赖链 · 下游（依赖该插件的节点）：
同一拓扑层（Layer 6，层次遍历层序）：
dsh-agent-presetdsh-command-goaldsh-compaction-basicdsh-experimental-auto-reviewdsh-goal-round-driverdsh-host-plugin-inventorydsh-mcp-clientdsh-office-to-pdfdsh-plan-modedsh-plugin-package-inventory-deepseekdsh-subagentdsh-terminal-bashdsh-tool-ask-userdsh-tool-bash-persistentdsh-tool-cordisdsh-tool-goaldsh-tool-pwsh-persistentdsh-tool-terminal
插件信息
| 包名 | @deepseek-ai/dsh-plan-mode |
|---|---|
| 分组 | G26 · 规划模式 |
| 拓扑层 | Layer 6（层次遍历：被依赖方先于依赖方） |
| 源码路径 | packages/plan/plan-mode |
① 实现逻辑
PlanModeController 注册 `plan` 会话投影，折叠 command/run、command/done、plan/mode、request/header 事件以还原模式状态与待选意图（src/index.ts:137-169）。用户切换经 pendingIntents 暂存，仅在下一个被接受的 in-turn agent/pre-step 里 append plan/mode 并附模式切换叙述（src/index.ts:197-214、:419-454）。服务同时注册仅激活时渲染的 plan:policy 提示段（src/index.ts:217-225）、条件注入的 /plan on|off 命令（src/index.ts:230-276）与常驻 exit_plan_mode 工具——后者经 userQuestions 呈现计划评审，批准则排队退出（src/index.ts:278-366）。invariant.ts 校验 plan/mode 的 active 必须是布尔（src/invariant.ts:20-49）。
内部结构动态 DAG（深色主题：橙色=上游依赖 · 绿色=下游依赖 · 棕色=外部seam · 蓝=本插件）
本插件
上游依赖
下游依赖
外部 seam
② 注册/提供（provides）
- ctx.planMode (日志化计划协作状态控制器，src/index.ts:59-61、:176-469)
- sessionProjections `plan` 投影（cropped {active,pending}，src/index.ts:227、:137-169）
- ctx.tools 的 `exit_plan_mode` 工具（提交计划供用户评审，src/index.ts:278-366）
- ctx.commands 的 `/plan` 命令（on/off 与消息附带，条件注册，src/index.ts:230-276）
- systemPrompt `plan:policy` 段（部署自有计划指导，仅激活时渲染，src/index.ts:217-225）
③ 依赖（depends_on · 上游前驱）
dsh-agentE1
阅读并驱动 Agent 的会话与预备步决策
src/index.ts:29 type import Agent/PreStepDecision + src/index.ts:202 agent.session
dsh-commandsE1+E2
注册 /plan 命令并关联命令生命周期事件
src/index.ts:35 type import CommandDefinitionId + src/types.ts:11 CommandId + src/index.ts:230 ctx.inject(['commands'])
dsh-invariantsE1+E2
注册 plan/mode 载荷校验不变式
src/invariant.ts:5 type InvariantInstaller + src/invariant.ts:49 ctx.invariants.register
dsh-sessionE1
追加 plan/mode 事件供投影折叠与恢复
src/index.ts:32 type Session/UserMessage + src/invariant.ts:4 + src/index.ts:434 session.append('plan/mode')
dsh-session-projectionE1+E2
注册 plan 投影并读取 plan/turnBoundary 状态
src/index.ts:36-37 type import ProjectionDefinition + src/index.ts:227 ctx.sessionProjections.register + src/index.ts:374 stateOf
dsh-toolsE1+E2
注册常驻的 exit_plan_mode 工具
src/index.ts:33 import defineTool + src/index.ts:177 inject 'tools' + src/index.ts:278 ctx.tools.register
dsh-user-questionsE1+E2
呈现计划评审问答通道
src/index.ts:34 import UserQuestionError + src/index.ts:303 ctx.get('userQuestions')
④ 被依赖（dependents · 下游消费者）
dsh-client-ui-conversation
计划模式输入提示
src/client/skeleton/InputBar.tsx:24 import @deepseek-ai/dsh-plan-mode