跳过主要内容
M

dsh-cloud-backup

maxc100/dsh-cloud-backup

自动备份,会话、配置、Agent 文件、插件数据,到你的阿里云盘。被覆盖的文件自动留一份旧版,你改过的工作区名字不会被冲掉。扫码即可登录,换台电脑也能把整套环境和插件装回来。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。

安装

dsh plugin --profile web add github:maxc100/dsh-cloud-backup

README

dsh-cloud-backup

把 DSH 的会话与配置做内容寻址去重后备份到免费云盘(阿里云盘首发):设置页点一下 → 扫码授权 → 之后每小时自动备份 → 需要时一键还原。

  • 零外部依赖:不需要装云盘客户端、Node 用 DSH 自带的。
  • 只上传去重后的数据块:内容不变的快照几乎不额外占空间。
  • 凭据用 Windows DPAPI 加密存放,明文不落盘、不进日志、不上云。

功能一览

能力说明
授权设置页出二维码(本机生成)→ 手机阿里云盘 App 扫码 → 自动建云端目录;也支持「从本机客户端导入(免扫码)」
备份采集 sessions / storages / profiles/*/package.json 等 → sha256 分块去重 → 增量上传 → 逐块校验
调度每小时自动(可关)+ 手动「立即备份」
保留GFS 四层:近 24 份 + 日 7 + 周 4 + 月 6
恢复列快照 → 预览(写哪些、覆盖哪些)→ 还原到指定目录 → 校验;可从云端拉缺失数据块后还原
安全写盘路径强制留在目标目录内;覆盖前先留 .bak-restore-<stamp>;写 DSH_HOME 需要二次确认

界面里的目录树(中文名对照)

展开一份「快照」时,顶层目录以中文名显示,后面跟灰字原始目录名与说明:

目录界面中文名说明行
sessions/会话各工作区的会话记录(.jsonl)
storages/存储Harness 持久化缓存与工作区登记
profiles/插件配置每个 profile 的插件清单与 patch 文件
(根)根文件AGENTS.md、prompt-inject.md 等

卡片里的三个 ⓘ 说明

位置解释什么
「快照 / 块」行右侧为什么云端存的是「块 / 清单 / 索引」:内容寻址去重、增量、可逐块 sha256 校验、云端目录平坦、换云只换上传层、命中同内容可秒传
「清理本地旧快照」按钮右侧只删本地:删整份副本目录(含清单)+ 回收仅它引用的数据块;共用块保留;云端一个字节不动;删前确认云端有该清单,没有则跳过
「还原」区标题右侧一份副本 = 那一刻整份 DSH 数据的完整拷贝,不是一个文件、也不只存变化

安装

装到桌面版 DSH 的某个 profile 上(desktop 是默认 profile):

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop add dsh-cloud-backup

也可以直接从 GitHub 装,取仓库默认分支的最新提交:

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop add github:Maxc100/dsh-cloud-backup

装完完全退出并重启桌面版 DSH(后端路由随进程启动,不重启不生效)。 重启后:设置(Ctrl+Alt+,)→ 左侧「云盘备份」。

从源码调试

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
  plugin --profile desktop add "<本机仓库绝对路径>"

桌面版不在 %LOCALAPPDATA% 下时,把上面的路径换成自己的 dsh.cmd 绝对路径。本地路径务必用绝对路径,相对路径会被 DSH 解析错。

首次使用

  1. 设置 → 云盘备份 → 点「连接阿里云盘」,卡片里出现二维码。
  2. 手机「阿里云盘」App 扫码 → 手机上确认。
  3. 卡片变成「已连接」,云端出现目录 dsh-cloud-backup(可在设置里改名)。
  4. 点「立即备份」跑第一次全量;之后每小时自动跑(可在 config.json 里 enabled: false 关掉)。

恢复

场景做法
误删了某个会话选最近一份快照 → 预览 → 还原到默认目标,只补缺失文件(默认不覆盖)
换了电脑 / 重装先连接同一账号 → 「含云端」列出云端快照 → 选中 → 「从云端拉取」(把数据块下载回本地)→ 再还原
演练预览 → 还原到临时目录 → 「校验」逐文件比对 sha256

还原到 DSH_HOME 本身属于破坏性操作,接口要求显式二次确认;覆盖已有文件时原文件先改名为 .bak-restore-<stamp>。

数据放在哪

  • 本机状态:%DSH_HOME%\cloud-backup\(credentials.json DPAPI 密文、config.json、store/ 本地数据块与快照、state.json)
  • 云端:<你配置的目录>/objects/blobs/<ab>/<cd>/<sha256>、snapshots/<stamp>/manifest.json、index.json
  • 上传集合是白名单:只有 objects/、snapshots/、index.json 三样会上云;.keys、credentials.json、日志永远不上云。

接口(宿主侧,给排障用)

前缀 /api/dsh-cloud-backup(兼容别名 /dsh-cloud-backup,仅 status)。

方法路径作用
GET/status状态、版本、授权、上次备份、配置
POST/auth/qr/start生成扫码会话与二维码
POST/auth/qr/poll轮询扫码结果
POST/auth/refresh / /auth/verify / /auth/logout续期 / 验证 / 断开
GET/backup/status备份与审计
POST/backup/run立即备份({upload:false} 只做本地)
POST/backup/config改备份配置
GET/restore/snapshots列出可还原快照(?remote=1 附云端)
POST/restore/preview / /restore/run / /restore/verify / /restore/from-cloud预览 / 还原 / 校验 / 从云端拉块
POST/maintenance/cleanup清云端孤儿快照目录(默认 dryRun)

状态码排查:404 = 插件没被加载(没重启、或没进 dsh.profile.bundles);401 unauthorized = 路径不在 /api/<ns> 前缀下,被宿主的 /api 前置校验拦下。

目录

dsh-cloud-backup/
├─ package.json          exports ./client + dsh.bundle.patch + dsh.client.platform=web
├─ cordis.patch.yml      - insert: - id: dsh-cloud-backup / name: dsh-cloud-backup
├─ client.js             前端:设置页卡片(window.__ModuleLoader__ 工厂包,无需构建链)
├─ lib/
│  ├─ index.js           后端:export name / inject=["webServer"] / apply(ctx),17 条 exact 路由
│  ├─ qr.js              二维码(矩阵 / SVG / data URL)
│  ├─ auth/aliyun.js     扫码会话、换 token、续期、建目录、业务错误归一
│  ├─ auth/adrive-local.js 免扫码:复用本机阿里云盘客户端登录态
│  ├─ store/             paths / secret(DPAPI) / credentials / state / config
│  ├─ engine/            collect / blob / manifest / rotation / run / restore / prune
│  ├─ providers/aliyun.js 云端读写:上传、列目录、拉块、回收站、孤儿清理
│  └─ vendor/qrcode-generator.cjs  自包含二维码编码器(避免外部依赖)
└─ README.md

License

本项目以 GPL-3.0-or-later 发布,全文见仓库根目录 LICENSE。

相关插件