多机同步 Rosa42/dsh-sync

dsh-sync

一个 DeepSeek Harness 插件，它添加了一个 设置 → 同步 页面，用于将一台机器的 DSH 主目录（~/.dsh）迁移到其他机器：会话日志和配置文件，通过任意 rclone 远程进行双向同步。

它封装了 rclone bisync，因此以下操作都无需手动完成：编辑 rclone 过滤文件、记住 --resync 的初始化顺序，或交互式运行 rclone config。

该页面的功能

| 区域 | 用途 |
| 当前状态 | rclone 是否已安装、解析出的本地目录和工作目录、生成的规则文件、上次运行情况，以及存在多少个冲突副本 |
| 同步目标 | 从 rclone listremotes 中选择的云远程，加上子路径，组合为 remote:subpath |
| 同步范围 | 针对各机器之间传输内容的逐项开关、额外排除规则、比较模式、冲突处理、删除上限 |
| 配置云存储 | 非交互式创建 WebDAV 远程，并带有坚果云（Nutstore）预设 |
| 操作 | 预览更改（--dry-run）、立即同步、首次初始化（--resync） |
| 运行输出 | 完整的 rclone 输出，同时追加到 logs/ui-.log |
| 冲突副本 | 留下的每个 .conflictN 文件，以便手动合并 |

安装

该插件是一个普通的 DSH bundle。在磁盘上的任意位置编写或解压它，然后将其安装到某个 profile 中：

plugin_manager install_bundle target:

安装会将该目录链接到 profile 中并启用该 bundle。之后请重启 dsh web 服务器：Cordis 加载器会缓存它为某个条目解析出的模块路径，因此被替换或移动的插件会继续运行上一代 JavaScript 模块，直到进程重启。更改目录或行 id 并不能绕过该缓存。

配置

设置位于 /settings.json，由页面写入。它们是一个普通的 JSON 文档：

{
"version": 1,
"target": "nutstore:dsh",
"sync": {
"sessions": true,
"attachments": true,
"profiles": true,
"homeConfig": true,
"credentials": false,
"workspaceState": false,
"providerCache": false,
"pluginModules": false
},
"extraExcludes": [],
"compare": "size,modtime",
"conflictResolve": "none",
"maxDelete": 10
}

加载器行的 config 会预置两个路径，在找到设置文件之前必须先知道它们：

- id: dsh-sync
name: '@local/dsh-sync'
config:
localRoot: /home/me/.dsh # default: $DSH_HOME, then ~/.dsh
workDir: /home/me/.dsh-sync # default: ~/.dsh-sync

为什么设置不是 Config schema 在配置文件之外安装的 bundle 无法解析 @deepseek-ai/schemastery，因此无法导出 harness 所期望的经过验证的 Config schema。设置文件取代了它，而页面就是编辑界面。从配置文件内部安装此 bundle 的部署可以切换到由 schema 支持的 Config，而无需更改路由契约。

同步范围

每个切片映射到当该切片被禁用时发出的 rclone 过滤规则：

| 键 | 内容 | 默认值 |
| sessions | sessions/ — 每个会话一个仅追加日志 | 开启 |
| attachments | attachments/ — 会话引用的图片和文件 | 开启 |
| profiles | profiles/ — bundle、补丁层、锁文件 | 开启 |
| homeConfig | 主目录根下的 cordis.patch.yml、AGENTS.md | 开启 |
| credentials | .credentials.yaml、.env — 明文 API 密钥 | 关闭 |
| workspaceState | storages/ — 侧边栏分组和派生缓存 | 关闭 |
| providerCache | llm-deepseek/ — 会过期的供应商上传记录 | 关闭 |
| pluginModules | node_modules/ — 平台特定的二进制文件和绝对链接 | 关闭 |

/.anonymous-user-id、session.lock 和 .tmp 始终被排除。

规则文件是生成的；手动编辑它没有任何效果，因为下一次状态读取会根据设置重写它。更改设置还会使 bisync 记住的过滤哈希失效，这就是页面在每次运行前重新生成它的原因。

