用户配置同步 PandaBlessing/dsh-user-sync

dsh-user-sync

换机器、多台电脑用 DSH，不用再手动拷 ~/.dsh。

DeepSeek Harness（DSH）的用户级配置同步插件：把技能、插件清单、配置、记忆在设备间对齐——新机器装一次、点一下，环境和老机器一致。

30 秒上手

cd ~/.dsh/profiles/desktop
pnpm add @pandablessing/dsh-user-sync
重启 DSH → 设置 → 设置同步 → 同意并启用 → 上传用户配置

换到新机器，同样装一次 → 设置同步 → 从远端同步。

它能解决什么

| 痛点 | 以前 | 现在 |
| 换台电脑，DSH 环境全空 | 手动 scp -r ~/.dsh，漏文件、带错配置 | 点「从远端同步」，覆盖前弹窗确认 |
| 插件装不回来 | 一个个翻 package.json 重新 pnpm add | 按远端清单自动装回，失败项单独列出 |
| 配置改乱了想回滚 | 无备份 | 每次应用前生成 pre-restore 快照 |
| 担心密钥被传走 | —— | 文件名黑名单 + 内容模式扫描，命中直接拒绝打包 |

同步范围（默认四类用户级）： 技能 ~/.agents/skills、插件清单（profile 声明与锁文件）、配置 cordis.patch.yml（含自定义 agent 预设）、用户记忆 AGENTS.md + memories/。

截图

面板截图放在 docs/assets/，欢迎 PR 补充（设置同步面板 / 恢复结果 / 运营监控页）。

和「手动拷 .dsh」/ 其他同类的差别

| | 手动拷 .dsh | 本插件 |
| 跨机恢复 | 整目录搬，容易带错机器专属状态 | 只同步四类用户级资产，会话/项目记忆不参与 |
| 插件 | 手动重装 | 自动装回，失败清单可见 |
| 覆盖安全 | 无确认 | 弹窗确认 + 快照回滚 + 远端新包拦截（E_REMOTE_NEWER） |
| 隐私 | 全量拷贝 | 敏感文件硬拒绝（黑名单 + 内容模式） |
| 登录 | —— | 用官方账号 id 自动派生 key，没有运营方登录入口 |

同类项目还有 dsh-sync 等；本插件侧重「自动装回插件 + 敏感数据硬拒绝 + 可自建服务端」。

安全与数据

- 存储凭据只在运营方服务端，插件包内不含任何存储口令；
- 上传内容经 HTTPS 到运营方 API，再落到坚果云 WebDAV；远端只保留 1 份包，上传即覆盖；
- 想自建：服务端是纯 node:http 零依赖，见 docs/deploy.md，在 state.json 写 baseUrl 即可指向自己的服务。

功能细节

- 四类用户级资产：技能、插件清单、配置（cordis.patch.yml，含自定义 agent 预设）、用户记忆；项目记忆默认不选，会话不参与同步。
- 新覆盖旧：包级 createdAt 比较，不做合并；覆盖前弹窗确认，先快照再写盘。
- 上传前查远端：远端已被别的设备更新时先拦下（E_REMOTE_NEWER），确认后才用本机覆盖。
- 敏感数据硬拒绝：文件名黑名单 + 内容模式，命中即拒绝打包并列出文件与行号。
- 官方账号自动配对：用 deepseekAccount 派生 accountKey 自动换 token，无需运营方登录。
- 缺插件自动装回：应用远端包后按 manifest.dependencies 自动安装，结果列出已装 / 失败 / 需手动放回（link: 依赖）。
- 自动检查：启动 + 每 6 小时（可配）只读远端元数据，发现更新只提示、不自动应用。
- 更新提示：发现 npm 上有新版本时面板顶部给出「更新插件」按钮，完成后弹窗提示重启。

安装

从 npm

cd ~/.dsh/profiles/desktop
pnpm add @pandablessing/dsh-user-sync

