dsh-session-cloud 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.1.7
+
+### 修复
+
+- **恢复成功后侧边栏出现工作区但会话列表为空，需刷新页面才显示**
+  根因：恢复只写了会话文件、更新了 workspace 成员关系，但 web 会话列表
+  （`useSessions` 的 `list.byId`）靠 Host 的 `api-session/added` 事件增量
+  更新；插件没有发这个事件，所以新会话要等刷新页面触发全量 `list()` 才
+  出现（工作区行与会员行是两个独立通道）。
+  修复：恢复落位成功后 emit `api-session/added`（携带 sessionId / 有效
+  cwd / running / blank 等列表所需字段），侧边栏立即出现新会话，无需刷新。
+
+- **跨机恢复把会话误判「本地已存在」、无法重新落位**
+  根因：`existsLocal` 只看「本地持久化里有没有这个 session id」。旧版
+  相对路径 bug 把会话写到了错误 cwd，文件在盘上却没挂到工作区，于是被
+  判「本地已存在」且恢复弹窗禁用勾选，会话卡死无法归位。
+  修复：
+  - `existsLocal` 收紧为「本地有文件 **且** 已挂载到工作区」（以
+    `workspaceRegistry.list()` 的 `sessionIds` 并集判定）；无工作区注册表
+    的环境退回旧语义，不回归 headless 场景；
+  - 重新恢复落位后清理同 id 残留在其它 cwd 的旧副本，避免同 id 出现两份
+    （一份在工作区、一份在未分组）。
+
 ## 0.1.6
 
 ### 修复

package/lib/dsh-types.d.ts

@@ -33,9 +33,28 @@ export interface SessionPersistenceLike {
 /** @deepseek-ai/dsh-workspace 的 Workspace（恢复挂载用到 attachSession）。 */
 export interface WorkspaceLike {
     readonly path: string;
+    /**
+     * 过滤后的成员账号：只有 cwd realpath 等于本工作区 path 的会话才在此
+     * （dsh 侧同步过滤缺失/无效 cwd）。恢复目录据此判定「本地已存在」。
+     */
+    readonly sessionIds: readonly string[];
     /** 把会话记入本工作区成员（cwd 校验：realpath 后须等于工作区 path） */
     attachSession(sessionId: string): Promise<void>;
 }
+/**
+ * `api-session/added` 事件的载荷（Host 恢复成功后 emit，供 web 侧边栏的
+ * `useSessions` 列表增量插入恢复的会话；字段与 dsh 的 SessionSummary 对齐，
+ * 仅覆盖恢复链路需要的子集）。
+ */
+export interface SessionSummaryLike {
+    readonly sessionId: string;
+    readonly updatedAt: number;
+    readonly running: boolean;
+    readonly blank: boolean;
+    readonly parentSessionId?: string;
+    readonly origin?: 'subagent';
+    readonly cwd?: string;
+}
 export interface WorkspaceRegistryLike {
     list(): WorkspaceLike[];
     /** 按本机 canonical path 查找已有 workspace；不存在返回 undefined */
@@ -70,5 +89,7 @@ declare module '@deepseek-ai/cordis' {
         'session/flush'(session: {
             id: string;
         }): void;
+        /** 恢复会话后回发，让 web 会话列表无需刷新页面即可出现新会话。 */
+        'api-session/added'(summary: SessionSummaryLike): void;
     }
 }

package/lib/index.js

@@ -155,6 +155,16 @@ export async function apply(ctx, config) {
     function workspacePaths() {
         return ctx.get('workspaceRegistry')?.list().map((workspace) => workspace.path) ?? [];
     }
+    /**
+     * 本机已正确挂载到工作区的会话 id 并集；无 workspaceRegistry 时返回
+     * undefined（fetchCatalog 退回旧 existsLocal 语义）。
+     */
+    function attachedSessionIds() {
+        const registry = ctx.get('workspaceRegistry');
+        if (!registry)
+            return undefined;
+        return [...new Set(registry.list().flatMap((workspace) => [...workspace.sessionIds]))];
+    }
     /** 构造恢复链路的 deps；配置不全返回 undefined（调用方回写 unconfigured 回显）。 */
     async function catalogDeps() {
         const cfg = current();
@@ -168,6 +178,7 @@ export async function apply(ctx, config) {
             persistence: persistencePort(),
             state: stateStore,
             workspacePaths: workspacePaths(),
+            attachedSessionIds: attachedSessionIds(),
             // 恢复落位后的 workspace 挂载（web 侧边栏可见性）。复刻 dsh 自己创建会话的
             // 路径（session-controller commands.ts）：resolveByPath 复用已有工作区，
             // 无则 create（registry 自带 realpath + isDirectory 校验），再 attachSession。
@@ -181,6 +192,11 @@ export async function apply(ctx, config) {
                     await workspace.attachSession(sessionId);
                 })();
             },
+            // 恢复成功后的会话列表增量：web 侧边栏 useSessions 靠 api-session/added
+            // 事件插入新会话，否则只写文件要到刷新页面（全量 list()）才可见
+            onRestored: (summary) => {
+                ctx.emit('api-session/added', summary);
+            },
             onWarn: (message) => logger.warn(message),
         };
     }