Nutstore（坚果云）和其他 WebDAV 服务器

页面通过 rclone obscure 后接 rclone config create 来创建远程，因此永远不需要交互式的 rclone config 流程。

对于 Nutstore：URL 为 https://dav.jianguoyun.com/dav/，供应商为 other，并使用在账户信息 → 安全选项 → 添加应用密码下生成的应用密码。登录密码无法通过 WebDAV 使用。

纯 WebDAV 的两个特性对 bisync 很重要：

- 修改时间。 rclone 仅为 Fastmail Files、ownCloud 和 Nextcloud 报告修改时间。在纯 WebDAV 服务器上，远程副本的修改时间是上传时间，这可能会让 bisync 看到虚假的更改。从默认的 size,modtime 开始；如果预览在原本空闲的目录树上列出了大量更改，请将更改比较切换为 size。
- 哈希。 纯 WebDAV 不报告任何哈希，因此校验和比较需要下载每个文件。它被有意不提供为比较模式。

密码作为进程参数传递给 rclone obscure，因此它会短暂地出现在本地进程列表中。它永远不会写入设置文件或日志，并且混淆后的值会从返回给浏览器的所有内容中隐去。

播种顺序

--resync 使两侧都成为超集：仅存在于一侧的文件始终会保留。只有同时存在于两侧且内容不同的文件才需要选出胜者，由 resync 模式决定。
1. 在保存最完整状态的机器上，以胜出方 path1（本地胜出）运行 首次播种。远端为空，因此不会丢失任何内容。
2. 在其他每台机器上，以胜出方 path2（远端胜出）运行 首次播种。该机器上独有的会话会被上传，其同名配置文件会被云端副本替换——这正是“保持各机器一致”的含义。
3. 之后使用 立即同步。--resync 仅用于首次配对、规则文件变更或从失败运行中恢复；日常使用它会让已删除的文件重新出现。

先用 预览变更 预览每次播种。

操作约束

- 不要在两台机器上继续同一个会话。 会话日志是仅追加的；两个写入方会产生分歧，同步只能留下一个冲突副本。
- 保持各机器上的项目路径一致。 会话头会记录其创建时的绝对 cwd，侧边栏按该路径对会话分组。复制到没有该路径的机器上的会话，会被归组到一个在该机器上不存在的工作区路径下。
- 主机侧编辑需要重启服务器——参见安装。

路由

这四个都是 /api/ 下的精确 Fetch 路由，因此 Connection 会应用其 Host/Origin 检查以及浏览器身份验证。浏览器以文档相对方式访问它们，不带前导斜杠。

| 路由 | 方法 | 请求体 | 返回 |
| /api/dsh-sync.state | GET | — | 设置、同步范围目录、rclone 状态、上次运行、冲突 |
| /api/dsh-sync.settings | POST | 部分设置 | { ok, settings } |
| /api/dsh-sync.remote | POST | { name, url, user, pass, vendor } | { ok, remote, output } |
| /api/dsh-sync.run | POST | { action, target, resyncMode } | { ok, exitCode, output } |

action 为 preview、sync 或 seed。

开发

没有构建步骤：Host 部分是纯 ESM，Client 部分是纯 JavaScript 的模块加载器工厂。

node --check index.js && node --check client.js # 语法
npm test # 下面的两个测试套件

test/host-routes.mjs 构建一个桩 Context，其 connection.fetch.register 会记录路由，用重定向到临时目录的两个路径调用 apply(ctx, { localRoot, workDir })，然后用真实的 Request 调用每个路由并断言结果。它从不接触真实的 DSH 主目录。

test/dictionaries.mjs 读取 client.js，检查两个字典定义了相同的键、每个 t('...') 调用都能解析，以及间接引用的 ITEM_TEXT 键存在。

两个测试套件都不需要运行中的服务器或已安装的 rclone：依赖 rclone 的断言覆盖的是在任何进程被启动之前触发的防护。

许可证

MIT——参见 LICENSE。