profile 的 package.json 与 cordis.patch.yml 里必须使用 npm 包名 @pandablessing/dsh-user-sync；若此前用旧名 dsh-user-sync 装过，先删掉旧条目（junction / dependencies / bundles）再装，否则会重复注册面板。

安装后重启 DSH，在设置页启用「设置同步」。

开发期（junction 到本仓库）

powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install-dev.ps1 # 装进 desktop profile scripts\uninstall-dev.cmd # 回滚

使用

1. 设置 → 设置同步 → 首次点「同意并启用上传」；
2. 勾选同步范围（默认四类用户级）；
3. 「上传用户配置」→ 打包并上传（远端更新时先确认再用本机覆盖）；
4. 「从远端同步」→ 检查远端，覆盖前弹窗确认。

服务地址内置（https://dsh-user-sync-test.wenzhi.info），传输固定走运营方 API；需要自建服务时在 state.json 写 baseUrl 覆盖。

架构

插件（HTTP 客户端） ──HTTPS──▶ 运营方 API ──WebDAV──▶ 坚果云 │ │ └─ 本地 state.json └─ 鉴权 / 配额 / 隔离 / 审计

- 插件侧只实现 api 传输；folder 仅用于本机调试。
- 存储凭据只放在服务端，插件包里不含任何存储口令。
- 身份：官方账号 id → accountKey（sha256 前 16 位）→ 服务端分区。
- 远端只保留 1 份包，上传即覆盖；每次应用在本地生成 pre-restore 快照。

构建与测试

源码是 TypeScript，构建产物 lib/ 与 server/dist/ 已提交（junction 安装与部署直接用）。

pnpm install
pnpm run build # 插件：src/.ts → lib/.js
pnpm run build:server # 服务端：server/src/.ts → server/dist/.js
pnpm test # 单元 / 组件 / 时序（直接跑源码）
node scripts/audit-cases.mjs # 用例清单与结果记录一致性审计
node scripts/e2e-clone.mjs # 替代换机演练（本地模式，不写真实 WebDAV）
node scripts/verify-npm-install.mjs # npm 安装冒烟（临时 profile，用完即删）
powershell -File scripts/smoke.ps1 # 真实 DSH 路由冒烟

开发与真实环境

- 日常开发（junction）：install-dev.ps1 把仓库 link 进 profile，改源码 → pnpm run build → 热重载生效。
- 验证真实安装：verify-npm-install.mjs 在临时 profile 里 pnpm add 已发布版本，校验 patch 名、宿主/client 入口与资源文件。
- 两者互不干扰：npm 安装的是编译产物副本，改源码不会生效，所以开发用 link、验证用临时 profile。

发布

发布时机由维护者决定（scripts/publish.mjs 只手动执行，agent 不自动发布）。

cp .env.local.example .env.local && chmod 600 .env.local # 填 NPM_TOKEN
node scripts/publish.mjs --dry-run # 先看打包内容
node scripts/publish.mjs --otp=123456 # 2FA 时带当次验证码

token 只写进 0600 临时 npmrc、发布后删除，不进命令行与 git；CI 可用 NPM_TOKEN 环境变量。发布前先 pnpm run build && pnpm run build:server。

已知限制

- 桌面端整机验证以 Windows / macOS 为主，Linux 未验证。
- 服务端单节点，未做限流与多副本；坚果云单账号有流量配额。
- link: 本地依赖需要手工放回目标机。
- 远端只保留 1 份包，回滚依赖本地 pre-restore 快照。

赞赏

插件免费开源（MulanPSL-2.0）。如果它帮你省过换机时间，欢迎小额赞赏，用于服务端坚果云空间与持续维护。赞赏自愿，不影响功能与权益。

微信赞赏码

仓库结构

docs/ 设计 / 用例 / 部署 / 测试结果 lib/ 插件（宿主 + client + 传输 + 同步编排） server/ 运营方 API（纯 node:http） scripts/ 安装 / 卸载 / 冒烟 / 换机演练 / 发布 / npm 安装冒烟 test/ 单元、组件、时序测试与 fixtures legacy/ 需求稿与原型脚本

License

Mulan PSL v2