chatsync 接着聊
换台电脑，继续做。
把 DeepSeek Harness（DSH）的会话、附件、设置和项目文件带到另一台电脑。
数据存放在你自己的 私有 Git 仓库中：默认 GitHub，也可以用 Gitee、GitLab 等。
chatsync 能做什么
| 接着做的事 | 同步内容 |
|---|---|
| 接着聊 | 会话记录、聊天附件，以及会话与「工作区」的对应关系 |
| 接着做 | 项目文件夹中的文档、代码等文件 |
| 少配一遍 | 模型、界面设置；密钥、代理和本机路径各机保留；可选同步全局 AGENTS.md 与技能 |
安装方式
先准备能正常打开的 DSH 和 Git。同步仓库放在 GitHub（默认）时，还需要 GitHub CLI 和可访问 GitHub 的网络；放在 Gitee、GitLab 等其他托管站时不需要 GitHub CLI，见其他 Git 托管站。
未手动指定代理时，同步优先使用环境变量，否则跟随当前 Windows 或 macOS 系统代理；更换系统代理端口无需重启。已保存的固定代理可以改为空或 auto，详见代理配置。
推荐：在 DSH 中安装。 打开「插件」→「添加插件」，输入 chatsync。
也可使用命令行安装（Windows 用 PowerShell，macOS 用“终端”）：
Web 端：
dsh plugin --profile web add chatsync
Windows 桌面端：
以下命令适用于默认安装位置，自定义安装时请调整路径。
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add chatsync
macOS 桌面端：
以下命令适用于安装在「应用程序」文件夹的情况，其他位置请调整路径。
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add chatsync
旧包名 @dpskk2/dsh-chatsync 继续提供同版本，原有安装可沿用，无需重复安装两个包名。
也可从 GitHub Release 下载安装包，按本地包安装指南操作。
更新方式
如果原先安装的是 @dpskk2/dsh-chatsync，把命令中的 chatsync 换成原包名。 插件更新提醒可关闭，不会自动安装更新。
Web 端：
dsh plugin --profile web update chatsync
Windows 桌面端：
以下命令适用于默认安装位置，自定义安装时请调整路径。
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop update chatsync
macOS 桌面端：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop update chatsync
第一次设置
安装后重启 DSH，点击侧边栏「同步」，也可从「设置 → 同步」进入。
① 登录托管站
使用默认仓库（GitHub）时，在 PowerShell 中执行，按提示在浏览器完成授权：
gh auth login --hostname github.com --git-protocol https --web
使用 Gitee、GitLab 等其他托管站时，先在网页创建空的私有仓库（不要勾选用 README 初始化），再运行一次下面的命令（换成你的仓库地址），在弹出的 Git 登录窗口输入该站的账号和密码或访问令牌；SSH 地址则先配置 SSH 密钥。
git ls-remote https://gitee.com/用户名/dsh-sync.git
② 同步仓库 — 点击「使用默认仓库并继续」。首次同步时自动创建或复用 dsh-sync 私有仓库；使用已有仓库则点击「使用其他仓库」，填写 GitHub、Gitee、GitLab 等托管站的私有仓库地址（HTTPS 或 SSH）。
③ 选择内容 — 按需勾选，修改即时保存。首次连接先手动使用，之后可开启自动同步。完整同步范围与排除规则
④ 首次同步 — 点击「立即同步」，等待完成。确认上传成功后再换电脑；只生成本地快照不代表已经上传。
换台电脑接着使用
- 原电脑同步成功后，在新电脑安装插件，并按「第一次设置」登录同一托管站账号。
- 打开「同步」，使用默认仓库；自定义仓库时，两台电脑使用相同仓库与分支。
- 同步取回后，检查会话、附件和项目文件，配置本机模型 API 密钥。界面提示需要重启时，完全退出后重新打开。
其他插件和项目依赖需另装；项目目录不同可在同步设置中调整本机保存位置。在 Windows 与 macOS 之间共用仓库时，macOS 打不开 Windows 上建的会话（工作目录是 Windows 路径），这类会话不导入、远端保留，不影响其他内容同步。macOS 上建的会话可以导入 Windows 查看，继续对话前需要按提示换到本机项目。macOS 桌面端不支持自动重启，需要刷新会话列表时会提示手动退出再打开。详细指南
日常使用
点击侧边栏「同步」→「立即同步」。
开启自动同步后，会在启动和正常退出时运行。
启动同步期间可正常新建会话、工作区和编辑草稿。旧会话若提示等待，请在核对完成后再次发送；文字与附件会保留。
冲突与修复
- 查看冲突内容： 选择文件，点击「查看内容」。会话默认按用户与助手消息阅读，设置和会话列表信息按字段显示；需要排查时可切换「查看原始记录」。项目文件可选择版本恢复，会话分叉可另存为独立会话。
- 会话与数据修复： 在同步页打开处理页面，查看检查结果、预览方案并确认；需要退出 DSH 的修复会明确提示，原件和备份会保留。
- 分组检查： 会话分组异常时，可在同步页查看检查结果与处理方案。
数据与隐私
聊天、附件或项目文件中写入的密钥等敏感信息需自行处理，可用排除规则控制同步范围。本机凭据、锁、缓存及运行状态不参与传输。
会话分叉会保留为独立版本。远端删除不会直接删除本机会话。重要资料请另留备份。同步与恢复边界
同步仓库与本机存储（实验性）： 点「检查」后，每行以「明细」打开详情。首次同步只取当前快照；旧 Git 历史保留在同步仓库，不再自动下载整段历史。本机把当前同步副本、必要的恢复原件、旧版本遗留分开显示；清除历史时旧内容留在同步仓库的归档分支，不生成完整本机备份。同步范围 · 本机存储
上次同步详情中的「本机同步副本（含历史）」统计本机 Git 对象的占用，不代表本次传输量或新电脑下载量。清除历史会回收当前同步副本中已归档的旧历史；本机独有分支继续保留。早先版本清除历史后留在本机的同步前备份会显示为「本机另存旧历史」，同步仓库仍保有时可在同步仓库明细中「回收本机空间」。历史检查复用已缓存的设备回执，最多等待 2 分钟，失败时说明具体阶段。
已核对且旧会话已归档的迁移原件可手动清理；旧仓库中尚未被当前副本覆盖的提交（含 reflog 历史）仍受保护。
兼容性
支持 DSH 的 Web 和 Windows、macOS 桌面端，最低 0.2.0-rc.1（macOS 没有真机验收记录，会话日志格式和设置已按 DSH 0.2.2-rc.1 的官方源码核对，见文件说明）；桌面端推荐 0.2.1-rc.3 或更新版。独立运行要求 Node.js 24 或更新版，桌面端使用应用自带运行时。
具体已验证与未覆盖范围见本版验证记录。
帮助与开发
安装与使用 · 配置与恢复 · 同步范围 · 文件说明 · 提交问题
开发需要 Node.js 24 和 Git，原生 ESM，无运行时 npm 依赖：
npm test
npm pack --dry-run
开发约定 · 更新日志 · MIT License