前言¶
DeepSeek Harness（DSH）的用户数据集中在 ~/.dsh。DSH 生态强调“一切皆插件”，社区目录是独立站点，不是官方应用商店，也与 DeepSeek / 幻方没有官方从属关系。dsh-backup 解决的是这类用户数据的备份、恢复、校验、定时任务、GitHub 同步，以及在 DSH 无法启动时的救援恢复。
这是什么¶
dsh-backup 是一个 DSH 插件，由 xiaoyuyu6420 维护，许可证为 MIT。它面向 DeepSeek Harness 用户，用来备份和恢复 ~/.dsh 下的用户数据，并提供 sha256 校验、保留策略、凭据脱敏、定时备份、GitHub 同步拉取和图形设置面板。
该插件要求：
macOS / Linux / Windows 10+DSH 0.1.1-rc.2 or compatible
核心能力¶
已核实的能力包括：
- 用
/backup备份 DeepSeek Harness 用户数据（~/.dsh） - 用
/backup auto配置定时自动备份，且配置在重启后仍保留 - 为备份生成 sha256 checksums，并支持完整性校验
- 备份轮换 / 保留策略，默认
keep 7 - 恢复前可用
--dry-run预览，恢复失败时自动回滚并给出结果回执 - 凭据默认从归档中脱敏，明文只保存在本地 vault
- 支持 GitHub 同步拉取，以及跨机恢复预检
- 提供 Visual Settings panel，可执行 list、verify、restore、delete，并编辑设置
- DSH 无法启动时，可使用 rescue console 进行恢复
/backup doctor用于会话日志健康检查与修复- 当 host version 变化时，可生成 pre-upgrade snapshots
- 支持
macOS / Linux / Windows 10+
安装与启用¶
先安装插件，然后按插件说明重启 dsh web。官方安装命令如下：
dsh plugin --profile web add @xiaoyuyu6420/dsh-backup
安装前建议检查源码与许可证。插件以当前 dsh 进程权限运行，权限范围取决于你的 dsh 运行环境。
已核实材料中版本信息不一致：package.json 声明 0.9.1，README 示例与近期发布说明提到 0.9.0。实际以安装包的 package.json 为准。
典型用法¶
下面按常见操作顺序介绍。
1、手动备份¶
/backup
这一步会对 ~/.dsh 生成备份归档。默认备份目标为：
~/Desktop/dsh-backups/
2、查看备份列表¶
/backup list
用于查看已有备份。
3、校验备份完整性¶
/backup verify all
用于检查备份的 sha256 checksums 与完整性。
4、预览恢复¶
/backup restore latest --dry-run
先预览即将恢复的内容，不直接覆盖当前状态。
5、执行恢复¶
/backup restore latest
确认无误后执行恢复。若恢复失败，会触发自动回滚并给出结果回执。
6、配置定时自动备份¶
/backup auto 12
这一步开启定时自动备份；12 是命令中的定时参数。该配置在重启后仍保留，并按默认保留策略轮换，默认 keep 7。
7、检查会话日志¶
/backup doctor
用于会话日志健康检查与修复。
8、从 GitHub 拉取备份¶
/backup github pull
用于从 GitHub 同步拉取备份归档。
9、跨机恢复并处理依赖¶
/backup restore latest --sync-deps
用于跨机恢复场景，并同步相关依赖。
默认路径与保留策略¶
默认备份目录为：
~/Desktop/dsh-backups/
默认保留策略为：
keep 7
凭据处理¶
凭据默认从归档中脱敏。明文只保存在本地 vault，不随归档扩散。
DSH 无法启动时¶
如果 dsh 无法启动，可以使用备份生成的 rescue console 进行恢复。它面向的是 DSH 无法正常启动时的恢复场景。
适用场景与注意¶
适合以下情况：
- 升级前保留一份可回滚的快照
- 误删或损坏
~/.dsh后需要恢复 - 定时备份，减少人工遗漏
- 跨机迁移或 GitHub 同步拉取
- 校验备份完整性
注意：
- 平台要求：
macOS / Linux / Windows 10+ - DSH 要求：
0.1.1-rc.2 or compatible - 安装后需要重启
dsh web - 插件以当前
dsh进程权限运行 - 版本信息存在不一致，建议以实际
package.json为准
链接¶
目录页：
https://www.skillhub.cn/plugins/xiaoyuyu6420/dsh-backup
GitHub：
https://github.com/xiaoyuyu6420/dsh-backup
