在多设备环境下使用 DeepSeek Harness（DSH）时，会话进度、界面设置以及工作区里的项目文件往往难以在换机时无缝衔接。dsh-chatsync 插件解决了这个问题，它通过用户的 GitHub 私有仓库来存储这些状态，实现跨设备的同步。
这是一个记忆类插件，由 dpskk2 维护，开源协议为 MIT。它的核心价值在于将 DSH 的运行时状态（包括会话、附件、设置和项目文件）纳入版本控制，而不是仅仅保存在本地。
核心功能¶
该插件提供以下能力：
* 全量状态同步：同步会话、附件、模型与界面设置，以及工作区里的项目文件。
* 私有仓库存储：所有数据存储在用户自己的 GitHub 私有仓库中，而非公共云端服务。
安装与启用¶
在安装之前，请确保环境满足以下条件：
* DSH 版本不低于 0.1.5-rc.3
* 已安装 Git
* 已安装并配置 GitHub CLI
安装插件¶
在终端中执行以下命令安装插件（以 Web 端为例）：
dsh plugin --profile web add @dpskk2/dsh-chatsync
登录 GitHub¶
安装完成后，需要使用 GitHub CLI 进行授权：
gh auth login --hostname github.com --git-protocol https --web
按提示完成浏览器授权，并在询问是否让 Git 使用此账号时选择 Yes。
配置与使用¶
安装并登录后，重启 DSH，打开 设置 → 同步 进行配置。
第一步：连接同步仓库¶
- 第一次使用：仓库地址留空，保持「地址留空时自动创建或复用私有仓库」勾选，分支保留
main。同步时会尝试创建或复用账号下的dsh-sync私有仓库。 - 已有仓库：填写原电脑显示的仓库地址和分支。
点击 保存连接，继续第 2 步。
第二步：选择同步内容和方式¶
默认同步会话、附件、设置和工作区里的项目文件。如果只需要会话与设置，可以关闭 同步工作区文件。
首次使用建议保留 手动同步，点击 保存选择，继续第 3 步。
第三步：在原电脑开始同步¶
点击 立即同步，取回远端数据并上传本机改动。传输完成前保持 DSH 打开。确认设置页显示同步已完成且无失败。
第四步：在新电脑取回并验证¶
在新电脑上完成安装与 GitHub 登录后，重新启动 DSH，在设置页填写原电脑的仓库地址和分支，保存连接及同步内容选择。
点击 立即同步，确认原电脑的会话和选定的项目文件已出现。在换机后，仍需在本地配置模型 API 密钥、安装其他插件和项目依赖。
日常使用与注意事项¶
- 操作习惯：建议在开工前同步，收工后同步，确认成功后再换电脑。
- 自动同步：双向验证通过后，可在设置中开启自动同步（默认每 5 分钟同步一次）。
- 重要提醒：
- 新电脑配置：新电脑必须单独配置 API 密钥、插件和项目依赖，插件本身不会自动迁移这些本地环境配置。
- 数据备份：虽然插件会传播删除和修改，重要资料请另留备份。
- 敏感信息：专用凭据文件不会上传，但聊天、附件或项目文件中的密钥仍可能被同步，必要时需设置排除规则。
