dsh-workspace-mover 2.3.0 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [2.4.0] - 2026-10-22
+
+### Added
+
+- Agent tools mover_create_workspace (register an existing folder) and mover_rename_workspace (display title only), from PR #7. Duplicate names/folder aliases are rejected. Rename asks for approval unless the calling session has full access.
+- Sidebar edge autoscroll from PR #9, with pointer bounds, scroll limits, drag cancellation and hot-unload cleanup.
+- pluginVersion in status and doctor output.
+
+### Fixed
+
+- Issue #5: also detect opening/closing JSONL writer claims even after the session leaves memory. Unknown handle backends wait safely. Keep header rewrite and relocation synchronous after the final writer check.
+- Fresh-install scans treat only missing storage roots as empty (PR #8); permission and I/O failures remain visible.
+- Optional tools/approval no longer disable the whole plugin. Tools follow host service load/unload; approval requests carry ACP callId. Missing approval or agent context refuses operations requiring confirmation.
+
+- Queue resident sessions until unloading instead of mutating private writer state or frozen live headers; await backend flush before cold migration. Workspace repoint refuses resident writers before changing registry paths.
+- Preserve existing working-directory history and append the destination directory when needed; invalidate the corresponding projection checkpoint. Unsupported sequences are rejected before migration.
+- Restore v3/v4 backup filenames from the official header version; preserve unversioned legacy filenames.
+- Read Portable Bundle pluginVersion from package.json.
+
+### Validation
+
+- Desktop `0.2.1-rc.2`: user accepted candidate `2.4.0-rc.1`; opened-session queueing, continued A2 replies while pending, migration after restart, B1/B2 replies across a second restart, destination working directory and doctor checks passed.
+- Workspace registration, rename rejection/approval, name conflicts, no-op renames and full-access rename passed in Desktop.
+- Windows local gate: 315 tests passed; installed official JSONL/ToolRuntime backend check passed. Sidebar autoscroll is covered by automated DOM checks; the user waived manual autoscroll acceptance.
+- Open sessions finish migration only after their writer is unloaded or DSH is restarted. Switch to another session before restarting so Desktop does not immediately reopen the pending session.
+
 ## [2.3.0] - 2026-10-13
 
 ### Added

package/README.md

@@ -1,5 +1,9 @@
 # dsh-workspace-mover
 
+
+当前版本：2.4.0。[Desktop 验收记录](docs/compatibility/issue-5-desktop-acceptance-2026-10-22.md)。
+
+当前待发布修复：运行中或仍驻留内存的会话会进入等待队列。DSH 暂无安全的写入句柄重绑定接口，因此驻留会话需要卸载或重启后才能迁移，单纯变为空闲并不足够。迁移会同步会话的当前工作目录到目标工作区；已有目录变更历史会保留，并追加一条目录变更记录。详见[验证记录与检验方法](docs/compatibility/dsh-0.2.1-rc.2-2026-10-18.md)。
 > [!IMPORTANT]
 > 非官方项目，由社区成员独立开发和维护。
 
@@ -61,10 +65,10 @@ DeepSeek Harness 侧边栏可以拖拽排序**同一工作区**内的会话，
 - **🛡️ 数据保护**：相同会话内容只保留一份物理快照，往返迁移不会无限增长；每次迁移仍写入历史，备份列表显示快照份数与占用
 - **⏪ 移动历史与撤回**：记录最近 100 次跨工作区移动，批量聚合为一条，整批可一键撤回
 - **🧾 迁移任务中心**：批量迁移逐项持久化记录（完成/失败、最后错误与尝试时间），失败项一键重试——按会话当前位置重新迁移，不用陈旧路径
-- **⏳ 忙碌会话自动排队**：运行中的会话不会触碰文件，空闲后自动重试；队列持久化，支持单项取消、单项重试和批量重试失败项
+- **⏳ 忙碌会话自动排队**：运行中或写入句柄未释放的会话不会触碰文件，卸载或重启后自动重试；队列持久化，支持单项取消、单项重试和批量重试失败项
 - **🔎 迁移预览**：确认前展示来源、目标路径、冲突、运行状态、适配器和本次预计新增备份大小；已有内容快照会明确显示复用
 - **📂 空分组清理 / 打开文件夹**：只列出真正零成员的工作区；组菜单可直达系统文件管理器
-- **🤖 Agent 工具**：`mover_list_sessions` / `mover_move_session` / `mover_repair_sessions` / `mover_doctor` 四个模型可调用工具——在对话里说「把这个会话挪到某组」即可触发与面板完全相同的备份回滚管线；迁移与修复执行前经宿主审批弹窗确认，未装 dsh-tools 的宿主自动停用
+- **🤖 Agent 工具**：`mover_list_sessions` / `mover_move_session` / `mover_repair_sessions` / `mover_doctor` / `mover_create_workspace` / `mover_rename_workspace` 六个模型可调用工具——在对话里说「把这个会话挪到某组」即可触发与面板完全相同的备份回滚管线，也能新建、改名工作区；迁移、修复与改名执行前经宿主审批弹窗确认（改名在完全访问模式下免确认），未装 dsh-tools 的宿主自动停用
 
 ## 🚀 安装
 
@@ -176,10 +180,14 @@ dsh plugin --profile web add "link:C:/path/to/dsh-workspace-mover"
 
 ### 对话里迁移（Agent 工具）
 
-1. 装有 `dsh-tools` 的宿主（web 与桌面版默认）自动注册四个模型工具：清单与会话清单（只读）、迁移、一键修复、自检（只读）；
-2. 在对话里说「列出我的会话」「把会话 X 挪到 Y 组」「跑一次修复」「自检一下」——模型先用清单工具把名字解析成精确 id，再执行动作；
+需要审批的工具在审批服务缺失时会拒绝执行，可改用设置中的会话修复面板。
+
+1. 装有 `dsh-tools` 的宿主（web 与桌面版默认）自动注册六个模型工具：会话清单（只读）、迁移、一键修复、自检（只读）、新建工作区、工作区改名；
+2. 在对话里说「列出我的会话」「把会话 X 挪到 Y 组」「跑一次修复」「自检一下」「用文件夹 /路径 新建一个叫 Z 的工作区」「把 Y 组改名为 Z」——模型先用清单工具把名字解析成精确 id，再执行动作；
 3. 迁移与修复在动手前经宿主审批弹窗请你确认（与面板确认同级）；拒绝或关闭弹窗则不执行；两个只读工具（清单 / 自检）不弹确认；
-4. 宿主没有 `dsh-tools` 时自动停用，不影响面板与拖拽。
+4. **新建工作区**：把一个已存在的文件夹登记为新分组；该文件夹（含指向它的符号链接）或该名称已被其他工作区使用时拒绝，不会在磁盘上创建文件夹，不弹确认；
+5. **工作区改名**：只改显示名，执行前弹窗确认；会话处于**完全访问**（`danger-full-access`）时免确认；与其他工作区重名时拒绝；
+6. 宿主没有 `dsh-tools` 时自动停用，不影响面板与拖拽。
 
 ### 批量迁移
 
@@ -228,6 +236,7 @@ dsh plugin --profile web add "link:C:/path/to/dsh-workspace-mover"
 
 | 插件版本 | 已验证 DeepSeek Harness | Node | 备注 |
 |----------|-------------------------|------|------|
+| 2.4.0 | `0.2.1-rc.2` Desktop | `≥22` | 用户确认排队、迁移前后继续发送、两次重启、目标工作目录和工作区工具审批；自动滚动仅自动检查 |
 | 2.3.0 | `0.2.0-rc.2` Desktop（用户验证部分场景） | `≥22` | 空闲会话迁移与快照复用已反馈通过；Web、队列进程重启和完整 runtime smoke 待验证 |
 | 2.2.0 | `0.1.5-rc.1`、`0.1.5-rc.2`、**`0.2.0 桌面版`**（0.2.0-rc.2 内核） | `≥22` | 存储布局自检、Agent 工具与桌面版实测；宿主缺 `dsh-tools` 时工具自动停用 |
 | 2.0.3 | `0.1.5-rc.1`、`0.1.5-rc.2` | `≥22` | 真迁移 / 批量 / 救援 / 回收站 / 备份；首次发布 npm |

package/README_EN.md

@@ -1,5 +1,7 @@
 # dsh-workspace-mover
 
+
+Running or resident sessions wait in the durable queue. Idle alone does not release a backend writer; unload the session or restart DSH before migration. Migration sets the current working directory to the target workspace, preserving existing directory-change events and appending a final change when needed. See the [validation record](docs/compatibility/dsh-0.2.1-rc.2-2026-10-18.md).
 > [!IMPORTANT]
 > Unofficial project, independently developed and maintained by community members.
 
@@ -65,7 +67,7 @@ DeepSeek Harness's sidebar supports drag-to-reorder **within** a workspace, but
 - **⏳ Busy-session queue**: running sessions are never touched; queued work is persistent, with per-item cancel/retry and batch retry for failed items
 - **🔎 Migration preview**: before confirmation, show source, target path, collisions, running state, adapter mode, and estimated new backup bytes; reuse is called out when a matching snapshot already exists
 - **📂 Empty-group cleanup / open folder**: only truly empty workspaces are listed; open a group directory in your file manager
-- **🤖 Agent tools**: four model-callable tools — `mover_list_sessions` / `mover_move_session` / `mover_repair_sessions` / `mover_doctor` — so "move this session to group X" in the conversation runs the same backup-first pipeline as the panel; mutating tools ask for user approval first, and hosts without `dsh-tools` skip them automatically
+- **🤖 Agent tools**: six model-callable tools — `mover_list_sessions` / `mover_move_session` / `mover_repair_sessions` / `mover_doctor` / `mover_create_workspace` / `mover_rename_workspace` — so "move this session to group X" in the conversation runs the same backup-first pipeline as the panel, and workspaces can be created and renamed too; move, repair and rename ask for user approval first (rename skips it under full access), and hosts without `dsh-tools` skip them automatically
 
 ## 🚀 Install
 
@@ -177,10 +179,14 @@ Mid-turn sessions are rejected; failed moves roll back automatically.
 
 ### Conversational moves (agent tools)
 
-1. Hosts with `dsh-tools` (web and desktop by default) register four model tools: listing and doctor (both read-only), move, and one-click repair;
-2. Say "list my sessions", "move session X to group Y", "run a repair", or "run a self-check" — the model resolves names into exact ids with the listing tool first, then acts;
-3. Mutating tools raise a host approval prompt before acting (same level as the panel confirm); dismissing or denying means nothing happens; the two read-only tools never prompt;
-4. Hosts without `dsh-tools` skip the tools automatically — the panel and drag flows are unaffected.
+Operations requiring approval are refused when the approval service is absent; use the rescue panel in settings instead.
+
+1. Hosts with `dsh-tools` (web and desktop by default) register six model tools: listing and doctor (both read-only), move, one-click repair, create workspace, and rename workspace;
+2. Say "list my sessions", "move session X to group Y", "run a repair", "run a self-check", "create a workspace called Z for folder /path", or "rename group Y to Z" — the model resolves names into exact ids with the listing tool first, then acts;
+3. Move and repair tools raise a host approval prompt before acting (same level as the panel confirm); dismissing or denying means nothing happens; the two read-only tools never prompt;
+4. **Create workspace** registers an existing folder under a new name. It is refused if another workspace already uses that folder (including a symlink to it) or that name, and it never creates folders on disk. It does not ask for approval;
+5. **Rename workspace** changes only the display name and asks for approval first. Sessions with **full access** (`danger-full-access`) rename without asking. A name another workspace already uses is refused;
+6. Hosts without `dsh-tools` skip the tools automatically — the panel and drag flows are unaffected.
 
 ### Bulk move
 
@@ -231,6 +237,7 @@ Recovery snapshots are separate from primary archives. A reused snapshot retains
 
 | Plugin version | Verified DeepSeek Harness | Node | Notes |
 |----------------|---------------------------|------|-------|
+| 2.4.0 | `0.2.1-rc.2` Desktop | `≥22` | User accepted queueing, continued replies, two restarts, target cwd and workspace-tool approval; autoscroll automated checks only |
 | 2.3.0 | `0.2.0-rc.2` Desktop (partial user verification) | `≥22` | Idle migration and snapshot reuse confirmed; Web, queue process restart, and full runtime smoke pending |
 | 2.2.0 | `0.1.5-rc.1`, `0.1.5-rc.2`, **`0.2.0 desktop`** (0.2.0-rc.2 core) | `≥22` | Storage-layout check; Agent tools + desktop verified; tools auto-skip on hosts without `dsh-tools` |
 | 2.0.3 | `0.1.5-rc.1`, `0.1.5-rc.2` | `≥22` | True move / bulk / rescue / recycle bin / backups; first npm publish |

package/client/client.js

@@ -174,15 +174,15 @@ window.__ModuleLoader__.load({
 				tasksCaption: "迁移任务",
 				tasksHelp: "批量迁移的持久化记录：完成 / 失败逐项可查。失败项可一键重试——按会话当前位置重新迁移，不会用记录里的旧路径；清除记录不影响已迁移的会话。",
 				queueCaption: "等待迁移",
-				queueHelp: "运行中的会话不会触碰文件；会话空闲后自动尝试，失败项可以重试或取消。",
+				queueHelp: "运行中或仍驻留内存的会话暂不移动。停止生成后，若仍驻留，需等待会话卸载或重启；队列随后自动重试，失败项可重试或取消。",
 				queueRetryBtn: "重试",
 				queueRetryAllBtn: "重试全部失败项",
 				queueCancelBtn: "取消",
 				queueRetryDone: "✓ 已重新尝试迁移",
 				queueRetryAllDone: "✓ 已逐项重试 {n} 个失败任务",
 				queueCancelled: "✓ 已取消迁移任务",
-				queuedMove: "已排队：会话空闲后自动迁移",
-				batchQueuedTail: "；{n} 个会话已排队等待空闲",
+				queuedMove: "已排队：等待会话停止运行并释放驻留写入句柄；可能需要重启 DSH",
+				batchQueuedTail: "；{n} 个会话已排队等待安全迁移",
 				previewStatus: "预览状态",
 				previewSource: "来源",
 				previewTarget: "目标路径",
@@ -203,7 +203,7 @@ window.__ModuleLoader__.load({
 				forkHint: "默认只迁移当前会话；选择后代分支会逐项迁移并独立记录结果。",
 				previewWarning: "提示",
 				previewSafe: "可安全移动",
-				previewQueued: "会进入空闲队列",
+				previewQueued: "会进入迁移等待队列（可能需重启）",
 				previewBlocked: "当前不可移动",
 				previewWarningState: "需要确认",
 				taskRetryBtn: "重试失败项",
@@ -374,15 +374,15 @@ window.__ModuleLoader__.load({
 				tasksCaption: "Move tasks",
 				tasksHelp: "Persistent records of bulk moves: every done / failed item is inspectable. Failed items can be retried in one click — retried from where each session currently lives, never from a stale recorded path; clearing a record never touches moved sessions.",
 				queueCaption: "Waiting migrations",
-				queueHelp: "Running sessions are never touched. The migration is retried automatically after the session becomes idle; failed items can be retried or cancelled.",
+				queueHelp: "Running or resident sessions wait. Once generation stops, a resident writer still needs session unloading or a DSH restart. The queue then retries automatically; failed items can be retried or cancelled.",
 				queueRetryBtn: "Retry",
 				queueRetryAllBtn: "Retry all failed",
 				queueCancelBtn: "Cancel",
 				queueRetryDone: "✓ Migration retried",
 				queueRetryAllDone: "✓ Retried {n} failed migration(s) independently",
 				queueCancelled: "✓ Migration cancelled",
-				queuedMove: "Queued: it will move automatically when the session is idle",
-				batchQueuedTail: "; {n} session(s) queued until idle",
+				queuedMove: "Queued: waiting for idle and writer release; a DSH restart may be required",
+				batchQueuedTail: "; {n} session(s) queued for safe migration",
 				previewStatus: "Preview status",
 				previewSource: "Source",
 				previewTarget: "Target path",
@@ -403,7 +403,7 @@ window.__ModuleLoader__.load({
 				forkHint: "Only the current session moves by default. Descendants are migrated independently and reported one by one.",
 				previewWarning: "Note",
 				previewSafe: "Safe to move",
-				previewQueued: "Will wait until idle",
+				previewQueued: "Will enter migration queue (restart may be required)",
 				previewBlocked: "Cannot move now",
 				previewWarningState: "Review before moving",
 				taskRetryBtn: "Retry failed",
@@ -752,6 +752,9 @@ window.__ModuleLoader__.load({
 					function renderPreview(plan) {
 						preview = plan;
 						if (!preview) return;
+						if (!batchCount && typeof preview.title === 'string' && preview.title.trim()) {
+							overlay.querySelector('.wsm-session').textContent = preview.title;
+						}
 						const statusLabels = {
 							safe: t("previewSafe"),
 							queued: t("previewQueued"),
@@ -901,8 +904,15 @@ window.__ModuleLoader__.load({
 		}
 
 		function rowTitle(row, sessionId) {
-			const text = row?.textContent?.replace(/\s+/g, " ").trim();
-			return text && text !== sessionId ? text : t("unnamedSession");
+			// Whole-row text also contains relative timestamps and status labels.
+			try {
+				const key = Object.getOwnPropertyNames(row ?? {}).find((name) => name.startsWith('__reactFiber$'));
+				for (let fiber = key ? row[key] : null; fiber; fiber = fiber.return) {
+					const node = fiber.memoizedProps?.node;
+					if (node && String(node.id) === String(sessionId) && typeof node.title === 'string' && node.title.trim()) return node.title.trim();
+				}
+			} catch { /* authoritative preview can supply the title */ }
+			return '';
 		}
 
 		function fmtBytes(n) {
@@ -986,7 +996,7 @@ window.__ModuleLoader__.load({
 				try {
 					const value = await call("mover.doctor");
 					setDoctor(value);
-					setNote(t("doctorSummary", value.summary));
+					setNote(`${t("doctorSummary", value.summary)}${value.pluginVersion ? ` · v${value.pluginVersion}` : ""}`);
 				} catch (err) {
 					setNote(t("failed", { msg: errMsg(err) }));
 				} finally {
@@ -1862,12 +1872,57 @@ window.__ModuleLoader__.load({
 			};
 			let dragging = null; // {el, els, id, target} —— id/target 在 drop 阶段解析
 			let wsCache = null; // {items, at}
+			// —— drag autoscroll：工作区列表长时，拖到视口外的目标工作区，指针靠近滚动容器边缘即持续滚动 ——
+			let autoscrollRaf = null;
+			let autoscrollState = null; // { scroller, clientX, clientY }
+			/** 从 el 向上找最近的可纵向滚动的祖先（侧栏滚动区），不依赖具体 class，与行定位的 ARIA 策略一致。 */
+			function findScrollableAncestor(el) {
+				let node = el && el.parentElement;
+				while (node) {
+					try {
+						const oy = getComputedStyle(node).overflowY;
+						if ((oy === "auto" || oy === "scroll") && node.scrollHeight > node.clientHeight + 1) return node;
+					} catch { /* getComputedStyle 不可用时跳过 */ }
+					node = node.parentElement;
+				}
+				return null;
+			}
+			/** 停止 autoscroll raf 并清空状态。 */
+			function stopAutoscroll() {
+				if (autoscrollRaf !== null) { cancelAnimationFrame(autoscrollRaf); autoscrollRaf = null; }
+				autoscrollState = null;
+			}
+			/** 每次 dragover 调用：更新指针 Y + 滚动容器；靠近边缘则 raf 持续滚动，离开边缘则停。 */
+			function startAutoscroll(scroller, clientX, clientY) {
+				if (!scroller || !Number.isFinite(clientX) || !Number.isFinite(clientY)) return stopAutoscroll();
+				autoscrollState = { scroller, clientX, clientY };
+				if (autoscrollRaf !== null) return; // 已在跑：tick 读最新 autoscrollState
+				const tick = () => {
+					autoscrollRaf = null;
+					if (!dragging || !autoscrollState || !autoscrollState.scroller.isConnected) { stopAutoscroll(); return; }
+					const sc = autoscrollState.scroller;
+					const r = sc.getBoundingClientRect();
+					const { clientX: x, clientY: y } = autoscrollState;
+					if (x < r.left || x > r.right || y < r.top || y > r.bottom) return stopAutoscroll();
+					const EDGE = Math.min(64, (r.bottom - r.top) / 3), STEP = 12;
+					let delta = 0;
+					if (y < r.top + EDGE) delta = -STEP;
+					else if (y > r.bottom - EDGE) delta = STEP;
+					if (!delta) return stopAutoscroll();
+					const previous = sc.scrollTop;
+					sc.scrollTop = Math.max(0, Math.min(sc.scrollHeight - sc.clientHeight, previous + delta));
+					if (sc.scrollTop === previous) return stopAutoscroll();
+					autoscrollRaf = requestAnimationFrame(tick);
+				};
+				autoscrollRaf = requestAnimationFrame(tick);
+			}
 
 			// 统一登记本插件挂到 document / window 上的监听器与 observer。
 			// 必须成对释放：桌面版热重载会废弃旧 fiber 并重新装载客户端半，
 			// 不释放就会叠加第二份监听器——重复确认框、重复 RPC，
 			// 两份闭包还会互相擦掉对方的多选高亮。
 			const disposers = [];
+			disposers.push(stopAutoscroll);
 			const listen = (type, fn, options) => {
 				document.addEventListener(type, fn, options);
 				disposers.push(() => document.removeEventListener(type, fn, options));
@@ -2195,6 +2250,8 @@ window.__ModuleLoader__.load({
 			listen("dragover", (e) => {
 				clearHints();
 				if (!dragging) return;
+				// autoscroll：指针靠近侧栏滚动容器上下边缘时持续滚动，让远处目标工作区进入视口
+				startAutoscroll(findScrollableAncestor(dragging.el), e.clientX, e.clientY);
 				const header = headerRow(e.target);
 				if (!header || isUngroupedHeader(header)) { dragging.target = null; return; }
 				e.preventDefault(); // 允许在此投放（没有它 drop 根本不会触发）
@@ -2212,6 +2269,7 @@ window.__ModuleLoader__.load({
 			listen("drop", async (e) => {
 				const current = dragging;
 				dragging = null;
+				stopAutoscroll();
 				clearHints();
 				if (!current) return;
 				const header = headerRow(e.target);
@@ -2270,7 +2328,7 @@ window.__ModuleLoader__.load({
 						if (el === current.el) continue; // 拖起行用 dataTransfer 的权威 id
 						try {
 							const id = await resolveRowId(el);
-							if (id) push(id, rowTitle(el, ""));
+							if (id) push(id, rowTitle(el, id));
 							else unresolvedCount += 1;
 						} catch { unresolvedCount += 1; }
 					}
@@ -2290,11 +2348,15 @@ window.__ModuleLoader__.load({
 
 				// ---- 单选：原有确认与 mover.move 路径 ----
 				if (sessions.length === 1) {
-					const { sessionId, sessionTitle } = sessions[0];
+					const { sessionId } = sessions[0];
+					let sessionTitle = sessions[0].sessionTitle;
 					let preview = null;
 					try {
 						const res = await rpcCall("mover.preview", { sessionId, targetWorkspaceId: workspace.workspaceId });
-						if (res?.ok) preview = res.value;
+						if (res?.ok) {
+							preview = res.value;
+							if (typeof preview?.title === 'string' && preview.title.trim()) sessionTitle = preview.title;
+						}
 					} catch (err) {
 						console.debug("[workspace-mover] preview unavailable:", err?.message ?? err);
 					}
@@ -2377,7 +2439,10 @@ window.__ModuleLoader__.load({
 				}
 			}, true);
 
-			listen("dragend", () => { dragging = null; clearHints(); });
+			listen("dragend", () => { dragging = null; stopAutoscroll(); clearHints(); });
+			listen("dragleave", (e) => {
+				if (autoscrollState && !autoscrollState.scroller.contains(e.relatedTarget)) stopAutoscroll();
+			});
 
 			// 整组迁移 + 分组合并：入口在官方组标题的「⋯」菜单（注入「整组迁移…」项）。
 			// 不再拦截浏览器右键——官方菜单同样在右键/⋯按钮打开，拦截会与之冲突。