前言¶
DeepSeek Harness (DSH) 采用插件化架构,允许开发者通过扩展功能来定制工作流。对于开发者而言,会话历史、配置文件以及自定义数据目录(如记忆库)的持久化是刚需。手动备份容易遗漏,且耗时。dsh-backup 插件旨在解决这一问题,提供自动化的备份方案,将重要数据打包存档。
插件介绍¶
dsh-backup 是一个由社区成员维护的非官方插件,采用 MIT 许可证。
它主要解决 DSH 开发过程中数据丢失的风险,支持对以下内容进行备份:
- 会话记录
- 配置文件
- 自定义目录
插件支持定时自动备份和手动备份,具备自动轮转机制(保留最近的备份文件),并将数据打包为 .zip 存档。
安装与启用¶
在安装前,请确保你的 DSH web 版本不低于 0.1.0-rc.6。
通过命令行安装插件:
dsh plugin --profile web add "github:a903067276-rgb/dsh-backup#main"
安装完成后,需要重启 dsh web 以使插件生效。
使用方法¶
-
打开备份面板
在 DSH 界面中,依次打开 Settings → Backup。 -
查看状态
在状态行中,你可以看到最后一次备份的时间、下一次定时备份的运行时间以及备份文件夹的默认路径(~/Documents/DSH/backup)。 -
手动备份
点击 “Back up now” 按钮,立即执行一次备份操作。 -
配置备份内容
在 Custom directories 设置项中,你可以添加额外的绝对路径。例如,如果你将记忆库存储在独立的目录中,可以将该路径添加进去,确保备份文件中包含所有关键数据。 -
管理备份列表
在备份列表中,你可以查看已生成的备份文件(文件名格式为dsh-backup-*.zip)、文件大小、创建时间,并支持手动删除。 -
设置定时任务
插件默认每 6 小时运行一次定时备份。你可以在设置中关闭定时任务,或调整备份的时间间隔。
注意事项¶
- 恢复方式:该插件仅提供备份功能,恢复操作是手动的。你需要停止 DSH 进程,将解压后的文件放回原始位置,并确保当前数据已确认无误。
- 覆盖策略:插件不会自行覆盖任何现有文件,这是为了防止意外数据丢失。
- 文件管理:备份文件夹中只有插件生成的文件(
dsh-backup-*.zip)会被列出和删除,其他无关文件不会被处理。 - 版本兼容性:插件对 DSH 版本的兼容性为“尽力而为”,未经过所有版本的测试。建议在 DSH 0.1.0-rc.6 及以上版本使用,若遇到兼容性问题可尝试切换插件版本标签。