@starwish-ai/xingyuan-dsh 0.6.3 → 0.6.4

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.4] - 2026-09-11
+
+### Changed
+- **dsh 0.1.5-rc.2 compatibility**: peer and dev dependencies moved from
+  `0.1.2-rc.1` to `^0.1.5-rc.2`. Every host/client API this plugin consumes was
+  re-verified against the installed 0.1.5-rc.2 build — tool registration,
+  settings namespaces, storage backend/domain, user questions, system prompt,
+  conversation cards and session tabs are unchanged; the client half needs no
+  code changes. XingYuan's prompt sections (orders 5–115) now naturally precede
+  the host's relocated sections (10000+).
+
+### Fixed
+- **Session log self-heal now covers format v3**: dsh 0.1.5 names session
+  artifacts `session.v{N}.jsonl[.zstd]`; the repair module now selects the
+  highest stored generation per session instead of the fixed `session.jsonl`
+  names, so `xingyuan/*` events in new sessions keep receiving the `ignorable`
+  marker before a cold load.
+- **Legacy sessions with XingYuan cards open again**: dsh 0.1.5's v0/v1/v2 → v3
+  migration chain rejects every unknown historical event, `ignorable` included,
+  which previously made a session containing `xingyuan/*` events fail to load as
+  a whole. Legacy artifacts are now de-poisoned ahead of migration: those event
+  rows are replaced with the official inert `hook/invoked` event (seq/time
+  preserved, payload valid across every migration edge), so the session migrates
+  and opens; other rows stay byte-identical and files without XingYuan events
+  are never written. Trade-off: historical cards in those old sessions no longer
+  replay (business data lives in SQLite; the pre-repair file is backed up under
+  `~/.dsh/xingyuan/session-backups/`).
+
 ## [0.6.3] - 2026-09-06
 
 ### Changed

package/README.en-US.md

@@ -25,6 +25,9 @@ Tools are only mounted on sessions using the XingYuan preset; other sessions are
 
 ## Install
 
+> Requires DeepSeek Harness `0.1.5-rc.2` (peer dependencies are pinned to that
+> release; check the upgrade notes in [AGENTS.md](./AGENTS.md) before bumping dsh).
+
 ```sh
 dsh plugin --profile web add @starwish-ai/xingyuan-dsh
 ```

package/README.md

@@ -27,6 +27,9 @@
 
 ## 安装
 
+> 需要 DeepSeek Harness `0.1.5-rc.2`（peer 依赖按该版本锁定；升级 dsh 前先核对
+> [AGENTS.md](./AGENTS.md) 的升级要点）。
+
 ```sh
 dsh plugin --profile web add @starwish-ai/xingyuan-dsh
 ```

package/lib/index.js

