Bidirectionally synchronize sessions, workspaces, settings and plugins between the DSH web instance and the DSH Desktop instance.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:hajimimaodie8/DSH-Session-Sync
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time. Only install sources you trust, and pin a commit (github:owner/repo#sha).
README
Synchronize sessions, presets and settings between DSH desktop‑shell embedded instance and external web browser instance. Fix session isolation issue for third‑party packaged DeepSeek‑Harness desktop builds.
一个 DeepSeek Harness 插件:在网页版或 DSH Desktop 桌面版内,一条命令即可同步两端的 会话(对话内容)、工作区、缓存、设置与插件。解决打包版桌面实例与网页实例之间的数据隔离问题。
- 网页版:安装后在对话中输入
/sync - DSH Desktop 桌面版:同样安装后输入
/sync
功能
| 命令 | 作用 |
|---|---|
/sync |
双向合并(默认):两边内容取并集,不丢失任何一方 |
/sync web-to-desk |
单向覆盖:网页版 → 桌面版 |
/sync desk-to-web |
单向覆盖:桌面版 → 网页版 |
/sync status |
查看两端路径与数据统计 |
/sync --to <目录> |
手动指定对端数据目录 |
同步内容:会话记录、工作区列表(同路径自动合并)、会话投影缓存、设置/凭据、 插件启用配置 + 插件本体差异同步。
安装(网页版)
# 1. 把插件包复制到网页版 profile 的 node_modules
xcopy /E /I /Y "dsh-session-sync" "%USERPROFILE%\.dsh\profiles\node_modules\dsh-session-sync"
# 2. 在 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml 中追加(空列表 [] 需替换):
# - insert:
# - id: session-sync
# name: 'dsh-session-sync'
# 3. 重启 dsh web(或等待 patch 热重载),输入 /sync status 验证
安装(DSH Desktop 桌面版)
把插件包复制到桌面版对应位置,patch 追加到:
%APPDATA%\dsh-desktop\harness\profiles\web\cordis.patch.yml
xcopy /E /I /Y "dsh-session-sync" "%APPDATA%\dsh-desktop\harness\profiles\node_modules\dsh-session-sync"
原理
- 通过
$DSH_HOME定位当前实例数据目录(网页版通常~/.dsh,桌面版通常%APPDATA%\dsh-desktop\harness) - 对端目录自动推断(本端为桌面版则对端为网页版,反之亦然),支持
--to覆盖 - 复用 Cordis 命令注册(
ctx.commands.register),无外部依赖,纯 Node 内置模块
开发
dsh-session-sync/
├── package.json 插件清单(含 dsh.bundle 声明)
├── cordis.patch.yml bundle patch layer(插入 /sync 命令)
├── install.js 一键安装脚本(web/desk/both)
├── CHANGELOG.md
├── docs/
│ └── install-examples.md
├── test/
│ └── plugin.test.mjs 单元测试
├── README.md
├── LICENSE
└── lib/
├── index.js 插件入口:注册 /sync 命令
└── sync-core.js 同步核心(会话/工作区/缓存/设置/插件)
插件为 ESM 模块,导出 name / inject / apply;package.json 声明
dsh.bundle.patch,作为正式 profile bundle 插件,可通过 dsh plugin add
或插件市场安装,无需手工修改 profile patch。
插件市场
本插件已提交至 awesome-dsh-plugin
市场 registry(data/plugins/hajimimaodie8__DSH-Session-Sync.yml),
合并后可在 DSH 插件市场(dshmarket)中搜索 "session-sync" 一键安装。
测试
npm test # node --test test/
许可
MIT
Links
More in this category
Anionex/dsh-turn-rewind★ 62
Rewind conversation and workspace state, powered by a persistent Change Ledger.
Nwflower/dsh-chat-import★ 43
Import full-fidelity chat histories from 13 coding agents (Claude Code, Codex, ChatGPT, Cursor, Gemini, opencode, and more) as resumable DeepSeek Harness sessions, with reverse export back to Claude Code.
whyihaveyou/dsh-suite#plugin-session-export★ 35
Export the append-only session log as human-readable Markdown or HTML, grouped by trajectory source.
Chinesezjc/dsh-interconnect★ 28
Cross-instance message and event handoff between DSH instances via an interconnect server.
Moeblack/dsh-message-edit★ 24
Branch-based message editing, reroll, retry, and a version timeline.
hellodigua/dsh-share★ 19
Share your conversations with one click.