# @dpskk2/dsh-chatsync 中文文档 规范地址：https://npmcn.com/package/%40dpskk2/dsh-chatsync/ 版本：0\.21\.2 npm 元数据更新时间：2026-11-06T07:58:31.885Z 中文译文更新时间：2026-11-12T21:47:47.563Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40dpskk2/dsh-chatsync 原文对照：https://npmcn.com/package/%40dpskk2/dsh-chatsync/?lang=original 项目主页：https://github.com/dpskk2/dsh-chatsync#readme 源码仓库：https://github.com/dpskk2/dsh-chatsync ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.2 MB，101 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=24 - 运行依赖：0 个 - peer 依赖：@deepseek-ai/dsh \>=0\.2\.0-rc\.1 - 首次发布：2026-09-27T04:47:34.975Z - 最新版本发布：2026-11-06T07:58:31.553Z - 近 30 天下载量：4610（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：12（近 12 个月 12 个） ## 中文简介 换台电脑，接着聊。同步会话、附件、设置和项目文件。 ## 安装 ```sh npm install @dpskk2/dsh-chatsync ``` 也可以使用：`pnpm add @dpskk2/dsh-chatsync`、`yarn add @dpskk2/dsh-chatsync`、`bun add @dpskk2/dsh-chatsync` ## README # chatsync 接着聊 ### 换台电脑，继续做。 把 DeepSeek Harness（DSH）的会话、附件、设置和项目文件带到另一台电脑。 数据存放在你自己的 **私有 Git 仓库**中：默认 GitHub，也可以用 Gitee、GitLab 等。 [![npm](https://img.shields.io/npm/v/chatsync?color=2563eb)](https://www.npmjs.com/package/chatsync) [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.2.0--rc.1-0f766e)](https://npmcn.com/package/%40dpskk2/dsh-chatsync/#readme-%E5%85%BC%E5%AE%B9%E6%80%A7) [![Desktop](https://img.shields.io/badge/Desktop-%E6%8E%A8%E8%8D%90%200.2.1--rc.5-2563eb)](https://npmcn.com/package/%40dpskk2/dsh-chatsync/#readme-%E5%85%BC%E5%AE%B9%E6%80%A7) [![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A524-43853d)](https://npmcn.com/package/%40dpskk2/dsh-chatsync/#readme-%E5%85%BC%E5%AE%B9%E6%80%A7) [![MIT](https://img.shields.io/badge/license-MIT-slateblue)](https://npmcn.com/package/%40dpskk2/dsh-chatsync/LICENSE) [安装方式](https://npmcn.com/package/%40dpskk2/dsh-chatsync/#readme-%E5%AE%89%E8%A3%85%E6%96%B9%E5%BC%8F) · [更新方式](https://npmcn.com/package/%40dpskk2/dsh-chatsync/#readme-%E6%9B%B4%E6%96%B0%E6%96%B9%E5%BC%8F) · [首次设置](https://npmcn.com/package/%40dpskk2/dsh-chatsync/#readme-%E7%AC%AC%E4%B8%80%E6%AC%A1%E8%AE%BE%E7%BD%AE) · [换台电脑](https://npmcn.com/package/%40dpskk2/dsh-chatsync/#readme-%E6%8D%A2%E5%8F%B0%E7%94%B5%E8%84%91%E6%8E%A5%E7%9D%80%E4%BD%BF%E7%94%A8) · [详细指南](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/getting-started.md) · [发布与下载](https://github.com/dpskk2/dsh-chatsync/releases/latest) · [English](https://npmcn.com/package/%40dpskk2/dsh-chatsync/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 托管站](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/configuration.md#%E5%85%B6%E4%BB%96-git-%E6%89%98%E7%AE%A1%E7%AB%99)。 未手动指定代理时，同步优先使用环境变量，否则跟随当前 Windows 或 macOS 系统代理；更换系统代理端口无需重启。已保存的固定代理可以改为空或 `auto`，详见[代理配置](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/configuration.md)。 **推荐：在 DSH 中安装。** 打开「插件」→「添加插件」，输入 `chatsync`。 也可使用命令行安装（Windows 用 PowerShell，macOS 用“终端”）： **Web 端：** ```powershell dsh plugin --profile web add chatsync ``` **Windows 桌面端：** 以下命令适用于默认安装位置，自定义安装时请调整路径。 ```powershell & "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add chatsync ``` **macOS 桌面端：** 以下命令适用于安装在「应用程序」文件夹的情况，其他位置请调整路径。 ```bash "/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) 下载安装包，按[本地包安装指南](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/getting-started.md#1-%E5%AE%89%E8%A3%85%E6%9C%AC%E5%9C%B0%E5%8C%85)操作。 ## 更新方式 **如果原先安装的是 `@dpskk2/dsh-chatsync`，把命令中的 `chatsync` 换成原包名。** 插件更新提醒可关闭，不会自动安装更新。 **Web 端：** ```powershell dsh plugin --profile web update chatsync ``` **Windows 桌面端：** 以下命令适用于默认安装位置，自定义安装时请调整路径。 ```powershell & "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop update chatsync ``` **macOS 桌面端：** ```bash "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop update chatsync ``` ## 第一次设置 安装后重启 DSH，点击侧边栏「同步」，也可从「设置 → 同步」进入。 **① 登录托管站** 使用默认仓库（GitHub）时，在 PowerShell 中执行，按提示在浏览器完成授权： ```powershell gh auth login --hostname github.com --git-protocol https --web ``` 使用 Gitee、GitLab 等其他托管站时，先在网页创建空的私有仓库（不要勾选用 README 初始化），再运行一次下面的命令（换成你的仓库地址），在弹出的 Git 登录窗口输入该站的账号和密码或访问令牌；SSH 地址则先配置 SSH 密钥。 ```powershell git ls-remote https://gitee.com/用户名/dsh-sync.git ``` **② 同步仓库** — 点击「使用默认仓库并继续」。首次同步时自动创建或复用 `dsh-sync` 私有仓库；使用已有仓库则点击「使用其他仓库」，填写 GitHub、Gitee、GitLab 等托管站的私有仓库地址（HTTPS 或 SSH）。 **③ 选择内容** — 按需勾选，修改即时保存。首次连接先手动使用，之后可开启自动同步。[完整同步范围与排除规则](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/sync-content.md) **④ 首次同步** — 点击「立即同步」，等待完成。确认上传成功后再换电脑；只生成本地快照不代表已经上传。 ## 换台电脑接着使用 1. 原电脑同步成功后，在新电脑安装插件，并按「第一次设置」登录同一托管站账号。 2. 打开「同步」，使用默认仓库；自定义仓库时，两台电脑使用相同仓库与分支。 3. 同步取回后，检查会话、附件和项目文件，配置本机模型 API 密钥。界面提示需要重启时，完全退出后重新打开。 其他插件和项目依赖需另装；项目目录不同可在同步设置中调整本机保存位置。在 Windows 与 macOS 之间共用仓库时，macOS 打不开 Windows 上建的会话（工作目录是 Windows 路径），这类会话不导入、远端保留，不影响其他内容同步。macOS 上建的会话可以导入 Windows 查看，继续对话前需要按提示换到本机项目。macOS 桌面端不支持自动重启，需要刷新会话列表时会提示手动退出再打开。[详细指南](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/getting-started.md#4-%E6%8D%A2%E5%8F%B0%E7%94%B5%E8%84%91%E6%8E%A5%E7%9D%80%E4%BD%BF%E7%94%A8) ## 日常使用 点击侧边栏「同步」→「立即同步」。 开启自动同步后，会在启动和正常退出时运行。 启动同步期间可正常新建会话、工作区和编辑草稿。旧会话若提示等待，请在核对完成后再次发送；文字与附件会保留。 ## 冲突与修复 - **查看冲突内容：** 选择文件，点击「查看内容」。会话默认按用户与助手消息阅读，设置和会话列表信息按字段显示；需要排查时可切换「查看原始记录」。项目文件可选择版本恢复，会话分叉可另存为独立会话。 - **会话与数据修复：** 在同步页打开处理页面，查看检查结果、预览方案并确认；需要退出 DSH 的修复会明确提示，原件和备份会保留。 - **分组检查：** 会话分组异常时，可在同步页查看检查结果与处理方案。 [冲突与恢复](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/configuration.md#%E5%86%B2%E7%AA%81%E5%8E%9F%E4%BB%B6%E4%B8%8E%E9%A1%B9%E7%9B%AE%E6%96%87%E4%BB%B6%E6%81%A2%E5%A4%8D) · [历史数据修复与会话分支](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/data-repair-0.20.1.md) ## 数据与隐私 聊天、附件或项目文件中写入的密钥等敏感信息需自行处理，可用[排除规则](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/sync-content.md)控制同步范围。本机凭据、锁、缓存及运行状态不参与传输。 会话分叉会保留为独立版本。远端删除不会直接删除本机会话。重要资料请另留备份。[同步与恢复边界](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/configuration.md) **同步仓库与本机存储（实验性）：** 点「检查」后，每行以「明细」打开详情。首次同步只取当前快照；旧 Git 历史保留在同步仓库，不再自动下载整段历史。本机把当前同步副本、必要的恢复原件、旧版本遗留分开显示；清除历史时旧内容留在同步仓库的归档分支，不生成完整本机备份。[同步范围](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/sync-content.md#%E5%90%8C%E6%AD%A5%E4%BB%93%E5%BA%93%E4%B8%8E%E6%9C%AC%E6%9C%BA%E5%AD%98%E5%82%A8) · [本机存储](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/local-storage.md) 上次同步详情中的「本机同步副本（含历史）」统计本机 Git 对象的占用，不代表本次传输量或新电脑下载量。清除历史会回收当前同步副本中已归档的旧历史；本机独有分支继续保留。早先版本清除历史后留在本机的同步前备份会显示为「本机另存旧历史」，同步仓库仍保有时可在同步仓库明细中「回收本机空间」。历史检查复用已缓存的设备回执，最多等待 2 分钟，失败时说明具体阶段。 已核对且旧会话已归档的迁移原件可手动清理；旧仓库中尚未被当前副本覆盖的提交（含 reflog 历史）仍受保护。 ## 兼容性 支持 DSH 的 Web 和 Windows、macOS 桌面端，最低 **0.2.0-rc.1**（macOS 没有真机验收记录，会话日志格式和设置已按 DSH 0.2.2-rc.1 的官方源码核对，见[文件说明](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/dsh-file-catalog.md)）；桌面端推荐 **0.2.1-rc.3 或更新版**。独立运行要求 **Node.js 24 或更新版**，桌面端使用应用自带运行时。 具体已验证与未覆盖范围见[本版验证记录](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/release-0.21.2-validation.md)。 ## 帮助与开发 [安装与使用](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/getting-started.md) · [配置与恢复](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/configuration.md) · [同步范围](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/sync-content.md) · [文件说明](https://npmcn.com/package/%40dpskk2/dsh-chatsync/docs/dsh-file-catalog.md) · [提交问题](https://github.com/dpskk2/dsh-chatsync/issues) 开发需要 Node.js 24 和 Git，原生 ESM，无运行时 npm 依赖： ```powershell npm test npm pack --dry-run ``` [开发约定](https://github.com/dpskk2/dsh-chatsync/blob/main/CONTRIBUTING.md) · [更新日志](https://npmcn.com/package/%40dpskk2/dsh-chatsync/CHANGELOG.md) · [MIT License](https://npmcn.com/package/%40dpskk2/dsh-chatsync/LICENSE) ## 常见问题 ### @dpskk2/dsh-chatsync 是什么？ 换台电脑，接着聊。同步会话、附件、设置和项目文件。 ### 如何安装 @dpskk2/dsh-chatsync？ 在项目目录运行 npm install @dpskk2/dsh-chatsync，或使用 pnpm add / yarn add / bun add。 ### @dpskk2/dsh-chatsync 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dpskk2\_\_dsh-chatsync 是否存在。 ### @dpskk2/dsh-chatsync 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @dpskk2/dsh-chatsync 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @dpskk2/dsh-chatsync 可以商用吗？ @dpskk2/dsh-chatsync 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @dpskk2/dsh-chatsync 的下载量有多少？ 根据 npm 官方下载统计，@dpskk2/dsh-chatsync 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,610 次，日均约 154 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @dpskk2/dsh-chatsync 还在维护吗？ 最新版本 0\.21\.2 发布于 2026/11/06（7 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/09/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。