@@ -65,7 +65,12 @@ export async function apply(ctx, config) {
         try {
             const report = await repairSessionLogs({ listLiveSessionIds: () => liveSessionIds(sessions) });
             if (report.patched > 0) {
-                console.log(`[xingyuan] 会话日志自愈：补标 ${report.eventsMarked} 条卡片事件（${report.patched} 个会话，扫描 ${report.scanned}）`);
+                const parts = [];
+                if (report.eventsMarked > 0)
+                    parts.push(`补标 ${report.eventsMarked} 条卡片事件`);
+                if (report.neutralized > 0)
+                    parts.push(`旧格式会话迁移前替换 ${report.neutralized} 条卡片事件（历史卡片不再回放）`);
+                console.log(`[xingyuan] 会话日志自愈：${parts.join('，')}（${report.patched} 个会话，扫描 ${report.scanned}）`);
             }
             for (const warning of report.warnings)
                 console.warn(`[xingyuan] 会话日志自愈跳过：${warning}`);

package/lib/session-log-repair.js

@@ -1,21 +1,26 @@
 /**
  * 会话日志自愈（bundle 常驻层）。
  *
- * 背景：dsh（0.1.1-rc.2）会话持久化读取端按「本仓库生成的官方事件类型白名单」
- * 拒绝未知事件；仓库外插件事件按构造就在名单之外，而写入端（Session.append）
- * 当前没有 ignorable 标记通道——因此任何包含 xingyuan/* 卡片事件的会话，
- * 进程重启后冷加载会被 SessionFormatUnsupportedError 整体拒绝，连对话文本都
- * 打不开（详见 docs/handoff-session-format-unsupported-event.md）。
+ * 背景：dsh 会话持久化读取端按「本仓库生成的官方事件类型白名单」拒绝未知事件；
+ * 仓库外插件事件按构造不在名单内，而写入端（Session.append）至今没有 ignorable
+ * 标记通道。0.1.5-rc.2 的规则分两档：
+ * - 当前格式（v3，工件名 session.v3.jsonl[.zstd]）：读取端认 `ignorable: true`，
+ *   不认识的带标事件被安全跳过且数据原样保留；
+ * - 历史格式迁移（v0/v1/v2 → v3）：迁移链**拒绝一切未知历史事件，ignorable
+ *   也不例外**（官方 alpha-historical-unknown-event-refusal 决策）——旧日志里的
+ *   xingyuan/* 事件会让整个会话冷加载失败，且不产出 v3 后继、源文件原样保留。
  *
- * 本模块以「事后补标」弥合「写时打标」的缺位：激活期扫描 $DSH_HOME/sessions
- * 下的会话工件，把 type 以 xingyuan/ 开头且未标记的事件行补上 `"ignorable": true`
- * 后原子替换原文件。读取端本来就支持该字段：不认识的带标事件被安全跳过且
- * **不会被过滤**——事件数据原封保留在日志中，卡片回放能力随之保留。
+ * 本模块在激活期扫描 $DSH_HOME/sessions，按工件版本分两种处理：
+ * - 当前版本工件：补标模式——xingyuan/* 未标记事件行补 `"ignorable": true`；
+ * - 历史版本工件：去毒模式——xingyuan/* 事件行替换为官方惰性事件 hook/invoked
+ *   （seq/time 不变），迁移链即可安全穿过、会话照常打开；代价是该会话历史卡片
+ *   事件不再回放（业务数据在 sqlite，不丢失）。仅当目录内无当前版本工件时才动
+ *   历史工件（dsh 只按最新代读取，旧代已不被消费）。
  *
  * 安全约束（改前必读，勿删）：
  * - 不含星愿事件的会话文件零写入（字节与 mtime 均不变）；
- * - 只有星愿事件行被重序列化（仅追加一个字段），其余行原样保留字节；
- *   行序与 seq 由构造保证不变（本模块从不增删移动任何行）；
+ * - 只有星愿事件行被重序列化（补标仅追加字段；去毒仅换 type/data），其余行原样
+ *   保留字节；行序与 seq 由构造保证不变（本模块从不增删移动任何行）；
  * - 首次改写前把原件备份到 <home>/xingyuan/session-backups/<项目目录>/，
  *   每会话保留最近 maxBackupPerSession 份；
  * - 任何看不懂的情况一律整文件跳过不动：撕裂尾、坏帧、header 版本不符、
@@ -28,7 +33,8 @@
  *   （历史上一次实现曾把整个文件重压成单帧导致宿主启动崩溃，已由本模块的
  *   relayout-only 路径兜底自愈），即使无需补标也会重写为合法布局。
  * - SESSION_FORMAT_VERSION 取自 @deepseek-ai/dsh-session。升级 dsh 时必须核对
- *   本模块的前提与布局契约仍然成立。
+ *   本模块的前提与布局契约仍然成立（尤其迁移链是否改为接受 ignorable 历史事件——
+ *   若接受，去毒模式可回归补标）。
  */
 import { constants as zlibConstants, zstdCompress, zstdDecompressSync } from 'node:zlib';
 import { promisify } from 'node:util';
@@ -41,6 +47,21 @@ const zstdCompressAsync = promisify(zstdCompress);
 const XINGYUAN_EVENT_PREFIX = 'xingyuan/';
 /** 工件内明文的防御性上限（远超个人部署可能的会话体积）。 */
 const MAX_PLAINTEXT_BYTES = 512 * 1024 * 1024;
+/**
+ * 去毒模式下替换星愿事件的官方惰性事件类型与载荷：hook/invoked 只做日志记录，
+ * 跨 v0/v1/v2 迁移边无任何关系约束，是最安全的中性载体（payload 语义校验要求
+ * turn≥0、point/handlerId 非空、dialect ∈ {claude-code, codex}）。
+ * handlerId 保留可追溯的替换来源，便于人工审计。
+ */
+const NEUTRAL_EVENT_TYPE = 'hook/invoked';
+function neutralEvent(seq, time, headerId) {
+    return JSON.stringify({
+        type: NEUTRAL_EVENT_TYPE,
+        seq,
+        time,
+        data: { turn: 1, point: 'PreToolUse', dialect: 'codex', handlerId: `xingyuan-repair:${headerId}:${String(seq)}` },
+    });
+}
 /**
  * 每会话自愈标记文件名（放在会话目录内，dsh 不扫描它）。用于把启动期自愈从
  * 「全量解压解析」降为「stat + 读 40 字节标记」：已修复的会话除非工件字节数
@@ -161,11 +182,12 @@ async function selfVerify(container, expectedPlaintext) {
     return undefined;
 }
 /**
- * 对工件明文做行级补标。首行必须是本构建可读的 session header；之后每个完整行
- * 必须能解析为对象（任何一行解析失败都整体放弃）。只有 xingyuan/* 且未标记的行
- * 会被重序列化，其余行保持原字节。撕裂尾（无换行的最后一段）按原样保留。
+ * 对工件明文做行级处理。首行必须是 session header 且版本与工件名一致
+ * （mark 要求当前版本；neutralize 要求历史版本）。之后每个完整行必须能解析为
+ * 对象（任何一行解析失败都整体放弃）。只有星愿事件行会被重序列化，其余行保持
+ * 原字节。撕裂尾（无换行的最后一段）按原样保留。
  */
-function patchPlaintext(plaintext) {
+function patchPlaintext(plaintext, mode, artifactVersion) {
     if (plaintext.length > MAX_PLAINTEXT_BYTES)
         return skip('oversized', `${plaintext.length} bytes`);
     const headerEnd = plaintext.indexOf(10);
@@ -179,20 +201,24 @@ function patchPlaintext(plaintext) {
         return skip('format', 'header line is not valid JSON');
     }
     const headerRecord = header;
+    const expectedVersion = mode === 'mark' ? SESSION_FORMAT_VERSION : artifactVersion;
     if (headerRecord === null || typeof headerRecord !== 'object' ||
         headerRecord['type'] !== 'session' ||
-        headerRecord['version'] !== SESSION_FORMAT_VERSION ||
+        headerRecord['version'] !== expectedVersion ||
+        (mode === 'neutralize' && expectedVersion >= SESSION_FORMAT_VERSION) ||
         typeof headerRecord['id'] !== 'string' || headerRecord['id'] === '') {
-        return skip('format', `header version=${String(headerRecord?.['version'])} expect=${SESSION_FORMAT_VERSION}`);
+        return skip('format', `header version=${String(headerRecord?.['version'])} expect=${expectedVersion}`);
     }
+    const headerId = headerRecord['id'];
     const chunks = [plaintext.subarray(0, headerEnd + 1)];
     let eventsMarked = 0;
+    let eventsNeutralized = 0;
     let totalMarked = 0;
     let cursor = headerEnd + 1;
     let lineNumber = 1;
     for (;;) {
         const newline = plaintext.indexOf(10, cursor);
-        // 无换行的尾段是撕裂尾或尚未落盘的部分记录：交给 dsh 自己的截断修复，不在补标范围
+        // 无换行的尾段是撕裂尾或尚未落盘的部分记录：交给 dsh 自己的截断修复，不在处理范围
         if (newline === -1) {
             chunks.push(plaintext.subarray(cursor));
             break;
@@ -211,8 +237,12 @@ function patchPlaintext(plaintext) {
         if (record === null || typeof record !== 'object' || typeof record['type'] !== 'string') {
             return skip('unparsable', 'event line is not an object with a type field');
         }
-        if (record['type'].startsWith(XINGYUAN_EVENT_PREFIX)) {
-            totalMarked += 1;
+        if (!record['type'].startsWith(XINGYUAN_EVENT_PREFIX)) {
+            chunks.push(rawLine, Buffer.from('\n', 'utf8'));
+            continue;
+        }
+        totalMarked += 1;
+        if (mode === 'mark') {
             if (record['ignorable'] !== true) {
                 record['ignorable'] = true;
                 eventsMarked += 1;
@@ -222,14 +252,21 @@ function patchPlaintext(plaintext) {
                 // 已是 ignorable：不触发补标（patched 判定只看 eventsMarked），只累计总数供回填
                 chunks.push(rawLine, Buffer.from('\n', 'utf8'));
             }
+            continue;
         }
-        else {
-            chunks.push(rawLine, Buffer.from('\n', 'utf8'));
+        // neutralize：seq/time 必须可原样承载，否则整文件放弃（宁可跳过不可伪造坐标）
+        const seq = record['seq'];
+        const time = record['time'];
+        if (!Number.isSafeInteger(seq) || !Number.isSafeInteger(time)) {
+            return skip('unparsable', `xingyuan event line ${lineNumber} lacks safe integer seq/time`);
         }
+        eventsNeutralized += 1;
+        chunks.push(Buffer.from(neutralEvent(seq, time, headerId), 'utf8'), Buffer.from('\n', 'utf8'));
+    }
+    if (eventsMarked === 0 && eventsNeutralized === 0) {
+        return { kind: 'clean', plaintext, eventsMarked: 0, eventsNeutralized: 0, totalMarked };
     }
-    if (eventsMarked === 0)
-        return { kind: 'clean', plaintext, eventsMarked: 0, totalMarked };
-    return { kind: 'patched', plaintext: Buffer.concat(chunks), eventsMarked, totalMarked };
+    return { kind: 'patched', plaintext: Buffer.concat(chunks), eventsMarked, eventsNeutralized, totalMarked };
 }
 function skip(reason, detail) {
     return { kind: 'skip', reason, detail };
@@ -267,14 +304,10 @@ async function subdirectories(dir) {
         return [];
     }
 }
-const SESSION_ARTIFACTS = [
-    { filename: 'session.jsonl.zstd', compressed: true },
-    { filename: 'session.jsonl', compressed: false },
-];
 /** 激活期自愈入口：永不抛出，异常折算进 report（warnings/skipped.error）。 */
 export async function repairSessionLogs(options = {}) {
     const log = options.log ?? (() => { });
-    const report = { scanned: 0, patched: 0, eventsMarked: 0, skipped: {}, warnings: [] };
+    const report = { scanned: 0, patched: 0, eventsMarked: 0, neutralized: 0, skipped: {}, warnings: [] };
     const sessionsRoot = join(options.dshHome ?? resolveDshHome(), 'sessions');
     const liveIds = safeLiveIds(options.listLiveSessionIds);
     if (!existsSync(sessionsRoot))
@@ -312,9 +345,12 @@ export async function repairSessionLogs(options = {}) {
                 if (outcome.kind === 'patched') {
                     report.patched += 1;
                     report.eventsMarked += outcome.eventsMarked;
+                    report.neutralized += outcome.eventsNeutralized;
                     log(outcome.relayoutOnly
                         ? `[xingyuan] 已修复会话 ${outcome.sessionId} 的工件帧布局（首帧须为单行 header）`
-                        : `[xingyuan] 已为会话 ${outcome.sessionId} 补标 ${outcome.eventsMarked} 条卡片事件（ignorable）`);
+                        : outcome.eventsNeutralized > 0
+                            ? `[xingyuan] 会话 ${outcome.sessionId} 为旧格式：${outcome.eventsNeutralized} 条卡片事件已替换为惰性事件以便 dsh 迁移（卡片不再回放）`
+                            : `[xingyuan] 已为会话 ${outcome.sessionId} 补标 ${outcome.eventsMarked} 条卡片事件（ignorable）`);
                 }
                 else if (outcome.kind === 'clean') {
                     report.eventsMarked += outcome.eventsMarked;
@@ -332,13 +368,47 @@ export async function repairSessionLogs(options = {}) {
     }
     return report;
 }
+/**
+ * 解析官方工件名：`session.jsonl[.zstd]`（v0）或 `session.v<N>.jsonl[.zstd]`（N>0）。
+ * 非规范名（大写 v、前导零、v0 带版本段、迁移临时文件等）与高于当前版本的代
+ * 一律不认（口径同 dsh 的 parseGenerationLogFilename）。
+ */
+function parseArtifactName(name) {
+    const match = /^session(?:\.v([1-9]\d*))?\.jsonl(\.zstd)?$/.exec(name);
+    if (match === null)
+        return undefined;
+    const version = match[1] === undefined ? 0 : Number(match[1]);
+    if (!Number.isSafeInteger(version) || version > SESSION_FORMAT_VERSION)
+        return undefined;
+    return { version, compressed: match[2] !== undefined };
+}
+/**
+ * 选目录内最高代的合法工件（dsh 只按最新代读取/迁移）：当前版本走补标，
+ * 更低版本走去毒，旧代在被更高代遮蔽时不处理（零写入原则）。同代并存时
+ * 优先压缩工件（与旧版选择顺序一致）。
+ */
 async function locateArtifact(sessionDir) {
-    for (const candidate of SESSION_ARTIFACTS) {
-        const path = join(sessionDir, candidate.filename);
-        if (existsSync(path))
-            return { path, compressed: candidate.compressed };
+    let entries;
+    try {
+        entries = await readdir(sessionDir);
     }
-    return undefined;
+    catch {
+        return undefined;
+    }
+    let best;
+    for (const name of entries) {
+        const parsed = parseArtifactName(name);
+        if (parsed === undefined)
+            continue;
+        if (best !== undefined) {
+            if (parsed.version < best.version)
+                continue;
+            if (parsed.version === best.version && (best.compressed || !parsed.compressed))
+                continue;
+        }
+        best = { path: join(sessionDir, name), version: parsed.version, compressed: parsed.compressed };
+    }
+    return best;
 }
 async function readMarker(sessionDir) {
     try {
@@ -388,7 +458,7 @@ async function repairOneFile(artifact, sessionId, projectDirName, backupRoot, ma
     else {
         plaintext = raw;
     }
-    const outcome = patchPlaintext(plaintext);
+    const outcome = patchPlaintext(plaintext, artifact.version === SESSION_FORMAT_VERSION ? 'mark' : 'neutralize', artifact.version);
     if (outcome.kind === 'skip')
         return { kind: 'skipped', reason: outcome.reason, detail: outcome.detail };
     // 布局非法时即使无需补标也要重写为合法容器（其余情况才允许 clean 跳过）
@@ -433,8 +503,15 @@ async function repairOneFile(artifact, sessionId, projectDirName, backupRoot, ma
         return { kind: 'skipped', reason: 'busy', detail: error instanceof Error ? error.message : String(error) };
     }
     await pruneBackups(dirnameOf(backupPath), `${sessionId}-`, maxBackupPerSession);
-    await writeMarker(dirnameOf(artifact.path), { artifactBytes: nextBytes.length, eventsMarked: outcome.totalMarked });
-    return { kind: 'patched', sessionId, eventsMarked: outcome.eventsMarked, totalMarked: outcome.totalMarked, relayoutOnly: outcome.kind === 'clean' };
+    // neutralize 后文件内不再有星愿事件：标记计数归零，避免下次启动虚报「已补标」
+    await writeMarker(dirnameOf(artifact.path), {
+        artifactBytes: nextBytes.length,
+        eventsMarked: outcome.eventsNeutralized > 0 ? 0 : outcome.totalMarked,
+    });
+    if (outcome.eventsNeutralized > 0) {
+        return { kind: 'patched', sessionId, eventsMarked: 0, eventsNeutralized: outcome.eventsNeutralized, totalMarked: outcome.totalMarked };
+    }
+    return { kind: 'patched', sessionId, eventsMarked: outcome.eventsMarked, eventsNeutralized: 0, totalMarked: outcome.totalMarked, relayoutOnly: outcome.kind === 'clean' };
 }
 function dirnameOf(path) {
     const index = path.lastIndexOf('/');

package/lib/types/index.d.ts

@@ -3,7 +3,7 @@
  * 1) 激活期把包内 preset 发布到用户根（preset-root.ts）；
  * 2) 打开 xingyuan 领域并发布同名服务；
  * 3) 注册 /xingyuan/* 数据 API 与页面路由；
- * 4) 激活期对会话日志做 ignorable 补标自愈（session-log-repair.ts）。
+ * 4) 激活期对会话日志做自愈（当前格式补 ignorable、旧格式去毒，见 session-log-repair.ts）。
  * （sqlite 后端在独立行 '@starwish-ai/xingyuan-dsh/sqlite'，见 cordis.patch.yml。）
  */
 import type { Context } from '@deepseek-ai/cordis';
@@ -21,9 +21,10 @@ export interface Config {
     /** 记忆列表单页条数（分页端点缺省 limit）。 */
     memoryListLimit: number;
     /**
-     * 激活期会话日志自愈（默认开）：为历史日志里的 xingyuan/* 卡片事件补
-     * `"ignorable": true` 标记，修掉「重启后旧会话冷加载被整体拒绝」。
-     * 不含星愿事件的文件零写入；详见 session-log-repair.ts 头注。
+     * 激活期会话日志自愈（默认开）：当前格式日志补 `"ignorable": true` 标记，
+     * 旧格式日志的 xingyuan/* 事件替换为官方便可迁移的惰性事件（详见
+     * session-log-repair.ts 头注；dsh 0.1.5 起历史迁移链拒绝未知事件）。
+     * 不含星愿事件的文件零写入。
      */
     repairSessionLogs: boolean;
 }

package/lib/types/session-log-repair.d.ts

@@ -1,21 +1,26 @@
 /**
  * 会话日志自愈（bundle 常驻层）。
  *
- * 背景：dsh（0.1.1-rc.2）会话持久化读取端按「本仓库生成的官方事件类型白名单」
- * 拒绝未知事件；仓库外插件事件按构造就在名单之外，而写入端（Session.append）
- * 当前没有 ignorable 标记通道——因此任何包含 xingyuan/* 卡片事件的会话，
- * 进程重启后冷加载会被 SessionFormatUnsupportedError 整体拒绝，连对话文本都
- * 打不开（详见 docs/handoff-session-format-unsupported-event.md）。
+ * 背景：dsh 会话持久化读取端按「本仓库生成的官方事件类型白名单」拒绝未知事件；
+ * 仓库外插件事件按构造不在名单内，而写入端（Session.append）至今没有 ignorable
+ * 标记通道。0.1.5-rc.2 的规则分两档：
+ * - 当前格式（v3，工件名 session.v3.jsonl[.zstd]）：读取端认 `ignorable: true`，
+ *   不认识的带标事件被安全跳过且数据原样保留；
+ * - 历史格式迁移（v0/v1/v2 → v3）：迁移链**拒绝一切未知历史事件，ignorable
+ *   也不例外**（官方 alpha-historical-unknown-event-refusal 决策）——旧日志里的
+ *   xingyuan/* 事件会让整个会话冷加载失败，且不产出 v3 后继、源文件原样保留。
  *
- * 本模块以「事后补标」弥合「写时打标」的缺位：激活期扫描 $DSH_HOME/sessions
- * 下的会话工件，把 type 以 xingyuan/ 开头且未标记的事件行补上 `"ignorable": true`
- * 后原子替换原文件。读取端本来就支持该字段：不认识的带标事件被安全跳过且
- * **不会被过滤**——事件数据原封保留在日志中，卡片回放能力随之保留。
+ * 本模块在激活期扫描 $DSH_HOME/sessions，按工件版本分两种处理：
+ * - 当前版本工件：补标模式——xingyuan/* 未标记事件行补 `"ignorable": true`；
+ * - 历史版本工件：去毒模式——xingyuan/* 事件行替换为官方惰性事件 hook/invoked
+ *   （seq/time 不变），迁移链即可安全穿过、会话照常打开；代价是该会话历史卡片
+ *   事件不再回放（业务数据在 sqlite，不丢失）。仅当目录内无当前版本工件时才动
+ *   历史工件（dsh 只按最新代读取，旧代已不被消费）。
  *
  * 安全约束（改前必读，勿删）：
  * - 不含星愿事件的会话文件零写入（字节与 mtime 均不变）；
- * - 只有星愿事件行被重序列化（仅追加一个字段），其余行原样保留字节；
- *   行序与 seq 由构造保证不变（本模块从不增删移动任何行）；
+ * - 只有星愿事件行被重序列化（补标仅追加字段；去毒仅换 type/data），其余行原样
+ *   保留字节；行序与 seq 由构造保证不变（本模块从不增删移动任何行）；
  * - 首次改写前把原件备份到 <home>/xingyuan/session-backups/<项目目录>/，
  *   每会话保留最近 maxBackupPerSession 份；
  * - 任何看不懂的情况一律整文件跳过不动：撕裂尾、坏帧、header 版本不符、
@@ -28,7 +33,8 @@
  *   （历史上一次实现曾把整个文件重压成单帧导致宿主启动崩溃，已由本模块的
  *   relayout-only 路径兜底自愈），即使无需补标也会重写为合法布局。
  * - SESSION_FORMAT_VERSION 取自 @deepseek-ai/dsh-session。升级 dsh 时必须核对
- *   本模块的前提与布局契约仍然成立。
+ *   本模块的前提与布局契约仍然成立（尤其迁移链是否改为接受 ignorable 历史事件——
+ *   若接受，去毒模式可回归补标）。
  */
 /** $DSH_HOME 解析：环境变量优先，否则 ~/.dsh。 */
 export declare function resolveDshHome(): string;
@@ -54,8 +60,10 @@ export interface RepairReport {
     scanned: number;
     /** 实际改写的会话文件数。 */
     patched: number;
-    /** 补上 ignorable 标记的事件总数。 */
+    /** 补上 ignorable 标记的事件总数（当前格式工件）。 */
     eventsMarked: number;
+    /** 旧格式工件中替换为惰性事件的星愿事件总数（迁移链拒绝未知历史事件）。 */
+    neutralized: number;
     skipped: Partial<Record<SkipReason, number>>;
     warnings: string[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starwish-ai/xingyuan-dsh",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "星愿 XingYuan for DeepSeek Harness: 对话创建愿望/任务、机会日打卡、微行动、记忆与图表的 Agent Preset 组合包",
   "type": "module",
   "license": "MIT",
@@ -93,14 +93,14 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-storage": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-user-questions": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-storage": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-user-questions": "^0.1.5-rc.2",
     "@deepseek-ai/schemastery": "*",
     "react": "^18.2.0",
     "zod": "^4.4.3"
@@ -113,27 +113,28 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
     "@deepseek-ai/cordis-plugin-loader": "1.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-attachment": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-chat": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-storage": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-storage-domain": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-tools": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-user-questions": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-agent": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-chat": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session-format-catalog": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-storage": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-storage-domain": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-user-questions": "0.1.5-rc.2",
     "@deepseek-ai/schemastery": "^3.18.0",
     "@types/node": "^24.0.0",
     "@types/react": "~18.3.1",