@domitor-syh/dsh-rollback
适用于 DeepSeek Harness 的 TRAE 风格对话回滚：按轮次创建检查点、恢复文件并原地截断对话、支持 /rollback 命令，以及带受影响文件预览的 Web 回滚按钮
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @domitor-syh/dsh-rollback@0.2.2
Rollback 以 @domitor-syh/dsh-rollback 发布，当前版本为 0.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
为 DeepSeek Harness（DSH）Web 端提供一个 TRAE 式「回退到本轮对话发起前」的插件：按轮次建立检查点，一键把【工作区文件】和【模型上下文】同时回退到某一轮发起之前，保持同一会话 id。
dsh-rollback 忠实实现了 TRAE 回退功能的核心设计思想——对话状态与文件状态对齐回滚：
| 能力 | 说明 |
|---|---|
| 按轮次检查点 | 每轮发起前建立检查点，只记录该轮实际触碰的文件（Copy-before-Write 前置内容），非全量快照 |
| 10 轮滑动窗口 | 借鉴 TRAE「仅最近 10 轮」，超出窗口的检查点被丢弃 |
| 文件回退 | 修改过的文件写回本轮前内容；已被删除的文件放回来；本轮新建的文件被删除；无法恢复的文件单独报告跳过 |
| 原位截断 | 用 user/message 承载的表层 replace（内置 /compact 同款官方原语）就地替换模型上下文，回退当场即生效，保持同一 session id |
| 两种触发入口 | 人工命令 /rollback、Web 端每轮结束后的「回退」按钮（正常轮次在回复的动作条上；被中断的轮次在轮次页脚） |
| 受影响文件列表 | Web 按钮弹出对话框，列出本轮及之后受影响文件及动作（恢复/找回/删除/跳过），点击文件可在编辑器打开 |
| 运行中禁止回退 | 只要有一轮还在跑就整体拒绝，必须等它结束或暂停（运行中的轮次本来也不会出现按钮） |
dsh plugin --profile web add @domitor-syh/dsh-rollback
然后重启 dsh web。从源码运行 DSH 时：
pnpm dsh plugin --profile web add @domitor-syh/dsh-rollback
/rollback list — 列出可回退到的轮次/rollback preview <n> — 预览回退到第 n 轮前会影响的文件（不执行）/rollback <n> — 回退到第 n 轮发起之前回退按钮：每轮结束后出现——正常轮次在回复下方动作条里（与「赞/踩」并排）；被中断的轮次在轮次页脚（那一轮没有收尾回复，动作条上不可能有按钮）。运行中按钮保留但置灰。
回退弹窗与文件修改提示：点击 ↩ 后弹出确认框，逐条列出受影响文件及其动作——修改过的写回原内容（恢复）、被删掉的放回来（找回）、新建的删除（删除）、无法恢复的标「跳过」。
被回退的消息从对话流中隐藏：确认后被回退的消息立刻隐藏（界面上不渲染分隔线）；被回退那一轮的用户文本 / 图片自动回到输入框，方便接着改。
回退首条消息的界面：回退到第一条消息之前时，对话区显示「已回退到对话发起前」欢迎页。
| 文件 | 职责 |
|---|---|
src/core/ | 纯逻辑（无 DSH 依赖）：检查点模型、捕获合并、回退规划、截断规划、滑动窗口、会话折叠，全部单测覆盖 |
src/service.ts | Host 侧执行：tools/result 捕获写/改的前置内容 + session/event 折叠轮次；执行恢复/删除/截断 |
src/index.ts | 插件体（Host 半侧）：注册 rollback 工具与 /rollback 命令 |
src/client/index.ts | 浏览器半侧：官方 assistant-actions 槽的「回退」按钮 + 受影响文件对话框 + 本地化，经已出厂 commands Remote 触发宿主 |
关键实现点：
write/edit 的执行结果里已带 before/after，用 ctx.on('tools/result') 取完整前置内容；str_replace_editor 的结果只有渲染文本，改由 tools/pre-execute 在调用前预读目标。mkdir 父目录，而 dirname('E:\\file.txt') 是带尾分隔符的 E:\，Windows 对卷根 mkdir 返回 EPERM。插件包装 ctx.fs.writeText 与 ctx.fs.editText：仅当原路抛出这一精确形状的错误时，改用「同目录临时文件 + rename」落盘（不做 mkdir 预检）。edit 分支还逐字复刻了字面匹配语义（FS_EDIT_NOT_FOUND / FS_AMBIGUOUS_EDIT 的判定与文案）并保留原文件的行尾风格与权限位；只包装后端实际实现了的方法。其余错误、以及策略不允许的路径（fail closed）一律按原样抛出。文件系统层若不再预建目录，该分支自动失效。write/edit 触碰过的文件才进入回退跟踪，改内容请用这两个工具而不是 shell。session.surface.nodes 中「第 n 轮及之后」的连续节点，append 一条 user/message 表层 replace（surfaceOp: { op:'replace', start, end } + sourceEventSeqs 覆盖全部被遮蔽节点），就地替换这段历史；会话 id 不变。
/rollback 执行时当场写入日志，被回退区间随即从模型历史中消失。display:none）；隐藏由日志里的持久标记驱动，刷新/重启后保持。恢复（文件还在，写回旧内容 · 绿）、找回（文件已被删除，重新放回 · 蓝）、删除（撤销该区间新建的文件 · 红）、跳过（无法恢复）。前三者的区别由记录里的 kind 决定（updated / removed / ），所以"写回内容"和"把文件找回来"在数据上就是两件事。空列表显示"无文件变更"——插件看不见 shell 直接写出的文件，这种话它保证不了。replace 只作用于模型上下文。插件在界面层把被回退区间隐藏（由日志里的持久标记驱动，刷新/重启后保持）。tests/truncation-plan.test.ts 用一条字符预算断言钉住它，防止以后又长回去。WeakMap）；重启后由 sidecar（storages/dsh-rollback/checkpoints-v2/）重建，保留最近 20 轮（KEEP_TURNS），更早的记录在加载时被剪枝。processPath + Node unlink、空目录清理通过 Node rmdir 完成，仅对本地后端可靠。write/edit 的结果里捕获改动，并在消息边界复查这些路径——所以「shell 改写了/删除了已登记文件」（含工作区外，如 E:\、桌面）可以回退；而「shell 新建一个全新文件」或「改动一个从未被工具碰过的文件」无法回退（后者连它存在过都不知道）。插件会注入提示引导模型改走文件工具，但无法强制。pnpm install # 安装依赖（prepare 会先构建一次）
pnpm build # 从 src/ 产出 lib/index.js、lib/invariant.js、lib/client.js
pnpm test # 运行核心逻辑（src/core/）单测
pnpm typecheck # tsc 检查 core + tests；scripts/typecheck-host.mjs 再检查
# src/service.ts、src/index.ts、src/client/index.ts
# （这三个文件 import 的 @deepseek-ai/* 不在本仓库安装，
# 故只忽略这些包造成的 TS2307/TS7006/TS7016，
# 其余一律视为真错误——含 TS2304「未定义标识符」）
pnpm deploy:profile # 打包并部署到 DSH profile（默认 web），随后需重启 DSH
⚠️ 改了代码必须
pnpm deploy:profile：DSH 不是从本仓库加载插件，而是从 profile 的node_modules加载file:tarball 解出来的副本（见scripts/deploy-profile.mjs的说明）。 只跑pnpm build改的是本仓库的lib/，运行时毫无变化。脚本会打包、更新 profile 引用的 tarball、覆盖已解出的副本并校验字节一致，最后提醒重启 DSH 与刷新页面——而重启必须由你手动做： 宿主半侧在启动时载入，脚本无法替正在运行的进程换代码。
createdconversation.chat.turnTail 槽——它是 chain 槽，条目必须提供 select（缺了会抛错且界面毫无痕迹），select 返回 null 即不渲染，这正是"只在动作条无法提供时才出现"的实现方式；注册带 try/catch 并在控制台留痕，不允许再出现"按钮静默消失"。src/core/rollback-guard.ts），无论目标是哪一轮。agent loop 持有表层位置并持续追加，在它下面截断会把"这一轮正在写的历史"遮蔽掉、而它更晚的输出还在；命令也不会打断运行，所以拒绝本身才是让两者不交错的原因。运行中的轮次本来就没有按钮（页脚节点要等该轮 turn/end 才存在，动作条要等助手消息收尾），所以这里只有一条规则、没有第二套禁用机制。ctx.remote.commands.execute 调 /rollback …。tests/core.test.ts（35）+ tests/truncation-plan.test.ts（10）+ tests/root-write.test.ts（14）+ tests/root-write-fallback.test.ts（15）+ tests/literal-edit.test.ts（12）+ tests/dir-cleanup.test.ts（15）+ tests/empty-dirs.test.ts（5）+ tests/boundary-scan.test.ts（10）+ tests/boundary-rescan.test.ts（13）+ tests/boundary-pipeline.test.ts（5）+ tests/rollback-guard.test.ts（10）+ tests/turn-entry.test.ts（3）。