DSH 撤销/回退系统:配置变更自动存档,一键撤销/恢复/回退到任意版本,支持 WebUI 与离线 CLI/GUI 工具(DSH 启动失败也能救)。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-undo-savepoint
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:lire1131/dsh-undo-savepoint
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
为 DeepSeek Harness (DSH) 打造的安全管家。改设置自动存档,一键撤销 / 恢复 / 回退到任意版本;DSH 起不来时,局外 WebUI / GUI / CLI 依然可用。
主动检查,有异常才说话。DSH 版本变化时先打升级保险快照,崩溃后给出最后正常快照。
预览
| 局外 WebUI:端口 → Profile → 快照库,逐条对比 / 恢复 / 备注 / 删除 |
|---|
| 快照对比:左栏文件导航带增删行数,右栏逐行红绿 | 设置:实例管理、快照策略、自动清理与保留数量 |
|---|---|
核心能力
| 能力 | 说明 |
|---|---|
| 配置与插件代码回滚 | 快照覆盖配置与用户插件代码树,undo / redo / 回退任意版本,WebUI、对话、离线 CLI 三入口。 |
| 消息级撤销 | 按 AI 消息或 60s 批次回滚工作区文件改动,不依赖 git,不碰会话存储。 |
| 一键安全模式 | DSH 完全起不来时只保留本插件保证启动,自动快照并备份 profile 与 home 补丁。 |
| 崩溃归因 | 按日志签名分类崩溃原因,给出最后正常快照与一键回退。 |
| 会话扫描修复 | undo_scan 修复会话单帧布局违规与 seq 重叠,修不了的隔离,原件不动。 |
| 时间线与快照管理 | 日期分组、备注标签、定时快照、ZIP 导出导入。 |
| 启动预检与诊断 | undo_doctor 检查启动硬失败与补丁、清单结构,可修项一键修复,修前自动落快照。 |
| 局外急救 | WebUI、GUI 窗口、CLI 与桌面快捷方式,DSH 挂了也能回滚、对比、进安全模式。 |
平台支持
| 能力 | Windows | macOS | Linux |
|---|---|---|---|
| 配置 / 插件快照、撤销 / 重做 | ✅ | ✅ | ✅ |
| 局外 CLI / GUI | ✅(.bat / .ps1) | ✅(.command) | ✅(.sh) |
| 局外 WebUI(undo-server) | ✅ | ✅ | ✅ |
| 文件选择对话框 | PowerShell 原生 | osascript | zenity → kdialog(都没有则回退手输) |
安装
前置:已安装 DSH(@deepseek-ai/dsh)与 Node.js。DSH 0.2.2 及以后版本的宿主要求 Node.js ≥24.9;本插件的离线 CLI / GUI 只要求 ≥20。
桌面端安装(推荐)
桌面端是主要使用场景,走 desktop profile。先启动一次桌面端完成初始化,再完全退出桌面客户端后执行安装。
GitHub 直装。默认装默认分支的最新提交,需要固定版本时在末尾加 #vX.Y.Z。
dsh plugin --profile desktop add github:lire1131/dsh-undo-savepoint
npm 源安装。默认装 npm 上的 latest,需要固定版本时在包名后加 @X.Y.Z。
dsh plugin --profile desktop add dsh-undo-savepoint
安装完成后重启 DSH 即生效。DSH 0.2.0-rc.2 起的桌面版遇到致命错误会弹官方恢复窗,第三个按钮会摘掉第三方插件的 bundles 条目,并把补丁备份为 cordis.patch.yml.bak-<时间戳>,包本体保留。被禁用后不需要重装,恢复挂载声明即可。桌面形态下 safe-mode 默认拒绝执行,带 confirmDesktop 的显式确认会先落前置快照再写文件;官方恢复窗第三个按钮仍是首选逃生路径。
Web profile 安装
把 profile 换成 web。需要固定版本时按上面的方式自行加 tag 或版本号。
dsh plugin --profile web add github:lire1131/dsh-undo-savepoint
dsh plugin --profile web add dsh-undo-savepoint
安装期环境自检
安装钩子会检查外部 Node.js、PowerShell、平台与 DSH home 可写性。设置 DSH_UNDO_SKIP_ENV_CHECK=1 可跳过整个自检。
使用
- 撤销:头部「撤销」按钮 /
Ctrl+Alt+Z/ 对 AI 说「撤销上一步」。 - 恢复:「恢复」按钮 /
Ctrl+Alt+Y(仅当撤销后没有新操作)。 - 手动保存:面板「手动保存」/ 对 AI 说「保存快照」。
- 回退到指定版本:面板里点快照行「回退到此版本」。
- 删除快照:面板里点「删除」。
- 消息级撤销:对话头部「对话撤回」,选择消息批次撤回其文件改动。
- 设置:通用页可改自动保存、防抖、保留数、两个快照目录与跟踪工作区目录。
DSH 起不来时
运行局外 WebUI,不依赖 DSH。
node tools/undo-server.mjs
时间线、回滚、对比、诊断与安全模式都在这个本地页面里。插件加载后会自动创建桌面快捷方式,双击也能打开。需要一键禁用除本插件外的全部用户插件时,用安全模式,重启 DSH 后再逐个排查。
支持范围
package.json 的 engines.dsh 覆盖 0.1.x 与 0.2.x 的历次声明,末段为 >=0.2.2-0。已验证桌面版 DSH 0.2.0-rc.2、0.2.1-rc.3 与 0.2.1-rc.5;0.2.2-rc.1 在隔离实例里验证过宿主激活与客户端装配,桌面形态待维护者机器复核。
DSH 0.2.2 起宿主要求 Node.js 24.9,本插件离线工具仍只要求 20,两者分开判定。版本不在声明范围内时,不要改 package.json,用官方的版本豁免。
dsh plugin --profile web allow-version dsh-undo-savepoint@<插件版本> --dsh-version <运行时版本> --accept-risk
卸载
dsh plugin remove dsh-undo-savepoint
node tools/uninstall.mjs
uninstall.mjs 默认摘掉挂载声明、junction 与桌面快捷方式,保留快照库与设置。确认不再需要历史快照时加 --purge。
node tools/uninstall.mjs --purge
快照存放与安全
快照默认在 $DSH_HOME\undo-snapshots,按 profile 分 manual 与 auto 两个库,手动库不自动清理。快照会复制 .env 等配置,可能含密钥;插件写入时对敏感文件做脱敏,真实值只存本机 vault。快照库仍是本机敏感目录,不要外传。
更多
- 版本变更见 CHANGELOG.md。
- English README 见 README.en.md。
- License: MIT
链接
同类插件
yjh051108/dsh-routing-suite★ 7029
一个仓库三件套:DSH 插件包的运行时注入器(注入、热重载、卸载、开发侧挂区一键转正、路由自愈,外带设置页插件管理:列出、卸载、拖入文件夹内化)、任务感知的思维模式路由 agent 预设(router-standard / router-spec / router-react)、以及分级两级任务协议(commit_star / lock_stage / revise_do / edit_plan / mark_task / redteam_verdict 六个工具,任务状态落盘)。注入器实现直接在库内,安装的是它自己的行为而不是一份依赖清单。
strukto-ai/mirage#dsh★ 3789
把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Slack、Gmail、Notion、Postgres)而非宿主磁盘,支持按挂载点设置读/写/执行模式、按命令选择沙箱(进程内 monty、pyodide、quickjs;远程 docker、e2b、daytona),并可在虚拟终端中安装 CLI(git、gh、slack、linear、ntn、gws,或自行注册的程序树)作为命令头词。
first-fluke/oh-my-agent#dsh★ 1468
在工具执行前后以及尝试结束当前轮次时运行项目 OMA 检查。随插件安装 OMA CLI 依赖,并在首次使用时初始化未配置的项目。需要 Node.js 22+;首次初始化需要网络连接和项目目录写入权限。
MichengAI/dsh-skills-manager★ 578
在设置里管理本地 DSH 技能,并只读查看公共 Agent 技能。
hust-open-atom-club/oh-dsh★ 324
社区发行版:TUI、桌面端与 Web UI 统一体验,分层安装、一步到位。
Fishquito7/dsh-skill-mcp-panel★ 278
在 DSH Web 设置中管理技能与 MCP 服务器:技能卡片热启停、工作区作用域、分组、批量迁移与拖拽导入,以及 stdio/HTTP MCP 增删改查、连接测试、密钥脱敏,并附带统一 dsh-panel 命令行。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。