dsh-backup

English | 简体中文

dsh-backup 是 DeepSeek Harness（DSH）的备份插件：一条命令备份 ~/.dsh，一条命令恢复。

会话记录、设置、技能、插件配置全在 ~/.dsh 一个目录里。误删了、改坏了、换电脑了——有备份就能找回来。密码等敏感文件不进备份包，还支持定时自动备份和 GitHub 云同步（细节见进阶文档）。

最近的更新：0.9.0 带来会话日志体检与定点修复（/backup doctor）、宿主起不来也能用的进程外救援通道（备份目录里的 dsh-rescue / 双击启动器）、恢复失败自动回滚与结果导向回执，以及智能备份：宿主升级前自动快照、损坏会话先隔离再入档防轮换毁掉好副本、每日/每周分级保留。0.8.0 可以在面板里直接改备份设置（备份目录、保留份数、排除模式），保存立即生效、写入 settings.yaml，不用重启；两处同时改会产生冲突提示，不会静默覆盖。0.7.x 新增了凭据脱敏（本机 vault）和跨机恢复。

安装

包发布在 npm 上，装进 DSH profile 用：

dsh plugin --profile web add @xiaoyuyu6420/dsh-backup
# 或者从 GitHub 安装：
dsh plugin --profile web add github:xiaoyuyu6420/dsh-backup

装完重启 dsh web。要求：macOS / Linux / Windows 10+（自带 tar），DSH 0.1.1-rc.2 或兼容版本。

快速上手

按上面装好插件，重启 dsh web
输入 /backup
搞定 —— 备份出现在 ~/Desktop/dsh-backups/，文件名带时间戳

想定时自动跑？/backup auto 12（每 12 小时一次，重启不中断）。

命令速查

场景	命令
立即备份	`/backup`
定时备份	`/backup auto 12`（`off` 关闭，`status` 看状态）
恢复	`/backup restore latest`（`--dry-run` 先预览）
列出备份	`/backup list`
校验是否完好	`/backup verify [前缀\|all]`
会话日志体检/修复	`/backup doctor`（`--repair [前缀\|latest]` 从备份定点修复）
彻底损坏自救	双击备份目录里的「点我恢复」文件，或 `node rescue.mjs`——零依赖救援网页，DSH 起不来也能恢复
删除某份备份	`/backup delete <前缀\|latest>`
保留份数（默认 7）	`/backup --keep N`

不敲命令也行：dsh web → 设置 → 插件 → 备份里有可视化面板——列备份、校验/恢复/删除，0.8.0 起还能直接改备份设置（目录、保留份数、排除模式），立即生效不用重启。

换新电脑

前提：旧电脑配过 GitHub 同步（配置方法）。

新电脑装好插件，配置里填同一个 githubRepo
/backup github pull —— 拉回云端备份
/backup restore latest --sync-deps —— 恢复并重装插件依赖
重启 dsh

定时备份策略、敏感文件脱敏、GitHub 同步、恢复的保护机制、配置参考、故障排查、开发说明——都在进阶文档。

致谢

@beastrobin —— #1 中对保留方法名的根因分析，直接促成 v0.5.1 修复
@mlosun —— #2 中详尽的复现与根因报告
@Choi-Peng —— #5 中协助把受影响用户指引到修复版本

许可证

MIT

dsh-backup

安装

源码

标签

作者

说明文档

dsh-backup

安装

快速上手

命令速查

换新电脑

更多

致谢

许可证