SiriLee/dsh-rewind

Name: SiriLee/dsh-rewind
Author: SiriLee

插件Plugin 原生Native ⭐ 16 MIT cat_label.checkpointcat_label.checkpoint cat_label.client-plugincat_label.client-plugin cat_label.conversationcat_label.conversation cat_label.cordiscat_label.cordis cat_label.deepseek-harnesscat_label.deepseek-harness cat_label.dshcat_label.dsh

DeepSeek Harness插件：在同一会话窗口内进行就地对话回退（Claude Code /rewind语义） + 可选的文件恢复

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-rewind 是 DeepSeek Harness 插件，在同一会话窗口内实现 Claude Code 的 /rewind 语义：可回到任一用户消息，支持仅回退对话或同时还原工作区文件（依据磁盘 before-backup）。当模型走偏需就地重来时使用。提示：回退仅隐藏消息，导出的会话日志仍保留完整内容，且操作无法在插件内撤销。

dsh-rewind is a DeepSeek Harness plugin that brings Claude Code's /rewind semantics into the same session window: cut the model context back to any earlier user message, optionally restoring workspace files from disk-persisted before-backups. Use it when the model drifts and an in-place retry is needed. Note: rewinds only hide messages—the exported session log retains the full transcript, and the action cannot be undone within the plugin.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-rewind】【https://github.com/SiriLee/dsh-rewind】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

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

把 SiriLee/dsh-rewind 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

13.3 KB · 缓存于 2026-08-26 14:42:33 · 13.3 KB

dsh-rewind

DeepSeek Harness 插件：一键就地回退对话到任意更早的用户消息——同窗口内完成，不新建分支、不换窗口，可一并还原工作区文件（完整 Claude Code /rewind 语义）。

English | 中文

刻意聚焦、保持极简，只做一件事：就地回退到任意远的用户消息，还能顺手还原改过的文件。

回退 = 时间回溯——目标消息及其之后的全部内容（agent 回复、工具调用）同时从模型上下文和渲染对话中撤回，不新建会话、不切换窗口；目标消息文本会回填输入框，改完可重发。
轻量工作区备份——行为对齐 Claude Code：只跟踪写文件的工具，写前做轻量备份并落盘持久化，不依赖、也不触碰 git 仓库。
信息安全优先——插件从不删改会话日志（append-only），从不真正删除你的任何内容。

效果预览

每条用户消息的操作行都有一个 ↶ 回退 按钮。点击后弹出模式选择浮层——「仅回退对话」或「回退对话和代码」，后者会先展示文件变更清单再确认。还可以通过 /rewind 命令和快捷键便捷地选择和回退。

_{用户消息旁的 ↶ 回退按钮}	_{模式选择浮层}
_{「回退对话和代码」影响清单}	_{/rewind 候选面板}

安装

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

装完重启 dsh web（--profile web）。

⚠️ npm 上的 dsh-rewind 属于其他作者，请用 dsh-rewind-plugin 安装。

给贡献者：本地 / pin commit 安装

可从本地 checkout 或 pin 的 commit 安装——dsh plugin --profile web add /path/to/dsh-rewind 或 dsh plugin --profile web add github:SiriLee/dsh-rewind#<sha>。git 安装首次会失败：pnpm 默认禁止 git 依赖执行构建脚本，需先在 profile 的 pnpm-workspace.yaml 加 allowBuilds；之后 pnpm 会执行插件的 prepare（完整构建）并装入 profile。

使用

在对话中找到要回退的那条用户消息，或输入 /rewind 打开候选列表选择。
选中它。 小浮层提供两种模式（「回退对话和代码」仅在目标之后有可还原的变更时显示）。
回退立即生效：对话回到目标消息当时的样子，被撤回消息的文本自动填入输入框——改完直接重发。

键盘操作：候选列表与模式浮层均支持 ↑↓ 移动、Enter 确认、Esc 取消/返回。

回退可以反复进行——可以一步步退到更早的消息；但回退本身无法撤销，被撤回的内容仍保留在会话日志中，可手动编辑日志恢复。

边界说明

「回退对话和代码」的文件还原动作不会再记录新备份。
每次回退都会在日志中追加一条标记事件（详见原理）。
插话也能回退——模型尚未读取的 steering 插话消息，同样可作为回退目标。
回退会打断当前正在运行的回合——确保回退安全执行。

