@domitor-syh/dsh-rollback
TRAE-style conversation rollback — per-turn checkpoints (10-turn sliding window) roll back touched files and truncate model context in place, keeping the same session id. Human-initiated only: a /rollback command or a per-turn Web button (works on interrupted turns too), with a preview listing each
Install
dsh plugin --profile web add @domitor-syh/dsh-rollback
Sandbox test results
| Stage | Result |
|---|---|
| 1 install | ✓ |
| 2 list | ✓ |
| 3 mount | ✓ |
| 4 boot | — |
Four stages run in an isolated sandbox: install (network on) → list → mount → boot (last three with no network).
README
<div align="center">
dsh-rollback · TRAE 式「回退」插件
<img src="./docs/page-display.jpeg" alt="dsh-rollback 界面预览" width="100%">
中文 · [English](./README.en.md)
     
</div>
为 DeepSeek Harness（DSH）Web 端提供按轮次回退：恢复已跟踪的文件变更，同时撤回对应的模型可见对话，继续使用原会话。
功能
- 按轮次回退：选择最近保留的 10 轮检查点，通过按钮或
/rollback发起。 - 文件与对话同步恢复：恢复旧内容、找回删除的文件、撤销新建；首尾状态相同的文件不做操作。
- 确认后执行：弹窗展示受影响文件及外部修改警告。
- 草稿回填：通过确认弹窗回退后，尝试将原消息和可恢复附件放回输入框。
- 恢复进度保留：失败后可重试或尝试补偿文件操作。
安装
Web 端（dsh web）：
dsh plugin --profile web add @domitor-syh/dsh-rollback
桌面端（官方渠道）——在插件的安装处填入包名 @domitor-syh/dsh-rollback，或使用等价命令：
dsh plugin --profile desktop add @domitor-syh/dsh-rollback
安装后：Web 端重启 dsh web 并刷新页面；桌面端重启桌面应用。从 DSH 源码运行时，在上述命令前加 pnpm。
当前适配目标为 DSH 0.2.2-rc.1。该版本把工具派发管线移入 ToolExecutor 插件、升级 Cordis 到 4.1.0，并给会话草稿接口新增必填参数；插件已跟随更新（见 0.5.2），但监听的 tools/* 事件契约与回退行为不变。声明的兼容范围仍为 >=0.1.5-rc.2 <0.2.0-0 || >=0.2.0-rc.2 <0.3.0-0（已覆盖 0.2.2-rc.1），旧版本在本次适配中未重新验证。
0.5.2 跟随 DSH 0.2.2-rc.1 与 Cordis 4.1.0；回退恢复的附件不触发即时图片上传，行为与 0.5.1 一致。0.5.1 修复了切换会话工作目录后，相对路径文件可能捕获到原目录同名文件的问题；回退继续使用修改时记录的目标路径。
使用
提供三种使用方式：
1. 回退按钮：点击已结束轮次中的「回退」按钮 → 查看受影响文件 → 确认回退。
2. /rollback：输入不带参数的 /rollback → 打开轮次选择弹窗 → 选择目标轮次 → 查看受影响文件并确认回退。
3. /rollback + Space（空格）：手动输入 /rollback 后按空格 → 打开子命令菜单 → 选择命令或参数 → 按回车执行。选择菜单项只补全参数，不立即执行；preview 会打开轮次子菜单，按 Esc 可返回。
命令 · 用途
/rollback · 选择轮次并打开确认弹窗
/rollback latest · 直接回退最近的检查点
/rollback <n> · 直接回退到第 n 轮之前
/rollback list · 查看可回退轮次
/rollback preview <n> · 预览受影响文件
/rollback retry · 继续未完成的恢复
/rollback abort · 对话尚未提交撤回时，尝试补偿文件操作
/rollback rescues · 查看文件救援点，不自动恢复
/rollback state · 查看当前回退状态
/rollback diagnose · 查看诊断信息
latest 和数字命令直接执行，不显示确认弹窗。 如需先检查，请使用界面入口或 preview。
运行中不能回退。回退只处理具备恢复依据的已跟踪文件，不是整个工作区备份；外部修改警告提示相关内容可能被覆盖。恢复失败后先按提示使用 retry 或 abort，报错不代表文件操作已自动撤销；对话撤回提交后不能再 abort。回退不会删除原始会话日志。
工具回报的文件路径与捕获目标不一致时，该操作留下持久的恢复缺口。例如第 5 轮出现缺口，第 6 轮起正常保留的检查点仍可回退；从第 5 轮或更早开始的回退会在预览和执行时被拒绝，并提示缺口及之后可用的起始轮次。重启后限制仍保留；不会跳过缺口做部分回退或只撤回对话。恢复记录写入或读取失败仍可能阻止更大范围的回退。
开发
构建工具链要求 Node ^22.18.0 || >=24.11.0。
pnpm --config.verify-deps-before-run=false install --ignore-scripts pnpm --config.verify-deps-before-run=false typecheck pnpm --config.verify-deps-before-run=false test pnpm --config.verify-deps-before-run=false check:readmes pnpm --config.verify-deps-before-run=false build
DSH 0.2.1 已退役 invariant 服务，插件不再依赖 @deepseek-ai/dsh-invariants。公开的 ./invariant 入口保留为已弃用的空操作，旧配置可继续加载，也可移除该条目。宿主版本范围由顶层 engines.dsh 声明；旧宿主缺少 workingDirectory 时保留原有目录回退路径。
修改后需将构建产物安装到目标 profile，再重启 DSH 并刷新页面。版本变更见 [更新日志](./CHANGELOG.md)。
许可证
[MIT](./LICENSE)
Rendered from the README published on npm. Formatted only, not edited.
Versions
Published on npm:：10，最后更新 2026-11-06