双向同步网页版与 DSH Desktop 桌面版之间的会话、工作区、设置与插件。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:hajimimaodie8/DSH-Session-Sync
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本。请只安装可信来源,并尽量锁定 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
链接
同类插件
Anionex/dsh-turn-rewind★ 62
对话回退:基于持久 Change Ledger 回滚会话与工作区状态。
Nwflower/dsh-chat-import★ 43
把 13 家 coding agent(Claude Code、Codex、ChatGPT、Cursor、Gemini、opencode 等)的完整对话历史导入为可续聊的 DeepSeek Harness 会话,并支持反向导出回 Claude Code。
whyihaveyou/dsh-suite#plugin-session-export★ 35
把 append-only 会话日志导出为按轨迹来源分组的可读 Markdown 或 HTML。
Chinesezjc/dsh-interconnect★ 28
跨实例互联:经 interconnect 服务在多个 DSH 实例间转发消息与事件。
Moeblack/dsh-message-edit★ 24
基于分支的消息编辑、reroll、重试与版本时间线。
hellodigua/dsh-share★ 19
一键分享你的对话。