快捷指令
版本说明：统一的命令、定向发送、对象引用和审批回复协议自
v0.0.4.beta起提供。
先确认命令版本
2026-10-01 核对的后端命令实现只支持 /delete（子会话）与 /clear-history（主会话、子会话），以及后者的两个别名。下文保留的 /refresh_messages、/compress 是旧版说明与示例，不能当作当前后端可执行命令。请以自己部署中的候选项和明确回执为准，不要用未知命令尝试恢复任务。
| 当前源码命令 | 范围 | 操作前确认 |
|---|---|---|
/delete | 子会话 | 先保存需要保留的文件与结论，核对目标会话 |
/clear-history | 主会话、子会话 | 推进历史可见起点并清理运行恢复材料，不是安全擦除；先保留必要上下文 |
快捷指令用于执行明确、固定的会话操作。它们不是发给 Agent 的普通任务，也不需要模型判断用户意图。
怎么使用
在 Agent 会话的输入框中输入 /，页面会显示当前会话可用的命令。选择命令并发送即可。
命令需要单独发送，不要追加普通任务说明。下面保留旧版压缩写法供迁移对照，当前后端不支持该命令：
/compress
如果命令不适用于当前会话，或者会话正在执行任务、等待确认，页面会提示当前不能执行。
当前可用命令
上方表格是当前源码范围。下表保留旧版四项菜单供对照，其中刷新属于旧版 Web 本地动作，手工压缩不再是当前命令。
| 命令 | 适用范围 | 作用 |
|---|---|---|
/refresh_messages | 主会话、子会话 | 重新同步当前页面中的会话消息 |
/delete | 仅子会话 | 删除当前子会话并从会话列表移除 |
/clear-history | 仅主会话 | 清理主会话当前可见历史，从新的上下文起点继续 |
/compress | 主会话、子会话 | 手工压缩当前会话上下文 |
旧版页面按上表过滤候选：主会话不显示 /delete，子会话不显示 /clear-history。当前源码允许主、子会话清理历史，不能沿用旧版候选规则。
重新同步消息
/refresh_messages
这是旧版 Web 本地刷新方式。当前页面显示不完整时，可通过页面实际提供的刷新/重新连接入口恢复，不要把此历史命令提交给当前后端。
它只重新同步页面消息，不会重新执行任务，也不会删除服务端记录。
删除子会话
/delete
该命令仅用于子会话。执行后，子会话会从当前会话列表中移除，不能用于删除主会话。
删除前应先确认需要保留的结果已经回传到主会话，或者相关文件已经保存到合适位置。
清理主会话历史
/clear-history
旧版仅用于主会话；2026-10-01 源码允许主会话和子会话使用。它会把较早消息移出当前可见历史，并让后续任务从新的上下文起点继续。
需要注意：
- 这不是安全擦除功能，不代表底层历史记录已经被物理删除。
- 工作区文件、Skill、Tool、密钥配置和用户记忆不会因此删除。
- 需要保留的重要结论，应先保存为文件或整理到新的任务说明中。
也可以使用 /clear_history 或 /clear history，系统会按同一个命令处理。页面默认展示标准写法 /clear-history。
手工压缩上下文
/compress
以下是旧版手工压缩说明，保留其用途与边界供迁移参考；当前后端不接受 /compress。当前长会话恢复由上下文压缩机制处理，并不等同于删除历史。
压缩会整理当前目标、进度、约束、关键事实和产物引用。它不会删除工作区文件，也不等同于清理历史。压缩过程可能需要等待一段时间，并会使用模型能力。
如果当前没有足够内容可压缩，页面会直接提示。会话正在执行任务或等待审批时，应先处理当前状态，再执行压缩。
定向发送、对象引用和审批回复
xAgent 使用不同前缀区分消息路由和对象引用：
@{session:会话ID} 继续处理这个任务
请分析 #{file:文件ID}
@{approval:审批ID} 同意
@{session:会话ID}表示把后面的消息或命令发送给指定会话。#{类型:ID}只表示在当前消息中引用对象，不改变路由，也不隐式执行操作。@{approval:审批ID} 同意/不同意表示向明确审批提交控制回复。#{approval:审批ID}只是引用审批记录，不能完成审批。
实际使用时应优先采用页面、连接器通知或候选菜单自动生成的格式，不建议手工猜测对象 ID。完整的语义、组合方式和安全边界请阅读快捷指令协议。
注意事项
- 未知的
/命令会直接报错，不会作为普通任务交给 Agent。 - 命令只处理明确操作，不要把普通任务说明写在命令后面。
- 会话运行中或等待确认时，部分命令不可用。
/clear-history不是数据销毁工具。- 定向目标必须写在消息开头，正文中间的
@{session:id}不会自动改变路由。 - 对象引用不会绕过文件访问范围、审批策略或其他权限边界。