AI Agent Hub
Back to plugins
🧩

dsh-compat-guard

admin-security Updated 2026.08.25

Run the following command in DeepSeek Harness:

dsh plugin install Shizuku-keop/dsh-compat-guard

Paste the following prompt into your AI chat to install this plugin:

Install it in DeepSeek Harness by running dsh plugin install Shizuku-keop/dsh-compat-guard; source code is available at https://github.com/Shizuku-keop/dsh-compat-guard

About this plugin

Upgrading DSH has no pre-hook, so storage format and plugin API changes can happen silently. dsh-compat-guard turns every upgrade into an explicit gate: a single preflight run checks the plugin compatibility matrix, storage-format fingerprint, and auto-backup status, and blocks the upgrade if any item is destructive. It also ships a safety-first session migration pipeline (detect, backup, transform, verify, checkpoint) that never guesses on unknown formats, plus profile-level lock files that let a team repo commit a verifiable, roll-back-able environment snapshot with credentials excluded by default. The compatibility matrix is produced by CI in isolated profiles and consumed by the same preflight, turning personal experience into a machine-readable shelf-life label. Ideal for teams managing shared DSH profiles, developers who care about session data integrity, and anyone who wants upgrade discipline enforced by executable checks rather than tribal knowledge.

Use Cases

  • Run a single preflight gate before upgrading DSH to check plugin compatibility, storage format, and backup in one pass
  • Commit profile-level lock files to a shared repo, verify environment drift, and roll back to a known-good snapshot
  • Migrate session data from sqlite to zstd JSONL across major DSH releases with a safe detect-backup-transform-verify pipeline

Best For

  • Teams managing shared DSH profiles across multiple developers
  • Developers who need session data integrity and refuse to risk a bare upgrade
  • Ops or DevOps roles who want upgrade discipline encoded as executable checks