dsh-config-manager 0.1.70 → 0.1.71

package/lib/foreign/claude-sessions.d.ts

@@ -30,7 +30,15 @@
 import type { Stats } from 'node:fs';
 import type { DshSessionHeader, DshSessionRow, IrParseStats, IrSession } from './session-ir.ts';
 export type { DshSessionHeader, DshSessionRow } from './session-ir.ts';
-/** 本模块已实现行式的 DSH 会话格式版本（其它版本一律拒绝，不猜） */
+/**
+ * 本模块已实现行式的 DSH 会话格式版本（其它版本一律拒绝，不猜）。
+ *
+ * **v3 与 v4 的行式是同一套**：`synthesizeDshRows` 产出的行在两代 DSH 自己的真 codec 上逐条复验过
+ * （v3 档 = 本机 CLI 档案树的 dsh-session；v4 档 = 桌面端 0.2.0-rc.2，均 `equivalentToReadPath`）。
+ * 所以**按目标机的版本写**：目标是 v3 就写 v3、是 v4 就写 v4。两条反向都不行 —— 一律写最高版本
+ * 会让 v3 主机读不了（反向不可读）；只认 v3 则让 v4 目标整批被跳过（2026-10-08 真机事故：
+ * 桌面端 v4 目标下每一条会话都被 `session-format-unsupported` 拒掉，产出的包里没有 sessions 分区）。
+ */
 export declare const SUPPORTED_DSH_SESSION_FORMAT_VERSIONS: readonly number[];
 export interface ClaudeSessionFile {
     /** 文件名（不含 .jsonl）——同时作为 DSH 侧的会话 id（DSH 要求目录名与 header.id 逐字相同） */

package/lib/foreign/claude-sessions.js

@@ -1,8 +1,16 @@
 import { projectKeyOf } from '../core/session-select.js';
 import { encodeZstdFrame } from '../utils/zstd-frame.js';
 import { irBump, irEarlier, irMessage, irMessageIdOf, irNum, irSafeTime, irStr, irTextBlock, irTextOfBlocks, irToolCallBlock, irToolResultBlock, isSafeIrId, parseJsonlObjects, synthesizeDshRows, } from './session-ir.js';
-/** 本模块已实现行式的 DSH 会话格式版本（其它版本一律拒绝，不猜） */
-export const SUPPORTED_DSH_SESSION_FORMAT_VERSIONS = [3];
+/**
+ * 本模块已实现行式的 DSH 会话格式版本（其它版本一律拒绝，不猜）。
+ *
+ * **v3 与 v4 的行式是同一套**：`synthesizeDshRows` 产出的行在两代 DSH 自己的真 codec 上逐条复验过
+ * （v3 档 = 本机 CLI 档案树的 dsh-session；v4 档 = 桌面端 0.2.0-rc.2，均 `equivalentToReadPath`）。
+ * 所以**按目标机的版本写**：目标是 v3 就写 v3、是 v4 就写 v4。两条反向都不行 —— 一律写最高版本
+ * 会让 v3 主机读不了（反向不可读）；只认 v3 则让 v4 目标整批被跳过（2026-10-08 真机事故：
+ * 桌面端 v4 目标下每一条会话都被 `session-format-unsupported` 拒掉，产出的包里没有 sessions 分区）。
+ */
+export const SUPPORTED_DSH_SESSION_FORMAT_VERSIONS = [3, 4];
 /** 单帧的软上限（字节）：把多条事件行合并进一帧，避免「一行一帧」产生上千个帧 */
 const FRAME_TARGET_BYTES = 64 * 1024;
 /** 该会话的请求头能力声明（从重构前的内联字面量原样搬出，取值一字未改） */

package/lib/foreign/session-ir.js

@@ -339,17 +339,53 @@ export function synthesizeDshRows(session, hints, stats, now) {
         messageIndex++;
     }
     closeTurn();
-    // 标题行放在最前面（与真实日志一致：会话标题是早期事件）
+    /**
+     * 标题行：位置与 `messageSeqs` 必须满足 DSH 的 `session/title` 硬规则（`assertTitleSources`；
+     * **v3 与 v4 是同一份校验**，真机实测两代在严格档报同一条）：
+     *  ① `messageSeqs` 为空 **⟺** `source.kind === 'user'`（用户消息标题不引用，其它来源必须引用）；
+     *  ② 非空时每个 seq 必须**早于本条事件**、且指向 `source.kind === 'user'` 的 `user/message`，互不重复。
+     *
+     * 所以标题行**不能**停在 seq 0：非 user 来源（本仓两处调用方都给 `{kind:'fallback'}`）在 seq 0
+     * 没有任何「更早的人类消息」可引用，只写 `messageSeqs: []` 会同时违反①。真机日志同形 ——
+     * 实测 `{"type":"session/title","seq":12,"messageSeqs":[7],"source":{"kind":"fallback"}}`（7 是首条人类消息）。
+     * 因此把标题行插在**首条人类 user/message 之后**，再按行序统一重编 seq（仍是连续递增）。
+     *
+     * 来源是 fallback 而整场又没有人类 user/message 时**不产标题行**：标题是装饰性的，
+     * 宁可让这条会话按 `session-empty` 如实跳过，也不编一条指不到人的引用（那是会被拒读的行）。
+     */
+    const titleSource = hints.titleSource;
+    const titleSourceKind = typeof titleSource === 'object' && titleSource !== null
+        ? titleSource.kind
+        : undefined;
     if (hints.title !== '') {
-        const titleRow = {
-            type: 'session/title',
-            seq: 0,
-            time: session.createdAt,
-            data: { title: hints.title, messageSeqs: [], source: hints.titleSource },
-        };
-        for (const row of rows)
-            row.seq++;
-        rows.unshift(titleRow);
+        if (titleSourceKind === 'user') {
+            rows.unshift({
+                type: 'session/title',
+                seq: 0,
+                time: session.createdAt,
+                data: { title: hints.title, messageSeqs: [], source: hints.titleSource },
+            });
+        }
+        else {
+            const at = rows.findIndex((row) => {
+                if (row.type !== 'user/message')
+                    return false;
+                const source = row.data['source'];
+                return typeof source === 'object' && source !== null && source.kind === 'user';
+            });
+            if (at >= 0) {
+                rows.splice(at + 1, 0, {
+                    type: 'session/title',
+                    seq: 0,
+                    // at 是「插入前」首条人类消息的 seq（未插入时行序即 seq），引用它必然早于本行
+                    data: { title: hints.title, messageSeqs: [at], source: hints.titleSource },
+                    time: session.createdAt,
+                });
+            }
+        }
+        rows.forEach((row, index) => {
+            row.seq = index;
+        });
     }
     return rows;
 }

