/goal 子命令、参数、状态与行为的完整参考
/goal 用于为当前会话设定一个持久化目标，让 Agent 围绕该目标持续自主执行。本页列出全部子命令、参数与状态行为。关于 Goal 模式的使用指南，见 持续完成目标。
直接运行 /goal（不带子命令）等同于 /goal status，显示当前目标状态。
子命令
| 子命令 | 参数 | 说明 |
|---|---|---|
/goal set | <描述> [--turns <N>] | 创建或更新目标。设定后自动切换到 auto 权限模式。 |
/goal status | 无 | 显示当前目标的描述、状态、已用轮数与已用时间。 |
/goal clear | 无 | 移除当前目标，并恢复设定目标前的权限模式。 |
/goal pause | 无 | 暂停当前目标，恢复权限模式。 |
/goal resume | 无 | 恢复被暂停的目标，重新进入 auto 权限模式。 |
/goal take | 无 | 认领由其他会话拥有的目标，转为当前会话所有。 |
set 参数
/goal set <描述> [--turns <N>]
<描述>（必填）：目标的自然语言描述。省略描述会提示用法。--turns <N>（可选）：最大交互轮数。N必须为正整数；非法值会被忽略。达到上限后目标转入TurnLimited状态。
状态字段
目标状态持久化保存，包含以下字段：
| 字段 | 说明 |
|---|---|
objective | 目标描述。 |
status | 状态：Active / Paused / TurnLimited。 |
maxTurns | 最大轮数上限（可选）。 |
turnsUsed | 已用轮数。 |
timeUsedSeconds | 已用时间（秒）。 |
ownerSessionId | 拥有该目标的会话 ID（用于多会话协作）。 |
planWasActive | 目标激活前是否处于 Plan 模式（用于恢复后还原）。 |
关键行为
- 权限模式自动切换：
/goal set与/goal resume会自动切换到auto权限模式，并在目标激活期间锁定 Shift+Tab 切换；/goal clear与/goal pause会恢复之前的模式（仅当当前仍为auto时才还原）。 - 跨会话持久化：目标随会话持久化。若进程被意外终止时目标处于
Active，下次启动会自动降级为Paused，可用/goal resume重新激活。 - 所有权：目标记录拥有它的会话 ID。其他会话看到目标时需先用
/goal take认领，才能更新它。这避免了新窗口静默继承另一个会话未完成的目标。 - Plan 状态恢复：若目标在激活前处于 Plan 模式，
/goal resume在进程重启后会一并恢复 Plan 模式。 - 轮数限制：设置了
--turns时，turnsUsed达到maxTurns后目标转入TurnLimited。