weibaohui/dsh-sync

多机同步插件：让多台机器上的 dsh 通过一个私有 GitCode 仓库保持一致——技能、会话、设置、插件清单都能同步。除 Git 完整同步外，还支持 WebDAV 与 本地文件夹 两种纯备份协议，各协议一个页签一个开关。

核心功能

• 多协议备份，一个协议一个页签一个开关：
  • Git 仓库（默认开）：完整的 分支 → PR → 合并 同步语义，冲突显化、AI 语义合并
  • WebDAV（默认关）：填地址/账号/密码/子目录即可，兼容坚果云、Nextcloud、Alist 等一切标准 WebDAV 服务；每次同步按 sha1 清单增量上传（只传变化的文件、删除同步传播）
  • 本地文件夹（默认关）：填一个目录（支持 ~）即可；每次同步整目录原子镜像（tmp-swap，中断不留半截备份）
  • 未开启的协议只显示开关；开启后出现地址参数配置与「测试连接」
  • 纯备份协议的内容与布局和 git 的备份策略完全一致：backup/<实例ID>/…，本地永不被读回覆盖；单协议失败不影响其他协议
• 四类内容可同步，每类独立开关 + 独立策略：
  • 技能 skills（默认开，策略=并集）：覆盖 ~/.dsh/skills、~/.agents/skills、~/agents/skills 三个根；新增都收、双方改动交 AI 语义合并
  • 会话 sessions（默认关，策略=备份）：写 backup/<实例ID>/，各机云上独立，本地永不被覆盖
  • 设置 settings.yaml（默认开，策略=备份）：机器专属配置不打架，想共享键用「AI 智能对齐」逐键并
  • 插件清单（默认开，策略=备份）：各机 bundle/依赖清单互不覆盖（跨机整文件覆盖曾致宿主 crash loop）
  • 四种策略：备份（各机独立，永不被覆盖）/ 并集（新增都收、逐文件三方、冲突交 AI）/ 覆盖·远端为准（本地只读镜像，远端删本地也删）/ 覆盖·本地为准（只推不拉）
• 快照：本地优先，通用上云，勾选才传
  • 「立即快照」默认只落本机（~/.dsh/dsh-sync/snapshots/，滚动保留 30 份，超窗真删除真释放）；勾选「上传到云端」才写入所有已启用的云端协议（git → backup/<实例ID>/snapshots/，WebDAV / 本地文件夹同布局），永久存档
  • 每天首个同步自动打一份本地快照；范围=设置+插件清单（可选含技能），永远不含会话（体积大头）
  • 一键恢复：本地快照直接恢复；本地没有的按 git → WebDAV → 本地文件夹 依次回退取回；恢复前自动把当前状态再拍一份（pre-restore-*）
• 分支 → PR → 合并：每台机器的变更以 PR 形式提交，冲突显化为一个待合并的 PR，绝不静默覆盖
• 同步前自动回填：每次推送前先把远端新增、本机没动过的内容拉回本机，本机快照不会误删别的机器推上来的新技能/新配置
• AI 智能对齐：点「AI 智能对齐」，先自动回填远端新增，再由 AI 对两边都改过的文件做语义合并（动手前自动备份本机文件），合并后由系统自动推送
• AI 一键解决冲突：出现冲突时设置页冒出「AI 解决冲突」按钮，点击后由系统取回冲突分支与 main 制造冲突工作树，AI 只做本地语义解冲突，推送与 PR 合并由系统自动完成
• 浏览远端备份：点「浏览远端」可查看云端仓库的完整目录树，自动识别 backup/<实例ID>/ 下每台机器的备份并标记本机；在树中勾选文件后「预览拉取」会给出安全判定（哪些可拉、哪些会被阻止及原因），确认后才写入本地——写入前自动拍一份 pre-remote-pull 安全快照
  • 跨机安全提示（不阻止拉取）：另一台机器的 插件清单（本地已有时）和 settings.yaml 跨机拉取时会⚠警告（覆盖机器专属配置可能导致宿主崩溃），但允许用户自行决定是否拉取；技能文件可安全跨机拉取；本机自己的备份无警告（恢复语义）
  • 浏览是只读的：远端 main 拉进独立 ref（refs/dshsync/browse），不触碰 FETCH_HEAD，与同步循环无竞争
• 安全：强制私有仓库（公共仓库直接拒绝保存）；访问 token 只写不回读
• 凭据不出域：AI agent（冲突处理/智能对齐/远端对齐）的提示词不含任何访问令牌——需要凭据的 git 推送、PR 查询/合并全部由插件 host 侧完成，token 不会随提示词发送给模型服务（0.4.1 修复）。git 子进程同样不经 argv 携带 token（argv 可被 ps 全机看到），改为 GIT_ASKPASS 环境变量注入（0.4.1）；conflictMode=manual 时所有 AI 入口（自动触发 + 手动按钮）一律关闭，ai 才放行
• 残余风险提示：「智能对齐」的本质是把待合并文件的内容交给模型做语义判断——若 settings.yaml 等文件内含其他机密（如模型 apiKey），这些值仍会进入模型上下文（这是语义合并功能的固有性质，无法在保留功能的前提下消除）；介意者请把 conflictMode 设为 manual 或关闭对应同步开关
• 拉取安全：pull 只回写本地没动过的远端变更，本地改过的内容不会被覆盖

