前言¶
DeepSeek Harness (DSH) 遵循“一切皆插件”的生态理念。在多台机器上协同开发智能体时，同步技能、会话、设置和插件清单容易导致数据不一致。weibaohui/dsh-sync 旨在解决多机环境下的数据同步与冲突问题，提供一套完整的备份与恢复方案。
插件介绍¶
名称：weibaohui/dsh-sync
核心功能：会话同步与冲突解决（apiproxy、token 内联）
维护者：weibaohui
类别：记忆
许可证：MIT
Stars：7
该插件支持多机同步与多协议备份，涵盖 Git、WebDAV 和本地文件夹。它允许同步四类内容：技能、会话、设置和插件清单。插件内置 AI 智能对齐与冲突解决机制，并提供本地优先快照与云端恢复功能，同时具备私有仓库校验与 Token 隔离的安全机制。
核心功能¶
多协议备份¶
插件提供三种备份协议，每个协议对应一个页签和一个开关：
- Git 仓库（默认开启）：支持完整的分支 → PR → 合并流程，显式冲突，支持 AI 语义合并。
- WebDAV（默认关闭）：兼容坚果云、Nextcloud、Alist 等标准 WebDAV 服务。基于 SHA1 清单增量上传，只传变化文件。
- 本地文件夹（默认关闭）：支持
~等路径。每次同步整目录原子镜像，中断不留半截备份。
四类内容同步¶
每类内容可独立开关并配置策略：
- 技能：默认开启，策略=并集。新增都收，双方改动交 AI 语义合并。
- 会话：默认关闭，策略=备份。写入
backup/<实例ID>/，各机云上独立，本地永不被覆盖。 - 设置：默认开启，策略=备份。
- 插件清单：默认开启，策略=备份。
AI 智能对齐与冲突解决¶
- 智能对齐：点「AI 智能对齐」，先自动回填远端新增，再由 AI 对两边都改过的文件做语义合并，合并后自动推送。
- 解决冲突：出现冲突时设置页出现「AI 解决冲突」按钮，点击后由系统自动推送与 PR 合并。
快照与恢复¶
- 本地优先快照：默认只落本机（
~/.dsh/dsh-sync/snapshots/），滚动保留 30 份。 - 通用上云：勾选「上传到云端」才写入所有已启用的云端协议。
- 恢复：本地直接恢复；本地没有的按 Git → WebDAV → 本地文件夹 依次回退。
安全机制¶
- 私有仓库校验：支持 GitCode（默认）、GitHub、GitLab、Gitee 四个托管方。保存时判定公共仓库一律拒绝保存。
- Token 隔离：AI 提示词不含任何访问令牌，凭据只写不回读，通过环境变量注入。
安装与启用¶
使用官方命令安装插件：
dsh plugin --profile web add @weibaohui/dsh-sync -w
安装完成后重启 dsh web 即可生效。
典型用法¶
- 创建私有 Git 仓库：在 GitCode（默认）、GitHub、GitLab 或 Gitee 创建一个私有仓库。
- 配置托管方：打开 Web UI → 设置页 → dsh-sync → Git 页签，点选托管方，填入仓库地址与 access token。
- 切换托管方：支持 GitCode、GitHub、GitLab、Gitee 四个托管方。
- 使用 AI 对齐：日常修改后，点「AI 智能对齐」进行语义合并。
- 浏览与恢复：出现冲突时点击「AI 解决冲突」。需从远端恢复文件时，点「浏览远端」→ 勾选文件 → 「预览拉取」→ 「应用」。
注意事项¶
- 机密泄露风险：
settings.yaml等含机密时可能进入 AI 上下文（语义合并功能固有性质）。介意者请设置conflictMode=manual或关闭对应同步开关。 - Windows 路径问题：Windows 下 Git Bash 路径转换问题，需注意环境变量配置。
- 设置持久化：设置持久化依赖宿主文档或自持文件（
~/.dsh/dsh-sync/settings.）。 - 自建/未知主机：无法校验仓库私有性，保存前需用户手动确认风险。
总结¶
weibaohui/dsh-sync 专注于解决 DSH 多机开发中的数据一致性问题。通过多协议备份、AI 辅助合并和安全的快照机制，它提供了一个可靠的同步方案。
