数据保险箱 feiyang-dev/dsh-vault

DeepSeek Harness 数据保险箱（dsh-vault）🛡

GitHub · npm · MIT License

由开发者制作的 DeepSeek Harness 插件 —— 自动备份 → 清空检测 → 一键恢复，把聊天记录、工作区数据、设置与凭据备份到 ~/.dsh 之外的安全位置。

🔔 重要通知（2026-08-16）：项目已改名

1️⃣ 仓库改名

| | 旧地址 | 新地址（当前） |
| GitHub 仓库 | feiyang-dev/deepseekharnessdesktop-vault | feiyang-dev/dsh-vault |
| 本地 remote | https://github.com/feiyang-dev/deepseekharnessdesktop-vault.git | https://github.com/feiyang-dev/dsh-vault.git |

旧地址会自动 301 重定向到新地址，star / fork / issue / Release 全部保留。
本地已有 clone 的仓库，只需更新 remote：

git remote set-url origin https://github.com/feiyang-dev/dsh-vault.git

2️⃣ npm 包名更换

| | 旧包名 | 新包名（当前） |
| npm 包 | @feiyang666/deepseekharnessdesktop-vault | @feiyang666/dsh-vault |

- 安装 / 升级请改用新包名：dsh plugin --profile web add @feiyang666/dsh-vault
- 旧包名 @feiyang666/deepseekharnessdesktop-vault 仍会保留一段时间，但不再维护、不会更新，请尽快迁移
- 桌面端（DeepSeek Harness 桌面版）已兼容两种包名，旧包名安装的会自动识别并升级到新包名

简介

DeepSeek Harness 桌面端在检测到插件加载失败时，可能会强制清除 ~/.dsh 本地数据（聊天记录、工作区数据、设置、凭据、插件配置）并恢复出厂。dsh-vault 把全部关键数据持续备份到 ~/.dsh 之外的安全位置，即使数据被清空也能完整找回。

npm 包名：@feiyang666/dsh-vault（同项目系列：@feiyang666/dsh-usage-plugin 用量插件）。

功能

| 能力 | 说明 |
| 设置页「备份管理」 | Web 端设置页新增「备份管理」页面：查看备份状态与历史、立即备份、按范围一键恢复（全部 / 仅聊天记录 / 仅工作区设置）、删除备份（需二次确认） |
| 自动备份 | 只保留三种触发时机（v1.2.2 起）：① 启动备份（正常启动 6 秒后）② 意外关闭备份（上次运行未正常退出，本次启动立即备份）③ 手动备份（设置页 / backup_vault 工具）。不再按会话落盘或定时全量备份，避免大量任务运行时反复复制 ~/.dsh 导致卡死 |
| 备份内容 | sessions/（聊天记录，zstd 二进制完整复制）、storages/（工作区数据）、settings.yaml、.credentials.yaml、.anonymous-user-id、profiles/ 配置（排除可重装的 node_modules）；若已安装用量插件（dsh-usage-plugin），其用量数据（usage-records.json / pricing.json 等）会一并备份，恢复时按原目录还原 |
| 备份位置 | ~/.dsh-backups/<时间戳>/ —— 在 ~/.dsh 之外，数据清空不会波及；最多保留最近 10 份，旧的自动清理 |
| 清空检测 | 启动时对比备份与当前会话数，数据疑似被清空时红色告警 |
| 一键恢复 | 设置页或 backup_vault 工具按范围恢复（全部 / 仅聊天记录 / 仅工作区设置） |
| 恢复脚本 | 生成 restore-latest.ps1，退出桌面端后右键运行即可离线还原 |
| 删除备份 | 设置页按名称删除指定备份（二次确认） |

推荐安装方式

两个方法任选其一，效果等价。推荐使用桌面端，全程图形化、无需命令行。

方式一（推荐）：桌面端一键安装

安装 DeepSeek Harness 桌面版，打开后点击 「安装插件」→ 推荐插件 → 数据保险箱 → 一键安装，完成后点 「立即重启服务」 即可生效。

方式二：命令行安装

前提：已安装 dsh（npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add @feiyang666/dsh-vault

本插件是标准 Cordis bundle 插件，通过 npm 安装后挂载到 dsh profile：

1. 安装到 profile（等价于官方 bundle 机制）
npm install --prefix "$HOME/.dsh/profiles/web" @feiyang666/dsh-vault

2. 在 profile 的 package.json 中注册 bundle（dsh.vault 行会通过 cordis.patch.yml 自动挂载）也可用你的桌面端插件管理器安装

或手动编辑 ~/.dsh/profiles/web/package.json，在 dsh.profile.bundles 中加入 "@feiyang666/dsh-vault"。

使用方式一：设置页「备份管理」（Web 端）

安装并重启后，打开设置 → 「备份管理」：

- 顶部显示备份目录、上次备份时间、备份份数、数据完整性状态
- 「立即备份」按钮手动触发备份
- 「备份历史」列表每项有「恢复」（选择范围：全部/仅聊天记录/仅工作区设置）与「删除」（二次确认）按钮

使用方式二：backup_vault 工具（TUI / Web 通用）

插件注册模型工具 backup_vault，直接对助手说"帮我备份一下 / 查看备份状态 / 从最新备份恢复聊天记录 / 删除那个旧备份"即可：

- action: status —— 备份目录、上次备份、备份列表、是否检测到清空
- action: backup —— 立即备份
- action: list —— 列出全部备份
- action: restore（name + scope: all/sessions/data）—— 恢复
- action: delete（name）—— 删除备份
- action: make_script —— 生成一键恢复脚本

手动恢复（桌面端退出后）

1. 找到备份目录 ~/.dsh-backups/
2. 若已生成 restore-latest.ps1，退出桌面端后右键"使用 PowerShell 运行"
3. 或手动把 backup-<时间戳>/ 下的内容复制回 ~/.dsh/

安全说明

- 备份含 .credentials.yaml（API 密钥），请妥善保管备份目录（可复制到加密磁盘/网盘）。
- 恢复会覆盖当前数据，请先确认备份时间点。
- 聊天记录文件在 DSH 运行时可能被占用，恢复聊天记录建议先退出桌面端。

相关项目

| 项目 | 说明 | 安装方式 |
| DeepSeek Harness 桌面版 | Windows 桌面控制台：一键安装/启动/停止/重启 dsh web 服务，内置插件管理，推荐插件区一键安装本插件 | 下载桌面版，点几下即可 |
| 用量与消耗插件（dsh-usage-plugin） | 每次调用的 token 用量/缓存命中统计、峰谷计费、余额查询、CSV/JSON/PNG 导出 | 桌面端一键安装，或 dsh plugin add @feiyang666/dsh-usage-plugin |
| DeepSeek-Harness | 官方 CLI / Web 服务 | 见下方「运行 DeepSeek Harness」 |

运行 DeepSeek Harness

快速安装（通过 npm）

安装 Node.js，然后运行：

npx @deepseek-ai/dsh web

该命令会启动 Web UI，默认地址为 http://127.0.0.1:3080。详见 Web UI 指南。

从源码运行

如需从仓库源码运行：

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