安装

dsh plugin --profile web add @weibaohui/dsh-sync -w

装完重启 dsh web 即生效。

使用

1. 到 gitcode.com 创建一个私有仓库（插件不会代建）
2. 打开 Web UI → 设置页 → dsh-sync，填入仓库地址与 access token，保存
3. 按需开关四类同步内容
4. 之后每次修改，通过同步操作把本机变更推成 PR；多机之间即可保持一致
5. 日常可点「AI 智能对齐」让 AI 先回填远端新增、语义合并双方改动；出现冲突时设置页会出现「AI 解决冲突」按钮，点一下即可
6. 需要从其他机器恢复个别文件时，点「浏览远端」→ 在远端目录树中找到文件并勾选 → 「预览拉取」确认安全判定 → 「应用」写入本地（自动拍安全快照）

Windows 用户注意（路径转换）

在 Windows 的 Git Bash 里，MSYS2 runtime 会对传给原生 .exe 的参数做 POSIX→Windows 路径转换。 若路径中某个目录名带点（如 C:\Users\x\.dsh\dsh-sync\repo），这个点会被当成路径分隔符， 路径被改写成 C:\Users\x\dsh\dsh-sync\repo（点消失、多出一级），git 于是在不存在的目录里执行并报 fetch failed。

这是 Git for Windows 的既有行为，官方定性为 wontfix（git-for-windows#685）。 本插件自 0.4.2 起做了两层防护：

• host 侧：git 子进程在 Windows 下自动注入 MSYS_NO_PATHCONV=1 与 MSYS2_ARG_CONV_EXCL='*'（仅该子进程，不写全局环境）
• AI 侧：三个 AI 提示词都带 Windows 前置保险——先判定平台，再自检路径是否被改写，每条 git 命令前置开关， 并用 git -C <影子仓库> rev-parse --show-toplevel 确认目录真实可达后才动手；验证失败即停止汇报

⚠️ 请不要把 MSYS_NO_PATHCONV=1 写进 .bashrc 或全局环境——全局设置会影响其它程序， Git for Windows 官方也专门警告过这一点（build-extra#376）。 只在你自己的终端里按"每条命令前置"的方式临时使用即可。

联系我 :飞书群

版本兼容性

本插件与 DeepSeek Harness（@deepseek-ai/dsh）的版本对应关系：

插件版本	适配 dsh 版本	备注
0.4.2	0.1.7-rc.2	修复 issue #10（Windows）：Git Bash 的 POSIX→Windows 路径转换会把目录名里的点拆成路径段（C:\Users\x\.dsh\... → C:\Users\x\dsh\...），git 于是在不存在的目录里执行而报 fetch failed。git 子进程在 win32 下注入 MSYS_NO_PATHCONV=1 + MSYS2_ARG_CONV_EXCL='*'（仅子进程，绝不写全局）；三个 AI 提示词加入 Windows 前置保险（判定平台 → 路径自检 → 每条命令前置开关 → rev-parse --show-toplevel 验证目录可达，失败即停）；离线测试 60 项全绿
0.4.1	0.1.7-rc.2	安全修复（issue #9）：AI agent 提示词不再携带 GitCode 访问令牌（prepare/finalize 收归 host 侧）；git 子进程改经 GIT_ASKPASS env 注入凭证，argv 不再出现 token；conflictMode=manual 现在关闭全部 AI 入口（含手动按钮端点）；离线测试 52 项全绿
0.4.0	0.1.7-rc.2	新增 WebDAV / 本地文件夹备份协议（每协议一页签一开关）、快照多协议通用上云与恢复回退；离线测试 45 项全绿（含伪 WebDAV 服务器 wire 级集成测试）
0.3.5	0.1.7-rc.2	新增 ~/agents/skills（无点目录）技能根，随技能开关与策略一起同步/快照
0.3.2	0.1.7-rc.2	修复宿主将 volatile 字段物化为 {} 导致的设置毒化（saneConfigValues 清洗 + 移除 Config 兼容字符串字段）
0.3.1	0.1.7-rc.2	适配 0.1.7 settings 模型（导出 volatile Config，ctx.settings.update 持久化），面板改动重启不再丢失
0.2.3	0.1.7-rc.2	已在 @deepseek-ai/dsh@0.1.7-rc.2 下验证运行
0.3.0	0.1.7-rc.2	新增远端备份浏览+选择性拉取+AI对齐+文件预览；已在 @deepseek-ai/dsh@0.1.7-rc.2 下验证运行

发版约定：每次发布新版本时，请在上表追加一行，记录该插件版本实际验证所用的 @deepseek-ai/dsh 版本。package.json 的 engines.dsh 声明最低支持版本；本表记录实际验证版本，二者配合使用。