chatsync 能做什么

接着做的事	同步内容
接着聊	会话记录、聊天附件，以及会话与「工作区」的对应关系
接着做	项目文件夹中的文档、代码等文件
少配一遍	模型、界面设置；密钥、代理和本机路径各机保留；可选同步全局 AGENTS.md 与技能

安装方式

先准备能正常打开的 DSH、Git 和 GitHub CLI，以及可访问 GitHub 的网络。

未手动指定代理时，同步优先使用环境变量，否则跟随当前 Windows 系统代理；更换系统代理端口无需重启。已保存的固定代理可以改为空或 auto，详见代理配置。

推荐：在 DSH 中安装。 打开「插件」→「添加插件」，输入 chatsync。

也可使用 PowerShell 安装：

Web 端：

dsh plugin --profile web add chatsync

Windows 桌面端：

以下命令适用于默认安装位置，自定义安装时请调整路径。

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" 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

第一次设置

安装后重启 DSH，点击侧边栏「同步」，也可从「设置 → 同步」进入。

① 登录 GitHub

在 PowerShell 中执行，按提示在浏览器完成授权：

gh auth login --hostname github.com --git-protocol https --web

② 同步仓库 — 点击「使用默认仓库并继续」。首次同步时自动创建或复用 dsh-sync 私有仓库；使用已有仓库则点击「使用其他仓库」。

③ 选择内容 — 按需勾选，修改即时保存。首次连接先手动使用，之后可开启自动同步。完整同步范围与排除规则

④ 首次同步 — 点击「立即同步」，等待完成。确认上传成功后再换电脑；只生成本地快照不代表已经上传。

换台电脑接着使用

1. 原电脑同步成功后，在新电脑安装插件并登录同一 GitHub 账号。
2. 打开「同步」，使用默认仓库；自定义仓库时，两台电脑使用相同仓库与分支。
3. 同步取回后，检查会话、附件和项目文件，配置本机模型 API 密钥。界面提示需要重启时，完全退出后重新打开。

其他插件和项目依赖需另装；项目目录不同可在同步设置中调整本机保存位置。详细指南

日常使用

点击侧边栏「同步」→「立即同步」。

开启自动同步后，会在启动和正常退出时运行。

启动同步期间可正常新建会话、工作区和编辑草稿。旧会话若提示等待，请在核对完成后再次发送；文字与附件会保留。

冲突与修复

• 查看冲突内容： 选择文件，点击「查看内容」。会话默认按用户与助手消息阅读，设置和会话列表信息按字段显示；需要排查时可切换「查看原始记录」。项目文件可选择版本恢复，会话分叉可另存为独立会话。
• 会话与数据修复： 在同步页打开处理页面，查看检查结果、预览方案并确认；需要退出 DSH 的修复会明确提示，原件和备份会保留。
• 分组检查： 会话分组异常时，可在同步页查看检查结果与处理方案。

冲突与恢复 · 历史数据修复与会话分支

数据与隐私

聊天、附件或项目文件中写入的密钥等敏感信息需自行处理，可用排除规则控制同步范围。本机凭据、锁、缓存及运行状态不参与传输。

会话分叉会保留为独立版本。远端删除不会直接删除本机会话。重要资料请另留备份。同步与恢复边界

同步仓库与本机存储（实验性）： 点「检查」后，每行以「明细」打开详情。首次同步只取当前快照；旧 Git 历史保留在 GitHub，不再自动下载整段历史。本机把当前同步副本、必要的恢复原件、旧版本遗留分开显示；清除历史时旧内容留在 GitHub 归档分支，不生成完整本机备份。同步范围 · 本机存储

上次同步详情中的「本机同步副本（含历史）」统计本机 Git 对象的占用，不代表本次传输量或新电脑下载量。清除历史会回收当前同步副本中已归档的旧历史；本机独有分支继续保留。早先版本清除历史后留在本机的同步前备份会显示为「本机另存旧历史」，GitHub 仍保有时可在同步仓库明细中「回收本机空间」。历史检查复用已缓存的设备回执，最多等待 2 分钟，失败时说明具体阶段。

已核对且旧会话已归档的迁移原件可手动清理；旧仓库中尚未被当前副本覆盖的提交（含 reflog 历史）仍受保护。

兼容性

支持 DSH 的 Web 和 Windows 桌面端，最低 0.2.0-rc.1；桌面端推荐 0.2.1-rc.3 或更新版。独立运行要求 Node.js 24 或更新版，桌面端使用应用自带运行时。

具体已验证与未覆盖范围见本版验证记录。

帮助与开发

安装与使用 · 配置与恢复 · 同步范围 · 文件说明 · 提交问题

开发需要 Node.js 24 和 Git，原生 ESM，无运行时 npm 依赖：

npm test
npm pack --dry-run

开发约定 · 更新日志 · MIT License