Introduction

The philosophy of DeepSeek Harness (DSH) is “everything is a plugin”. The most frequent operation in daily use is installing plugins, updating, and modifying settings. The risk lies here: if a single change makes DSH unable to start, what you need most is “the state before it broke”. Manually copying the configuration directory before every change is easy to forget and difficult to guarantee completeness.

kidai-snapshot-guard automates this: it completes the “save → confirm → restore” loop inside DSH. Install and use it, and you don’t need to remember to do anything.

What is This

One-sentence positioning: DSH’s internal automatic backup manager — saves before closing, confirms after booting, and one-click rollback.

The plugin is maintained by NokorinNishikino, licensed under MIT, and the version is 1.3.4 as of this writing (September 2026). It runs with DSH startup, and its core functionality consists of only three steps: taking a full snapshot before a normal shutdown, confirming the snapshot as “verified” after a successful boot, and restoring any snapshot back when needed.

Core Features

Automatic Save Before Shutdown

Before every normal shutdown, the plugin automatically saves a full snapshot, including configuration, settings, and third-party plugin directories, rolling back the latest 3. This means the latest 3 “full states at normal shutdowns” are available anytime.

Boot Confirmation and known-good

Snapshots are in a pending state when first generated. If the next DSH starts successfully, it indicates that the configuration at the time of shutdown runs normally. The plugin automatically converts it to “verified” and maintains a fixed-ID known-good snapshot as a known-good rollback baseline.

Single Zip Backup

Any snapshot can be exported to an offline zip with one click, or imported and restored from a zip. The zip file itself does not depend on DSH— even if DSH cannot start, you can restore the configuration using this file.

Isolated Automatic Recovery

If the “one-time isolation” of an external manager is interrupted (the started DSH is not the one launched by the manager, i.e., PID mismatch), the plugin will automatically restore the configuration prior to isolation and clear the isolation flag on the next startup. Isolation only affects a single startup.

Other Capabilities

  • Startup Notice: The top of the “Jidai Backup” page displays startup success / auto-recovery prompts.
  • Snapshot Notes: Add notes to any snapshot for easy distinction; bi-directionally syncs with external managers.
  • Compatibility: Compatible with reading and restoring rollbacks from dsh-plugin-guard and snapshots from dsh-config-manager.
  • Capacity Quota: Set snapshot usage limits in the management page.

Installation and Enablement

Environment requirements: Node >= 22.0.0. The plugin itself depends on adm-zip ^0.6.0 and the peer dependency @deepseek-ai/cordis ^4.0.1, which are handled during installation.

Installation command:

dsh plugin --profile desktop add github:NokorinNishikino/kidai-snapshot-guard

Restart DSH after installation to take effect. The plugin is ready to use immediately upon installation; it runs with DSH startup and requires no further operation.

For local development, you can execute the installation script from the kidai-plugin-remote repository directory:

powershell -ExecutionPolicy Bypass -File scripts\install-guard.ps1

Uninstall:

dsh plugin --profile desktop remove kidai-snapshot-guard

For manual cleanup: remove the dependency and bundle declaration for kidai-snapshot-guard from profiles/desktop/package.json, then delete the node_modules/kidai-snapshot-guard directory.

Typical Usage

  1. Open DSH Settings → Jidai Backup. This is the plugin’s management page, where you can view and manage snapshots, perform exports and imports, and set capacity quotas.
  2. Type /kidai-snapshot in the dialog to view a read-only summary.

Common operation mappings:

  • Save: Wait for DSH to automatically save on a normal shutdown, or call /api/kidai-snapshot/save manually.
  • Rollback: Select a snapshot to restore in the management page.
  • Long-term Retention: Export the snapshot as a zip and save it outside of DSH, then import and restore it when needed.

For integrators: The plugin exposes /api/kidai-snapshot/* interfaces on the DSH webServer, including:

status  list  save  known-good  delete
export  exports  import  restore
foreign  foreign-restore
settings  quota  meta  notice  note

The management page is implemented for the web client, injecting the @deepseek-ai/dsh-client-runtime, @deepseek-ai/dsh-client-locale, and @deepseek-ai/dsh-client-ui-settings modules.

Relationship with External Manager

Snapshots are stored in $DSH_HOME/.kidai-snapshots, and the guard directory is in $DSH_HOME/guard/. Both locations are shared with the external manager Kidai Plugin Remote. Both ends see the same batch of snapshots, and notes are bi-directionally synced between the two.

It needs to be emphasized: kidai-snapshot-guard is completely independent. You can still automatically snapshot, export, and restore without installing Kidai Plugin Remote. The external manager is merely an optional supplement, providing an entry point to operate on this batch of snapshots outside of DSH.

Applicable Scenarios and Notes

Who is it for:

  • People who frequently install, update plugins, or adjust configurations and worry that a change will break DSH.
  • Those who do not want to manually backup before every change and desire an unattended automatic snapshot mechanism.
  • Those who need recovery means even when DSH completely fails (via exported zip or external manager).

Notes Before Use:

  1. The plugin runs with the permissions of the current DSH process. You should check the source code and license before installing any third-party plugin. The source code for this plugin is public on GitHub, licensed under MIT, and can be reviewed by yourself.
  2. Snapshots are rolled back to keep the latest 3; older ones will be overwritten. For snapshots you wish to retain long-term, export them as a zip and save them separately, or add notes to distinguish them.
  3. Snapshots contain full content (configuration + settings + third-party plugin directories), and space usage can be controlled via the capacity quota in the management page.

Summary

kidai-snapshot-guard solves a specific problem: what to do if changes to DSH’s configuration break DSH itself. It does not change your usage habits; it simply silently leaves a snapshot at every normal shutdown, confirms it after a successful boot, and provides you with a clear rollback path when things go wrong.

  • Community Directory Page: https://www.skillhub.cn/plugins/NokorinNishikino/kidai-snapshot-guard (Community-maintained independent directory, no official affiliation with DeepSeek or HF Holdings)
  • GitHub Repository: https://github.com/NokorinNishikino/kidai-snapshot-guard