配置同步 antonbru/dsh-settings-sync

dsh-settings-sync

通过私有 GitHub 仓库同步 DeepSeek Harness 的配置和已安装插件——灵感来自 VS Code Settings Sync。

插件把 ~/.dsh 的「配置面」放进仓库，在另一台机器上再还原：配置档设置、MCP 服务器、插件列表、lock 文件、本地插件、技能和全局指令。

同步哪些内容

| 类别 | 路径（相对 DSH_HOME） |
| 设置与 MCP | profiles/<profile>/cordis.patch.yml、settings.yaml |
| 插件 | profiles/<profile>/package.json、pnpm-lock.yaml、pnpm-workspace.yaml |
| 本地插件 | link:/file: 依赖的源码——放到 <repo>/plugins/<name>/ |
| 技能 | skills/* |
| 指令 | AGENTS.md |
| 其他 | agents/*、pet.json、skin-center-active.json——如果存在 |

永远不同步： .credentials.yaml、.env、sessions/、storages/、cache/、attachments/、dsh-runtimes/、node_modules/、.git、.plugin-manager/。

上传时，家目录的绝对路径会替换成 ${DSH_HOME} 和 ${HOME}；应用时再展开成当前机器的路径。

安装

插件的公开仓库：https://github.com/antonbru/dsh-settings-sync

在 DSH 中（配置档 desktop）：

plugin_manager install_bundle target=github:antonbru/dsh-settings-sync

完整写法：target=https://github.com/antonbru/dsh-settings-sync.git。

本地开发时可以从工作目录安装：

plugin_manager install_bundle target=/Users/antonb_ru/DSH/plugins/dsh-settings-sync

安装完成后：Settings → 同步。

配置仓库是独立的，而且必须私有：里面放着你的 MCP token。插件的公开仓库不含 token。

在第二台机器上：

1. 从公开仓库安装插件（命令见上）；
2. Settings → 同步 → 连接 GitHub → 填写私有配置仓库的 URL；
3. 「获取」→「应用」→ 重启 DSH。

首次配置

1. 在 GitHub 上创建一个私有空仓库（或者在插件页面点「创建」，它会建一个私有仓库）。
2. 连接 GitHub：
- 如果已安装并登录 gh（gh auth login），token 会自动读取；
- 否则粘贴带 repo scope 的 PAT，点「连接 / 校验 token」。
3. 填写仓库 URL、分支，勾选类别，保存。
4. 点「捕获并发送」——产生第一个 commit。
5. 检查「检查密钥」：插件不会剔除 token（配置时就是这么选的），但会显示它们在哪。仓库必须保持私有——推送到公开仓库会被 GitHub API 检查拦截。

GitHub token 只存在本地 ~/.dsh/settings-sync/settings.json（0600），不会进 patch，不会进仓库，也不会出现在 API 响应里。

日常使用

- 「同步」——记录本地改动，拉取远端，有变化就应用，然后发送。
- 「捕获并发送」——只做上传。
- 「获取」——只执行 git pull。
- 「应用并安装插件」——把快照写入 ~/.dsh，恢复本地插件，执行 pnpm install。写入前先做备份；完成后需要重启 DSH。
- 「回滚到上一个备份」和「历史」，支持从提交恢复——应对应用失败的情况。
- 「检查密钥」——按模式出报告（Bearer、ghp_、sk-、token/password = …）。

自动同步

- 「DSH 启动时拉取并应用远程改动」——前提是仓库里出现了新提交。
- 「每 N 分钟捕获一次改动」+「立即推送」——有改动时后台推送。请只在一台「主」机器上保持自动推送开启。

分叉与回滚

如果本地仓库副本和 origin 分叉了，pull 会停下并返回 diverged。页面上会出现「分叉」区块：

- 采用远程——把本地仓库副本重置到 origin/<branch>（在点「应用」之前不动实际文件）；
- 推送本地——git push --force-with-lease。

每次应用前都会在 ~/.dsh/settings-sync/backups/<时间>/ 创建备份。

智能体与命令

- 工具 settings_sync，支持动作 status、push、pull、apply、sync、history、restore、scan。
- 命令 /sync status|push|pull|apply|sync|history|scan。

限制

- 可移植性按 macOS/POSIX 设计；Windows 上用复制代替符号链接，插件源路径必须可写。
- pnpm install 用 DSH_HOME/dsh-runtimes 里的 Node/pnpm 执行；如果没有，就用系统的 node/pnpm。
- 不做逐行冲突合并：整侧选择。
- 会话和聊天历史不同步。

许可证

MIT。基于 dsh-config-sync（MIT，© liangfengqi）；见 LICENSE 和 NOTICE。