Skip to content

dsh-backup-sync v0.1.0

Choose a tag to compare

@Arlenman Arlenman released this 14 Oct 09:11
· 20 commits to main since this release

dsh-backup-sync v0.1.0

DeepSeek Harness 的备份 / 恢复 / 换机同步插件首个公开版本。

安装

# 从 GitHub 装(推荐锁这个 tag)
dsh plugin --profile web add github:Arlenman/dsh-backup-sync#v0.1.0

# 或直接用下面这个 tar.gz 资产
dsh plugin --profile web add https://github.com/Arlenman/dsh-backup-sync/releases/download/v0.1.0/dsh-backup-sync-0.1.0.tgz

桌面版:设置 → 插件 → 安装,粘贴上面任意一条。
装完重启一次 DSH(宿主半边的 HTTP 路由不热重载)。

暂未发布到 npm,dsh plugin --profile web add dsh-backup-sync 这个写法现在装不到东西。

要求 DSH 0.2.0-rc.2、Node.js ≥ 22,零运行时依赖。

这个版本有什么

  • 六个模块:技能(~/.agents/skills,别的备份插件备不到)、插件清单、核心配置、记忆、待办、对话(默认不勾)。
  • 带基线的三方合并导入:逐文件判定「只有对方改了 / 只有我改了 / 两边都改了」,
    冲突弹差异预览逐项裁决;裁决「保留本地」之后基线记归档版本当共同祖先,下次不再打扰。
  • 删除默认关闭(allowDelete=false);导入前自动快照到 <输出目录>/pre-restore-<时间戳>/。
  • 凭据永不进包:凭据文件名/后缀黑名单 + 1 MiB 内容闸,包内不可能出现 API key。
  • 定时备份:每天固定时刻或每隔 N 小时;DSH 没开不补跑、失败不重试、只删自己打的包。
  • 同步目录推送:推到 OneDrive / 坚果云 / 群晖 / U 盘,带 sha256 校验。
  • 入口:设置 → 备份同步(四个页签:备份 / 历史版本 / 导入 / 同步)。
  • 12 条 HTTP 路由(/api/dsh-backup-sync/*),走 DSH 自带连接鉴权。

质量

  • 423 项单元测试,Windows 与 Linux 双平台全绿;CI 跑 Node 22 / 24 × Ubuntu / Windows。
  • 归档格式 tar.gz + .sha256 边车;包内 manifest.json 记录逐文件哈希。
  • 文档开源:逆向内核得到的客户端模块加载器契约与 settings.section 槽位契约
    (docs/notes/),以及本插件的设计与实施记录(docs/plans/)。

已知限制

  • 归档不加密(tar.gz + sha256);要加密请用同步目录那一侧的工具。
  • 配置文件的合并粒度是「整文件」,不做字段级合并(插件清单的 JSON 除外)。
  • 定时器跑在宿主进程内,DSH 退出即停(有意为之)。
  • 界面半边是手写 CJS bundle(本机无打包器),无 JSX / TS。

完整改动:CHANGELOG.md