Overview
dsh-sync
把整台机器的 dsh 状态迁移到另一台机器:导出可移植 bundle(settings / 凭据(可选) / 插件源码 / profile 清单 / 会话历史 / 工作区记录 / skills 链接),在目标机落地并按路径映射改写会话 cwd 与工作区路径,最后逐条核对一致性。会话改写只换 zstd 首帧,事件区逐字节不动。
README / EN
Package documentation
Registry summary
把整台机器的 dsh 状态迁移到另一台机器:导出可移植 bundle(settings / 凭据(可选) / 插件源码 / profile 清单 / 会话历史 / 工作区记录 / skills 链接),在目标机落地并按路径映射改写会话 cwd 与工作区路径,最后逐条核对一致性。会话改写只换 zstd 首帧,事件区逐字节不动。
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- **`node_modules` 不随行**:新机要重建依赖(桌面版退出重开自动重建;web 跑 `pnpm install` 或 `dsh plugin add`)。 - **新机 node 要够新**:包要求 ≥ 22.19,会话改写还需要内建 zstd(22.15+ 或 24)。不满足时会话不迁移并明确告警,不静默跳过。 - **工作区代码默认不带**:不打开 `includeWorkspaces` 时会话能列出但打不开;打开后体积从百 MB 涨到 GB 级。 落位目录已存在且非空时**拒绝覆盖**,要显式覆盖。 - **外部软链要有对应路径**:`skills/` 下指向 `$DSH_HOME` 外的链接,新机缺目录时如实报 WARN(I6b),不偷改指向。 - **宿主跨 `major.minor`** 时插件可能被启动时拒装,需在插件管理器逐个授予精确版本豁免。 - **传输任务状态在内存里**:插件重载或重启 dsh 后任务失效,重跑拉取按哈希续传。 - **Windows 首次监听会弹防火墙**,选「专用网络」允许;进度页是浏览器页面,不在 DSH 界面里。