dsh-chatsync

chatsync 接着聊

换台电脑，继续做。

把 DeepSeek Harness（DSH）的会话、附件、设置和项目文件带到另一台电脑。

数据存放在你自己的 私有 Git 仓库中：默认 GitHub，也可以用 Gitee、GitLab 等。

[安装方式](#安装方式) · [更新方式](#更新方式) · [首次设置](#第一次设置) · [换台电脑](#换台电脑接着使用) · [详细指南](docs/getting-started.md) · [发布与下载](https://github.com/dpskk2/dsh-chatsync/releases/latest) · [English](README.en.md)

chatsync 能做什么

| 接着做的事 | 同步内容 |

| --- | --- |

| 接着聊 | 会话记录、聊天附件，以及会话与「工作区」的对应关系 |

| 接着做 | 项目文件夹中的文档、代码等文件 |

| 少配一遍 | 模型、界面设置；密钥、代理和本机路径各机保留；可选同步全局 AGENTS.md 与技能 |

安装方式

先准备能正常打开的 DSH 和 [Git](https://git-scm.com/downloads/)。同步仓库放在 GitHub（默认）时，还需要 [GitHub CLI](https://cli.github.com/) 和可访问 GitHub 的网络；放在 Gitee、GitLab 等其他托管站时不需要 GitHub CLI，见[其他 Git 托管站](docs/configuration.md#其他-git-托管站)。

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

推荐：在 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](https://github.com/dpskk2/dsh-chatsync/releases/latest) 下载安装包，按[本地包安装指南](docs/getting-started.md#1-安装本地包)操作。

更新方式

如果原先安装的是 @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）。

③ 选择内容 — 按需勾选，修改即时保存。首次连接先手动使用，之后可开启自动同步。[完整同步范围与排除规则](docs/sync-content.md)