Skip to main content
管理会话和改动

撤销改动与恢复会话

概述

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

回退(/rewind)

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

可以恢复什么

在确认回退时,你可以选择恢复的范围:
  • 恢复对话和文件(默认):把对话恢复到检查点,同时把该点之后由 Qoder 产生的文件改动一并还原。
  • 仅恢复对话:把对话历史恢复到检查点,文件保持当前状态不变。
  • 仅恢复文件:把该点之后由 Qoder 产生的文件改动还原,对话保持当前状态不变。
回退界面会显示如果恢复文件,会涉及多少个文件、以及新增和删除的行数(例如"若现在回退,将还原 3 个文件(+42 -17)"),帮助你在确认前了解影响范围。
通过手动编辑或 Shell 命令产生的文件改动,可能不会被回退还原。回退主要针对 Qoder 通过文件编辑工具产生的改动。

工作原理

Qoder CLI 在会话过程中记录文件编辑历史。每个检查点对应对话中的一条用户消息,Qoder 会跟踪从那之后发生的文件改动。当你选择回退到某个检查点时:
  • 如果你选择恢复对话,对话历史会被截断回到该检查点。
  • 如果你选择恢复文件,Qoder 会依据记录的编辑历史,把相关文件还原到检查点时的状态。
如果某个检查点没有可还原的文件改动,回退界面会明确提示"将恢复对话,不涉及文件改动"。

何时使用

回退适合以下情况:
  • Qoder 走错了方向,你想回到分岔前重新描述需求。
  • 最近一批改动不理想,你想快速还原并换一种做法。
  • 你想从对话中较早的某个节点重新展开,尝试不同的方案。
如果你想在保留原会话的前提下从某个节点探索新方向,也可以考虑使用会话分支,见 管理会话。回退是"就地回到过去",分支是"从过去岔出一条新路"。

提示

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