dsh-session-cloud 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog
+
+## 0.1.5
+
+### 修复
+
+- **状态自愈：曾被「ENOENT 静默跳过」污染的会话恢复上传**
+  根因：旧版把 locate 失败的会话按「未物化」静默记录 `localRevision` 却
+  从未上传过一个字节，`needsSync` 因此永远判定「已同步」——即使修复了
+  文件名推导，这些会话也不会重新进同步队列（表现为「成功 0」且无报错）。
+  修复：
+  - `needsSync` 自愈判定：`uploadedBytes === 0` 且无恢复抑制标记的条目
+    一律视为待同步，被污染的会话自动重新上传，无需手工清理 state；
+  - `markRestoredSynced` 写入 `restoredAt` 标记区分「恢复落位待续写」
+    的合法抑制条目，自愈判定不误伤（恢复后未续写不回传）。
+
+## 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';
@@ -96,6 +97,11 @@ export class SyncEngine {
             this.backoff.delete(snapshot.header.id);
             return true;
         }
+        // 自愈：从未上传过任何字节、又不是恢复抑制（restoredAt）的条目，其
+        // localRevision 记录不可信——历史上被「ENOENT 静默跳过」污染过的会话
+        // 曾因此永远卡在「已同步」假象里。一律视为待同步，宁可重试不可漏传。
+        if (state !== undefined && state.uploadedBytes === 0 && !state.restoredAt)
+            return true;
         if (state?.localRevision === snapshot.revision && wait === undefined)
             return false;
         return true;
@@ -255,9 +261,20 @@ export class SyncEngine {
         catch (error) {
             if (error.code !== 'ENOENT')
                 throw error;
-            // v1 宿主 list() 含「已创建未物化」的会话（首个 append 前无文件），
-            // 也可能撞上并发删除。记 revision 静默跳过：物化或内容变更会改
-            // revision，下一轮 scan 自然重新调度。
+            // 区分两种 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;

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,
         });
@@ -284,6 +292,7 @@ export async function markRestoredSynced(deps, sessionIds) {
             lastSegmentIndex: -1,
             lastTag: '',
             localRevision: snapshot.revision,
+            restoredAt: Date.now(),
             eventCount: 0,
             updatedAt: 0,
             status: 'ok',

package/lib/sync/state.d.ts

@@ -14,6 +14,8 @@ export interface SessionSyncState {
     lastTag: string;
     /** 上次处理到的 sessionPersistence revision（不透明令牌） */
     localRevision: string;
+    /** 恢复抑制标记（markRestoredSynced 写入）：本地续写前不回传 */
+    restoredAt?: number;
     /** meta 折叠累积 */
     eventCount: number;
     title?: string;

package/lib/sync/state.js

@@ -12,6 +12,7 @@ const sessionStateSchema = z.object({
     lastSegmentIndex: z.number().int().min(-1),
     lastTag: z.string(),
     localRevision: z.string(),
+    restoredAt: z.number().optional(),
     eventCount: z.number().int().nonnegative(),
     title: z.string().optional(),
     updatedAt: z.number(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-cloud",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "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": {
     ".": {