本插件的优势

和常见的几种做法相比，本插件在"回退"这件事上的取舍：

维度	常见做法	本插件
对话回退	Fork 分支新建对话	就地回退——不新建会话、不切窗口，便捷回退
文件还原	无、git 管理、完整快照	写前轻量备份——写文件前自动存原内容，一键还原（对齐 Claude Code）
依赖	常依赖 Git 仓库或完整快照引擎	无依赖——不依赖 git，普通目录即可用
存储开销	整树快照占空间大	轻量——只存被写工具改动过的文件，落盘持久化

原理

机制与 Claude Code 的 checkpointing 同源（Claude Code 的文件历史也是逐文件记录 + 每条消息重扫已跟踪文件，并非整树快照）。本插件实现的是同一套语义，落在 dsh 上：

1. 对话回退：怎么做到"就地"又不丢日志

对话日志是只追加的——插件绝不改写历史。回退的做法：往日志里追加一条空内容标记，用它把目标消息之后的全部对话内容"遮蔽"掉，让模型和界面都只看到目标之前的部分：

标记本身是空的——不进入模型上下文、不渲染成任何对话内容，agent 和你看到的对话就是目标消息当时的样子；
因为只是"遮蔽"而非"删除"，被撤回的每一条事件都完整留在日志里，审计可追溯；
标记复用"最后一个已开始的回合"的编号，并自带独立的步骤框架——让 dsh 自身的机制（日志重放、/compact 压缩、续接检查）都能正确识别它，不会误认为真实对话（这些兼容细节经过专门的探针测试固化，见开发一节）。

实现细节（给维护者）

插件向会话日志追加一条空内容标记 assistant/message，其 surfaceOp: { op: 'replace', start, end } 把目标消息之后的全部 surface 节点替换为标记本身：

标记携带 sourceEventSeqs 覆盖所有被遮蔽节点，Session.append 的 surface 规则校验切割合法性（仅限当前 surface 上的连续区间）。
因为标记内容为空，harness 会将其派生为 null——永不进入模型上下文、也永不渲染成对话内容。
标记的 turn 号复用最后一个已开始的回合（markerTurnOf），而不是「最后回合 + 1」：harness 恰好用 最后 turn/start + 1 编号下一条真实回合。若标记也取这个数，日志里就会出现同一 turn 的 assistant/message 先于 turn/start 的乱序，客户端 conversation 构建器会以 conversation Context …:turn-tail… received an update before its start Match 拒绝重放——历史加载失败、整个对话从界面消失。复用已消费的 turn 号则标记只是上一个已完成回合尾部的一次无害追加，永不与新回合冲突。
标记自带幽灵步骤框架——自己的 step/start … step/end，step 号取该回合未用过的新号（markerStepOf）：harness 的 token-meter 重放要求每条 assistant/message 位于打开的 step 内，裸标记则会让该会话的 /compact 失效。

若 agent 正在运行（LLM 思考/流式输出），会先强制停止并等待安静下来再回退；停不下来则中止并报错。

2. 文件还原：写前备份 + 外部变更追踪 + 磁盘比对

插件跟踪写文件的工具——write、edit、str_replace_editor：

写前备份：每次写文件之前先把原内容存下来（在审批门放行之后捕获——审批短路不会漏备份，被拒绝的调用也不会记录；读取失败只警告、不阻塞写操作）。备份按当前对话轮次分组，跨重启保留（每会话保留最近 100 组）。
外部变更也追踪：每条用户消息边界会重新检查所有已跟踪文件——外部编辑或删除（写工具从没参与过的改动）同样被记录下来，回退时一并还原。
还原前真实磁盘比对：回退时实时读取文件当前内容，与目标状态比对——只操作真正不一致的文件：改过的写回最早备份、目标之后新建的删除、已一致的一律跳过（重复回退零副作用）。符号/硬链接跳过，避免误伤。

实现细节（给维护者）

