核心功能
目标模式(Goal)
面对需要长时间运行的复杂任务,可以用 /goal 为当前会话设定一个明确目标。设定后,ZCode Agent 会围绕目标 持续迭代:每轮迭代结束自动进行目标校验,未完成则继续推进,确认完成后才结束任务——把「盯着 Agent 反复说继续」变成「设一个目标,等结果」。

适用场景:一句话说得清、但需要多轮才能完成的工作,例如——
- 「重构整个模块并保持测试通过」
- 「修复所有 TypeScript 编译错误」
- 「把这个页面的 Lighthouse 性能分提到 90 以上」
设定与管理目标
在对话输入框输入 /goal(或输入 / 后在建议面板中选择 goal):
/goal <目标描述> 设定会话目标
/goal replace <目标> 替换当前目标
/goal pause 暂停目标
/goal resume 恢复目标
/goal clear 清除目标
建议:目标描述尽量具体、可校验,例如「修复所有 TypeScript 编译错误,并让
pnpm test全部通过」——校验条件越明确,每轮迭代的判断就越准确。
设定目标后会发生什么
摘要面板实时跟踪
右上角摘要面板会出现目标卡片,展示目标状态(活跃 / 暂停 / 已完成),以及 累计时间、累计 Token 和迭代轮次——长任务跑了多久、花了多少,一目了然。

每轮自动校验
一轮迭代结束时,Agent 会自动校验目标是否达成:
- 目标未完成,任务继续——自动开启下一轮迭代,无需手动追问「继续」
- 目标已完成,任务结束——校验通过后才会收尾并输出总结

随时介入
目标设定后仍然可以随时调整。在迭代过程中,直接用自然语言告诉 Agent 你的想法即可,例如让它换个方向、先暂停推进,或者不再需要这个目标。Agent 会据此调整、暂停或清除当前目标,无需记忆专门的命令格式。
与执行模式搭配
目标模式与 执行模式 互不冲突:目标决定「做到什么程度才算完」,执行模式决定「过程中多少操作需要确认」。长目标任务建议搭配 完全访问 或 自动编辑 模式,减少中途打断,让迭代更连贯。