dsh-session-cloud 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+## 0.1.4（未发布）
+
+适配 dsh 0.1.3-alpha.1（源码版）的两处兼容修复：
+
+### 修复
+
+- **恢复会话弹窗所有会话被误标"版本不兼容"、checkbox 无法勾选**
+  根因：`LOCAL_FORMAT_VERSION` 写死为 `0`，而 dsh 的 `SESSION_FORMAT_VERSION`
+  实际为 `2`（rc.1 与 0.1.3-alpha.1 均如此），导致云端目录里每一行都满足
+  `formatVersion > 0` 而被禁用。
+  修复：常量更正为 `2`；同时恢复目录的兼容基准改为动态取本机会话 header
+  的 `version`（即本机运行时的 `SESSION_FORMAT_VERSION`），上游未来升级
+  格式版本后随本地新会话自适应，仅本地无任何会话时才落到常量兜底。
+
+- **"立即全部同步"成功 0：v1 宿主日志文件名漏了格式代（`vN`）段**
+  根因：dsh 0.1.3-alpha.1 的 jsonl 后端日志文件按格式代命名
+  （`session.v2.jsonl.zstd`），而 persistence-port 仍按 rc.1 旧形态推导
+  `session.jsonl.zstd`，`stat` 必然 ENOENT；该 ENOENT 又被"未物化会话"
+  的静默跳过逻辑吞掉——会话从未上传，引擎却显示全部已同步。
+  修复：
+  - `locateDerived` 按会话 `header.version` 生成当前代文件名
+    （`v0 → session.jsonl`、`vN>0 → session.vN.jsonl`，与 dsh
+    `session-format/filename.ts` 一致），并按"当前代 zstd → v0 旧形态
+    zstd → 当前代明文 → v0 明文"优先级探测；
+  - 引擎 ENOENT 分支不再无条件静默：会话目录中存在 canonical 日志
+    （`session[.vN].jsonl[.zstd]`）而推导路径缺失时按布局失配报错
+    （计入"失败"并展示错误），只有目录中无日志文件（真未物化：v1 后端
+    lock 先建目录、首个 append 才物化日志）才静默记录 revision 跳过。
+
+## 0.1.3
+
+适配 dsh 0.1.3-alpha.1 的 `SessionPersistence` API 收敛：
+
+- 新增 `persistence-port` 双版本兼容层：运行时探测宿主形态，v0（rc.1）
+  透传 `listSnapshots/list/locate`，v1 以 `list()` 作快照枚举并按 jsonl
+  磁盘布局推导落位路径（复刻 `projectKey`/`encodeSegment` 编码）；
+- 引擎对 v1 "已创建未物化" 会话（首个 append 前无日志文件）的 ENOENT
+  静默跳过，不计失败、不进退避。
+
+## 0.1.2
+
+- npm 发布链路与 `dsh plugin add` 安装修复。
+
+## 0.1.1 / 0.1.0
+
+- 初始版本：端到端加密上传、增量同步、云端恢复对话框、路径映射、
+  启动检查等（M1–M4）。

package/lib/sync/engine.js

@@ -6,6 +6,7 @@
  * → meta 覆写 → 推进本地 state。与 cordis 解耦，纯类便于单测。
  */
 import fsp from 'node:fs/promises';
+import path from 'node:path';
 import { LogEncryptor, encryptMeta, verifyTailSegment } from '../crypto/envelope.js';
 import { detectEncoding, emptyFold, foldFrame, scanZstdFrames } from './frames.js';
 import { ProtocolError } from './http-client.js';
@@ -248,7 +249,31 @@ export class SyncEngine {
             await store.putSession(id, state);
             return;
         }
