DSH Toolbox

DSH Sync Hub

免费 · 跑在你自己的机器上 · 需要 Node.js 20 或更高版本 · 不依赖第三方包

跨设备、跨 DSH 形态同步会话与工作区索引。会话文件按不透明字节搬运，从不解析内容。

三步

1

起 Hub

一个 Node 进程。数据落在你指定的目录。

node src/hub/server.mjs
2

配对设备

一次性 8 位配对码，10 分钟有效。

node src/agent/cli.mjs pair --hub http://host:7788 --code ABCD2345
3

同步

首次全量，之后只传变化的分块。

node src/agent/cli.mjs sync --hub http://host:7788 --home ~/.dsh

一眼看清：什么同步，什么不同步

同步什么

  • sessions/<工作区>/<会话>/session*.jsonl.zstd
  • storages/workspace.json
  • storages/session_projcache.json

双向同步。

永远不离机的

  • .credentials.yaml
  • *.pem *.key id_rsa*
  • storages/schedule.json
  • storages/dsh_automation.json
  • logs/ cache/
  • profiles/ skills/

不读取、不哈希、不上传。

.credentials.yaml、*.pem、*.key、*.p12、id_rsa*、.env、profiles/**/cred* —— 这些路径在扫描阶段直接跳过。

冲突保留双份

两台机器从同一版本各自往下写时，后到的那份存为冲突副本，本地文件原样不动。永不静默覆盖。

平台现实

平台能力
Windows / macOS / Linux完整同步宿主。
Android（Termux）能用，但要自己装 Node，且系统可能杀后台。
iOS / 鸿蒙只能当浏览器控制台——没有 Node 运行时，无法承载会话。

获取

源码与中英文使用手册都在仓库里。克隆、看手册、跑三条命令。

git clone https://github.com/FindSomeSkills/Skills.git dsh-skills
cd dsh-skills/dsh-tools/dsh-sync-hub
node src/hub/server.mjs

使用手册

中文使用手册

安装、配对、同步、冲突处理、常见故障，一步一步写。

英文使用手册

同一份手册的英文版。

源码

在 GitHub 上查看源码

常见问题

会解析我的会话吗？

不会。只做哈希、分块、搬运。解析会把自己绑死在会随版本变化的内部格式上。

两台机器都改了同一会话怎么办？

两份都留。Hub 把后到的存成冲突副本，你本地那份保持原样。

增量是真的吗？

是。会话是追加写的，一个普通回合只传变化尾部那块。实测追加 10 KB 只传了 28,928 字节，而不是 160,000。

两端 DSH 版本必须一致吗？

请保持在同一 0.2.x 线上。工具会拒绝跨格式合并，而不是猜。