首页/Grok Build 功能/会话管理

会话管理

Grok 自动将每个对话保存到磁盘 — 提示、响应、工具调用和文件快照 — 存储在 ~/.grok/sessions/ 下,按工作目录索引。会话在 TUI、无头模式和 ACP 中工作方式相同。

恢复会话

在 TUI 中,/resume 打开当前工作区最近会话的选择器;欢迎屏幕也会列出它们。从命令行:

grok --resume <session-id>   # 特定会话
grok --resume                # 当前目录最近的
grok -c                      # 简写:继续最近的

在无头模式中,从 JSON 输出读回会话 ID 并传给 -r 构建多步自动化:

grok -p "Start the refactor" --output-format json | jq -r '.sessionId'

-s, --session-id 用你提供的 UUID 命名新会话;不会恢复现有会话。要分叉恢复的会话而不是继续它,添加 --fork-session

分叉

/fork [directive] 将当前会话分叉为一个从对话副本开始的同级会话。传入 --worktree--no-worktree 选择分叉是否在仓库的隔离副本中运行,以避免并行会话互相覆盖文件 — 详见 工作树

回退

/rewind(或空闲时 Esc Esc)列出每个提示的回退点。选择一个会将所有文件恢复到该点时的状态,并截断对话以匹配。回退会修改磁盘上的文件 — 除非提交到 git,否则恢复的更改将丢失。

压缩

/compact [context] 压缩对话历史以回收上下文窗口,可选择性指定保留哪些内容的指令。Grok 也会在上下文窗口填满时自动压缩;通过 /context/session-info 检查使用情况。

维护命令

命令功能
/sessions切换、重命名或关闭活跃会话
/rename <title>重命名当前会话(别名 /title
grok sessions list列出当前目录的最近会话
grok sessions search <query>搜索会话标题和提示
grok sessions delete <id>永久删除会话
grok export <id> [file]将记录导出为 Markdown(--clipboard 复制)