会话回退 ixietv/dsh-session-rewind

dsh-session-rewind

回退你当前所在的对话——同一个会话，不分叉，不开新标签页。

DSH 官方处理「撤销几轮对话」的方式，要么新开一个分叉，要么手动改状态。dsh-session-rewind 只加一条命令——/rewind——把当前对话的尾部就地折叠掉。sessionId 始终不变，事件日志保持只追加，模型在下一次请求时真的会忘掉被折叠的轮次。

这不是分叉。磁盘上什么都没删，没有重写任何 .jsonl，侧边栏也不会多出一个会话。

为什么要回退？

| 场景 | 之前 | 用 dsh-session-rewind |
| 某一轮答坏了，想干净地重试 | 新开会话，丢掉上下文 | /rewind 1，保留它之前的一切 |
| 提示词在对话中途跑偏 | 分叉再重新解释一遍 | /rewind 3，就地继续 |
| 裁掉一段冗长的探索 | 手动清理 | 在轮次操作行点一下 |

核心特性

- 就地折叠——session.append('user/message', checkpoint, { surfaceOp: 'replace' })；sessionId 不变。
- 只追加日志——每个更早的事件都保留自己的 seq；唯一的写入是一条 checkpoint 事件。
- 模型可见——被折叠的节点会从 deriveMessages() 中消失，所以下一次请求真的拿不到它们。
- 两个入口——/rewind [<turn>] 命令，外加官方 conversation.chat.assistant-actions 行里的一个图标按钮。
- 默认安全——智能体运行期间拒绝执行，每个会话单飞，持久化失败会报 PERSIST_FAILED，而不是假装成功。
- 零额外运行时依赖——Host 半边不导入任何东西；Client 半边只依赖 react。

安装

git clone https://github.com/ixietv/dsh-session-rewind.git "$HOME/.dsh/plugins/dsh-session-rewind"

然后重启 DeepSeek Harness。Loader 会读取 cordis.patch.yml 并插入 Host 行；Web shell 通过 dsh.client.platform: "web" 加载 lib/client.js。

用法

| 入口 | 语法 | 行为 |
| 命令 | /rewind | 回退到最近一轮之前 |
| 命令 | /rewind 3 | 回退到第 3 轮之前 |
| UI | 轮次操作行图标 | 悬停某一轮，点击即可回退到它 |

工作原理

User: /rewind <turn>
│
▼
Host (lib/host.js) ── validate turn, agent idle, no rewind in flight
│
▼
Locate target turn/start seq ── collect every surface node up to the tail
│
▼
session.append('user/message', checkpoint, { surfaceOp: 'replace', sourceEventSeqs })
│
▼
ctx.sessions.flush(session) ── persist; failure → PERSIST_FAILED
│
▼
Client (lib/client.js) ── hide folded DOM rows, mark via sessionStorage

架构

dsh-session-rewind
├── lib/host.js # Host 半边：注册 /rewind，计算切点，追加检查点 ├── lib/client.js # Web 客户端半边：操作行按钮、DOM 隐藏、回退标记 ├── cordis.patch.yml # Loader 补丁：插入一行 Host（不覆盖、不隔离） ├── docs/design.md # 第二轮契约：语义、决策 DEC-1..DEC-12 ├── docs/research.md # 表面原语与命令系统调研 ├── docs/research-truncate.md # 截断 / 工具配对语义 └── docs/verification.md # 验证日志与验收证据

| 模块 | 职责 |
| lib/host.js | 掌管命令、切点，以及唯一一次 surfaceOp: replace 追加 |
| lib/client.js | 掌管触发面，以及被折叠行在视觉上的消失 |
| cordis.patch.yml | 与官方模块并列组合，不替换它们 |

设计说明

- 切点是轮次边界 —— 不打补丁就能满足工具配对平衡。
- 检查点来源是 { kind: 'user' } —— 落在封闭的 MessageSourceMap 内；它不会渲染成用户气泡，因为 replace 检查点不属于「追加表面」事件。
- 没有恢复 / 撤销回退 —— 第二次回退只能退得更远，因为被折叠的节点已经从表面上消失。

开发

node --check lib/host.js
node --check lib/client.js

FAQ

这会新建会话吗？ 不会。重点就在于它不新建。

历史会从磁盘删除吗？ 不会。事件还在，只是派生出的表面不再暴露它们。

能撤销回退吗？ 不能原地撤销。被折叠的节点已经不在表面上了。

许可证

MIT