Undo/redo & rollback system for DSH: every config change is auto-snapshotted; undo/redo/restore to any version from the WebUI or the offline CLI/GUI tools (works even when DSH fails to boot).
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-undo-savepoint
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:lire1131/dsh-undo-savepoint
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
A security caretaker for DeepSeek Harness (DSH): every settings change is auto-snapshotted, with one-click undo / redo / restore to any version; and when DSH won't boot, the offline WebUI / GUI / CLI still work.
It checks proactively and speaks only when something is wrong. A DSH version change takes an upgrade-insurance snapshot first, and a crash names the last-known-good snapshot.
Preview
| Offline WebUI: port → Profile → snapshot store, with per-row Compare / Restore / Note / Delete |
|---|
| Snapshot diff: file navigation with add/remove counts, red/green lines | Settings: instances, snapshot policy, auto-cleanup and retention |
|---|---|
Core capabilities
| Capability | What it does |
|---|---|
| Config + plugin-code rollback | Snapshots cover config files and user-plugin code trees; undo / redo / restore any version from the WebUI, chat or offline CLI. |
| Message-level undo | Rolls back workspace file changes per AI message or 60s batch, without git or session storage. |
| One-click SAFE MODE | When DSH cannot boot, only this plugin stays enabled so boot is guaranteed; snapshots and profile/home patches are backed up first. |
| Crash attribution | Classifies the crash by log signature and names the last-known-good snapshot for one-click rollback. |
| Session-file repair | undo_scan repairs single-frame layout violations and seq overlaps; what it cannot repair is quarantined, originals untouched. |
| Timeline and snapshot management | Date grouping, notes and tags, scheduled snapshots, ZIP export/import. |
| Boot preflight and diagnostics | undo_doctor checks hard boot failures plus patch and manifest structure; repairable findings are fixed in one step after a snapshot. |
| Offline emergency kit | WebUI, GUI window, CLI and desktop shortcut: undo, diff, SAFE MODE and diagnostics while DSH is down. |
Platform support
| Capability | Windows | macOS | Linux |
|---|---|---|---|
| Config/plugin snapshots, undo/redo | ✅ | ✅ | ✅ |
| Offline Web UI (undo-server) | ✅ | ✅ | ✅ |
| Offline CLI / GUI | ✅ (.bat/.ps1) | ✅ (.command) | ✅ (.sh) |
| File/dir selection dialog | PowerShell native | osascript | zenity → kdialog (fallback: manual path) |
Installation
Prerequisites: DSH (@deepseek-ai/dsh) and Node.js. DSH 0.2.2 and newer require Node.js ≥24.9 on the host; the plugin's offline CLI / GUI needs only ≥20.
Desktop installation (recommended)
The desktop build is the main path and runs the desktop profile. Launch the desktop client once so the profile initialises, then quit it completely before installing.
GitHub direct. This installs the latest commit on the default branch; append #vX.Y.Z to pin a version.
dsh plugin --profile desktop add github:lire1131/dsh-undo-savepoint
npm registry. This installs npm's latest; append @X.Y.Z to pin a version.
dsh plugin --profile desktop add dsh-undo-savepoint
Restart DSH after installing. When DSH from 0.2.0-rc.2 on the desktop hits a fatal error, the official recovery dialog's third button drops third-party bundle entries and backs the patch up to cordis.patch.yml.bak-<timestamp>, keeping the package. No reinstall is needed after that, only restoring the mount declaration. Safe mode is refused by default on the desktop build; a request carrying confirmDesktop takes a pre-safe-mode snapshot before writing, and the third button of the official dialog remains the preferred escape path.
Web profile installation
Swap the profile to web. Append a tag or version as above to pin a version.
dsh plugin --profile web add github:lire1131/dsh-undo-savepoint
dsh plugin --profile web add dsh-undo-savepoint
Install-time environment check
The install hooks check the external Node.js, PowerShell, the platform and whether the DSH home is writable. Set DSH_UNDO_SKIP_ENV_CHECK=1 to skip the check.
Usage
- Undo: header Undo button /
Ctrl+Alt+Z/ tell the AI "undo the last step". - Redo: Redo button /
Ctrl+Alt+Y(only when nothing changed since the undo). - Manual save: "Save" in the panel / tell the AI "save a snapshot".
- Restore to a fixed version: "Restore to this" on a snapshot row.
- Delete a snapshot: "Delete" in the panel.
- Message-level undo: the header "conversation undo" entry opens the message list.
- Settings: auto-save, debounce, retention, snapshot directories and tracked workspace directories.
When DSH won't boot
Run the offline WebUI, which does not depend on DSH.
node tools/undo-server.mjs
The local page carries the timeline, rollback, diff, diagnostics and SAFE MODE. A desktop shortcut is created on plugin load. To disable every user plugin except this one, use SAFE MODE, restart DSH, then re-enable plugins one by one.
Support range
engines.dsh in package.json covers the successive 0.1.x and 0.2.x declarations, ending with >=0.2.2-0. Verified: DSH 0.2.0-rc.2 desktop, 0.2.1-rc.3 and 0.2.1-rc.5; DSH 0.2.2-rc.1 was verified in an isolated instance for host activation and client assembly, while the desktop build still needs a check on the maintainer's machine.
DSH 0.2.2 and newer require Node.js 24.9 on the host; the plugin's offline tools still need only 20, and the two are judged separately. If your DSH version falls outside the declared range, do not edit package.json; use the official version exemption.
dsh plugin --profile web allow-version dsh-undo-savepoint@<plugin-version> --dsh-version <runtime> --accept-risk
Uninstall
dsh plugin remove dsh-undo-savepoint
node tools/uninstall.mjs
uninstall.mjs removes the mount declaration, junction and desktop shortcut, keeping the snapshot library and settings. When the history is no longer needed, add --purge.
node tools/uninstall.mjs --purge
Snapshot storage and safety
Snapshots live under $DSH_HOME\undo-snapshots, split into manual and auto stores per profile; the manual store is never auto-pruned. Snapshots copy .env and similar config which may contain secrets; the plugin redacts sensitive files on write and keeps real values only in the local vault. The snapshot store is still a sensitive local directory, so do not share it.
More
- Version changes: CHANGELOG.en.md.
- Chinese README: README.md.
- License: MIT
Links
More in this category
yjh051108/dsh-routing-suite★ 7029
One repository, three parts: a runtime injector for DSH plugin packages (inject, hot-reload, unload, promote a dev staging tool to the front, route self-heal, plus a settings-page plugin manager that lists, unloads and drags folders in to internalize), a task-aware reasoning-mode router agent preset (router-standard / router-spec / router-react), and a graded two-level task protocol whose six tools (commit_star, lock_stage, revise_do, edit_plan, mark_task, redteam_verdict) pin task state to disk. The injector implementation ships in-tree, so the install carries its own behaviour rather than a dependency list.
strukto-ai/mirage#dsh★ 3789
Swaps the filesystem and bash providers for a mirage virtual workspace: file tools and shell commands run over mounted resources (RAM, S3, Redis, Slack, Gmail, Notion, Postgres) instead of the host disk, with per-mount read/write/exec modes, per-command sandbox routing (monty, pyodide, quickjs in process; docker, e2b, daytona remote), and installed CLIs (git, gh, slack, linear, ntn, gws, or one you register) as head words in the virtual terminal.
first-fluke/oh-my-agent#dsh★ 1468
Runs project OMA checks before and after tool execution and when a turn tries to finish. Installs its OMA CLI dependency and initializes unconfigured projects on first use. Requires Node.js 22+; initial setup needs network access and project write access.
MichengAI/dsh-skills-manager★ 578
Manages local DeepSeek Harness skills in Settings and shows shared Agent skills as read-only.
hust-open-atom-club/oh-dsh★ 324
Community distribution: TUI, desktop, and Web UI as one bundle with layered installation.
Fishquito7/dsh-skill-mcp-panel★ 278
Manages DSH skills and MCP servers from the web settings: skill cards with hot enable/disable, workspace scopes, groups, batch migration and drag-and-drop import, plus stdio/HTTP MCP CRUD with connection tests, secret redaction and the unified dsh-panel CLI.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.