a903067276-rgb/dsh-backup

dsh-backup 📦

License: MIT

非官方项目：社区成员独立开发维护，非 DeepSeek 官方产品。

DSH 数据自动备份——会话记录、配置文件与自定义目录打包成 .zip，支持定时与手动备份、自动轮转。

截图

dsh-backup 设置页

| 操作 | 效果 |
|---|---|
| 定时备份 | 按设定的间隔自动打包 DSH 数据（默认每 6 小时） |
| 手动备份 | 设置页一键「立即备份」 |
| 自定义目录 | 每行一个绝对路径（如记忆库） |
| 自动轮转 | 只保留最近 N 份（默认 10），旧的自动删除 |
| 恢复 | 仅手动——把压缩包解压回原位置（步骤见 docs/install.md） |

默认备份内容： ~/.dsh/sessions（会话记录）、~/.dsh/profiles（配置，排除 node_modules）、~/.dsh/AGENTS.md（全局约定）。其它内容（比如记忆库）加到自定义目录列表。

安装

dsh plugin --profile web add "github:a903067276-rgb/dsh-backup#main"

然后重启 dsh web。手动兜底：docs/install.md。

使用

打开 设置 → 备份：

- 状态行：上次备份 / 下次定时 / 备份目录
- 「立即备份」按钮
- 备份列表：文件名、大小、时间、删除
- 设置：备份目录、定时开关 + 间隔（小时）、保留份数、自定义目录（每行一个绝对路径）

平台支持

| 平台 | 状态 |
|---|---|
| macOS | ✅ 实测 |
| Linux | ✅ 预期可用（纯 Node 实现，不依赖系统 zip） |
| Windows | ✅ 预期可用（纯 Node 实现，不依赖系统 zip） |

环境要求

- DSH web（≥ 0.1.0-rc.6）
- 版本兼容（尽力兼容——设置卡片用双字段 key+id 注册，同满足 rc.6（id 契约）与 rc.7+（key 契约）；已在本地实测 rc.6/rc.8/0.1.1-rc.2/0.1.5-rc.1，不保证每个 DSH 版本）：
- DSH 0.1.0-rc.6 及以上（含 0.1.1-rc.1/rc.2）：装 main（默认）。
- DSH 0.1.5-rc.1：加载实测通过（host 半加载日志正常）；只用 settings/shell 等稳定服务，不碰 0.1.5 变更过的契约。备份/还原端到端流程未在 0.1.5 上复测。
- 保守回退（升级前的最后版本）：DSH 0.1.0-rc.7/rc.8 → v0.1.2（dsh plugin add github:a903067276-rgb/dsh-backup#v0.1.2）；DSH 0.1.0-rc.6 → 冻结 rc6-compat（不再维护）。
- Node.js ≥ 16.7（DSH 自带）
- 维护策略：本插件将持续跟随 DSH 最新版本演进；对旧版 DSH 的兼容仅是尽力而为、不保证长期有效。

工作原理

- Host 半：零依赖 zip 打包器（lib/zip.js，纯 Node 流式——不依赖系统 zip、不走 shell、不受会话沙箱限制）；timer 定时调度；/api/dsh-backup/ 路由供设置页调用。
- Client 半：一个设置页区块（settings.section，「备份」）负责列备份、改配置；保存后把配置写回当前 profile 的 cordis.patch.yml（重启生效）。

注意事项

- 恢复故意只做手动：先停 DSH、把压缩包解压覆盖回原路径，且确认恢复无误前保留现有数据。插件自身绝不覆盖任何东西。
- 备份目录默认 ~/Documents/DSH/backup，可在设置里修改。
- 只列出/删除本插件命名的备份（dsh-backup-.zip），目录里其它文件不动。

License

MIT