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

# 撤销改动与恢复会话

# 概述

在与 Qoder 协作的过程中，你可能想回到之前的某个状态——撤销最近的一批改动，或者把对话恢复到某个更早的节点重新出发。Qoder CLI 通过 **Rewind（回退）** 提供这种能力：它以对话中的用户消息为检查点，让你把对话、文件改动或两者一并恢复到某个更早的状态。

# 回退（/rewind）

用 `/rewind` 打开回退界面：

```shell theme={null}
/rewind
```

回退界面会列出对话中的检查点（以你发送的用户消息为标记）。选择一个检查点后，Qoder 会显示从该点回退将会带来的影响，并让你确认。

# 可以恢复什么

在确认回退时，你可以选择恢复的范围：

* **恢复对话和文件**（默认）：把对话恢复到检查点，同时把该点之后由 Qoder 产生的文件改动一并还原。
* **仅恢复对话**：把对话历史恢复到检查点，文件保持当前状态不变。
* **仅恢复文件**：把该点之后由 Qoder 产生的文件改动还原，对话保持当前状态不变。

回退界面会显示如果恢复文件，会涉及多少个文件、以及新增和删除的行数（例如"若现在回退，将还原 3 个文件（+42 -17）"），帮助你在确认前了解影响范围。

> 通过手动编辑或 Shell 命令产生的文件改动，可能不会被回退还原。回退主要针对 Qoder 通过文件编辑工具产生的改动。

# 工作原理

Qoder CLI 在会话过程中记录文件编辑历史。每个检查点对应对话中的一条用户消息，Qoder 会跟踪从那之后发生的文件改动。当你选择回退到某个检查点时：

* 如果你选择恢复对话，对话历史会被截断回到该检查点。
* 如果你选择恢复文件，Qoder 会依据记录的编辑历史，把相关文件还原到检查点时的状态。

如果某个检查点没有可还原的文件改动，回退界面会明确提示"将恢复对话，不涉及文件改动"。

# 何时使用

回退适合以下情况：

* Qoder 走错了方向，你想回到分岔前重新描述需求。
* 最近一批改动不理想，你想快速还原并换一种做法。
* 你想从对话中较早的某个节点重新展开，尝试不同的方案。

如果你想在**保留原会话**的前提下从某个节点探索新方向，也可以考虑使用会话分支，见 [管理会话](https://docs.qoder.com/zh/cli/03-使用QoderCLI/04-管理会话和改动/sessions.md)。回退是"就地回到过去"，分支是"从过去岔出一条新路"。

# 提示

* 回退前留意界面显示的文件影响范围，确认要还原的内容符合预期。
* 涉及重要改动时，配合 Git 使用更稳妥：在关键节点提交，可以让你即便超出回退能覆盖的范围也能恢复。
* 回退只针对当前会话内记录的编辑历史，跨会话或手动/Shell 产生的改动不在其管辖范围内。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.