同步备份 · summerscar 的 DSH 插件

以下内容来自 docs/README.zh-CN.md（0.1.15）。

dsh-mnemon-sync

为 dsh-mnemon 的记忆和你的技能做备份与恢复 —— 打包到 S3 兼容存储或 WebDAV，随时挑一个包还原回来。

dsh-mnemon 把长期记忆存在本地 SQLite 和一批 Markdown 文件里，DSH 则把技能存成磁盘上的 SKILL.md 目录。这个插件给这两样都加上异地备份和按需恢复：装好后在记忆系统里多一个「同步备份」标签页。

同步备份页面：选择记忆与技能组件、备份目标与备份频率

记忆系统 → 同步备份
  ├── 备份范围   记忆空间 / 项目档案 / 运行时记忆 / 技能文件 / 技能数据（可任选）
  ├── 备份目标   S3 兼容存储 或 WebDAV
  ├── 自动备份   关闭 · 每小时 · 3/6/12 小时 · 每天 · 3/7 天
  └── 备份列表   查看明细 · 选择组件恢复

快速开始

dsh plugin --profile web add @summerscar/dsh-mnemon-sync

重启 DSH，打开记忆系统即可看到「同步备份」。没装 dsh-mnemon 时插件仍可运行，只是不显示标签页。

Desktop 版：在桌面应用的插件界面里安装即可。desktop profile 由 Electron 应用独占管理，命令行 dsh plugin --profile desktop 会被拒绝，这是 dsh 自身的限制。

功能

五个组件，任意组合

组件	内容	默认
记忆空间	`<MNEMON_DATA_DIR>/data/`，每个空间的 `mnemon.db` 与空间清单	选中
项目档案	`<MNEMON_DATA_DIR>/documents/`，`index.json` 与全部 Markdown	选中
运行时记忆	`<MNEMON_DATA_DIR>/runtime/`，`memories.json` 与两份投影	选中
技能文件（SKILL.md）	用户级技能根下真实的技能目录树：`$DSH_HOME/skills`、`$DSH_AGENTS_HOME/skills`	不选
技能数据（mnemon）	`<MNEMON_DATA_DIR>/skills/`，`ledger.json`、`evals.json`、`versions/`、`trajectories/`、`market/`、`trash/`	不选

MNEMON_DATA_DIR 未设置时取 ~/.mnemon，页面上会直接显示当前实际读取的目录。

技能的两个组件默认都不勾选。备份记忆是常规操作，搬技能则是主动决定：恢复会直接写入技能根目录，不该作为「顺手备份一次」的副作用发生。要换机器时把这两项勾上即可。

技能拆成两项，是因为它们的性质不同：SKILL.md 决定模型会什么，换机器一定要带走；ledger.json 与 trajectories/ 是本机进化历史，体积大且可重算，不想传到远端就把它留空。

项目级技能不在备份范围：<项目>/.dsh/skills 和 <项目>/.agents/skills 属于代码仓库，跟着 git 走。把它们塞进记忆备份等于给同一份内容找第二个来源，恢复时还可能覆盖你的工作区，所以这里只备份用户自己的那一层。

dsh-mnemon 的存储位置不一定是默认的那一个（它的 storageScope 还可以是 workspace、custom 或 workspaces），而第三方 Source 拿不到这个值，所以「备份范围」里可以手填数据目录。留空即按上面的规则自动判断；填了就只读你指定的目录，页面上「当前实际读取」会跟着变。「恢复自动判断」把这一项清回留空状态。

两种备份目标

S3 兼容 — 手写 AWS Signature V4，适用于 Cloudflare R2、MinIO、Backblaze B2、阿里云 OSS 等
WebDAV — Basic 认证，自动创建远端目录

备份文件按设备区分

mnemon-sync-<设备名>-2026-11-09T01-20-27.875Z.zip

设备名取自 dsh-mnemon 的 state/machine.json，多台机器备份到同一目录也能一眼分辨来源。

一致性有保证

数据库走 node:sqlite 的 backup() 在线备份，写入方的 WAL 不会把副本撕开
每个文件记录 SHA-256，上传前自校验，恢复前再校验一次
恢复默认只做预览，确认后才写盘；写数据库前先删同名 -wal / -shm，避免 SQLite 重放恢复文件里没有的事务
系统的杂物文件（.DS_Store、Thumbs.db、desktop.ini、._* 资源分叉、编辑器 .swp / ~ 备份）不会进备份包；旧包里带上的这类文件在恢复时被跳过，不影响其余文件写入

配置

在「同步备份」页面填好即可，配置存在 <MNEMON_DATA_DIR>/state/mnemon-sync.json（权限 0600），不写入 DSH 配置，也不会进备份包。

S3 / Cloudflare R2 示例

字段	示例
Endpoint	`https://<account>.r2.cloudflarestorage.com`
Bucket	`my-mnemon-backup`
Region	`auto`
Access Key ID	你的 R2 Access Key
Secret Access Key	你的 R2 Secret
强制 path-style	R2 和 MinIO 通常需要勾选

WebDAV 示例

字段	示例
地址	`http://192.168.100.134:5005`
用户名	你的 WebDAV 账号
密码	你的 WebDAV 密码
远端目录	`config-backup/mnemon-sync`

地址带不带结尾斜杠都可以，插件会归一化。

页面只回显掩码，回传掩码表示不修改。想换密钥就直接填新值。

常见问题

装好了但看不到标签页？

重启 DSH —— Host 侧的 Source 注册和浏览器端代码都要重启才加载
确认 dsh-mnemon 已安装且版本 ≥ 0.5.40
确认 dsh.profile.bundles 里有 @summerscar/dsh-mnemon-sync
强刷页面（Ctrl+Shift+R）绕开浏览器缓存

备份报 401 Not Authorized？

凭据问题。检查用户名密码，以及 WebDAV 服务是否真的在运行。注意有些 NAS 的 WebDAV 改配置后需要重启服务才生效。

为什么不用 litestream？

litestream 一个实例只盯一个数据库，v0.5 每个库只允许一个副本 —— 备份整个 data 目录就得为每个记忆空间养一个常驻进程。另外它接管 WAL checkpoint 并持锁，实测会让 mnemon.db-wal 停在非零字节，而 dsh-mnemon 自己的备份导出有这条检查，会直接报错：

if (existsSync(wal) && statSync(wal).size > 0)
  throw new Error(`Memory Space ${id} is busy (...-wal is not checkpointed)`)

保留份数怎么算？

按运行时间保留最新的 N 个，超出后删除最旧的。删除依据是插件自己的运行记录，不会去 LIST 远端目录。

开发

git clone https://github.com/summerscar/dsh-plugins.git
cd dsh-plugins
pnpm install
pnpm --filter @summerscar/dsh-mnemon-sync test

文件	职责
`index.js`	Host 入口：HTTP 接口、调度装配、备份引擎
`source.js`	承载页面身份的记忆 Source（不存记忆）
`snapshot.js`	组件识别、数据库在线备份、manifest 与校验
`scheduler.js`	定时器与运行历史
`store.js`	设置存取（0600）与规范化
`targets.js`	S3 SigV4 / WebDAV 的上传、下载、列目录、删除
`zip.js`	零依赖 ZIP 读写（基于 `node:zlib`）
`client.js`	浏览器端页面与标签注册

零外部运行时依赖。

许可

SATA 2.1（0.1.11 及之前发布在 npm 上的版本仍为 MIT。）

安装

说明

dsh-mnemon-sync

快速开始

功能

配置

常见问题

开发

许可