dsh-undo — DSH 撤销/回退系统

中文 | English

还在为 DSH 崩溃而苦恼?还在担心小改动会带来大灾难?这款工具能帮到你!

为 DeepSeek Harness (DSH) 打造的撤销/回退系统:装插件、换皮肤、改设置,自动保存即存档;手动保存随时存档;一键撤销/恢复/回退到任意版本,DSH 启动不了时还有局外工具(GUI 窗口 + 命令行)兜底。

预览

会话头部按钮(撤销/恢复/快照)	设置:快捷键与快照参数

快照管理面板(回退到任意版本)	局外程序窗口(DSH 撤销管理器)

功能一览

入口	能力
WebUI 头部按钮	「撤销」(红)「恢复」(绿)「快照」三个按钮,所有会话可见
快照管理面板	可视化列表(时间/类型/原因/文件数/所在库)、回退到任意快照版本、删除快照、手动保存、刷新
键盘快捷键	默认 Ctrl+Alt+Z(撤销)/ Ctrl+Alt+Y(恢复),设置 → 通用 可自定义
双模式保存	手动保存(主动存档,永不被自动清理)+ 自动保存(配置变化 1.5 秒防抖自动存档,保留最近 20 份);两种模式存储位置不同
可配置参数	设置 → 通用 →「快照设置」:自动保存开关、防抖毫秒、自动档保留数量、手动快照目录、自动快照目录,保存即生效
对话指令	对 AI 说"撤销上一步 / 回退 / 恢复 / 保存快照 / 查看快照",自动调用工具完成
撤销/重做栈	连续多步撤销;撤销后可重做;有新变更则阻止重做;每次撤销前先把当前状态存为"后悔档"
局外工具	CLI(snapshot/undo/redo/restore/remove/list/diff/prune/status)+ 程序窗口(桌面快捷方式)+ 安全装插件包装器

快照内容与存储

快照对象是 DSH 的 6 个配置文件:cordis.patch.yml、package.json、cordis.yml、pnpm-workspace.yaml(profile 下)+ settings.yaml、.env(~/.dsh 下)。

库	默认路径(可在设置中修改)	内容
手动库	<快照根>\manual\	手动保存的快照(永不自动清理)
自动库	<快照根>\auto\	自动快照、启动基线、撤销后悔档(自动档保留最近 20 份)
旧库(兼容)	<快照根>\ 根	旧版扁平布局,读取兼容,启动时自动迁移到新库

⚠️ 快照含 .env 等配置副本,可能含密钥——不要外传。

安装

前置:已安装 DSH(@deepseek-ai/dsh)与 Node.js(≥20)。

方式 A(推荐,生态标准一条命令) — 本插件已声明 dsh.bundle manifest,可直接用官方插件命令安装:

dsh plugin --profile web add github:lire1131/dsh-undo-plugin#master

安装完成后重启 DSH 即生效(快照目录、参数等均可在设置中修改)。

方式 B(本地源码/免发布) — clone 到本地目录并手工挂载:

1. 把仓库放到本地插件目录(无中文路径更稳妥),例如 D:\dsh\plugins\dsh-undo:

git clone https://github.com/lire1131/dsh-undo-plugin.git D:\dsh\plugins\dsh-undo

2. 建立 junction,让 DSH 的模块解析器通过包名 dsh-undo 找到本地源码(host 插件与 WebUI client 插件都靠它):

mklink /J "<你的DSH安装>\node_modules\dsh-undo" "D:\dsh\plugins\dsh-undo"

说明:DSH 从它自己的 node_modules 向上解析包名。默认安装位置是 C:\Users\<用户名>\node_modules(npm 安装在用户目录时);若用 npx 缓存运行,则对 npx 缓存目录下的 node_modules 建 junction。执行 npm root -g / 检查 DSH 启动报错路径即可确认。

3. 挂载到 profile 补丁层:编辑 <DSH_HOME>\profiles\web\cordis.patch.yml,追加:

- insert:
    - id: dsh-undo
      name: dsh-undo

4. 生效:保存即热加载(host 部分);刷新页面出现头部按钮与设置项;重启 DSH 后一切进入稳态(旧版扁平快照会自动迁移)。

依赖说明:host 插件通过 createRequire('<DSH安装根>/package.json') 加载 @deepseek-ai/dsh-tools。若 DSH 安装在其他位置,设置环境变量 DSH_ROOT=<DSH安装根> 即可,无需额外安装依赖。

