dsh-sync-plugin

不止把聊天记录搬过去

台式机上讨论到一半的方案、会话里的附件、正在修改的项目文件——换到笔记本，也能继续处理同一份工作。

支持的会话与配置会自动合并；普通文件冲突有明确的本机优先与备份策略，详见合并边界。适合个人多台电脑交替使用，不是多人实时协作工具。

开始使用

准备好 DSH Web、Git 和 GitHub CLI，在运行 DSH 的同一台电脑、同一系统用户下执行：

dsh plugin --profile web add dsh-sync-plugin
gh auth login
gh auth status

登录选择 GitHub.com → HTTPS，然后重启 DSH。

点侧栏左下角「⟳ 同步」即可开始。 未配置仓库时，插件会尝试创建或复用账号下的私有 dsh-sync 仓库，并保存地址。

打开 设置 → 同步，确认仓库地址正确、同步完成、工作区没有失败。显示「本地快照」只代表本机保存成功，还没有传到云端。

默认包含工作区文件。只想同步会话与设置？首次同步前关闭「同步工作区文件」。已有仓库、使用 SSH 或网络需要代理，请看安装与排障指南。

接入第二台电脑

1. 安装 DSH Web、Git、GitHub CLI 和本插件，重启 DSH。
2. 执行 gh auth login 登录同一 GitHub 账号。默认仓库可自动复用；自定义仓库需填写相同的 remote 和 branch。
3. 点「⟳ 同步」，确认成功后重启 DSH，让取回的会话索引与设置完整加载。
4. 配置这台机器的 API 密钥、安装插件和项目依赖。项目路径不同，可在同步结果中使用「换位置」。

试一下： A 新建测试会话 → A 同步 → B 同步 → B 找到会话；再从 B 新建会话同步回 A，完成双向验证。

日常只需记住两件事

开始前同步，结束后同步。 两台电脑交替工作，先把上一台的更改推上去，再从下一台取回来。

想省去手动操作，就打开自动模式。 设置 → 同步 → 同步偏好，选择自动并保存，无需重启。默认每 5 分钟同步，也会响应会话活动。切回手动会停止后续自动调度，正在进行的同步仍会完成。

同步什么，留下什么

排除凭据文件不等于扫描所有秘密：会话、附件或 .env 内的密钥仍可能上传。首次使用请检查同步范围与排除规则。同步会传播删除与错误修改，重要资料仍需独立备份。

兼容性

市场的最低宿主声明用于安装前判断，不代表全部更高版本和操作系统组合都已实测。

遇到问题？先看这里

完整排障 · 配置参考 · 更新记录 · 开发与验证

# 升级后重启 DSH
dsh plugin --profile web update dsh-sync-plugin

如果它帮你省去了换机搬运的麻烦，欢迎给项目一个 Star。遇到卡点，请提交 Issue，附上宿主版本、操作步骤和脱敏错误，帮助下一位用户少走一步弯路。