-        const stat = await fsp.stat(location.path);
+        let stat;
+        try {
+            stat = await fsp.stat(location.path);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+            // 区分两种 ENOENT：目录里有 canonical 日志（session[.vN].jsonl[.zstd]）而
+            // locate 指的路径不存在 = 布局推导失配（上游改名/改布局），静默跳过会把
+            // 失配伪装成「已同步」（曾表现为「成功 0」无任何报错），必须抛错暴露；
+            // 目录不存在或只有 session.lock（v1 后端 lock 先建目录、首个 append 才
+            // 物化日志）= 真未物化，记 revision 静默跳过，物化后 revision 变化自然重调度。
+            const dirEntries = await fsp.readdir(path.dirname(location.path)).catch((dirError) => {
+                if (dirError.code === 'ENOENT')
+                    return [];
+                throw dirError;
+            });
+            const hasCanonicalLog = dirEntries.some((name) => /^session(\.v\d+)?\.jsonl(\.zstd)?$/.test(name));
+            if (hasCanonicalLog) {
+                throw new Error(`session log artifact not found at derived path (layout mismatch?): ${location.path}`);
+            }
+            state.localRevision = revision;
+            await store.putSession(id, state);
+            return;
+        }
         if (stat.size < state.uploadedBytes) {
             // 文件变短（防御：正常不可达）——回退全量重传
             Object.assign(state, freshSessionState());

package/lib/sync/persistence-port.js

@@ -8,8 +8,9 @@
  * 消费的 SessionPersistenceLike 端口：
  * - v0（rc.1 及以前）：listSnapshots/list/locate 原样透传；
  * - v1（0.1.3-alpha.1 起）：list() 即快照枚举；落位路径无法再问宿主，
- *   按 jsonl 后端的磁盘布局推导（<root>/<projectKey>/<id>/session.jsonl[.zstd]，
- *   复刻 dsh format.ts 的 projectKey/encodeSegment 编码）。
+ *   按 jsonl 后端的磁盘布局推导（<root>/<projectKey>/<id>/session[.vN].jsonl[.zstd]，
+ *   vN 为会话格式代（v0 无标签），复刻 dsh format.ts 的 projectKey/encodeSegment
+ *   与 session-format filename.ts 的代命名）。
  */
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
@@ -75,13 +76,31 @@ export function sessionDirOf(root, cwd, id) {
     const project = cwd === undefined ? join(root, '_no-cwd') : join(root, projectKeyOf(cwd));
     return join(project, encodeSegmentOf(id));
 }
-/** 推导会话 artifact 位置：zstd 存在优先；仅明文存在则指明文（引擎会标记 skipped-plain）。 */
+/**
+ * 推导会话 artifact 位置：候选按优先级探测——当前代（header.version）zstd →
+ * v0 旧形态 zstd（rc.1 数据 / 代升级残留）→ 当前代明文 → v0 明文；都不存在则
+ * 推导当前代 zstd 路径（调用方按 ENOENT 语义处理未物化会话）。
+ */
 function locateDerived(root, meta) {
     const dir = sessionDirOf(root, meta.cwd, meta.id);
-    const zstd = join(dir, 'session.jsonl.zstd');
-    if (existsSync(zstd) || !existsSync(join(dir, 'session.jsonl')))
-        return { kind: 'jsonl', path: zstd };
-    return { kind: 'jsonl', path: join(dir, 'session.jsonl') };
+    const candidates = [
+        join(dir, `${logBasenameOf(meta.version)}.zstd`),
+        join(dir, 'session.jsonl.zstd'),
+        join(dir, logBasenameOf(meta.version)),
+        join(dir, 'session.jsonl'),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return { kind: 'jsonl', path: candidate };
+    }
+    return { kind: 'jsonl', path: candidates[0] };
+}
+/**
+ * 当前代日志 basename（复刻 dsh session-format filename.ts:14）：
+ * version 0 保持 `session.jsonl`，之后每代带小写 `.vN` 段。
+ */
+function logBasenameOf(version) {
+    return version === 0 ? 'session.jsonl' : `session.v${version}.jsonl`;
 }
 /**
  * 把宿主 sessionPersistence 归一为引擎/恢复消费的端口。

package/lib/sync/restore.d.ts

@@ -1,8 +1,12 @@
 import type { SessionHeaderLike, SessionPersistenceLike } from '../dsh-types.js';
 import type { SyncClient } from './http-client.js';
 import type { StateStore } from './state.js';
-/** 本机支持的会话格式版本（dsh SESSION_FORMAT_VERSION，pre-release 恒为 0）。 */
-export declare const LOCAL_FORMAT_VERSION = 0;
+/**
+ * 本机支持的会话格式版本兜底值（dsh core/session 的 SESSION_FORMAT_VERSION，
+ * rc.1 与 0.1.3-alpha.1 均为 2）。运行时基准优先取本机会话 header 的 version
+ * （见 fetchCatalog），本地无任何会话时才落到此常量。
+ */
+export declare const LOCAL_FORMAT_VERSION = 2;
 /** 恢复目录的一行（Host 计算好解析结果，Client 只负责呈现与改选）。 */
 export interface CatalogEntry {
     sessionId: string;

package/lib/sync/restore.js

@@ -16,8 +16,12 @@ import path from 'node:path';
 import { decryptLog, decryptMeta } from '../crypto/envelope.js';
 import { logKey } from './engine.js';
 import { scanZstdFrames, zstdCompressAsync, zstdDecompressAsync, ZSTD_CHECKSUM_OPTIONS } from './frames.js';
-/** 本机支持的会话格式版本（dsh SESSION_FORMAT_VERSION，pre-release 恒为 0）。 */
-export const LOCAL_FORMAT_VERSION = 0;
+/**
+ * 本机支持的会话格式版本兜底值（dsh core/session 的 SESSION_FORMAT_VERSION，
+ * rc.1 与 0.1.3-alpha.1 均为 2）。运行时基准优先取本机会话 header 的 version
+ * （见 fetchCatalog），本地无任何会话时才落到此常量。
+ */
+export const LOCAL_FORMAT_VERSION = 2;
 // ---- JSON 载荷的编解码（两端各自拼写，不跨半 import；Host 侧编码 + 防御性解码） ----
 export function encodeCatalog(catalog) {
     return JSON.stringify(catalog);
@@ -144,7 +148,11 @@ const META_SUFFIX = '.meta.enc';
 export async function fetchCatalog(deps) {
     const objects = await deps.client.list('sessions/');
     const metaKeys = objects.filter((object) => object.key.endsWith(META_SUFFIX));
-    const localIds = new Set((await deps.persistence.list()).map((header) => header.id));
+    const localHeaders = await deps.persistence.list();
+    const localIds = new Set(localHeaders.map((header) => header.id));
+    // 兼容基准优先取本机会话 header 的 version（即本机运行时的 SESSION_FORMAT_VERSION，
+    // 上游 bump 后随本地新会话自适应）；本地一个会话都没有才落到常量兜底
+    const localFormatVersion = localHeaders.reduce((max, header) => Math.max(max, header.version), LOCAL_FORMAT_VERSION);
     const mappings = deps.state.getGlobal().pathMappings;
     const entries = [];
     for (const object of metaKeys) {
@@ -173,7 +181,7 @@ export async function fetchCatalog(deps) {
             cwd: meta.cwd,
             formatVersion: meta.formatVersion,
             existsLocal,
-            versionIncompatible: meta.formatVersion > LOCAL_FORMAT_VERSION,
+            versionIncompatible: meta.formatVersion > localFormatVersion,
             resolvedCwd: resolution.cwd,
             resolution: resolution.kind,
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-cloud",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "E2E-encrypted cloud mirror plugin for deepseek-harness sessions",
   "type": "module",
   "publishConfig": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "lib",
-    "cordis.patch.yml"
+    "cordis.patch.yml",
+    "CHANGELOG.md"
   ],
   "exports": {
     ".": {