← cd ~/notes

AI / Agent / 开发工具

dsh-message-rewind:给 DSH 一个撤回键

编辑已发送的消息、回滚它之后的所有轮次,必要时连那一轮改过的文件一起还原。一个 DSH 插件的用法、实现与边界。

/9 分钟阅读

用 Agent 跑长任务,最贵的不是 token,是对话里攒起来的那点共识。

比如第 3 轮你本来想说「别动测试」,手一快打成了「测一下」。模型照着改了测试文件,你发现不对,赶紧纠正——可它已经带着「测试可以改」这个前提往下走了。继续掰,越掰越歪;重开一个对话,前面半小时交代的约束、目录结构、失败过的尝试,全要再来一遍。

DeepSeek Harness(DSH)原生给的路是新建对话或分支,都意味着重新交代上下文。dsh-message-rewind 补的是另一条路:给自己发出的消息加两个按钮,编辑和回滚。

先说清楚:这个插件是我写的,仓库和本站同一个作者。所以下面既是推荐,也是一份自述——能做什么、怎么实现的、哪些情况会明确拒绝,都写出来。

自己发出的消息气泡下方多了「编辑 / 回滚 / 复制」三个按钮

它把「说错了」拆成三个动作

你想要的 操作 结果
改掉打错的字 点铅笔,改完点「保存并重发」 这条消息之后的内容被截断,按改后的文本重新开始
撤回一句不该说的话 点撤销箭头,确认 回到这条消息之前,之后的所有轮次一起丢弃
连那一轮改的文件也还原 在小窗里选「连文件一起回滚」 文件恢复成这条消息之前的内容

按钮只出现在你自己发出的普通消息上。一轮运行中追加的 steering 行没有这两个按钮,「复制」还在原位。有未结束的轮次时按钮是灰的——它不去和正在执行的写入抢时序。

「编辑」为什么要 fork

DSH 的会话日志是只追加的,没有「删掉中间一段」的接口。所以插件并不能真的修改历史,它做的是另起一条截断后的分支,再把原会话收拾干净:

  1. 在这条消息所属轮次之前 fork 出一个新会话,只保留截断点之前的事件;
  2. 把原会话从侧边栏摘掉,并直接删除它的日志目录——正常路径不写归档;
  3. 新会话接过原会话的工作区和 agent preset;编辑则把改后的文本作为新的 prompt 发进去。

结果是侧边栏始终只有一条对话,反复编辑也不会堆出一排同名会话。但代价得说清楚:

  • 会话 ID 会变。在别处引用过旧 ID 的地方,需要重新取一次。
  • 回滚第一条消息时没有可 fork 的边界,只能新建一个会话,标题会先显示默认值。
  • 原会话的记录是删掉,不是遮蔽。只有运行中的会话摘不掉、或日志目录被占用删不掉时,才退回归档兜底;正常路径找不回来。

这是一个明确的取舍:用「原始记录不可追溯」换「侧边栏永远只有一条」。在意前者的人,应该选另一个方案(下面会讲)。

编辑小窗:改完点「保存并重发」,其后的对话会被截断

文件回滚才是分水岭

只撤回消息是不够的。Agent 的一轮往往同时改了文件:消息撤了、代码留着,下一轮模型看到的工作区就和它以为的上下文对不上,于是继续在错误的地基上施工。

插件在打开小窗时就会读出这条消息之后记录到的文件改动(DSH 自身的按轮改动记录),并给出二选一:只回滚消息(默认),或者连文件一起回滚。后者不是「拍个目录快照再整体覆盖」,而是把那一轮记录的 diff 逐文件反着应用一遍:这一轮新建的文件删掉,改过的写回原内容,删掉的重新写出来,顺手清掉变空的父目录。

两个安全设计值得单独说:

  • 写之前先核对现状。如果文件在记录之后又被你或别的工具改过,回滚会被拒绝,而不是把你后来的改动覆盖掉。
  • 先算完再落盘。所有目标内容都算好才开始写;中途失败会整体撤回,连「文件已还原、但 fork 失败」这种情况也会把文件改回去。

