> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 计划模式

<Info>
  让用户要求 assistant 先给出计划，再继续执行。
</Info>

计划模式是 ChatKit composer 中的一种工作模式，适合那些需要先明确范围、步骤和风险再执行的任务。它让用户可以要求 assistant 暂停下来，先说明准备如何处理，而不是直接进入实现或操作。

## 适用场景

计划模式适合用于：

* 在实现前先审阅代码库
* 拆解多步骤任务
* 在多个方案之间先比较取舍
* 对高风险或不可逆操作进行确认
* 在执行前生成清晰的 checklist

它不会让普通聊天变重，但给了用户一个很明确的入口：当任务需要更谨慎时，可以主动切换到计划模式。

## 用户体验

用户可以在 composer 左侧的 `+` 菜单中打开计划模式。计划模式启用后，ChatKit 会在输入区上方显示一个简洁的 Plan 状态。

也可以使用 slash command：

```text theme={null}
/plan
/plan 先规划一下如何重构 checkout flow，并列出可能会修改的文件。
```

`/plan` 会切换计划模式；`/plan <prompt>` 会直接以计划模式提交后面的 prompt。

## 请求行为

当计划模式启用时，ChatKit 会在提交的用户输入和 `state.human` 中写入 `planMode: true`。后端工作流可以根据这个标记让模型先产出计划、路由到规划节点，或进入需要用户确认的流程。

代码中也可以通过同样的字段发起计划模式请求：

```ts theme={null}
await chatkit.sendUserMessage({
  text: '先规划一下从 REST 端点迁移到 SDK 调用的步骤。',
  planMode: true,
});
```

计划模式不会绕过 ChatKit 的正常请求链路。消息仍然会经过当前 ChatKit session、已有权限、工具、运行时能力选择和后端工作流规则。

## 产品建议

计划模式应该是用户可控的能力，而不是替代后端安全规则的机制。assistant 仍然需要遵守 Xpert 中配置的工作流和策略约束。

好的计划模式回复通常应该：

* 紧扣用户当前请求
* 明确假设和未知点
* 按执行顺序列出步骤
* 标出哪些动作需要用户确认
* 足够简洁，方便用户快速审阅

对于客服问答或简单 FAQ assistant，可以保留计划模式入口但不必强制使用。对于代码、运维、研究和多智能体工作流，建议让计划模式在 composer 菜单和 `/plan` 中都容易发现。