---
url: /antigravity/cli-conversations.md
description: 恢复先前的开发线程、将活动历史限定在本地工作空间内，以及分支 (Fork) 对话以试验备选架构。
---

# 管理对话 (Managing Conversations)

恢复先前的开发线程、将活动历史限定在本地工作空间内，以及分支 (Fork) 对话以试验备选架构。

## 工作空间限制 (Workspace Scoping)

为了维护上下文的整洁，Antigravity CLI 将对话历史直接限制在您当前的工作目录下。当您从特定目录启动 `agy` 时，Agent 仅显示并允许恢复与该特定本地仓库或子目录相关联的会话。

这能防止上下文污染，确保 Agent 的语义记忆和 Token 限制完全集中于相关的代码库。

## 恢复会话 (Resuming Sessions)

您可以返回到先前的对话中，以继续执行某项实施计划或完善现有解决方案。

### 通过 TUI 会话选择器恢复

要在活跃的终端屏幕中搜索并加载先前的对话：

1. 在提示框中输入 `/resume` 并按 `Enter`。
2. 交互式的“对话选择器 (Conversation Picker)”浮层将被打开。
3. 开始输入关键词以通过描述或 ID 过滤对话。
4. 使用 `↑/↓` 在列表中导航，使用 `←/→` 翻页查看较早的记录。
5. 按 `Enter` 键恢复所选的对话。按 `Esc` 键取消并返回提示框。

```text
   CLI    Antigravity   (tab to cycle)

  Conversations
  Type to search...
> implement-auth-pipeline                                      4 steps   3h ago
  refactor-db-connection-pool                                  7 steps   5h ago
  add-unit-tests-for-parser                                    2 steps   1d ago
  fix-socket-connection-timeout-error                         14 steps   2d ago
  update-project-dependencies                                  5 steps   3d ago
  optimize-image-compression-algorithm                         9 steps   4d ago
  draft-release-notes-v2.1.0                                   3 steps   May 23
  clean-up-obsolete-cache-files                                6 steps   May 22
  integrate-payment-gateway-sdk                               19 steps   May 20
  fix-layout-alignment-in-navbar                              8 steps   May 19
  [1-10 of 75 items]

Keyboard: ↑/↓ Navigate  ←/→ Page  enter Select  f2 Rename  tab Switch  esc Done
```

### 从 Antigravity 2.0 导入对话

如果您使用的是公开版本的 Antigravity CLI，则可以导入并恢复在 Antigravity 2.0 桌面可视化编辑器中发起的活跃线程：

1. 在提示面板中输入 `/resume` 并按 `Enter` 打开选择器。
2. 按 `Tab` 键在 `CLI` 选项卡（本地 TUI 对话）和 `Antigravity` 选项卡（Antigravity 2.0 桌面对话）之间进行切换。
3. 使用 `↑/↓` 高亮选中您目标桌面对话，然后按 `Enter` 键。
4. TUI 将显示一个确认提示。按 `Enter`（或 `y`）确认导入。
5. CLI 会将桌面对话历史、上下文和轨迹复制到您的终端会话中，让您无缝地继续该工作流。

```text
   CLI    Antigravity   (tab to cycle)

  Conversations
  Type to search...
  a1b2c3d4-e5f6-7890-abcd-ef1234567890                       loading…   May 23
  f9e8d7c6-b5a4-3210-fedc-ba9876543210                       loading…   May 16
> Design New Analytics Dashboard Layout [Import this? (y/n)] 12 steps   Apr 30
  Implement Realtime Graph Plotter                           15 steps   Apr 30
  fix-visual-flashes-on-load                                  2 steps   Apr 30
  add-collapsible-menu-sidebar                                4 steps   Apr 29
  refactor-utility-helper-methods                             6 steps   Apr 28
  Verify Webpack Configuration Output                         5 steps   Apr 28
  [1-10 of 13 items]

Keyboard: ↑/↓ Navigate  enter Select  tab Switch Tab  esc Go back / Clear search
```

### 通过命令行快速恢复

若要立即恢复您当前工作空间中最近的单次会话而无需进入选择器，启动可执行文件时带上 `--continue` 标志：

```bash
agy --continue
```

要直接从 Shell 加载特定的会话，请传入目标 UUID：

```bash
agy --conversation 9a8b7c6d-5e4f-3a2b-1c0d-ef1234567890
```

## 使用 `/fork` 进行分支 (Branching with `/fork`)

在开发复杂功能时，您可能希望探索多种设计方案，同时又不丢失当前的进度。`/fork` 命令提供了安全的、并行的实验。

```text
/fork
(别名: /branch)
```

`/fork` 命令会将您截至当前轮次的完整对话历史克隆到一个新的独立会话中。

### 分支工作流

1. 在提示面板中输入 `/fork` 并按 `Enter`。
2. CLI 将分配一个新的唯一会话 ID，并复制您现有的工作空间状态和 Agent 线程。
3. 您当前活跃的终端会立即切换到新分支。
4. 如果实验失败，运行 `/resume` 即可恢复您原先的、稳定的对话分支。

> \[!TIP]
> **分支文件系统**：Forking 仅克隆对话线程，并不克隆您的本地 Git 检出 (Git checkout)。要在并行 Fork 期间完全隔离文件，请在测试不同的方案之前使用 Git 分支或暂存 (Stash) 本地更改。

## 下一步 (Next Steps)

探索 Agent 如何处理复杂的、异步的操作和并行任务：

* **后台任务与子 Agent (Background Tasks & Subagents)**：监控子 Agent 并处理快速通道审批。
* **设置、渲染与键绑定 (Settings, Rendering & Keybindings)**：自定义渲染缓冲区和覆盖 JSON 偏好。
* **权限与沙箱 (Permissions & Sandbox)**：管理安全配置文件和系统命令列表。