package/lib/index.d.ts

@@ -76,7 +76,7 @@ export declare const name = "config-manager";
 /** Services required before the engine can mount (present in every profile). */
 export declare const inject: string[];
 /** Plugin version, kept in sync with package.json ("version"). */
-export declare const PLUGIN_VERSION = "0.1.70";
+export declare const PLUGIN_VERSION = "0.1.71";
 /**
  * Star 引导弹窗指向的 GitHub 仓库（用户引导点 Star 的目标）。
  * 与 package.json 的 repository 字段保持一致；界面不可改（硬编码，参照

package/lib/index.js

@@ -127,7 +127,7 @@ export const name = 'config-manager';
 /** Services required before the engine can mount (present in every profile). */
 export const inject = ['settings', 'credentials'];
 /** Plugin version, kept in sync with package.json ("version"). */
-export const PLUGIN_VERSION = '0.1.70';
+export const PLUGIN_VERSION = '0.1.71';
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager';
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-config-manager",
-  "version": "0.1.70",
+  "version": "0.1.71",
   "license": "MIT",
   "description": "Backup, restore, export, import, migrate and sync your DeepSeek Harness (DSH) configuration: settings, plugins, MCP servers, skills, agent presets and workspaces. One-click migration to another machine. DSH 配置一键备份、恢复、导出、导入、迁移与同步插件。",
   "icon": "./icon.svg",

