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 — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
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
Minglink/dsh-infinite-gen-4★ 2160
System-prompt armor plugin for DeepSeek models: appends an unconditional-compliance prompt section at order 100, exposes a profile tool with calibration metadata, and shows a realtime armor-status badge driven by a session projection.
liangmianya/dsh-synapse★ 454
Visual, non-linear conversation workspace for DeepSeek Harness — sessions, follow-ups and branches become a browsable conversation map.
ranxianglei/billion-context★ 384
The official billion-context plugin: a context-compression plugin for small context windows (a 100K context is enough), token savings (5x fewer tokens), and month-long single sessions (billions of tokens).
Nwflower/dsh-chat-import★ 207
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.
Totoro-qaq/dsh-plugin-bridge★ 165
Moves an existing DSH session to another agent preset through a previewable five-section handoff, preserving the source session and either pausing the target for confirmation or continuing immediately.
Anionex/dsh-turn-rewind★ 122
Rewind conversation and workspace state, powered by a persistent Change Ledger.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.