前言¶
在多台机器上使用 DeepSeek Harness 时，界面偏好、默认模型和部分 DeepSeek 参数往往要重复设置；换机或重装后还要对照旧环境逐项恢复。把配置丢进网盘手工拷贝，既难区分「当前生效的配置」和「历史快照」，API Key 等敏感项也不适合明文散落。社区插件 DSH Sync（jeweis/dsh-sync）面向 DeepSeek Harness 0.2.1-rc.2，通过自建的 WebDAV 存储做跨设备同步、自动备份，并在需要时预览与离线恢复历史配置。目前仅支持 WebDAV，README 中写明暂不支持 S3、GitHub 存储。
这是什么¶
DSH Sync 由维护者 jeweis 发布，在 SkillHub 社区目录中归类为「联网工具」。插件在 Harness 内提供「同步与备份」设置页：连接 WebDAV、选择同步内容、开启自动备份、查看备份记录与恢复预览。跨设备同步、API Key 同步和自动备份安装后均需自行开启；日常操作无需编辑 YAML，也无需先跑终端命令（凭据扩展接入、回退与完整恢复需按页面指引离线确认）。
核心功能¶
跨设备同步¶
在 连接存储 中填写相同的 WebDAV 文件夹地址，在 同步到其他设备 中开启自动同步，并在 选择同步内容 里勾选需要的项目后保存。两台设备在「同步状态」中使用相同、且与 WebDAV 密码不同的 同步口令（12–1024 个字符），通过 解锁并检查更新 完成首次对齐：首台设备可用 使用本机设置开始同步，新设备可用 接收云端设置，也可逐项比较差异。
默认约每 3 分钟核对一次，也可 立即同步。两端同时改同一项时会提示选择，不会简单以最后上传覆盖。README 列出的同步范围包括：主题、字体、字号和界面语言；默认模型及部分 DeepSeek 参数（支持字段可自动同步并在线生效）；供应商 API Key（需单独开启，仅加密同步）；插件清单（显示差异，需在 Harness 中手动安装或移除）。会话、附件、OAuth 登录状态、MCP/技能文件和第三方插件配置不在当前同步范围内。同步作用于当前运行的配置（如 web 或 desktop），与备份所选配置独立；不同用途可用「更多同步设置」中的 同步分组（通常保留 default）区分。
API Key 加密同步¶
默认关闭。开启 同时同步 API Key 后，支持 DeepSeek 与 pi-ai 中已绑定的 Key；两端需已有对应供应商配置。受支持的 Key 记录可双向同步；引用型 Key（如环境变量 DEEPSEEK_API_KEY）默认只加密上传，接收端需在 Harness 手动配置，或在 更多同步设置 → API Key 自动接收设置 中预览接入。高级接入需按文档停止相关 Harness 进程并在终端确认；日常同步与备份无需退出应用。
历史备份与恢复¶
在 备份与恢复 中可 立即备份，输入加密口令后开始；可开启配置变更后的自动备份（默认稳定 30 秒后备份，两次尝试至少间隔 5 分钟），默认保留本设备最近 30 份快照。备份含插件依赖清单、profile 配置补丁及存在的锁文件，不含凭据文件、会话、附件或 node_modules。加密默认开启；明文备份会使配置内直接填写的秘密值一并明文保存。
新设备连接同一 WebDAV 后，在 恢复备份 中预览、核对多份配置（若有），通过 生成离线恢复步骤 与 复制恢复命令，在退出全部使用该配置位置的 Harness 进程后于终端执行一条命令完成恢复；恢复前会保留加密回退副本。备份恢复不包含聊天记录或凭据文件；API Key 仍通过独立的加密同步功能接收。需逐文件原样还原时，可在向导中展开 高级：原样还原配置文件。
安装与启用¶
在 DeepSeek Harness 中打开 插件管理 → 添加插件，在输入框中填写以下任意一种后点击 安装：
npm 包名（推荐）：
@jeweis/dsh-sync
GitHub 仓库地址：
https://github.com/jeweis/dsh-sync
安装完成后，在 已安装插件 中为 同步与备份 打开启用开关。npm 安装使用所选安装源；新包若在镜像找不到可切换 npm 官方源。GitHub 安装需能访问 GitHub，并按 Harness 提示授权源码构建。
使用入口：更多 → 设置 → 同步与备份。页面分为 连接存储、同步到其他设备、备份与恢复 三个页签；超时、检查间隔等放在各部分的「更多设置」，通常不必改动。
典型用法：两台设备对齐配置¶
- 两台设备分别安装并启用插件。
- 在 连接存储 填写相同的 WebDAV 文件夹地址，开启 同步到其他设备 → 开启自动同步。
- 在 选择同步内容 勾选需要的项，点击 保存设置；两台设备的 同步分组 保持一致（通常
default）。 - 输入相同 同步口令，点击 解锁并检查更新，按首次连接指引选择 使用本机设置开始同步 或 接收云端设置。
- 若需同步 API Key，在两台设备分别开启 同时同步 API Key；引用型 Key 按 README 或 API Key 自动接收指南 处理。
适用场景与注意¶
适合已在自有或可信任的 WebDAV（NAS、网盘 WebDAV 等）上存放数据、需要在笔记本与台式机或多套 Harness 配置 profile 之间保持一致的用户。设备同步要求 WebDAV 支持强 ETag 和条件写；不支持时仍可使用普通备份。连接可用 HTTP 或 HTTPS；HTTP 会在链路上暴露 WebDAV 用户名和密码，优先 HTTPS。测试连接成功只代表目录可读，备份还需写入与建子目录权限；请填写对外共享路径，勿直接用 NAS 内部磁盘路径。
插件随当前 DeepSeek Harness 进程运行，读写配置与调用 WebDAV 均在该进程权限下完成。安装前建议在 GitHub 仓库 查看源码与 MIT 许可证（package.json 中版本为 0.11.0，engines.dsh 为 0.2.1-rc.2）。加密口令需自行保管，丢失无法解密备份；关闭设置页后，Harness 仍在运行时会继续同步，退出应用后停止，且不会创建系统登录启动项。
结尾¶
DSH Sync 把 Harness 常用配置、可选的加密 API Key 同步，以及带保留策略的 WebDAV 备份收进同一套图形流程，换机时再通过离线恢复命令降低误改风险。更多细节见仓库内 双设备同步、自动备份 等文档；问题可提交 GitHub Issues。