写前备份（tools/execute，around-dispatch 阶段）：读取目标文件，把解析后的路径与内容放入 pending 表。此阶段只在任何 pre-execute 审批门放行之后运行——审批 ask 短路（dsh-edit-approval）无法跳过备份，被拒绝的调用也不会记录。若读取失败（如权限错误），该次变更直接不入备份——插件只在日志中警告，不会阻塞写操作。
落盘提交（tools/post-execute）：备份按当前轮锚点消息 seq 写入 ~/.dsh/rewind-snapshots/<会话>/<锚点 seq>/<callId>.json。
外部变更追踪（reconcileTracked）：消息边界处重扫已跟踪文件，磁盘状态与上次记录不同则记录一条 recheck-<锚点>-<hash> 条目（锚定边界消息）；首见路径必记（重启后第一次边界无条件记录当前状态——冗余但正确，对应 Claude Code 的 resume 后 restat 行为）。
还原（/rewind @<seq> both）：planRestore 对每条记录实时探测磁盘——before === null（目标时不存在）仅当文件当前存在才计划删除（已缺失即已达成）；before === 'X' 仅当当前内容 ≠ X 才计划还原（一致即 no-op，幂等）；探测失败保守视为不一致（绝不静默跳过）。执行时 restore = 建父目录 + 写回内容，delete = 删文件（已不存在容忍为 no-op）；符号/硬链接跳过（与另一名字共享 inode，透过一个还原会误伤两个）；失败逐文件记录、不中止整轮。
工具体抛异常会跳过 tools/post-execute；tools/result 兜底清掉 pending，避免内存泄漏。备份跨 host 重启持久化，prune 每会话有界保留最近 100 组锚点。

明确不做的事

本插件刻意保持轻量、聚焦"对话回退"这一件事，以下场景不属于它的职责：

整树 / Git 级快照——只跟踪写类工具编辑 + 已跟踪文件的外部改动，从未被工具碰过的文件不还原。需要 Git 工作树级的完整快照回退时，请交给专门的快照工具（或你的 git）。
子代理的编辑——不追踪（同 Claude Code）：子代理运行在自己的会话里，其备份无法由父会话的回退还原，只会在磁盘上残留。
fork / 分支回退——harness 已内置「在新对话中分支」，不重复造轮子。

兼容性

Node.js ^22.19.0 || >=24.0.0。
DeepSeek Harness web 配置档（dsh --profile web）；peer @deepseek-ai/* 包由 harness 运行时解析。

[!WARNING] 本项目与 DeepSeek Harness 均处于开发者预览阶段。可复现环境请 pin 精确版本，并阅读上述行为说明。

客户端契约

需要获知哪些转录行被回退撤回的第三方 DOM 插件，应使用 dsh-rewind-plugin/client 导出的稳定、与本地化无关的纯函数（hiddenSeqsOf、targetSeqOfArgs），切勿解析 outcome.text。 data-dsh-rewind-hidden 属性标记被撤回的行（仅观测性）。详见：docs/client-contract.zh.md。

已知问题

导出的日志是完整内容——回退只是把消息从模型上下文和视图中移除，/export 导出的会话日志包含已撤回的消息。本插件无法改动导出。
v0.2.4 及更早版本回退过的会话，继续对话后可能加载历史失败。可安装 v0.4.0 之前的版本，用随附的修复工具处理（完整步骤）。
v0.3.3 及更早版本回退过的会话，压缩对话（compact）可能不可用。新版本已兼容；受影响的旧会话建议新建会话。

安全

本插件只向会话日志追加回退标记事件，从不删除或改写已记录的历史。工作区文件仅在「回退对话和代码」时被改写，备份与还原都限定在 ~/.dsh/rewind-snapshots/ 内。不触碰你的 git 仓库，无网络请求，不访问任何凭据。

开发

npm install            # devDeps 来自 npm registry
npm run typecheck      # tsc 三面编译（host + client + client-test）
npm test               # vitest：全部单元与兼容性测试套件
npm run build          # esbuild：lib/index.js（host ESM）+ lib/client.js（loader 闭包）+ .d.ts
node scripts/verify-host.mjs   # 端到端验证构建产物

prepare 执行完整构建，所以 git 安装与 npm pack / npm publish 总会产出完整的 lib/ 与 LICENSE。

维护者：模块地图与 harness 接口参考见 docs/harness-reference.md；发布步骤见 docs/release.md。

发布

通过 GitHub Actions Trusted Publishing（OIDC，无存储 NPM_TOKEN）发布：推送 v<版本> tag，CI 即带 Sigstore provenance 发布。

npm version patch && git push origin main --tags

一次性 npm 侧配置与完整流程：见 docs/release.md。

许可

MIT

渲染基于仓库 SiriLee/dsh-rewind 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install