目标与计划：跨轮次的持续任务与日志化的计划模式

示例本次示例：一个跨 turn 的目标

# 用户：/goal "把这个目录的所有 TODO 修完"
# command-goal 注册目标（commands 旁路，23 页）
# 一个 turn 修完 3 个 TODO，还剩 2 个 → turn 以 completed 关闭（05 页）
# goal-round-driver（inject=['agents','goals','sessions']）：
#   监听 agent/* 事件 → 检查 goal 状态（sessions 读日志判断完成度）
#   → 未完成 → 经 agent 事件发起下一个 turn（续跑）
# → 直到 5 个 TODO 全修完 → goal 完成 → 不再续跑
# 全程不需要用户再输入——goal 是「持续任务」，跨多个 turn

# 用户：/plan "重构认证模块"
# PlanModeController（plan-mode/src/index.ts:202）：
#   切换工具面（tools：计划专用工具集）
#   切换提示词面（systemPrompt：计划模式指引）
#   状态落盘（logged state）→ 可回放
# 模型产出计划文档 → 用户批准 → 切回执行模式
# 注意：loop 没改一行（05 页）——换的是模型看到的东西（12/14 页）

§1挂载条目

• goal → @deepseek-ai/dsh-goal（1291 行）——目标注册表
• goal-round-driver → dsh-goal-round-driver——把 goal 转成轮次
• command-goal → dsh-command-goal（226 行）——/goal 命令
• tool-goal → dsh-tool-goal——模型操作目标的工具
• plan-mode → dsh-plan-mode——计划模式（PlanModeController，202 行）

§2包文件地图

§3机制：goal 轮驱动与 plan 状态

1. goal 的续跑：goal-round-driver 监听 agent/* 事件——一个 turn 结束后若 goal 未完成，它通过 agent 事件发起下一个轮次（05 页 turn-stopping 的「数据决定」之外的另一条续跑通道）。goal 是「同会话目标」，与 subagent 的「另开会话」相对。
2. plan 是日志化的状态：进入计划模式 = 一个可回放的持久状态切换。PlanModeController 通过 tools + systemPrompt 注入切换模型的行为面（计划工具集 + 计划提示词）。
3. 命令与工具双入口：用户 /goal（命令，23 页的旁路）与模型 tool-goal（工具）都能操作目标——同一能力、两个入口，这是 dsh 的常见形态。

§4关键代码

202export class PlanModeController extends Service {
203  static inject = ['tools', 'systemPrompt']

19export const inject = ['agents', 'goals', 'sessions']

§5易错点