dsh-ownsync
Verifieddsh-ownsync · v1.3.0 · MIT · Web UI
在自己的 Git 服务器上同步 DSH 的工作区, 会话与聊天附件, 主力放在上传和下载两个按钮.
Install
dsh plugin add dsh-ownsync Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-ownsync
把 DeepSeek Harness (DSH) 的工作区登记, 会话和聊天附件同步到你自己的 Git 服务器, 换台电脑接着用. 自动上传可以在设置里开关(默认开启); 下载只在你点「下载」时发生, 没有分支, 没有合并. 同一时间仅限单台电脑使用.
它怎么工作
服务器上就是一个普通的空仓库:
git init --bare /srv/git/dsh-sync.git
每次"上传"会:
- 扫描本机数据目录里的三类内容(见下);
- 把文件写进本地同步仓库
.ownsync/repo.git; - 生成一个只含当前内容的根提交, 推到
main.
所以服务器上的 main 是一份可以直接 git clone 下来的快照, 仓库体积等于当前内容,
不会随着上传次数膨胀.
每次"下载"会:
- 取回
main; - 按文件写回本机(覆盖前先把原件存到
.ownsync/backup/); - 记录本机基线版本;
- 如果写回了会话, 自动重启 DSH 以便重新读取; 被占用的会话会先切到空白会话再重启.
服务器是唯一权威:服务器有什么, 本机就变成什么.
同步什么
| 类别 | 内容 |
|---|---|
| 工作区 | storages/workspace.json: 全部工作区, 标题, 顺序, 会话归属, 归档状态 |
| 会话 | sessions/** 下每个会话的最高代际日志 |
| 聊天附件 | attachments/** 中被上述会话日志引用到的文件 |
不同步: 项目文件夹里的代码文档, settings.yaml, cordis.patch.yml, 插件清单,
凭据, 缓存, 日志, AGENTS.md, skills/.
只有 header、或者只有权限预设/沙箱模式/审批策略引导与 session/end-seed 标记的空对话也不参与同步. 上传时还会把这些空对话的 id 从工作区登记里剔除(只改上传内容, 本机 storages/workspace.json 保持原样).
判断"本机有没有未上传改动"时, 工作区登记只比语义: 忽略 updatedAt 时间戳、sessionIds 的数组顺序, 以及本机没有内容可同步的 id. 宿主新建一个不用的会话、或只是重写了一遍登记, 都不会让面板显示改动, 也不会平白多推一个版本.
界面
侧栏左下角(头像上方) 是一张卡片:
┌──────────────────────────────┐
│ ● 已同步 │
│ 本机 v12 │
│ 服务器 v12 │
│ 上次同步 2026-11-08 12:30 │
│ [ 上传 ] [ 下载 ] [ 检查更新 ] │
└──────────────────────────────┘
[ ⚙ 设置 ] [ 🗘 同步 ] [ ↻ 重启 ]
- 上传 / 下载: 按当前状态自动启用或禁用, 禁用时悬停会说明原因;
- 检查更新: 任何状态都能按, 立刻向服务器 fetch 一次版本;
- 状态胶囊: 可点击展开详情--"本机有 N 处未上传改动" 展开黄色的改动列表; 上传成功后的"已同步" 展开绿色的上传结果(版本号 + 本次改动列表);
- 设置(齿轮): 打开设置弹层(仓库地址, 分支, 自动上传开关, 两个刷新间隔);
- 重启(标记 ↻): 点击后先弹确认框(防误触), 确认才派发. 外部助手结束 Electron 主进程, 宿主因 IPC 断开优雅退出(会话落盘), 随后助手用原启动参数拉起应用. 有任务在跑, 插件安装中或刚重启过 5 秒内会拒绝; Web / 非 Windows 环境只给手动提示.
状态与按钮
| 状态 | 含义 | 可用按钮 |
|---|---|---|
| 未填写仓库地址 | 还没配置同步仓库 | 无 |
| 尚未检查服务器 | 还没连过服务器 | 无(先点"检查更新") |
| 无法连接服务器:... | 地址, 网络或认证问题 | 无 |
| 服务器上还没有内容, 建议上传 | 服务器是空仓库(首次使用) | 上传 |
| 本机尚未下载 | 本机还没有服务器基线 | 下载 |
| 有会话待写回本机 | 有会话被宿主占用, 等重启后写回 | 下载 |
| 本机有 N 处未上传改动 | 本机内容比服务器新 | 上传 |
| 服务器版本较新, 建议下载 | 另一台电脑传过更新 | 下载 |
| 本机版本较新, 建议上传 | 本机有内容还没传 | 上传 |
| 本机与服务器内容不同 | 两边版本号相同但内容不同 | 上传 / 下载 |
| 已同步 | 两边一致 | 无 |
自动上传
设置弹层里的「自动上传」默认开启. 只要 DSH 在运行(界面开着, 或窗口关闭留在托盘), 宿主每 30 秒检查一次, 满足以下条件就自动上传:
- 有未上传改动;
- 连续两次检查(约 30 秒)内容没有变化;
- 没有正在生成的回合或运行中的任务;
- 没有待写回的会话;
- 服务器没有更新(否则暂停并提示先下载);
- 距上次自动上传至少 60 秒.
上传过程中如果本地内容又变化, 本轮放弃, 下一轮再传. 批量删除不会自动确认, 需要手动处理. 自动上传只推不取, 不会覆盖服务器.
下载
下载本身仍然只能手动触发, 不会自动覆盖本机. 但打开 DSH / 页面首次加载、以及窗口从托盘或最小化恢复时, 会立即检查一次服务器版本:
- 检查期间用遮罩挡住输入;
- 本机领先或与服务器一致时自动撤掉遮罩;
- 服务器较新时在中间提示需要下载, 只给「下载」按钮, 不会自动下载.
两个刷新间隔
设置弹层里可以改, 单位秒, 范围 1-600:
| 设置 | 默认 | 行为 |
|---|---|---|
| 本机状态刷新间隔 | 5 秒 | 读版本, pending, 改动数, 纯本地扫描, 不联网 |
| 服务器自动检查间隔 | 10 秒 | 每次 git fetch, 只刷新版本状态 |
两个间隔都保存在本机浏览器里(不参与同步); 页面在后台或正在上传/下载时会跳过自动检查. 自动检查不抢焦点, 不打断输入.
改动与上传结果
点侧栏卡片上的状态胶囊会在胶囊上方展开列表, 再点一次收起:
- 有未上传改动时(黄色背景):"本机有 N 处未上传改动", 列表是当前改动;
- 刚上传完成后(绿色背景):"已上传 vN, 这次更新了 M 个改动", 列表是本次上传的内容.
每行显示成"工作区 - 会话标题":
- 会话: 取
workspace.json里的工作区标题和 DSH 投影缓存里的会话标题, 悬停可看完整路径; - 附件: 显示"附件 - 文件名";
- 工作区登记: 显示"工作区登记";
- 标题取不到时退回"工作区 - 会话 xxxxxxxx".
使用前提
- 同一时间只有一台电脑在改内容;
- 换电脑之前, 先在原来那台点"上传";
- 到新电脑先点"下载", 再开始用.
按这个顺序用, 就不会出现两份都改过, 需要合并的情况.
插件调用的是系统 PATH 里的 git(Windows 上是 Git for Windows, DSH 不自带). 如果点上传/下载时提示"这台电脑上找不到 git 命令", 安装 Git for Windows 后 完全退出并重新打开 DSH 即可, 消息里会列出当前 PATH 方便排查.
安装
插件发布在 npm(或你们自己的 registry) 上, 直接在 DSH 里装:
- 打开 DSH → 设置 → 插件;
- 输入包名
dsh-ownsync, 点安装; - 完全退出 DSH 再打开.
等价的命令行安装:
# Web 端
dsh plugin --profile web add dsh-ownsync
# Windows 桌面端
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add dsh-ownsync
升级时指定版本, 例如 [email protected], 装完同样要完全退出再打开.
如果 DSH 用的不是公共 npm, 需要先在 profile 的
.npmrc里配置 registry, 或在安装命令后加--registry <地址>.
第一次使用
1. 准备服务器
在服务器上建一个空仓库:
git init --bare /srv/git/dsh-sync.git
不要设置 receive.denyNonFastForwards: 每次上传都是一次强制推送.
2. 配好 git 凭据
插件不弹任何登录窗口, 先把这台电脑的 git 访问打通:
- SSH:
ssh-keygen生成密钥, 把公钥加到服务器,ssh -T user@host能通; - HTTPS: 在终端执行一次
git ls-remote <仓库地址>, 按提示输入账号与访问令牌, 交给系统 Git 凭据管理器保存.
3. 填仓库地址
打开 DSH, 点侧栏左下的设置齿轮, 填入仓库地址(例如
ssh://[email protected]:2222/srv/git/dsh-sync.git), 点"保存".
4. 第一次上传(在已经有内容的那台电脑)
点"检查更新". 因为服务器还是空仓库, 状态会显示**"服务器上还没有内容, 建议上传"**, 此时只有"上传"可用; 点一下就在服务器上建出 v1.
5. 在新电脑第一次下载
装好插件, 填同一个地址, 点"检查更新"→ 状态变成"服务器版本较新, 建议下载"→ 点"下载".
- 覆盖前会把本机原件备份到
.ownsync/backup/; - 下载写回会话后会自动重启, 重启后才能看到新内容;
- 如果目标会话正被占用, 会切到空白会话并自动重启.
6. 之后
- 换电脑前: 在原机器点"上传";
- 到新机器: 点"检查更新", 再点"下载";
- 同一时间只在一台电脑上改内容.
安全边界
- 下载会覆盖本机: 覆盖前把原件存到
<数据目录>/.ownsync/backup/<时间>/files/..., 需要时可以手工拷回; - 一次删掉多个文件要确认: 上传时如果发现本机少了 3 个以上(或超过一半) 上次同步过的 文件, 会先让你确认, 并把服务器上的旧版本备份到本机;
- 本机有未上传改动时下载要确认: 确认后以服务器为准;
(DSH 打开会话时追加的
session/end-seed标记不算改动); - 上传是"比较交换": 如果服务器在你上次下载之后被改过, 上传会被拒绝并提示先下载, 不会覆盖别人的内容;
- 服务器只是传输通道, 不是备份: 真正的备份责任在本机的数据目录和
.ownsync/backup.
已知限制
- 下载写回会话后会自动重启: DSH 页面显示的是打开会话时读到的内容, 宿主进程重启才会重新读盘; 只要写回了会话就自动重启(不弹确认), 重启后回到原会话;
- 会话被占用时下载会切空白会话并自动重启: 写入权归活着的 Agent, 切走界面不一定释放, 只有 进程退出才释放. 遇到被占用的会话时, 插件会切到空白会话并直接重启; 重启后自动补写并尽量跳回 原会话, 没抢到时机就停在"有会话待写回本机", 再点一次"下载"即可;
- 自动重启: 仅 Windows 桌面版支持(外部助手结束主进程后再拉起); Web 端, 其他系统或助手无响应时, 仍会提示手动退出重启;
- 会话正在生成时上传会被拒绝: 等这轮回复结束再点;
- 会话日志只追加, 所以下载时如果发现服务器版本比本机长, 会通过宿主接口追加而不是整体替换;
- 单文件上限 256 MiB(会话和附件), 超过的附件会被跳过并列在上传结果里.
更新日志
每个版本的变更见 CHANGELOG.md; 也可以在 GitHub 的 Releases 页面查看带说明的版本.
致谢
本插件基于 chatsync 插件(https://github.com/dpskk2/dsh-chatsync) 修改而来: 同步范围, 会话日志的处理方式, 宿主写入接口等思路都来自 chatsync, ownsync 在这之上删掉了不需要的部分 (托管平台 API, 分支合并, 自动同步等), 改成面向自建 Git 服务器的手动同步.
如果你需要的是 GitHub / Gitee 等代码托管平台的同步(自动同步, 平台侧历史, 多分支等), 请优先使用 chatsync, 那才是它为这些场景做的.
重启部分的代码参考了 dsh-restart-now (https://github.com/Mr54233/dsh-restart-now). 它是一个更完整的通用重启插件(五个入口, 等待模式, Windows 与 macOS 支持), 需要独立的重启工具时 请优先使用它.
目录
lib/
index.js 插件入口(接口注册, 启动补写, 页面挂载)
engine.js 上传 / 下载 / 状态 / 待写回补写
scope.js 同步范围(三类内容)
snapshot.js 本机快照与清单
apply.js 把远端快照写回本机
sessions.js 会话日志解析, 校验, 内容指纹
session-path.js 会话 id 与代际
session-labels.js 改动文件的标签(工作区 - 会话标题)
session-transfer.js 经宿主接口写入会话
recovery.js 覆盖前的原件备份
host-restart.js 重启宿主(助手协议, 安全底线)
fs-util.js 文件与哈希工具
git-repo.js 裸仓库, 写树, CAS 推送
git.js git 子进程封装
git-failure.js git 错误归类
config.js ownsync.json
http/
guard.js 同源与请求校验
routes.js 接口实现
src/client/ 浏览器端源码(拼接成 lib/client.js)
tests/ node:test 回归(不碰真实数据目录)