dsh-session-migrate
DSH (DeepSeek Harness) 会话迁移插件：Web UI 设置面板中把会话拖拽到目标工作区完成迁移，
自动备份、自动回滚、官方 workspaceRegistry 同步。零运行时依赖。
Topics: dsh-plugin, deepseek-harness, dsh
安装（标准方式）
# 方式一：官方标准命令（推荐，从 GitHub 安装）
dsh plugin --profile web add github:ailiasdesu/dsh-session-migrate#main
# 方式二：本地开发源码路径
cd ~/.dsh/profiles/web
pnpm add file:../../dsh-session-migrate
安装后确认 profile/package.json 的 dsh.profile.bundles 已包含本包（插件自带
dsh.bundle.patch，装配层自动应用，无需额外 patch 注册）。重启 DSH 生效。
使用
- 打开 设置 → 会话迁移（设置面板左侧导航）。
- 左栏「会话」（来自官方 session.list），右栏「目标工作区」。
- 把会话行拖到目标工作区行 → 确认对话框 → 迁移完成（绿色提示）。
刷新 按钮重新拉取；迁移结果实时反馈。
交互约束
- 当前活动会话（●当前）不可迁移。
- 已打开/运行中的会话（DSH 内存中 live）会被拒绝：先关闭会话或重启 DSH 后再迁移。
- 迁移自动备份原日志到
~/.dsh/session-migrate-backup/<session-id>/<epoch>/；
官方索引同步失败时自动回滚文件与索引。
工作原理
会话归属权 = 日志头部（header）的 cwd（workspaceRegistry canonical-cwd 索引，
见 @deepseek-ai/dsh-workspace）。迁移 = 磁盘层（zstd 日志仅重写 header 行改 cwd，
事件行字节不变，文件搬到目标项目目录）+ 官方层（workspaceRegistry.indexHeader → attachSession → detachSession）。目录命名算法与
@deepseek-ai/dsh-session-persistence-jsonl 完全一致（encodeSegment / projectKey），
不会触发 DSH 的 corrupt 校验。
架构
| 文件 | 职责 |
|---|
lib/index.js | host 插件：REST /session-migrate/api（list / migrate）+ 官方服务编排 + 失败回滚 |
lib/migrate.js | 核心：编码、zstd header 读写（node:zlib 原生）、文件级迁移/回滚 |
lib/client.js | 浏览器端：设置面板 section（slots 注册，React 壳 + 纯 DOM UI，拖放交互） |
tests/unit.mjs | 在临时目录对真实会话副本演练迁移/回滚（node tests/unit.mjs） |
开发
node --check lib/index.js && node --check lib/migrate.js && node --check lib/client.js
node tests/unit.mjs # 全量演练（真实会话副本，不碰真实数据）
规范检查：plugin_check（bundle 形态，PASS；hub catalog 由官方生态后续接入）。
License
BSD-3-Clause