package/lib/sync/restore.d.ts

@@ -1,4 +1,4 @@
-import type { SessionHeaderLike, SessionPersistenceLike } from '../dsh-types.js';
+import type { SessionHeaderLike, SessionPersistenceLike, SessionSummaryLike } from '../dsh-types.js';
 import type { SyncClient } from './http-client.js';
 import type { StateStore } from './state.js';
 /**
@@ -103,6 +103,12 @@ export interface CatalogDeps {
     state: StateStore;
     /** 本机工作区 canonical path 列表（workspaceRegistry 缺失时传空数组） */
     workspacePaths: string[];
+    /**
+     * 本机已正确挂载到工作区的会话 id 并集（workspaceRegistry.list() 的
+     * sessionIds）。缺省（undefined，即无 workspaceRegistry 环境）时退回旧
+     * 语义：仅按「会话 id 在本地持久化中存在」判 existsLocal。
+     */
+    attachedSessionIds?: readonly string[];
     /** 单个 meta 解密失败时回调（口令不匹配的兜底呈现走状态行，不打断目录） */
     onWarn?: (message: string) => void;
 }
@@ -121,6 +127,11 @@ export interface RestoreDeps {
      * 实现负责 resolveByPath/create/attachSession；缺省跳过（无 workspaceRegistry 环境）。
      */
     attachWorkspace?: (sessionId: string, cwd: string) => Promise<void>;
+    /**
+     * 单条恢复成功后回发（Host 据此 emit api-session/added，让 web 会话列表
+     * 增量出现新会话，无需刷新页面）。仅在文件落位成功后调用，挂载失败也会调用。
+     */
+    onRestored?: (summary: SessionSummaryLike) => void;
     onWarn?: (message: string) => void;
 }
 /**

package/lib/sync/restore.js

@@ -151,6 +151,11 @@ export async function fetchCatalog(deps) {
     const metaKeys = objects.filter((object) => object.key.endsWith(META_SUFFIX));
     const localHeaders = await deps.persistence.list();
     const localIds = new Set(localHeaders.map((header) => header.id));
+    // 已挂载工作区的会话 id：existsLocal 只有同时命中「本机有文件」且「已挂载到
+    // 工作区」才算本地已存在——残留在错误 cwd（旧版相对路径 bug）的会话文件仍可恢复。
+    const attachedIds = deps.attachedSessionIds === undefined
+        ? undefined
+        : new Set(deps.attachedSessionIds);
     // 兼容基准优先取本机会话 header 的 version（即本机运行时的 SESSION_FORMAT_VERSION，
     // 上游 bump 后随本地新会话自适应）；本地一个会话都没有才落到常量兜底
     const localFormatVersion = localHeaders.reduce((max, header) => Math.max(max, header.version), LOCAL_FORMAT_VERSION);
@@ -169,7 +174,7 @@ export async function fetchCatalog(deps) {
             deps.onWarn?.(`meta 解密失败，跳过 ${object.key}：${String(error)}`);
             continue;
         }
-        const existsLocal = localIds.has(sessionId);
+        const existsLocal = localIds.has(sessionId) && (attachedIds === undefined || attachedIds.has(sessionId));
         const resolution = existsLocal || meta.cwd === ''
             ? { kind: 'none', cwd: null }
             : resolveTargetCwd(meta.cwd, mappings, deps.workspacePaths);
@@ -255,11 +260,14 @@ async function restoreOne(deps, item) {
     const tmp = `${location.path}.tmp-${process.pid}`;
     await fsp.writeFile(tmp, plaintext);
     await fsp.rename(tmp, location.path);
+    const effectiveCwd = locatedHeader.cwd ?? '';
+    // 清理同 id 的陈旧本地副本（旧版相对路径 bug 落错 cwd 的残留）：新文件已就位，
+    // 只删 cwd 不同且落位路径不同的副本，避免恢复后同 id 出现两份。
+    await removeStaleLocalCopies(deps, item.sessionId, effectiveCwd, location.path);
     // workspace 挂载（web 侧边栏按成员关系分组）。目录存在的落位 cwd 才尝试挂载：
     // 原样落位到本机不存在的来源路径时按 §4.3 语义保持「未分组」，不算失败。
     // 挂载失败仅告警不回滚——文件已就位，会话至少出现在「未分组」桶，重试 attach
     // 也没有意义（同 cwd 再挂靠 registry 幂等，但失败原因通常是目录状态异常）
-    const effectiveCwd = locatedHeader.cwd ?? '';
     if (deps.attachWorkspace && effectiveCwd !== '' && await isExistingDirectory(effectiveCwd)) {
         try {
             await deps.attachWorkspace(item.sessionId, effectiveCwd);
@@ -268,6 +276,17 @@ async function restoreOne(deps, item) {
             deps.onWarn?.(`workspace 挂载失败 ${item.sessionId}（会话已落位，将出现在未分组）：${String(error)}`);
         }
     }
+    // 通知 Host 回发 api-session/added：web 侧边栏的会话列表靠该事件增量更新，
+    // 只写文件不会让新会话在刷新前出现（workspace 成员关系与会话行是两个通道）。
+    deps.onRestored?.({
+        sessionId: item.sessionId,
+        updatedAt: Date.now(),
+        running: false,
+        blank: false,
+        ...(effectiveCwd === '' ? {} : { cwd: effectiveCwd }),
+        ...(header.parentSession === undefined ? {} : { parentSessionId: header.parentSession }),
+        ...(header.origin === undefined ? {} : { origin: header.origin }),
+    });
     return location.path;
 }
 async function isExistingDirectory(target) {
@@ -278,6 +297,26 @@ async function isExistingDirectory(target) {
         return false;
     }
 }
+/**
+ * 删除同 id、但落在其它 cwd 的陈旧本地副本（旧版相对路径 bug 落错位置后
+ * 再恢复会残留）。仅在新的正确落位文件写盘后调用：只删 cwd 与 keepCwd 不同、
+ * 且落位路径与 keepPath 不同的副本，绝不触碰刚写的文件。删除失败静默——残留
+ * 副本顶多出现在「未分组」，不影响本次恢复结果。
+ */
+async function removeStaleLocalCopies(deps, sessionId, keepCwd, keepPath) {
+    const locals = await deps.persistence.list();
+    for (const header of locals) {
+        if (header.id !== sessionId)
+            continue;
+        if ((header.cwd ?? '') === keepCwd)
+            continue;
+        const stale = deps.persistence.locate(header);
+        if (!stale || stale.path === keepPath)
+            continue;
+        await fsp.rm(stale.path, { force: true }).catch(() => { });
+        await fsp.rmdir(path.dirname(stale.path)).catch(() => { });
+    }
+}
 /**
  * 规范化用户改选的落位路径（§4.3）：`~` 展开到本机 home，相对路径按本机
  * home 解析（跨机恢复最常见的心智模型——「home 下的 my-app」在两台

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-cloud",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "E2E-encrypted cloud mirror plugin for deepseek-harness sessions",
   "type": "module",
   "publishConfig": {