会话拖拽迁移 FurryBear2025/dsh-session-drag-move

dsh-session-drag-move

左侧栏「工作区」面板里，把会话拖到别的工作区——真正改归属，不只是改个名字分组。

官方只支持同一工作区内部拖排序；跨工作区拖拽是完全不响应的（onDrop 只在 drag.accountKey === group.key 时生效，insertSessionBefore 也拒绝不属于本工作区的会话）。
这个插件只接管这段本来就是空的行为，同工作区拖拽照旧交给官方。

它到底做了什么

DSH 里会话的归属是派生的，不是存出来的：

工作区拥有「会话日志 header 的 cwd 等于本工作区路径」的那些会话

~/.dsh/storages/workspace.json 里的 sessionIds 只是顺序账本，path 不匹配的 id 会在下次写入时被剪掉。所以换工作区必须改会话日志 header 里的 cwd。

会话日志是独立 Zstandard 帧的拼接，第一帧就是 header：

<root>/--<projectKey(cwd)>--/<sessionId>/session.v4.jsonl.zstd
└ 项目目录由 cwd 决定 └ 首帧 = header，其后每帧 = 一个追加批次

帧彼此独立，所以移动 = 重新压缩新的第一帧 + 原文件第二个 magic 之后的字节原样复制，事件数据一个字节都不动。写完再自行解压校验一遍，然后把旧目录移到备份区。

最后同步正在运行的进程（否则要重启才生效）：更新 registry 的 header 缓存与 session-path 索引，再走官方的 attachSession / insertSessionBefore / detachSession。
attachSession 会重新读 header 并校验 cwd，它成功就证明存储层改动真的落盘了。

安装

1. 放进 profile 的 node_modules Copy-Item 'E:\dsh插件开发' "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-session-drag-move" -Recurse -Force

2. 在 profile 的 cordis.patch.yml 里加一行
- insert:
- id: session-drag-move
name: 'dsh-session-drag-move'

3. 重启 DSH

也可以用官方命令行：

dsh plugin --profile desktop add dsh-session-drag-move

配置（host 半边）

| 字段 | 默认 | 含义 |
| root | ~/.dsh/sessions | 会话存储根目录 |
| backupRoot | <root>/../session-drag-move-backup | 移动前的会话目录停放处 |
| allowRemote | false | 默认只接受 loopback 请求；局域网部署需显式打开 |

使用

- 拖会话行到另一个工作区的头行 → 归入该工作区（追加到末尾）
- 拖会话行到另一个工作区的某个会话行上半 → 插到它前面；下半 → 插到它后面
- 同工作区内拖拽 → 不拦截，仍是官方排序
- 运行中 / 当前会话会被拒绝

拖拽时源行会变淡，目标行出现蓝色虚线框。松手后底部显示迁移进度条：先按阶段推进（查找目录 → 读取日志 → 重写 cwd → 搬运文件 → 备份 → 同步账本），搬运大量日志世代或分支会话时显示 已处理 n / 总数，完成后变绿并自动消失，失败变红并显示原因。

侧栏适配

客户端按运行时 DOM 契约识别行，而不是按源码里的类名：

| 信号 | 用途 |
| [data-row-key="session:<id>"] | 会话行识别 + 会话 id（主契约） |
| [data-row-key="workspace:<id>"] | 工作区头识别 + 工作区 id（主契约） |
| 类名 *_sessionRow 后缀 | 无 data-row-key 时的兜底 |
| [draggable="true"] / [role="treeitem"] | 最后的形状兜底 |

注意 dsh-better-workspace 等第三方侧栏用 CSS Modules 构建，源码里的可读类名（bw-session-row）在产物中会被哈希成 <hash>_sessionRow，因此按源码类名匹配一定失败；本插件匹配后缀与属性，跨构建稳定。目标工作区由几何位置（该行上方最近的工作区头）判定。
识别失败时会向 console 打印 [sm] 诊断日志（window.__smQuiet = true 可静默）。

迁移进度接口

长迁移在后台作业中执行，避免长时间无响应：

POST /session-drag-move/api/move → { jobId, started: true }
POST /session-drag-move/api/progress → { state, phase, detail, result, error }

move 传 wait: true 时同步返回最终结果（脚本/测试用）。phase 取值： resolve scan index read rewrite write-main move-extras backup ledger branches done；detail 在可量化阶段带 { done, total, current }。

安全边界

- 只重写第一帧；尾部原样复制；写完重新解压自检（id + cwd + 能解出 session header）
- 旧目录移出 sessions 根（留着会被扫到重复 id），停在备份区，可回滚
- 目标文件已存在则整体拒绝，不做半截写入
- 跨区移动前检查会话是否在运行

已知限制

- 依赖 workspaceRegistry 的内部字段（headers / sessionPaths / host.rememberSessionPath）同步运行状态。这些是普通字段不是 #private，能用，但版本敏感——所有访问都做了
- feature-probe，探测不到会返回结构化错误，不会抛栈。
- 侧栏适配跟随 dsh-better-workspace 的 data-row-key 契约，另留了类名/形状兜底。若某个侧栏把这套信号全部换掉，插件会静默不接管（不影响原生拖拽），此时用 ?smdiag=1 或默认的 [sm] 日志定位。
- 投影缓存 ~/.dsh/storages/session_projcache/sessions/<id>.json 里的 record.identity.cwd 目前未改写（可重建缓存，不影响归属）。

开发

$node = "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe"
& $node --test tests\smoke.mjs

测试覆盖路径编码（与本机磁盘目录逐字比对）、header 帧定位与校验、真实会话日志的 cwd 改写 round-trip（含尾部字节完全一致断言）。

许可证

MIT