Skip to content

dsh-ownsync

Verified

dsh-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

每次"上传"会:

  1. 扫描本机数据目录里的三类内容(见下);
  2. 把文件写进本地同步仓库 .ownsync/repo.git;
  3. 生成一个只含当前内容的根提交, 推到 main.

所以服务器上的 main 是一份可以直接 git clone 下来的快照, 仓库体积等于当前内容, 不会随着上传次数膨胀.

每次"下载"会:

  1. 取回 main;
  2. 按文件写回本机(覆盖前先把原件存到 .ownsync/backup/);
  3. 记录本机基线版本;
  4. 如果写回了会话, 自动重启 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 里装:

  1. 打开 DSH → 设置 → 插件;
  2. 输入包名 dsh-ownsync, 点安装;
  3. 完全退出 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 回归(不碰真实数据目录)