使用

• 撤销:头部「撤销」按钮 / Ctrl+Alt+Z / 对 AI 说"撤销上一步"。
• 恢复:「恢复」按钮 / Ctrl+Alt+Y(仅当撤销后没有新操作)。
• 手动保存:面板里「手动保存」/ 对 AI 说"保存快照" / CLI snapshot。
• 回退到指定版本:面板里点快照行「回退到此版本」;或对 AI 说"回退到 ";或 CLI restore -Id <id>。
• 删除快照:面板里点「删除」;或 CLI remove -Id <id>。
• 自定义快捷键:设置 → 通用 → 撤销/恢复快捷键(点击输入框后按组合键,Backspace 清除)。
• 保存参数:设置 → 通用 → 快照设置(自动保存开关、防抖、保留数、两个目录,目录旁 📁 按钮可打开系统目录选择器)。

局外工具(DSH 挂了也能用)

界面语言:程序窗口按系统 UI 语言自动显示中文/英文;可用环境变量 DSH_UNDO_LANG=zh|en 强制指定。

进入仓库目录后:

# 程序窗口(推荐):双击 tools\dsh-undo-gui.bat,或:
powershell -NoProfile -ExecutionPolicy Bypass -File "tools\dsh-undo-gui.ps1"

# 命令行
powershell -NoProfile -ExecutionPolicy Bypass -File "tools\dsh-undo.ps1" list
powershell -NoProfile -ExecutionPolicy Bypass -File "tools\dsh-undo.ps1" snapshot -Label "原因"
powershell -NoProfile -ExecutionPolicy Bypass -File "tools\dsh-undo.ps1" undo
powershell -NoProfile -ExecutionPolicy Bypass -File "tools\dsh-undo.ps1" redo
powershell -NoProfile -ExecutionPolicy Bypass -File "tools\dsh-undo.ps1" restore -Id <id> -Force
powershell -NoProfile -ExecutionPolicy Bypass -File "tools\dsh-undo.ps1" remove -Id <id>
powershell -NoProfile -ExecutionPolicy Bypass -File "tools\dsh-undo.ps1" prune -KeepAuto 20

# 安全装插件(自动前后存档,失败自动回退)
powershell -NoProfile -ExecutionPolicy Bypass -File "tools\dsh-plugin.ps1" add <包名>

常见事故场景:DSH 启动报 duplicate loader entry id 之类错误 → 打开「DSH 撤销管理器」选中出问题前的快照 → 回退 → 重启 DSH。不用重装、不丢会话。

REST API(WebUI 的后端)

端点	说明
GET /api/undo/status	{canUndo, canRedo, total}
GET /api/undo/list	快照列表(含 location: manual/auto/legacy)
GET/POST /api/undo/settings	读/写保存参数(自动保存、防抖、保留数、目录),POST 即时生效
POST /api/undo/undo	撤销上一步
POST /api/undo/redo	恢复
POST /api/undo/restore	body {id} 回退到指定版本
POST /api/undo/remove	body {id} 删除快照
POST /api/undo/snapshot	body {reason} 手动保存
POST /api/undo/pick-dir	弹出系统目录选择器,返回选中路径

设计要点

• 撤销语义:自动快照在变更之后生成,所以"恢复最新存档"是空操作;真实撤销 = 回退到与当前状态内容不同的最新快照;全部相同则明确提示"没有可撤销的变化"。
• 撤销不会撤销掉自己:恢复 cordis.patch.yml 后自动检查并重新写入 dsh-undo 挂载条。
• 自动存档不误伤撤销:watcher 记录恢复操作写入的内容哈希,恢复动作自己的文件变化不会被自动存档(否则会挡住 redo);真实变更照常存档。
• 格式互通:Node 插件与 PowerShell 工具共用快照仓库与 manifest 格式;Windows PowerShell 5.1 与 PowerShell 7 均兼容。

开发

• 依赖解析:host 插件通过 createRequire(<DSH安装根>/package.json) 加载 @deepseek-ai/dsh-tools(环境变量 DSH_ROOT 可覆盖),无需在仓库内安装依赖。
• 测试(不需要 DSH 运行,在仓库目录执行):

node tools\smoke-test.mjs     :: 29 项逻辑测试(快照/撤销/重做/存储分流/无变化提示)
node tools\e2e-watch.mjs      :: 6 项真实时序回归(自动存档/撤销不误伤/重做)