DeepSeek Harness Data Vault (dsh-vault) 🛡
English · 简体中文
GitHub · npm · MIT License
A community plugin for DeepSeek Harness — auto backup → wipe detection → one-click restore. Backs up chat history, workspace data, settings, and credentials to a safe location outside ~/.dsh.
🔔 Important Notice (2026-08-16): This project has been renamed
1️⃣ Repository renamed
| Old | New (current) |
|---|
| GitHub repo | feiyang-dev/deepseekharnessdesktop-vault | feiyang-dev/dsh-vault |
| Local remote | https://github.com/feiyang-dev/deepseekharnessdesktop-vault.git | https://github.com/feiyang-dev/dsh-vault.git |
The old URL redirects (301) to the new one automatically. All stars / forks / issues / releases are preserved.
If you already cloned the repo locally, just update the remote:
git remote set-url origin https://github.com/feiyang-dev/dsh-vault.git
2️⃣ npm package renamed
| Old package | New package (current) |
|---|
| npm package | @feiyang666/deepseekharnessdesktop-vault | @feiyang666/dsh-vault |
- For install / upgrade, use the new package name:
dsh plugin --profile web add @feiyang666/dsh-vault
- The old package
@feiyang666/deepseekharnessdesktop-vault remains published for a while, but it is no longer maintained and will not receive updates — please migrate soon.
- The desktop client (
DeepSeek Harness Desktop) supports both package names and will auto-detect and upgrade installs made with the old name.
Overview
When the DeepSeek Harness desktop client detects a plugin load failure, it may force-clear the local ~/.dsh data (chat history, workspace data, settings, credentials, plugin configs) and restore factory defaults. dsh-vault continuously backs up all critical data to a safe location outside ~/.dsh, so your data can be fully recovered even after a wipe.
npm package: @feiyang666/dsh-vault (same series as the @feiyang666/dsh-usage-plugin usage plugin).
Features
| Capability | Description |
|---|
| Settings page "Backup Manager" | Adds a "Backup Manager" page to the Web settings: view backup status and history, back up now, one-click restore by scope (All / Chat history only / Workspace settings only), delete backups (with confirmation) |
| Automatic backup | First backup 6s after startup + debounced backup after session writes/settings changes (2 min) + scheduled backup every 15 min |
| Backup contents | sessions/ (chat history, zstd binary full copy), storages/ (workspace data), settings.yaml, .credentials.yaml, .anonymous-user-id, profiles/ configs (excluding reinstallable node_modules); if the usage plugin (dsh-usage-plugin) is installed, its usage data (usage-records.json / pricing.json etc.) is included and restored to its original directory |
| Backup location | ~/.dsh-backups/<timestamp>/ — outside ~/.dsh, untouched by data wipes |
| Wipe detection | On startup, compares backup vs current session count; red alert when data is suspected wiped |
| One-click restore | Settings page or the backup_vault tool restores by scope (All / chat history only / workspace settings only) |
| Restore script | Generates restore-latest.ps1; after quitting the desktop app, right-click to run and restore offline |
| Delete backups | Delete a specific backup by name from the settings page (with confirmation) |
Recommended Installation
Either method works and is equivalent. We recommend the desktop app — fully graphical, no command line needed.
Option 1 (recommended): One-click via the desktop app
Install DeepSeek Harness Desktop, open it, then go to "Install Plugins" → Recommended → Data Vault → Install and click "Restart Service Now" to activate.
Option 2: Command line
# Prerequisite: install dsh (npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add @feiyang666/dsh-vault
This plugin is a standard Cordis bundle plugin installed via npm and mounted into a dsh profile:
# 1. Install into the profile (equivalent to the official bundle mechanism)
npm install --prefix "$HOME/.dsh/profiles/web" @feiyang666/dsh-vault
# 2. Register the bundle in the profile's package.json (the dsh.vault row mounts automatically via cordis.patch.yml)
# Or use your desktop app's plugin manager
Or manually edit ~/.dsh/profiles/web/package.json and add "@feiyang666/dsh-vault" to dsh.profile.bundles.
Usage 1: Settings page "Backup Manager" (Web)
After installing and restarting, open Settings → "Backup Manager":
- Top shows backup directory, last backup time, backup count, and data-integrity status
- "Back Up Now" button triggers a manual backup
- The "Backup History" list offers "Restore" (scope: All / chat history only / workspace settings only) and "Delete" (with confirmation) per item
Usage 2: backup_vault tool (TUI / Web universal)
The plugin registers the backup_vault model tool — just tell the assistant "back me up / check backup status / restore chat history from the latest backup / delete that old backup":
action: status — backup directory, last backup, backup list, whether a wipe was detectedaction: backup — back up nowaction: list — list all backupsaction: restore (name + scope: all/sessions/data) — restoreaction: delete (name) — delete a backupaction: make_script — generate a one-click restore script
Manual restore (after quitting the desktop app)
- Find the backup directory
~/.dsh-backups/
- If
restore-latest.ps1 was generated, quit the desktop app and right-click → "Run with PowerShell"
- Or manually copy the contents of
backup-<timestamp>/ back into ~/.dsh/
Safety notes
- Backups include
.credentials.yaml (API keys) — keep the backup directory safe (you may copy it to an encrypted disk / cloud drive).
- Restore overwrites current data — confirm the backup time point first.
- Chat-history files may be locked while DSH is running; it's best to quit the desktop app before restoring chat history.
Related Projects
| Project | Description | Installation |
|---|
| DeepSeek Harness Desktop | Windows desktop console: install/start/stop/restart the dsh web service with one click, built-in plugin management — install this plugin from its Recommended section | Download the desktop app and click a few buttons |
| Usage & Cost Tracker (dsh-usage-plugin) | Per-call token/cache-hit stats, peak/off-peak billing, balance query, CSV/JSON/PNG export | One-click from the desktop app, or dsh plugin add @feiyang666/dsh-usage-plugin |
| DeepSeek-Harness | Official CLI / Web service | Quick start below |
Running DeepSeek Harness
Quick start (via npm)
Install Node.js, then run:
npx @deepseek-ai/dsh web
This command starts the Web UI at the default address http://127.0.0.1:3080. See the Web UI Guide for details.
Run from source
To run from the repository source:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
License
MIT © dsh-vault
