/goal 子命令、参数、状态与行为的完整参考
/goal 用于为当前会话设定一个持久化目标，让 Agent 围绕该目标持续自主执行。本页列出全部子命令、参数与状态行为。关于 Goal 模式的使用指南，见 持续完成目标。
直接运行 /goal（不带子命令）等同于 /goal status，显示当前目标状态。
子命令
| 子命令 | 参数 | 说明 |
|---|---|---|
/goal | <描述> [--turns <N>] | 创建或更新目标；不带参数时显示当前目标状态。不改变权限模式。 |
/goal status | 无 | 显示当前目标的描述、状态、已用轮数与已用时间。 |
/goal clear | 无 | 移除当前目标。 |
/goal pause | 无 | 暂停当前目标。 |
/goal resume | 无 | 恢复被暂停的目标。 |
/goal 参数
/goal <描述> [--turns <N>]
<描述>（可选）：目标的自然语言描述。省略描述时显示当前目标状态（等同于/goal status）。--turns <N>（可选）：最大交互轮数。N必须为正的安全整数，可以大于100；不符合规则的值不会生效。达到上限后目标自动暂停，可用/goal resume继续。
轮数上限
| 场景 | 生效上限 |
|---|---|
新建或替换 Goal，并指定 --turns <N> | N |
新建或替换 Goal，未指定 --turns | 当前 Query 的 Goal 默认上限；宿主未配置时为 100 |
更新当前 Goal，未指定 --turns | 保留该 Goal 已持久化的上限 |
恢复旧版本创建且没有 maxTurns 的 Goal | 使用有效上限 100，不重写持久化数据 |
100。单个 Goal 显式指定的 --turns 始终优先于 Query 默认值。
状态字段
目标状态持久化保存，包含以下字段：
| 字段 | 说明 |
|---|---|
id | 目标唯一标识。 |
objective | 目标描述。 |
status | 状态：active / paused / complete。 |
maxTurns | 最大轮数上限；旧版本创建的持久化目标中可能不存在。 |
turnsUsed | 已用轮数。 |
timeUsedSeconds | 已用时间（秒）。 |
createdAt / updatedAt | 创建与最后更新时间戳。 |
planWasActive | 目标激活前是否处于 Plan 模式（用于恢复后还原）。 |
关键行为
- 权限模式独立：Goal 不改变权限模式，执行期间的工具授权按当前模式走。需要无人值守执行时，先自行切换到
auto或yolo。 - 跨会话持久化：目标随会话持久化。若进程被意外终止时目标处于
active，下次启动会自动降级为paused，可用/goal resume重新激活。 - Plan 状态恢复：若目标在激活前处于 Plan 模式，
/goal resume在进程重启后会一并恢复 Plan 模式。 - 轮数限制：
turnsUsed达到有效上限后目标自动暂停。因达到上限而暂停后，/goal resume会增加100轮预算；提前手动暂停再恢复不会扩展上限。