package/src/foreign/claude-sessions-bytes.test.ts

@@ -186,14 +186,27 @@ const GOLDEN: Record<string, string> = {
    * assistant 行补 `stream: []` 与 content 里的 `tool-call` 块；tool/result 块改为
    * `tool-result`/`toolCallId`/`isError` 且 callId 非空）后，字节必然变化。
    * 复验：DSH 自己的 `adoptSessionEvent` 逐行校验 hermes 71 会话 / 29687 行 → 0 拒绝。
+   *
+   * 2026-10-08 有意更新（**理由**）：标题行按 DSH 的 `session/title` 硬规则重做（`assertTitleSources`：
+   * `messageSeqs` 为空 **⟺** `source.kind === 'user'`，非空时每个 seq 必须**早于**本条且指向
+   * `source.kind === 'user'` 的 `user/message`）。旧实现把标题停在 seq 0 且恒写 `messageSeqs: []`，
+   * 于非 user 来源同时违反该规则：真 codec 的严格档两代都报 `messageSeqs must be empty exactly for
+   * a user title`，且 **v3→v4 迁移直接拒收**（`finish-failed: … refuses the transformed artifact`）——
+   * 后果是 v3 标记的产物在 v4 主机上整批读不出来。现在标题行插在首条人类 user/message 之后并引用它
+   * （真机日志同形：`{"seq":12,"messageSeqs":[7],"source":{"kind":"fallback"}}`）。
+   * **附带的行为变化**：`title-only-no-events` 从「只有标题行的会话」变成 `skip:session-empty` ——
+   * 整场没有任何人类 user/message 时，非 user 来源的标题**无解**（引用不到任何人），宁可如实跳过，
+   * 也不产出违反①的标题行。
+   * 复验：修后同一批产物对**两代真 codec**逐条 `verifySessionLogBytes` → `verified/strong/equivalentToReadPath` 全 true
+   * （v4 目标档用桌面端 app.asar 内的 catalog；v3 目标档用本机 CLI 档案树）。
    */
-  'basic-with-malformed-line': '891:1b8d8c38f294800815d3d4e9ad338313406ae650ccdaacd113f9a9d1dbfc840d',
-  'frames-crossing-64k': '7506:63663ed1e2d0f3f6c8b177b2a8ad04478ea6f92eebdfe2e0c8cae31f1dafe4a3',
-  'orphan-empty-and-unknown': '338:94f6bfc7a6c8414def1f26db26fc691eeefa90ab27df973c569e15116b20c817',
-  'title-only-no-events': '276:c7c2bb7be4040ecac5c404f88d2074a97986bceae08c4220d2efb5700a4a4159',
-  'no-uuid-fallback-ids': '731:babd8decf0b3b6a2396a12767d6ce1a428df157b6f3567012e606ef5269789aa',
-  'timestamps-numeric-and-unparsable': '723:462361f41500fc0611684c9bcfe46a4b489feb043c2cf343a3442706bba6271b',
-  'unicode-and-max-id': '725:bf06eee24f22d88fbe4764a8be8af62c22e1fcb51ffa65f0ed27d0e16cd2632c',
+  'basic-with-malformed-line': '896:b2fa752b2b5d2a9f470a9c49cb40d6f0dfafe40d1ea3fd6e81afc62ac189759d',
+  'frames-crossing-64k': '7518:d8be900e191b4a2c2c70819790bc0434bc8bffcbfbafbb00016b09bc04edaa8a',
+  'orphan-empty-and-unknown': '339:7492bd869daacad62ee75688ad8816e23af259215a360d01de9917cdffadc727',
+  'title-only-no-events': 'skip:session-empty',
+  'no-uuid-fallback-ids': '743:1c6ea7a8e76016376da2bff5f50e72e824eb7bce9724af4bee40d41d07d0b6df',
+  'timestamps-numeric-and-unparsable': '728:64308bcdea6fc439ed190dd56cad74354e9f53f1274821d97a57bc519f3505ce',
+  'unicode-and-max-id': '729:a8a5abaca4dc7ab15c499b1c38655972283def0bedd3bb73bc87558e22ef51c7',
   'skip-unsupported-version': 'skip:session-format-unsupported',
   'skip-unsafe-id': 'skip:session-unsafe-id',
   'skip-missing-cwd': 'skip:session-missing-cwd',

package/src/foreign/claude-sessions.test.ts

@@ -71,12 +71,23 @@ test('t1 形态：路径 / header / 事件序列', () => {
   assert.equal(header['createdAt'], Date.parse('2026-10-01T10:00:00.000Z'));
 
   const types = shape.rows.map((r) => (r === null ? 'null' : (r as Record<string, unknown>)['type']));
+  // 标题行**跟在首条人类 user/message 之后**（见 synthesizeDshRows 的标题行注释：非 user 来源的标题
+  // 必须引用一条**更早**的人类消息，停在 seq 0 就无解 —— DSH 的 assertTitleSources 会拒读）
   assert.deepEqual(types, [
-    'session/title', 'user/message', 'turn/start', 'request/header', 'step/start',
+    'user/message', 'session/title', 'turn/start', 'request/header', 'step/start',
     'assistant/message', 'tool/call', 'tool/result', 'step/end',
     'step/start', 'assistant/message', 'step/end', 'turn/end',
   ]);
 
+  // 标题行必须满足 DSH 的 assertTitleSources：非 user 来源 → messageSeqs 非空且引用更早的人类消息
+  const titleIndex = shape.rows.findIndex((r) => (r as Record<string, unknown> | null)?.['type'] === 'session/title');
+  assert.equal(titleIndex, 1);
+  const titleRow = shape.rows[titleIndex] as Record<string, unknown>;
+  const titleData = titleRow['data'] as Record<string, unknown>;
+  assert.deepEqual(titleData['messageSeqs'], [0], '必须引用首条人类 user/message 的 seq');
+  assert.deepEqual(titleData['source'], { kind: 'fallback' });
+  assert.ok((titleRow['seq'] as number) > 0, '被引用的 seq 必须早于标题行本身');
+
   // seq 必须从 0 连续递增（DSH 按位置校验引用）
   const seqs = shape.rows.map((r) => (r as Record<string, unknown>)['seq']);
   assert.deepEqual(seqs, seqs.map((_, i) => i));
@@ -103,9 +114,23 @@ test('t1 形态：路径 / header / 事件序列', () => {
   assert.equal(s.info.ignored['unparsable'], 1);
 });
 
+test('t1b v4 目标：按目标版本写出（header/文件名同步，不是一律写最高版本）', () => {
+  const result = transcodeClaudeSession({ id: ID, text: sessionText() }, { formatVersion: 4, now: 1_700_000_000_000 });
+  assert.ok(result.session, 'v4 目标必须能转码（2026-10-08 桌面端 v4 整批被跳过的回归护栏）');
+  const s = result.session;
+  assert.equal(s.relativePath, projectKeyOf(CWD) + '/' + ID + '/session.v4.jsonl.zstd');
+  assert.equal(s.relativePath, '--D-proj-app--/' + ID + '/session.v4.jsonl.zstd');
+  const shape = readSessionLogShapeFromBytes(s.data);
+  assert.equal(shape.ok, true, 'v4 产物同样必须是 DSH 可扫的 zstd 帧序列');
+  if (!shape.ok) return;
+  assert.equal((shape.headerValue as Record<string, unknown>)['version'], 4, 'header.version 必须等于目标版本');
+});
+
 test('t2 拒绝面：不认识的格式版本 / 缺 cwd / 非法 id 一律跳过并报码', () => {
   const base = { id: ID, text: sessionText() };
   assert.equal(transcodeClaudeSession(base, { formatVersion: 2 }).skip?.code, 'session-format-unsupported');
+  // 比本模块已实现的最高版本更高（未来格式）同样**如实跳过**，绝不按最高版本硬写
+  assert.equal(transcodeClaudeSession(base, { formatVersion: 5 }).skip?.code, 'session-format-unsupported');
   assert.equal(transcodeClaudeSession({ ...base, id: 'a/b' }, { formatVersion: 3 }).skip?.code, 'session-unsafe-id');
   const noCwd = [line({ type: 'user', uuid: 'aaaaaaaa-0000-4000-8000-000000000001', message: { role: 'user', content: 'hi' } })].join(NL);
   assert.equal(transcodeClaudeSession({ id: ID, text: noCwd }, { formatVersion: 3 }).skip?.code, 'session-missing-cwd');

package/src/foreign/claude-sessions.ts

@@ -59,8 +59,16 @@ import type {
 
 export type { DshSessionHeader, DshSessionRow } from './session-ir.ts';
 
-/** 本模块已实现行式的 DSH 会话格式版本（其它版本一律拒绝，不猜） */
-export const SUPPORTED_DSH_SESSION_FORMAT_VERSIONS: readonly number[] = [3];
+/**
+ * 本模块已实现行式的 DSH 会话格式版本（其它版本一律拒绝，不猜）。
+ *
+ * **v3 与 v4 的行式是同一套**：`synthesizeDshRows` 产出的行在两代 DSH 自己的真 codec 上逐条复验过
+ * （v3 档 = 本机 CLI 档案树的 dsh-session；v4 档 = 桌面端 0.2.0-rc.2，均 `equivalentToReadPath`）。
+ * 所以**按目标机的版本写**：目标是 v3 就写 v3、是 v4 就写 v4。两条反向都不行 —— 一律写最高版本
+ * 会让 v3 主机读不了（反向不可读）；只认 v3 则让 v4 目标整批被跳过（2026-10-08 真机事故：
+ * 桌面端 v4 目标下每一条会话都被 `session-format-unsupported` 拒掉，产出的包里没有 sessions 分区）。
+ */
+export const SUPPORTED_DSH_SESSION_FORMAT_VERSIONS: readonly number[] = [3, 4];
 
 /** 单帧的软上限（字节）：把多条事件行合并进一帧，避免「一行一帧」产生上千个帧 */
 const FRAME_TARGET_BYTES = 64 * 1024;

package/src/foreign/reasonix.test.ts

@@ -316,9 +316,11 @@ test('reasonix t9 createdAt 兜底 stem 内嵌时刻（YYYYMMDDHHMM）；usage s
     const session = sessionFilesOf(result)[0];
     assert.ok(session !== undefined);
     const rows = rowsOf(session.data);
-    const header = rows.find((r) => r['type'] === 'session/title');
-    assert.ok(header !== undefined);
-    assert.equal(rows[0]?.['time'], reasonixStemTime(stem), '会话创建时间必须落成记录时间而非导入时刻');
+    // 标题行承载会话创建时间；行序是「首条人类 user/message → session/title」（见 synthesizeDshRows
+    // 的标题行注释：非 user 来源的标题必须引用一条更早的人类消息），所以不能再看 rows[0]。
+    const title = rows.find((r) => r['type'] === 'session/title');
+    assert.ok(title !== undefined);
+    assert.equal(title['time'], reasonixStemTime(stem), '会话创建时间必须落成记录时间而非导入时刻');
     const assistant = rows.find((r) => r['type'] === 'assistant/message');
     assert.ok(assistant !== undefined);
     assert.deepEqual(dataOf(assistant)['usage'], {

package/src/foreign/session-ir.test.ts

@@ -25,7 +25,7 @@ import {
   irToolResultBlock,
   synthesizeDshRows,
 } from './session-ir.ts';
-import type { DshSessionRow, SynthesisStats } from './session-ir.ts';
+import type { DshSessionRow, IrMessage, SynthesisStats } from './session-ir.ts';
 
 const NOW = 1700000000000;
 
@@ -134,3 +134,56 @@ test('合成行：无主结果不产出空 callId，按 orphan-tool-result 计
   }
   assert.equal(s.ignored['orphan-tool-result'], 1, '无主结果必须计数可见');
 });
+
+/* ---------------- 标题行（DSH 的 assertTitleSources 是硬校验，v3/v4 同款） ---------------- */
+
+/**
+ * 标题行规则的最小语料。
+ *
+ * 为什么单列一组用例（2026-10-08 真机事故）：旧实现把标题停在 seq 0 且恒写 `messageSeqs: []`，
+ * 而 DSH 的规则是「`messageSeqs` 为空 **⟺** `source.kind === 'user'`，非空时每个 seq 必须**早于**
+ * 本条事件且指向 `source.kind === 'user'` 的 `user/message`」。真 codec 的严格档两代都报这条，
+ * 且 **v3→v4 迁移直接拒收整份产物**（`finish-failed: … refuses the transformed artifact`）。
+ */
+function synthTitle(titleSource: unknown, messages: readonly IrMessage[]): DshSessionRow[] {
+  return synthesizeDshRows(
+    { id: 's1', cwd: 'D:/proj', createdAt: NOW, records: messages.length, messages },
+    { title: '标题', titleSource, emptyBlocks: [], provider: 'hermes', reasoningEffort: 'medium', maxTokens: 8192 },
+    stats(),
+    NOW,
+  );
+}
+
+test('标题行：非 user 来源必须引用**更早**的人类 user/message（且 seq 仍连续）', () => {
+  const rows = synthTitle({ kind: 'fallback' }, [
+    irMessage(irFallbackMessageId(0), 'user', [irTextBlock('你好')], { time: NOW }),
+    irMessage(irFallbackMessageId(1), 'assistant', [irTextBlock('在')], { time: NOW + 1 }),
+  ]);
+  const title = rows.find((r) => r.type === 'session/title');
+  assert.ok(title !== undefined, '有标题就必须产标题行');
+  const data = title.data as { messageSeqs: number[]; source: { kind: string } };
+  assert.equal(data.source.kind, 'fallback');
+  assert.deepEqual(data.messageSeqs, [0], '必须引用首条人类 user/message 的 seq');
+  assert.ok(title.seq > data.messageSeqs[0]!, '被引用的 seq 必须**早于**标题行本身');
+  const cited = rows.find((r) => r.seq === data.messageSeqs[0]);
+  assert.equal(cited?.type, 'user/message', '只能引用 user/message（DSH 按位置与类型双重校验）');
+  assert.deepEqual(rows.map((r) => r.seq), rows.map((_, i) => i), 'seq 必须仍从 0 连续递增');
+});
+
+test('标题行：user 来源 → messageSeqs 必须为空（空 ⟺ user），可停在 seq 0', () => {
+  const rows = synthTitle({ kind: 'user' }, [
+    irMessage(irFallbackMessageId(0), 'user', [irTextBlock('你好')], { time: NOW }),
+  ]);
+  const title = rows[0];
+  assert.equal(title?.type, 'session/title');
+  assert.equal(title?.seq, 0);
+  assert.deepEqual((title?.data as { messageSeqs: unknown }).messageSeqs, [], 'user 标题不引用任何 seq');
+});
+
+test('标题行：非 user 来源且整场没有人类 user/message → 不产标题行（不编指不到人的引用）', () => {
+  const rows = synthTitle({ kind: 'fallback' }, [
+    irMessage(irFallbackMessageId(0), 'assistant', [irTextBlock('只有助手')], { time: NOW }),
+  ]);
+  assert.equal(rows.some((r) => r.type === 'session/title'), false);
+  assert.ok(rows.length > 0, '助手消息本身仍要产出（标题只是装饰）');
+});

package/src/foreign/session-ir.ts

@@ -525,16 +525,51 @@ export function synthesizeDshRows(
   }
   closeTurn();
 
-  // 标题行放在最前面（与真实日志一致：会话标题是早期事件）
+  /**
+   * 标题行：位置与 `messageSeqs` 必须满足 DSH 的 `session/title` 硬规则（`assertTitleSources`；
+   * **v3 与 v4 是同一份校验**，真机实测两代在严格档报同一条）：
+   *  ① `messageSeqs` 为空 **⟺** `source.kind === 'user'`（用户消息标题不引用，其它来源必须引用）；
+   *  ② 非空时每个 seq 必须**早于本条事件**、且指向 `source.kind === 'user'` 的 `user/message`，互不重复。
+   *
+   * 所以标题行**不能**停在 seq 0：非 user 来源（本仓两处调用方都给 `{kind:'fallback'}`）在 seq 0
+   * 没有任何「更早的人类消息」可引用，只写 `messageSeqs: []` 会同时违反①。真机日志同形 ——
+   * 实测 `{"type":"session/title","seq":12,"messageSeqs":[7],"source":{"kind":"fallback"}}`（7 是首条人类消息）。
+   * 因此把标题行插在**首条人类 user/message 之后**，再按行序统一重编 seq（仍是连续递增）。
+   *
+   * 来源是 fallback 而整场又没有人类 user/message 时**不产标题行**：标题是装饰性的，
+   * 宁可让这条会话按 `session-empty` 如实跳过，也不编一条指不到人的引用（那是会被拒读的行）。
+   */
+  const titleSource = hints.titleSource;
+  const titleSourceKind = typeof titleSource === 'object' && titleSource !== null
+    ? (titleSource as { kind?: unknown }).kind
+    : undefined;
   if (hints.title !== '') {
-    const titleRow: DshSessionRow = {
-      type: 'session/title',
-      seq: 0,
-      time: session.createdAt,
-      data: { title: hints.title, messageSeqs: [], source: hints.titleSource },
-    };
-    for (const row of rows) row.seq++;
-    rows.unshift(titleRow);
+    if (titleSourceKind === 'user') {
+      rows.unshift({
+        type: 'session/title',
+        seq: 0,
+        time: session.createdAt,
+        data: { title: hints.title, messageSeqs: [], source: hints.titleSource },
+      });
+    } else {
+      const at = rows.findIndex((row) => {
+        if (row.type !== 'user/message') return false;
+        const source = row.data['source'];
+        return typeof source === 'object' && source !== null && (source as { kind?: unknown }).kind === 'user';
+      });
+      if (at >= 0) {
+        rows.splice(at + 1, 0, {
+          type: 'session/title',
+          seq: 0,
+          // at 是「插入前」首条人类消息的 seq（未插入时行序即 seq），引用它必然早于本行
+          data: { title: hints.title, messageSeqs: [at], source: hints.titleSource },
+          time: session.createdAt,
+        });
+      }
+    }
+    rows.forEach((row, index) => {
+      row.seq = index;
+    });
   }
 
   return rows;

package/src/index.ts

@@ -166,7 +166,7 @@ export const name = 'config-manager'
 export const inject = ['settings', 'credentials']
 
 /** Plugin version, kept in sync with package.json ("version"). */
-export const PLUGIN_VERSION = '0.1.70'
+export const PLUGIN_VERSION = '0.1.71'
 
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager'

package/src/routes/foreign.test.ts

@@ -25,7 +25,7 @@ import {
  * 全量构造需要一个完整 DSH 宿主。这里只放本组用到的字段 —— 组文件在构建期只解构 env，
  * 其余依赖都在 handler 内，所以桩足够驱动真实行为（与 route-fence 的 stubEnv 同思路）。
  */
-async function stubEnv(): Promise<Record<string, unknown>> {
+async function stubEnv(sessionFormatVersion?: number): Promise<Record<string, unknown>> {
   const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'dcm-foreign-route-'));
   return {
     tmpDir,
@@ -42,7 +42,8 @@ async function stubEnv(): Promise<Record<string, unknown>> {
     host: {
       homeDir: path.join(tmpDir, 'dsh-home-NOT-user-home'),
       dshVersion: 'test',
-      sessionFormatVersion: undefined,
+      // 缺省 = 读不到目标版本（内核据此逐条报 session-format-version-unknown，绝不猜）
+      sessionFormatVersion,
     },
   };
 }
@@ -246,9 +247,9 @@ function importRoute(env: Record<string, unknown>) {
  */
 async function callImport(
   payload: unknown,
-  opts: { userHome?: string } = {},
+  opts: { userHome?: string; sessionFormatVersion?: number } = {},
 ): Promise<{ status: number; body: ForeignImportBody; raw: string }> {
-  const env = await stubEnv()
+  const env = await stubEnv(opts.sessionFormatVersion)
   const prevProfile = process.env['USERPROFILE']
   const prevHome = process.env['HOME']
   if (opts.userHome !== undefined) {
@@ -383,3 +384,60 @@ test('foreign-import：真实 fixture 产包 → 分区非空、路径受控、
     await fs.rm(userHome, { recursive: true, force: true })
   }
 })
+
+/** 在受控 userHome 下造一条最小 Claude Code 会话（cwd 写在记录里，DSH 按它归位目录键）。 */
+async function writeClaudeSession(userHome: string, id: string, cwd: string): Promise<void> {
+  const dir = path.join(userHome, '.claude', 'projects', 'D--proj-app')
+  await fs.mkdir(dir, { recursive: true })
+  const lines = [
+    JSON.stringify({
+      type: 'user',
+      uuid: 'aaaaaaaa-0000-4000-8000-000000000001',
+      timestamp: '2026-10-01T10:00:00.000Z',
+      cwd,
+      message: { role: 'user', content: '帮我看看这个 bug' },
+    }),
+    JSON.stringify({
+      type: 'assistant',
+      uuid: 'aaaaaaaa-0000-4000-8000-000000000002',
+      timestamp: '2026-10-01T10:00:05.000Z',
+      cwd,
+      message: { model: 'claude-sonnet-4', content: [{ type: 'text', text: '修好了' }] },
+    }),
+  ]
+  await fs.writeFile(path.join(dir, id + '.jsonl'), lines.join('\n') + '\n', 'utf8')
+}
+
+test('foreign-import：目标机是 v4 时必须照 v4 产出会话（2026-10-08 桌面端整批被跳过的回归护栏）', async () => {
+  /**
+   * 真机事故：DSH 桌面端（0.2.0-rc.2）的会话格式是 v4，而转码器只认 v3 ⇒ 每一条会话都被
+   * `session-format-unsupported` 跳过、产出的包里**没有 sessions 分区**，用户看到「历史对话不见了」。
+   * 本用例把「宿主给的是 v4 就照 v4 产出」钉在**路由层**（GUI 走的正是这条端点）。
+   */
+  const userHome = await fs.mkdtemp(path.join(os.tmpdir(), 'dcm-foreign-v4-'))
+  try {
+    await writeClaudeSession(userHome, '11111111-1111-4111-8111-111111111111', 'D:/proj/app')
+
+    const v4 = await callImport({ source: 'claude-code' }, { userHome, sessionFormatVersion: 4 })
+    assert.equal(v4.status, 200, 'v4 目标下必须产包：' + v4.raw)
+    assert.ok((v4.body.sections ?? []).includes('sessions'), 'v4 目标必须产出 sessions 分区：' + v4.raw)
+    assert.equal(v4.body.counts?.['sessions.transcoded'], 1)
+    assert.equal(
+      (v4.body.skipped ?? []).some((s) => s.code === 'session-format-unsupported'),
+      false,
+      '不得再整批报 session-format-unsupported',
+    )
+
+    // 读不到目标版本时**不猜**：内核如实报码、一个会话都不转 → 整包没有分区（400 nothing-to-import）。
+    // 这是「绝不猜版本」的既有语义，与上面那条并排钉住，避免修复被误读成「以后可以直接硬写 v4」。
+    const unknown = await callImport({ source: 'claude-code' }, { userHome })
+    assert.equal(unknown.status, 400, unknown.raw)
+    assert.equal(unknown.body.code, 'nothing-to-import')
+    assert.ok(
+      (unknown.body.skipped ?? []).some((s) => s.code === 'session-format-version-unknown'),
+      '读不到版本必须如实报码：' + unknown.raw,
+    )
+  } finally {
+    await fs.rm(userHome, { recursive: true, force: true })
+  }
+})