dsh-workspace-migrate
Manifest validBackup and Migration: Package DeepSeek Harness sessions, project files, and attachments by workspace, restore them on a new computer, and rewrite historical paths (fork of lij0000-arch/dsh-workspace-migrate)
dsh-workspace-migrate(备份与迁移)
界面显示名「备份与迁移」。本仓库是 lij0000-arch/dsh-workspace-migrate v0.5.3 的本地化改造版,依 MIT License 分发,上游版权归 dsh-migrate contributors;本地改动见提交历史。
换电脑,把 DeepSeek Harness 里的项目、对话和文件一起带走,而且搬过去的旧对话还能接着聊。
和别的迁移工具不一样的三点:
- 按工作区选,不是整机全量:勾哪个项目就带走哪个项目的会话、归属、置顶/归档、文件和附件。
- 指定新根目录:导入时填一个目录,每个项目自动建
<根>/<项目名>,并把历史对话里的旧绝对路径重写成新路径——这是「搬过去就能接着聊」的关键。 - 增量同步:之后想再同步一次,只复制改动的文件,没变化的会话直接复用;旧机器上重新激活(继续聊)的会话再次导入时会快进追加新事件,不再整条跳过。
安装
# 桌面端(推荐:Release 预构建包)
dsh plugin --profile desktop add "https://github.com/jockerbear/dsh-workspace-migrate/releases/download/v0.7.0/dsh-workspace-migrate-0.7.0.tgz"
# 或从仓库源码装
dsh plugin --profile desktop add github:jockerbear/dsh-workspace-migrate
⚠️ 不要用裸包名 dsh-workspace-migrate:npm 上的同名包是上游 0.5.4(lij0000-arch),不是本仓库。
不想用命令行:设置 → 插件 里安装,或在一个对话里让 agent 用 plugin_manager 装这个仓库。装完刷新页面,设置 → 备份与迁移 出现即可用。
插件按 profile 隔离:你现在用的界面是哪个 profile,就装到哪个。装错的表现是「装好了,但设置里看不到这个页签」。桌面端一般是
desktop,dsh web是web;不确定就执行echo $env:DSH_PROFILE。
怎么用(两步)
- 旧电脑:设置 → 备份与迁移 → 导出(旧电脑)→ 勾项目 → 开始导出,默认得到一个
.zip压缩包 + 一个.sha256小边车(同步盘上只放两个文件),拷到新电脑。 - 新电脑:设置 → 备份与迁移 → 导入 → 选包(
.zip可直接选)→ 填新根目录 → 导入前体检 → 开始导入。
完成后刷新页面,项目、对话、文件都在新位置,旧对话可以继续。
用之前先知道
迁移包默认是单个 .zip 压缩包 + 一个 <包名>.zip.sha256 传输边车(同步盘推送/拉取只面对两个文件,降低小文件撕裂与瞬锁风险);导出时可关掉「压缩为单文件 zip」改回文件夹形态,两种形态都能导入。包内自携带插件副本 plugin\dsh-migrate\,新电脑上也能从这个目录装(更推荐直接从本仓库安装)。
能力与边界
- 读:
~/.dsh/sessions(会话事件流)、~/.dsh/storages/workspace.json(项目登记、置顶/归档集合)、~/.dsh/attachments、以及所选项目目录 - 写:经公开服务新建会话与项目登记(
sessionPersistence/workspaceRegistry)、按路径映射复制项目文件与附件 - 删:只有「撤销这次导入」会删,而且只删本次进程内由本插件创建的项目登记与会话目录,其它 id 一律拒绝
- 网络:不向外发起请求;仅在本机
127.0.0.1注册/api/dsh-migrate供当前页面调用 - 鉴权:每个请求都经宿主
ctx.connection.requestRejection()校验浏览器签名凭据,被拒返回 401/403;宿主没有该服务时直接返回 503,不回退到 Origin/Host 比较(请求头可以伪造,不能当身份凭据) - 凭据:不读取、不导出
~/.dsh/.credentials.yaml - 隐私:迁移包含完整对话与项目文件,导出目录不要放在公开位置
旧电脑:导出
- 设置 → 备份与迁移 → 导出(旧电脑)
- 勾选要带走的工作区(默认全选),按需勾选「同时打包项目文件」「同时打包图片附件」
- 导出位置留空则写到 profile 配置项
defaultOutDir,未配置时回退~/.dsh/migrations/(输入框会显示实际生效的默认目录);填过的值会记住,下次打开自动填入 - 完成后把
<包名>.zip与<包名>.zip.sha256两个文件拷到新电脑;先校验.sha256边车与包内容一致(匹配再导入)
不带项目文件时只打包对话;带项目文件时按目录排除 node_modules、.git、.venv、__pycache__ 等可重建目录。
增量同步(0.2.0+)
第一次导出之后,可以让同一个迁移包保持最新,而不是每次整包重拷:
- 设置 → 备份与迁移 → 导出 → 增量更新已有迁移包,从列表选一个包,或直接填包的路径
- 只复制新增或修改过的文件;源里删掉的文件会同步从包里删除
- 会话按其源日志的字节数与事件数判断:没变化的会话直接复用,不重新编码
- 增量范围固定为这个包原本包含的工作区,不会把别的项目卷进来
实测:改 1 个 / 删 1 个 / 加 1 个 → copied=2 removed=1 unchanged=0;紧接着再跑一次 → copied=0 unchanged=2;空闲会话 → reused=1、sessionBytes=0。
判断变更用「文件大小 + 修改时间」:内容变了但大小和时间都没变的文件不会被识别(正常编辑不会出现)。
再次导入:重新激活的会话会增量更新(0.7.0+)
历史会话在新旧两台机器上都存在时,导入不再一律跳过:
- 快进合并:本机保存的会话是包内会话的严格前缀(同一条时间线,只是更短)→ 只把包内多出来的尾部事件追加进来,会话 id、标题、归属不变
- 已最新:本机事件数与包内相同 → 直接跳过,不重复写
- 分叉跳过:本机也在这条会话里继续聊过(两边都新增了事件)→ 跳过并在报告里写明「两端已分叉」,本机内容一字不动
- 占用跳过:会话正在界面里使用(写入占用)→ 跳过,关掉会话后重导即可
- fork 会话:按 DSH 原生结构(继承前缀 +
session/end-seed标记)导入,之后同样支持快进追加
判断「同一条时间线」用 header.createdAt 与事件的 seq/type/time,不受导入时路径重写影响;因此换一个新根目录再导一次也不会误判。追加前做两层校验:事件类型必属本机 DSH 已知词汇(或带 ignorable 标记),并用 DSH 自己的 Session 构造器把「本机日志 + 尾部」试构造一次(不落库、不 announce),畸形载荷会被拒绝,避免把已有会话追加成读不出来的状态。追加的事件走公开的 sessionPersistence 写入通道,遵守 DSH 的单写者与连续 seq 约束。
报告会给出「增量更新 N · 追加 M 事件 · 已最新 K」;追加的事件无法用「撤销这次导入」回退(撤销只删本次新建的会话/项目)。需要严格回退时,请在导入前备份 ~/.dsh/sessions。
新电脑:导入
- 装好 DSH,从迁移包的
plugin/dsh-migrate/安装本插件 - 设置 → 备份与迁移 → 导入(新电脑)
- 选择迁移包,读取清单
- 填导入到(新根目录),比如
E:\DSH:每个项目会自动建在E:\DSH\<项目名>下,目录不存在就创建;下面每一行仍可单独改路径 - 勾选重写对话里提到的旧路径(默认开)
- 开始导入;结束后看报告里的导入数、重写数、未归属数和提醒
为什么要重写旧路径
会话历史里的工具调用、文件引用、报错信息都写着旧机器的绝对路径(D:\...)。只改工作目录不改这些,续聊时模型会去找不存在的文件——这就是「对话变乱」的根因。导入时会把被重映射的根路径在事件数据里整体替换成新路径,并报告替换了多少处。
实测:把旧根目录迁到另一盘符下的新根目录 → 报告 rewritten=1054,导出后检查会话内容确认工具调用、cwd、文件引用都指向新根。
导入通过 Harness 的公开服务(sessionPersistence / workspaceRegistry)重建,不是覆盖文件,所以:
- 同 id 会话默认按「快进合并」处理(见上一节):本机是旧前缀就追加,已最新或分叉则跳过,绝不覆盖本机
- fork 出来的会话按 DSH 原生 seeded 结构导入(继承前缀 + 标记),不再展开复制
- 归档/置顶状态会尽量恢复
- 导入错了可以用「撤销这次导入」按本次报告里的 id 回滚
- 报告里的「未归属项目的会话」表示该会话的 cwd 不落在任何项目目录,检查一下路径映射即可
导入前体检
会话里引用过的图片/文件如果在新机器上不存在,续聊时请求会在准备阶段失败(表现为「DeepSeek Messages transport failed」)。导入页的 导入前体检 会先把包里每个会话的附件引用扫一遍,对照本机 ~/.dsh/attachments 报告缺多少、涉及哪些会话。
1 个会话 · 37 个附件引用 · 6 个缺失
建议:包内带了 attachments 目录,勾选「包含图片附件」即可补齐
• session-xxxx — 6/37
导入时若没勾选附件、且会话确实有缺失,报告里也会写「缺失附件的会话: N」。修法:把旧机器的 ~/.dsh/attachments 整个拷到新机器同名位置,重启 DSH,这些会话即可续聊(附件引用是内容寻址的,文件到位就解析得到)。
清理失效项目
导出页的「清理失效项目」会删掉路径已不存在且没有任何会话的项目登记。用于导入后目标目录被移动或删除的情况。
限制
- 日志格式有方向性:旧版本导出的包可以被新版本导入(后端会自动迁移),反过来不行。两台机器的 DSH 版本差距越大,越建议先把旧机升级到同一版本再导出。
- 凭据不迁移:
~/.dsh/.credentials.yaml不在包里,新电脑需要重新登录。 - 插件不自动装:
~/.dsh/profiles/*里的插件组合不会自动还原,需要在新电脑上重新装(插件源码随包带走的只有它自己)。 - 导出目录不能落在被导出的项目里面;这种情况会跳过该项目的文件并给出提醒。
开发
index.js:Host 半边。注册sessionPersistence/workspaceRegistry/webServer,在/api/dsh-migrate下提供inventory/preview/export/import/task/rollback。client.js:Client 半边。注册settings.section的migration页签,纯 React 无构建。- 改完
index.js需要在插件页把本插件关掉再打开,模块才会重新加载;client.js一般刷新页面即可。
Comments
Loading…
Similar plugins
by lij0000-arch
Workspace-scoped DeepSeek Harness migration: conversations, project files and attachments with path remapping
★ 1
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-workspace-migrateby baisama-cloud
Move a session to another workspace by dragging it onto the target workspace header in the sidebar: the session is cloned with full history into the target workspace and the original is archived.
★ 2
MIT
JavaScript
Aug 22, 2026
dsh plugin --profile web add dsh-session-moverby ame-code
Move a DeepSeek Harness workspace (folder tree, nested workspaces, sessions) to a new location from the sidebar — with rename, rollback and undo.
★ 1
MIT
JavaScript
Nov 10, 2026
dsh plugin --profile web add @reed-io/dsh-workspace-moveby mienfong
Move, archive, restore, portable backup/export and import sessions across workspaces in the DeepSeek Harness web UI.
★ 9
↓ 351/wk
MIT
JavaScript
Nov 14, 2026
dsh plugin --profile web add dsh-session-mgrby Alvin070911
DeepSeek Harness session migration panel: move a session (log, header cwd, workspace membership) into another workspace from a button in the session header.
★ 0
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-session-migrationby visitor257
Full backup, migration and disaster recovery for DeepSeek Harness - packs conversations, workspaces, plugins, settings and the directory/junction layout into a verified bundle with a readable report.
★ 0
MIT
JavaScript
Nov 3, 2026
dsh plugin --profile web add dsh-travel-kit