Overview
dsh-github-sync
dsh 插件 · 用 GitHub 私有仓库多机同步：会话 sessions 备份与恢复、插件清单、设置；纯 REST（不需要 git 二进制），token 只写不回读，各机路径互不覆盖。
README / EN
Package documentation
Registry summary
dsh 插件 · 用 GitHub 私有仓库多机同步：会话 sessions 备份与恢复、插件清单、设置；纯 REST（不需要 git 二进制），token 只写不回读，各机路径互不覆盖。
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
- **跨机恢复不会改写会话 header 里的 `cwd`**。dsh 的 `list()` 只看目录，所以会话会出现在映射后的工作区下；但日志体里的绝对路径仍是原机器的。要做到无损，恢复时得解压/改序化/重压缩每一帧——那会破坏「源文件字节不变」的格式契约，因此没做。 - `$DSH_HOME/storages/workspace.json`（工作区注册表 / 归档会话 id）不参与同步。它是机器本地的，覆盖它会影响本机侧栏；需要时可手工处理。 - 附件（`$DSH_HOME/attachments/`）不在同步范围内。 - GitHub 单个 blob 上限 100 MB，默认跳过超过 `maxFileMb`（45 MB）的单个文件并在结果里报告。 - 会话目录树很大时，GitHub 的 tree 接口可能返回 `truncated`，此时只做增量比对（插件会在结果里标注）。