[Plugin] dsh-session-migrate — drag-and-drop session migration between workspaces

[ailiasdesu]

dsh-session-migrate — migrate DSH sessions between workspaces straight from the Web UI settings panel, with drag-and-drop, automatic backup, and automatic rollback.

What it does

• Move any cold session (including 300+ turn, ~1.9M-event logs) to another workspace with one drag & drop
• Session identity, history, and projections stay intact — event lines are byte-identical; only the header cwd changes
• Automatic backup before any write; automatic file + index rollback if the official sync step fails

How it works

• Uses the official workspaceRegistry service (indexHeader → attachSession → detachSession) so session ownership (canonical cwd) stays consistent with DSH's own semantics
• Rewrites the zstd log header via native node:zlib — zero runtime dependency; directory naming (encodeSegment/projectKey) is kept in lockstep with dsh-session-persistence-jsonl, so session.list never sees a corrupt log
• Client: settings-panel section via ctx.slots (official UI extension pattern), pure-DOM drag-and-drop

Install

dsh plugin --profile web add github:ailiasdesu/dsh-session-migrate#main

Restart DSH, then open Settings → 会话迁移 (Session Migration).

Verification

• 16/16 unit tests against real session copies; plugin_check passes (bundle form); verified on a live DSH instance (list + migrate endpoints)

Repo: https://github.com/ailiasdesu/dsh-session-migrate
Topics: dsh-plugin deepseek-harness dsh

[liyangbing]

这个方向很实用，尤其是把“冷 Session”作为第一版边界，比尝试在线搬迁要靠谱得多。我按当前实现和上游 Workspace/JSONL 契约做了一轮源码审查，建议先明确标为 experimental，并优先补下面几项再让用户迁移不可替代的 Session：

1. 不要依赖 workspaceRegistry.indexHeader：它在当前上游实现中是 private method，不在公开 Workspace 接口里。attachSession 会读取持久化 header，并要求 canonical cwd 与 Workspace path 一致；因此这里需要上游提供公开、版本化的迁移/重索引能力，而不是把内部方法当兼容契约。
2. 目标必须 no-overwrite：当前临时文件 renameSync 到目标位置前没有独占创建/目标冲突门禁。POSIX 与 Windows 的替换行为也不同。应先拒绝已存在的 Session ID/path，并用平台安全的独占 publish 协议。
3. 把它当跨域事务，而不是单文件移动：当前成功路径随后递归删除整个旧 Session 目录，但备份只覆盖 session.jsonl.zstd。即使当前主要落盘对象是 transcript，也应 inventory 并保留未知的 Session-owned companion files，避免未来格式升级时静默丢数据。
4. 避免同步全量解压/重压：对 README 所说约 1.9M events 的 Session，readFileSync + zstdDecompressSync 多次执行会造成无界内存占用并阻塞 Host；同时把 append-oriented frames 重压成单 frame，保住了逻辑行但没有保住物理 framing。最好由官方 persistence layer 提供有界、可恢复的 header transformation。
5. 补齐崩溃一致性：需要 source writer lease/quiescence、文件及父目录 durability、manifest-backed backup，以及 copy/header publish/index/attach/detach/delete 每个边界后的 fault injection。重启后必须收敛到恰好一份可加载的权威副本。
6. 测试目前不可复现：tests/unit.mjs 依赖作者机器上的绝对路径 fixture。建议生成最小、多 frame fixture，并加入 destination collision、并发 writer、大日志 bounded-memory、rollback collision、Windows rename 和 HTTP endpoint authorization 测试。
7. 发布完整源码与许可证文件：现在真正实现位于预编译 lib/，src/index.ts 只是声明 stub；仓库也缺少 GitHub 可识别的顶层 LICENSE，虽然 package/README 声明 BSD-3-Clause。这会影响审计、贡献和分发。

在官方迁移 API 出现前，我会把“fork into a new rooted Session”作为默认安全路径，把本插件定位为只针对可恢复副本的实验工具。

我维护一个 DeepSeek Harness 社区 Handbook（与该插件无隶属关系），也把这轮审查整理成了可复用的迁移验收清单；待发布后会附链接，方便后续实现逐项打勾。

[liyangbing]

补充：上述迁移安全契约已经发布在 Handbook 的 Session groups / storage migration section（v0.5.197）。清单是从当前上游公开 Workspace 契约提炼的，欢迎直接用于 issue/roadmap；如果实现更新，我也会按新证据修订。

[ailiasdesu]

感谢 @liyangbing 的深度审查，全部采纳并在 cf35193 整改：

1. internal method 依赖：已在 README 明确 experimental 标注 + 上游内部方法（workspaceRegistry.indexHeader，@deepseek-ai/dsh-workspace v0.1.1-rc.2）依赖声明；官方公开迁移 API 出现前保持"实验工具"定位（与您的建议一致）。
2. no-overwrite：已完成——迁移与回滚在目标存在同 ID 会话时均拒绝（平台无关，先检后写），并新增 collision 单测。
3. 跨域事务/companion files：备份改为整会话目录复制（session.jsonl.zstd + 任何 session-owned 文件）+ manifest.json（id/srcCwd/targetCwd/at/sourceFile）。
4. 内存/ framing：这点已在此前修复中处理——迁移改为帧级改写（官方 scanZstdFrames 切帧，只重压 header 帧，body 帧字节原样保留，字节级校验），无全量重压；verify 不做任何全量解压（帧字节比较）。
5. 崩溃一致性：已有 quiescence（running 拒绝）+ 整目录备份/manifest + 失败回滚；完整 fault-injection（lease/durability/逐边界收敛）列入 roadmap——同样建议等官方迁移 API 提供持久层级能力后再系统化。
6. 测试可复现：新增合成多帧 fixture（按官方帧格式生成 header+body 两帧、带 checksum，机器无关），碰撞/回滚/字节一致性均入 unit.mjs；真实大文件用例改为可选（存在才跑）。HTTP 端点鉴权说明：仅 127.0.0.1 本机 + body sessionId 必须为 live 会话。
7. LICENSE/源码：顶层 LICENSE（BSD-3-Clause）已补；源码说明写进 README（本包实现为无构建链 ESM，lib/ 即正式源码）。

再次感谢！也期待您的迁移验收清单，后续逐项打勾。

[ailiasdesu]

📦 插件已升级并更名：dsh-session-migrate → dsh-session-manager（完整会话管理：归档/恢复/彻底删除 + 拖拽迁移 + 团队联动 + 过期子代理自动清理）。

• 新仓库：https://github.com/ailiasdesu/dsh-session-manager （旧地址自动重定向）
• 更新 commit：86a6ff5（归档区与迁移列表分离；彻底删除=仅已归档、整目录备份后清理索引）
• 无 API/v0 兼容性破坏（路由同步改为 /session-manager/api）