dsh-simple-sync
Sync your DeepSeek Harness config across computers — one click. Move everything
to a new machine, or keep two machines in step: plugin list, config patches,
settings, and agent presets travel as a file-level snapshot; missing plugins are
installed automatically.
多机同步 DSH 配置插件：一键搬家 + 自动同步。插件清单、配置补丁、全局设置、
Agent 预设按文件级快照同步，缺失的插件自动安装。
No chat commands, no OAuth, no build step. Everything lives in one settings
panel (Settings → Sync). 纯设置面板操作，无命令、无 OAuth、零运行时依赖。
Features / 功能
- One-click move / 一键搬家：install on a new machine → set the backend →
click「拉取并应用」→ config, plugins and presets all arrive; new plugins are
pnpm install-ed automatically.
- Auto-sync on startup / 启动自动检测：DSH boots → plugin checks the remote
→ newer snapshot found → applies it (opt-out in the panel).
- Two backends / 两种传输后端：
- Git repo (default): any git remote — GitHub / Gitee / GitLab /
self-hosted / LAN path. Token optional (blank = system credentials / SSH);
proxy configurable.
- Local folder: a plain directory (USB drive, shared folder, cloud-drive
sync folder). No network needed.
- File-level snapshots / 文件级快照：
snapshot.json with per-file
sha256 — only real changes travel; overwritten local files are backed up to
~/.dsh/.dsh-sync/backups/<timestamp>/ first.
- Safe by default / 默认安全：credentials (
.credentials.yaml) are not
synced unless you tick the option; tokens stay on the local machine (git
worktree .git-credentials, 0600); nothing machine-specific is hardcoded.
- No auto-restart / 应用后只提示手动重启：after applying, DSH asks you to
restart manually.
Install / 安装
dsh plugin --profile web add dsh-simple-sync
# or from GitHub
dsh plugin --profile web add github:LyaxZ/dsh-simple-sync
Then restart DSH. Requires DSH 0.1.1-rc.x or compatible; Windows / macOS / Linux.
Usage / 使用
- Open Settings → Sync（设置 → 同步）.
- Pick a backend and fill it in:
- Git: repo URL + optional token/proxy/branch — e.g.
https://github.com/you/dsh-sync.git (a private empty repo works).
- Local: a folder path.
- Click 测试连接 (Test connection) — first run prepares the worktree.
- On the machine you configured first, click 立即推送 (Push now) to upload
the first snapshot.
- On every other machine, click 拉取并应用 (Pull & apply) — changes land,
new plugins install, then restart DSH when prompted.
DSH startup auto-check applies newer remote snapshots by default; disable it in
the panel. 凭据同步（.credentials.yaml）默认关闭，按需勾选。
How it works / 原理
- Sync units（同步单元，白名单）:
settings.yaml, .agent-presets/**,
and per-profile package.json / cordis.patch.yml / pnpm-workspace.yaml
under profiles/*. Everything else (node_modules, sessions, memory, data,
lockfiles, generated cordis.yml) is excluded by construction.
- A push builds
snapshot.json = {meta:{machine,time,unitVersion}, files:[{path,sha256,content}]} and uploads it (git commit+push / file copy).
- A pull fetches it and diffs against local state; apply writes changed files
(backing up the old ones), then runs
pnpm install in profiles whose
package.json gained plugins.
- Last-writer-wins; machine names travel in every snapshot for traceability.
- Plugin state lives in
~/.dsh/.dsh-sync/state.json (backend config, last
push/pull timestamps, options).
Development / 开发
node --test test/ # core + transport tests (incl. real bare-repo git)
node test/gateway-sim.mjs # server-side gateway dispatch harness
test/gateway-sim.mjs imports the host's @deepseek-ai packages — create a
temporary node_modules junction to your DSH install's node_modules to run
it. The plugin itself ships with zero runtime dependencies.
License
MIT — see LICENSE.