代价是覆盖面有限,而且失败时会直接说清楚,不静默跳过:

情况 结果
文本文件的新建、修改、删除 能回,包括同一轮里「先建再删」这种组合
二进制文件、超过大小上限的文件 直接报错,不动任何文件
单轮改动文件数超过记录上限(默认 500)、快照过期或记录不完整 不出现「连文件」开关,只能回滚消息
工作区不在 Git 仓库,文件又是 shell 命令改的 记录不到,只能回滚消息;在该目录 git init 后可完整记录
记录之后文件又被改过 拒绝回滚,不覆盖后来的改动

默认值是「只回滚消息」,这个默认选得对:大多数人只是想改一句话,并不希望磁盘跟着动。

装起来只有一条命令

dsh plugin --profile web add dsh-message-rewind

把 web 换成你的 profile 名(桌面版安装里通常是 desktop)。也可以直接在 DSH 里装:设置 → 插件 → 搜索 dsh-message-rewind。

要求 DSH 0.2.2-rc.1 起(0.2.x),Node.js ≥ 20;宿主会按 engines.dsh 校验,版本不够直接拒绝加载。装完刷新页面,启动日志里能看到 message-rewind 处于 active。截至 2026-11-17,npm 上的最新版是 1.3.1。

它和 DSH 的版本绑定得比较紧:engines.dsh 只放行 0.2.x,DSH 升到 0.3 之前,得先等插件跟进。

第一次用,建议找个不关键的会话,故意让 Agent 改一个文件,再打开编辑小窗——看那一行「已记录 N 处文件改动」有没有出现。它是文件回滚能不能用的指示灯:没有这行,就只剩消息回滚。

几个不显眼但用起来舒服的细节

  • 小窗贴着按钮出现,下方放不下就翻到按钮上方,窄屏收窄到屏幕宽度,亮色主题保持同一套层级;点窗外或按 Esc 收起。
  • 快照不可用、有排队中的消息、工作区不在 Git 里,都会在小窗里先写一行提示,而不是等你点完按钮才报错。
  • 运行中禁用;排队中的消息会随回滚一起作废,小窗里提前说明。
  • 界面中英文跟随 DSH 的 locale,不是自己另写一套文案。

它不是时间机器

  • 文件回滚只作用于被记录过的那些轮次。快照过期、记录被截断,文件就回不去,消息仍可回滚。
  • 被回滚的源会话会被删除,正常路径不进归档。要留证据的场景,不该用它。
  • 不是 git reset 的替代。它不理解暂存区和分支,只是把文件内容倒回那一轮之前。

和同类插件怎么选

同一个市场里还有一个思路不同的 SiriLee/dsh-rewind:它不新建会话,只在原会话日志末尾追加一个遮蔽标记,把目标消息填回输入框;文件回滚靠自己的快照目录,只跟踪 DSH 文件工具改过的文件。

两者的取舍正好相反:

  • 在意历史可追溯、希望撤回的内容还留在日志里能翻——选 dsh-rewind。
  • 在意侧边栏始终一条、希望文件回滚也能算上 Git 仓库里 shell 命令造成的改动——选 message-rewind。

我为什么推荐它

因为这个插件我每天都在用:写得越久,越觉得「改一句」和「重开一局」差的不是几行操作,而是二十分钟和一次心态崩。

工程上也还算扎实:历史计算和差异反演拆成了可以单测的模块(rewind.js 负责倒 diff、files.js 负责落盘),五个测试文件,CI 在 Ubuntu 和 Windows 上跑 Node 20/22/24,发布前强制跑测试,MIT 许可,npm 和插件市场都能装。

但它治不了「prompt 写得烂」这件事,只是把返工的成本从「重开一局」降到「改一句」。如果一句话本身就没说清楚,改十次也还是没说清楚。

它更适合每天在 DSH 里推进长任务、经常需要改口的人。如果你只是偶尔问几句短问题,收益确实有限;可只要一个会话要连续跑上十几轮,这个按钮迟早会用上。

参考

↑↓ 选择↵ 打开