@michengai/dsh-archive-manager 0.1.44 → 1.0.1

package/lib/contracts.js

@@ -0,0 +1,15 @@
+function record(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) throw new TypeError("\u53C2\u6570\u5FC5\u987B\u4E3A\u5BF9\u8C61");
+  return value;
+}
+function errorMessage(error) {
+  return String(error && typeof error === "object" && "message" in error ? error.message ?? error : error);
+}
+function errorCode(error) {
+  return error && typeof error === "object" && "code" in error ? error.code : void 0;
+}
+export {
+  errorCode,
+  errorMessage,
+  record
+};

package/lib/plugin-updater.js

@@ -1,3 +1,4 @@
+import { record } from "./contracts.js";
 import { spawn } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
@@ -41,8 +42,9 @@ function profileNameFromArgv(argv) {
 }
 function isDshCliEntry(entry, manifest, packageRoot) {
   if (typeof manifest !== "object" || manifest === null) return false;
-  if (manifest.name !== "@deepseek-ai/dsh") return false;
-  const bin = typeof manifest.bin === "string" ? manifest.bin : typeof manifest.bin === "object" && manifest.bin !== null ? manifest.bin.dsh : void 0;
+  if (("name" in manifest ? manifest.name : void 0) !== "@deepseek-ai/dsh") return false;
+  const item = manifest;
+  const bin = typeof item.bin === "string" ? item.bin : typeof item.bin === "object" && item.bin !== null ? "dsh" in item.bin ? item.bin.dsh : void 0 : void 0;
   return typeof bin === "string" && bin !== "" && !isAbsolute(bin) && resolve(packageRoot, bin) === resolve(entry);
 }
 function cliEntry() {
@@ -120,7 +122,7 @@ async function latestVersion(packageName) {
   try {
     const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`, { signal: AbortSignal.timeout(8e3) });
     if (!response.ok) return void 0;
-    const value = await response.json();
+    const value = record(await response.json());
     if (typeof value.version !== "string" || value.version === "") return void 0;
     latestCache = { packageName, version: value.version, expiresAt: Date.now() + 5 * 6e4 };
     return value.version;
@@ -129,7 +131,7 @@ async function latestVersion(packageName) {
   }
 }
 async function currentVersion(manifestUrl) {
-  const value = JSON.parse(await readFile(manifestUrl, "utf8"));
+  const value = record(JSON.parse(await readFile(manifestUrl, "utf8")));
   if (typeof value.version !== "string" || value.version === "") throw new Error("\u65E0\u6CD5\u8BFB\u53D6\u5F53\u524D\u63D2\u4EF6\u7248\u672C\u3002");
   return value.version;
 }
@@ -148,8 +150,9 @@ async function status(options, target) {
 }
 async function runCliInstall(target, packageSpec) {
   if (target.cliEntry === void 0) throw new Error("\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301\u81EA\u52A8\u66F4\u65B0\uFF0C\u8BF7\u4F7F\u7528\u624B\u5DE5\u66F4\u65B0\u547D\u4EE4\u3002");
+  const entry = target.cliEntry;
   await new Promise((resolvePromise, reject) => {
-    const child = spawn(process.execPath, [target.cliEntry, "plugin", "--profile", target.profileName, "add", "--config.minimumReleaseAge=0", packageSpec, "--registry=https://registry.npmjs.org/"], {
+    const child = spawn(process.execPath, [entry, "plugin", "--profile", target.profileName, "add", "--config.minimumReleaseAge=0", packageSpec, "--registry=https://registry.npmjs.org/"], {
       cwd: target.profileDir,
       windowsHide: true,
       stdio: ["ignore", "pipe", "pipe"],

package/lib/projcache.js

@@ -1,3 +1,4 @@
+const CacheBase = SessionProjectionCache;
 import { createHash } from "node:crypto";
 import { Service } from "@deepseek-ai/cordis";
 import {
@@ -115,7 +116,7 @@ async function readLegacySafeRecords(ctx, spec, label) {
   const source = await readSourceRecords(ctx, spec, label);
   const records = [];
   for (const [physicalKey, stored] of source.records) {
-    if (stored === null || typeof stored !== "object" || typeof stored.sessionId !== "string") {
+    if (stored === null || typeof stored !== "object" || !("sessionId" in stored) || typeof stored.sessionId !== "string") {
       ctx.logger.warn(`archive-manager projcache: ${label} row "${physicalKey}" import skipped because its session id is invalid`);
       continue;
     }
@@ -123,22 +124,23 @@ async function readLegacySafeRecords(ctx, spec, label) {
       ctx.logger.warn(`archive-manager projcache: ${label} row "${physicalKey}" import skipped because its storage key does not match the session id`);
       continue;
     }
-    records.push([stored.sessionId, unwrapStoredCheckpoint(stored)]);
+    records.push([stored.sessionId, { identity: "identity" in stored ? stored.identity : void 0, rows: "rows" in stored ? stored.rows : void 0 }]);
   }
   return { ...source, records };
 }
 function normalizeLegacyRecord(record) {
-  if (record === null || typeof record !== "object" || record.identity === null || typeof record.identity !== "object") return void 0;
+  if (record === null || typeof record !== "object" || !("identity" in record) || record.identity === null || typeof record.identity !== "object") return void 0;
   const identity = record.identity;
   const inheritedEventCount = identity.inheritedEventCount;
-  const validOffset = Number.isSafeInteger(inheritedEventCount) && inheritedEventCount >= 0;
+  const validOffset = typeof inheritedEventCount === "number" && Number.isSafeInteger(inheritedEventCount) && inheritedEventCount >= 0;
   if (identity.isSeeded === true) {
     if (!validOffset) return void 0;
+    checkpointRecord.parse(record);
     return record;
   }
   if (identity.isSeeded !== void 0 && identity.isSeeded !== false) return void 0;
   if (inheritedEventCount !== void 0 && inheritedEventCount !== 0) return void 0;
-  return {
+  const normalized = {
     ...record,
     identity: {
       ...identity,
@@ -146,6 +148,8 @@ function normalizeLegacyRecord(record) {
       inheritedEventCount: 0
     }
   };
+  checkpointRecord.parse(normalized);
+  return normalized;
 }
 async function importMissingRecords(ctx, target, records, label) {
   let imported = 0;
@@ -180,7 +184,7 @@ async function importPreviousProjectionCache(ctx, target) {
   if (legacy.opened) imported += await importMissingRecords(ctx, target, legacy.records, "legacy v3");
   return imported;
 }
-var ArchiveProjectionCache = class extends SessionProjectionCache {
+var ArchiveProjectionCache = class extends CacheBase {
   /** 已永久删除的会话：其投影缓存行不再允许写入。 */
   deletedSessionIds = /* @__PURE__ */ new Set();
   /** 墓碑插入顺序，用于在上限处淘汰最旧项。 */
@@ -234,7 +238,7 @@ var ArchiveProjectionCache = class extends SessionProjectionCache {
   }
   /** rc.2 公开的 fail-soft 辅助在 alpha.2 已移除；保留同形兼容入口。 */
   async putSoft(id, identity, rows, what) {
-    const upstream = SessionProjectionCache.prototype.putSoft;
+    const upstream = CacheBase.prototype.putSoft;
     if (typeof upstream === "function") return upstream.call(this, id, identity, rows, what);
     try {
       await this.put(id, identity, rows);

package/lib/session-repair.js

@@ -0,0 +1,135 @@
+import { record } from "./contracts.js";
+import { createHash, randomUUID } from "node:crypto";
+import { lstat, readFile, readdir, open, link, unlink, realpath, rename } from "node:fs/promises";
+import { join, resolve, basename } from "node:path";
+import * as zlib from "node:zlib";
+import { classifySessionError } from "./archive-discovery.js";
+const LIMIT = 32 * 1024 * 1024;
+function decompressFrame(bytes, maxOutputLength) {
+  const result = record(zlib.zstdDecompressSync(bytes, { info: true, maxOutputLength }));
+  const engine = record(result.engine);
+  if (!Buffer.isBuffer(result.buffer) || typeof engine.bytesWritten !== "number") throw new Error("\u538B\u7F29\u5E27\u8FD4\u56DE\u683C\u5F0F\u65E0\u6548");
+  return { buffer: result.buffer, engine: { bytesWritten: engine.bytesWritten } };
+}
+const digest = (bytes) => createHash("sha256").update(bytes).digest("hex");
+function decodeRepairLog(bytes, compressed) {
+  if (bytes.length > LIMIT) throw new Error("\u65E5\u5FD7\u8D85\u8FC7 32 MB\uFF0C\u9700\u79BB\u7EBF\u5904\u7406");
+  const chunks = [];
+  let offset = 0, size = 0;
+  if (compressed && typeof zlib.zstdDecompressSync !== "function") throw new Error("\u5F53\u524D Node.js \u4E0D\u652F\u6301\u538B\u7F29\u65E5\u5FD7\u8BCA\u65AD");
+  while (compressed && offset < bytes.length) {
+    const result = decompressFrame(bytes.subarray(offset), LIMIT - size);
+    if (!result.engine.bytesWritten) throw new Error("\u538B\u7F29\u65E5\u5FD7\u6CA1\u6709\u5B8C\u6574\u5E27");
+    offset += result.engine.bytesWritten;
+    size += result.buffer.length;
+    chunks.push(result.buffer);
+    if (size > LIMIT) throw new Error("\u89E3\u538B\u65E5\u5FD7\u8D85\u8FC7 32 MB\uFF0C\u9700\u79BB\u7EBF\u5904\u7406");
+  }
+  const text = new TextDecoder("utf-8", { fatal: true }).decode(compressed ? Buffer.concat(chunks) : bytes);
+  if (!text.endsWith("\n")) throw new Error("\u65E5\u5FD7\u672B\u5C3E\u4E0D\u5B8C\u6574\uFF0C\u4E0D\u80FD\u81EA\u52A8\u4FEE\u590D");
+  return text.trimEnd().split("\n").map((line) => record(JSON.parse(line)));
+}
+function normalizeAutomationSources(input) {
+  const rows = structuredClone(input);
+  let count = 0;
+  const fix = (value) => {
+    if (!value || typeof value !== "object") return;
+    const message = record(value);
+    const candidate = message.source;
+    if (!candidate || typeof candidate !== "object") return;
+    const source = record(candidate);
+    if (source?.kind !== "automation") return;
+    if (Object.keys(source).some((key) => !["kind", "automationId", "runId", "scheduledFor"].includes(key)) || !["automationId", "runId", "scheduledFor"].every((key) => typeof source[key] === "string" && source[key].length > 0 && source[key].length < 512) || !Number.isFinite(Date.parse(String(source.scheduledFor)))) {
+      throw new Error("\u81EA\u52A8\u5316\u5F52\u5C5E\u4FE1\u606F\u4E0D\u5B8C\u6574\u6216\u5B58\u5728\u672A\u77E5\u5B57\u6BB5\uFF0C\u9700\u4EBA\u5DE5\u68C0\u67E5");
+    }
+    message.source = { kind: "plugin", plugin: "dsh-automation", form: "notice", summary: JSON.stringify(source) };
+    count++;
+  };
+  for (const row of rows.slice(1)) {
+    const data = row.data && typeof row.data === "object" ? record(row.data) : {};
+    if (row.type === "user/message") fix(data);
+    if (typeof row.type === "string" && ["assistant/message", "tool/result"].includes(row.type)) fix(data.message);
+    if (row.type === "agent/inbox/spliced") Array.isArray(data.inserted) && data.inserted.forEach(fix);
+    if (row.type === "session/title-llm-request") Array.isArray(data.messages) && data.messages.forEach(fix);
+  }
+  return { rows, count };
+}
+async function regularFile(path) {
+  const stat = await lstat(path);
+  if (!stat.isFile() || stat.isSymbolicLink() || stat.size > LIMIT) throw new Error("\u5DE5\u4EF6\u4E0D\u662F\u53EF\u5B89\u5168\u5904\u7406\u7684\u5E38\u89C4\u65E5\u5FD7\u6587\u4EF6");
+}
+async function prepareAutomationRepair({ directory, target, sessionId, format }) {
+  if (!format || format.currentVersion !== 3 || typeof format.createRestore !== "function") throw new Error("\u5F53\u524D\u5BBF\u4E3B\u4E0D\u652F\u6301\u6B64\u4FEE\u590D\uFF0C\u8BF7\u5347\u7EA7 DSH \u540E\u91CD\u8BD5");
+  if (resolve(await realpath(directory)).toLowerCase() !== resolve(directory).toLowerCase()) throw new Error("\u4F1A\u8BDD\u76EE\u5F55\u5B58\u5728\u94FE\u63A5\u91CD\u5B9A\u5411\uFF0C\u9700\u4EBA\u5DE5\u5904\u7406");
+  const names = (await readdir(directory)).filter((name) => /^session(?:\.v[1-9][0-9]*)?\.jsonl(?:\.zstd)?$/.test(name));
+  const sources = names.filter((name) => /^session\.jsonl(?:\.zstd)?$/.test(name));
+  if (sources.length !== 1 || names.some((name) => name !== sources[0] && name !== basename(target))) throw new Error("\u53D1\u73B0\u591A\u4E2A\u6216\u975E\u65E7\u7248\u65E5\u5FD7\u5DE5\u4EF6\uFF0C\u8BF7\u5148\u68C0\u67E5\u4EE3\u9645\u72B6\u6001");
+  const source = join(directory, sources[0]);
+  await regularFile(source);
+  const bytes = await readFile(source);
+  const rows = decodeRepairLog(bytes, source.endsWith(".zstd"));
+  if (rows[0]?.type !== "session" || rows[0]?.version !== 0 || rows[0]?.id !== sessionId) throw new Error("\u65E5\u5FD7\u8EAB\u4EFD\u6216\u7248\u672C\u4E0D\u5339\u914D\uFF0C\u4E0D\u80FD\u81EA\u52A8\u4FEE\u590D");
+  const normalized = normalizeAutomationSources(rows);
+  if (!normalized.count) throw new Error("\u672A\u627E\u5230\u7B26\u5408\u4FEE\u590D\u89C4\u5219\u7684\u81EA\u52A8\u5316\u6765\u6E90");
+  const restore = format.createRestore(normalized.rows[0]);
+  normalized.rows.slice(1).forEach((row) => restore.decodeRow(row));
+  const artifact = restore.finish();
+  const lines = [format.encodeHeader(artifact.header, artifact.inheritedEventCount), ...artifact.events.map((event) => format.encodeEvent(event))];
+  const verify = format.createRestore(lines[0]);
+  lines.slice(1).forEach((row) => verify.decodeRow(row));
+  const checked = verify.finish();
+  await format.validate?.(checked);
+  if (checked.header.id !== sessionId || checked.events.length !== artifact.events.length || checked.inheritedEventCount !== artifact.inheritedEventCount) throw new Error("\u751F\u6210\u7269\u6821\u9A8C\u5931\u8D25");
+  const plain = Buffer.from(lines.map((row) => JSON.stringify(row)).join("\n") + "\n", "utf8");
+  if (plain.length > LIMIT) throw new Error("\u4FEE\u590D\u7ED3\u679C\u8D85\u8FC7\u5904\u7406\u4E0A\u9650");
+  const compress = (value) => zlib.zstdCompressSync(value, { params: { [zlib.constants.ZSTD_c_checksumFlag]: 1 } });
+  const headerBytes = Buffer.from(JSON.stringify(lines[0]) + "\n", "utf8");
+  const output = target.endsWith(".zstd") ? Buffer.concat([compress(headerBytes), ...lines.length > 1 ? [compress(plain.subarray(headerBytes.length))] : []]) : plain;
+  await format.validateBytes?.(output);
+  let previousTarget;
+  if (names.includes(basename(target))) {
+    await regularFile(target);
+    previousTarget = await readFile(target);
+    if (!target.endsWith(".zstd")) throw new Error("\u5DF2\u6709\u65B0\u7248\u65E5\u5FD7\uFF0C\u4E0D\u80FD\u8986\u76D6");
+    const first = decompressFrame(previousTarget, LIMIT);
+    if (first.engine.bytesWritten !== previousTarget.length || !first.buffer.equals(plain) || first.buffer.indexOf(10) === first.buffer.length - 1) throw new Error("\u5DF2\u6709\u65E5\u5FD7\u4E0E\u65E7\u7248\u4FEE\u590D\u4EA7\u7269\u4E0D\u5339\u914D\uFF0C\u4E0D\u80FD\u8986\u76D6");
+  }
+  const token = digest(previousTarget ? Buffer.concat([bytes, previousTarget]) : bytes);
+  const unchanged = async () => {
+    if (digest(await readFile(source)) !== digest(bytes)) throw new Error("\u65E5\u5FD7\u5DF2\u53D8\u5316\uFF0C\u8BF7\u91CD\u65B0\u8BCA\u65AD");
+    if (previousTarget) {
+      await regularFile(target);
+      if (digest(await readFile(target)) !== digest(previousTarget)) throw new Error("\u4FEE\u590D\u4EA7\u7269\u5DF2\u53D8\u5316\uFF0C\u8BF7\u91CD\u65B0\u8BCA\u65AD");
+    }
+  };
+  return { token, correctingFrame: Boolean(previousTarget), count: normalized.count, source, async publish(expectedToken, ensureIdle) {
+    if (expectedToken !== token) throw new Error("\u65E5\u5FD7\u5DF2\u53D8\u5316\uFF0C\u8BF7\u91CD\u65B0\u8BCA\u65AD");
+    await ensureIdle();
+    await regularFile(source);
+    await unchanged();
+    const temp = join(directory, ".archive-repair-" + randomUUID());
+    let handle;
+    try {
+      handle = await open(temp, "wx", 384);
+      await handle.writeFile(output);
+      await handle.sync();
+      await handle.close();
+      handle = void 0;
+      await ensureIdle();
+      await unchanged();
+      if (previousTarget) await rename(temp, target);
+      else await link(temp, target);
+    } finally {
+      if (handle) await handle.close();
+      await unlink(temp).catch((error) => {
+        if (error.code !== "ENOENT") throw error;
+      });
+    }
+  } };
+}
+export {
+  classifySessionError,
+  decodeRepairLog,
+  normalizeAutomationSources,
+  prepareAutomationRepair
+};

package/lib/workspace.js

@@ -1,9 +1,22 @@
+import { record, errorMessage, errorCode } from "./contracts.js";
+import * as SessionRuntime from "@deepseek-ai/dsh-session";
+import { prepareAutomationRepair } from "./session-repair.js";
+import { repairInputSchema, classifySessionError, detailsInputSchema, countConversationTurns, discoveryInvocations, searchInputSchema, previewInputSchema, extractConversation, findContentMatch, previewConversation } from "./archive-discovery.js";
 import { lstat, rm } from "node:fs/promises";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { WorkspaceRegistry } from "@deepseek-ai/dsh-workspace";
 import { bindTypertRemote, Remote } from "@deepseek-ai/dsh-typert-protocol";
 import { sessionDir } from "@deepseek-ai/dsh-spill-local";
 import { trackTombstone } from "./tombstone.js";
+import { defineDomain } from "@deepseek-ai/dsh-storage-domain";
+import { favoriteInputSchema, favoriteStateSchema, favoriteInvocations } from "./archive-organizer.js";
+const favoriteDomainSpec = defineDomain({
+  name: "archive_manager_favorites",
+  version: 1,
+  tables: {},
+  // 宿主运行时仅调用 parse/safeParse；兼容早期同构 schema，不新增 Zod 运行依赖。
+  global: { schema: favoriteStateSchema, initial: { favoriteSessionIds: [] } }
+});
 function jsonlSessionDirectory(persistence, header, location) {
   if (persistence.name !== "session-persistence-jsonl" || location.kind !== "jsonl")
     return;
@@ -47,7 +60,8 @@ function markRemoteMethod(instance, method) {
       fn.call(instance);
     }
   };
-  Remote(method)(void 0, context);
+  Remote(method)(function() {
+  }, { ...context, kind: "method", access: { has: (value) => method in value, get: (value) => Reflect.get(value, method) }, metadata: void 0 });
 }
 function headerIdentity(header) {
   return {
@@ -65,7 +79,8 @@ const sessionIdSchema = {
   }
 };
 const archivedSetSchema = {
-  parse(value) {
+  parse(input) {
+    const value = record(input);
     if (typeof value !== "object" || value === null || Array.isArray(value))
       throw new TypeError("result must be an object");
     const ids = value.archivedSessionIds;
@@ -75,14 +90,16 @@ const archivedSetSchema = {
   }
 };
 const deletedSchema = {
-  parse(value) {
+  parse(input) {
+    const value = record(input);
     if (typeof value !== "object" || value === null || Array.isArray(value) || value.deleted !== true)
       throw new TypeError("deleted must be true");
     return value;
   }
 };
 const archivedBatchTargetSchema = {
-  parse(value) {
+  parse(input) {
+    const value = record(input);
     if (typeof value !== "object" || value === null || Array.isArray(value))
       throw new TypeError("target must be an object");
     if (value.scope === "all" || value.scope === "ungrouped") return value;
@@ -96,7 +113,8 @@ const archivedBatchTargetSchema = {
   }
 };
 const deletedBatchSchema = {
-  parse(value) {
+  parse(input) {
+    const value = record(input);
     if (typeof value !== "object" || value === null || Array.isArray(value))
       throw new TypeError("result must be an object");
     for (const key of [
@@ -115,7 +133,8 @@ const deletedBatchSchema = {
   }
 };
 const archivedSessionMetadataSchema = {
-  parse(value) {
+  parse(input) {
+    const value = record(input);
     if (typeof value !== "object" || value === null || Array.isArray(value) || !Array.isArray(value.items))
       throw new TypeError("result.items must be an array");
     if (value.items.some(
@@ -128,6 +147,8 @@ const archivedSessionMetadataSchema = {
   }
 };
 const ARCHIVE_MANAGER_INVOCATIONS = [
+  ...favoriteInvocations(),
+  ...discoveryInvocations(),
   {
     id: "@michengai/dsh-archive-manager#workspaceRegistry/unarchiveSession",
     service: "workspaceRegistry",
@@ -258,8 +279,217 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
     markRemoteMethod(this, "deleteSession");
     markRemoteMethod(this, "deleteArchivedSessions");
     markRemoteMethod(this, "archivedSessionMetadata");
+    markRemoteMethod(this, "favoriteSessions");
+    markRemoteMethod(this, "setSessionFavorite");
+    markRemoteMethod(this, "searchArchivedContent");
+    markRemoteMethod(this, "searchSessionContent");
+    markRemoteMethod(this, "previewArchivedSession");
+    markRemoteMethod(this, "sessionDetails");
+    markRemoteMethod(this, "diagnoseSession");
+    markRemoteMethod(this, "repairSession");
     registerHostRemote(this.ctx);
   }
+  /** 只读取归档日志；已有实时实例读取快照，不调用 prepare、enter 或恢复接口。 */
+  async readArchivedConversation(sessionId) {
+    const ensureArchived = () => {
+      if (!this.requireState().archivedSessionIds.includes(sessionId)) throw new Error("\u4F1A\u8BDD\u5DF2\u4E0D\u5728\u5F52\u6863\u4E2D\uFF0C\u8BF7\u5237\u65B0\u5217\u8868");
+    };
+    ensureArchived();
+    const events = await this.readConversationEvents(sessionId);
+    ensureArchived();
+    return extractConversation(events);
+  }
+  /** 复用宿主只读接口读取事件，不激活会话。 */
+  async readConversationEvents(sessionId) {
+    const live = this.ctx.get("sessions")?.get(sessionId);
+    if (typeof live?.snapshotEvents === "function") return live.snapshotEvents();
+    const persistence = this.ctx.get("sessionPersistence");
+    if (!persistence || typeof persistence.readFrom !== "function" && typeof persistence.open !== "function") throw new Error("\u5F53\u524D\u5BBF\u4E3B\u4E0D\u652F\u6301\u53EA\u8BFB\u4F1A\u8BDD\uFF0C\u8BF7\u6253\u5F00\u5B8C\u6574\u4F1A\u8BDD\u67E5\u770B");
+    return (await this.readStoredProjectionSource(persistence, sessionId)).events;
+  }
+  /** 只读取当前宿主已知会话；路径由宿主定位，不根据错误文本或 ID 拼接。 */
+  async sessionDetails(input) {
+    const { sessionIds } = detailsInputSchema.parse(input);
+    const items = [];
+    for (const sessionId of sessionIds) {
+      const item = { sessionId, turnCount: null, path: null, error: "" };
+      try {
+        if (!await this.sessionKnown(sessionId)) throw new Error("\u4F1A\u8BDD\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5237\u65B0\u5217\u8868");
+        const header = await this.readSessionHeader(sessionId);
+        if (Number.isSafeInteger(header.createdAt) && header.createdAt >= 0) item.createdAt = header.createdAt;
+        const persistence = this.ctx.get("sessionPersistence");
+        try {
+          const location = typeof persistence?.locate === "function" ? await persistence.locate(header) : void 0;
+          if (typeof location?.path === "string") {
+            const path = jsonlSessionDirectory(persistence, header, location) ?? location.path;
+            await lstat(path);
+            item.path = path;
+          }
+        } catch (error) {
+          item.error = "\u8DEF\u5F84\u4E0D\u53EF\u7528\uFF1A" + errorMessage(error).slice(0, 350);
+        }
+        item.turnCount = countConversationTurns(await this.readConversationEvents(sessionId));
+      } catch (error) {
+        item.error = errorMessage(error).slice(0, 500);
+      }
+      items.push(item);
+    }
+    return { items };
+  }
+  /** 诊断与执行共用同一工件校验；客户端不能提供文件路径。 */
+  async sessionRepairPlan(sessionId) {
+    if (!await this.sessionKnown(sessionId)) throw new Error("\u4F1A\u8BDD\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5237\u65B0\u5217\u8868");
+    await this.ensureSessionRepairIdle(sessionId);
+    const persistence = this.ctx.get("sessionPersistence");
+    const header = await this.readSessionHeader(sessionId);
+    const location = await persistence?.locate?.(header);
+    const directory = location && jsonlSessionDirectory(persistence, header, location);
+    if (!directory || !/^session\.v3\.jsonl(?:\.zstd)?$/.test(basename(location.path))) throw new Error("\u5F53\u524D\u5B58\u50A8\u540E\u7AEF\u6216\u683C\u5F0F\u4E0D\u652F\u6301\u81EA\u52A8\u4FEE\u590D");
+    return prepareAutomationRepair({ directory, target: location.path, sessionId, format: { ...persistence.generationFormat, validateBytes: async (bytes) => {
+      if (location.path.endsWith(".zstd")) {
+        if (typeof persistence.readZstdPrefix !== "function") throw new Error("\u5F53\u524D\u5BBF\u4E3B\u7F3A\u5C11\u538B\u7F29\u65E5\u5FD7\u6821\u9A8C\u80FD\u529B");
+        const parsed = await persistence.readZstdPrefix(bytes);
+        if (parsed.meta.id !== sessionId || parsed.tornTruncateTo !== void 0) throw new Error("\u751F\u6210\u7684\u538B\u7F29\u65E5\u5FD7\u672A\u901A\u8FC7\u5BBF\u4E3B\u6821\u9A8C");
+      }
+    }, validate: (artifact) => {
+      if (typeof SessionRuntime.Session?.fromRestore !== "function") throw new Error("\u5F53\u524D\u5BBF\u4E3B\u7F3A\u5C11\u5B8C\u6574\u4F1A\u8BDD\u6821\u9A8C\u80FD\u529B");
+      SessionRuntime.Session.fromRestore(artifact.header.id, artifact.events, artifact.header, artifact.inheritedEventCount, "detached");
+    } } });
+  }
+  async ensureSessionRepairIdle(sessionId) {
+    if (!this.requireState().archivedSessionIds.includes(sessionId)) throw new Error("\u8BF7\u5148\u5F52\u6863\u4F1A\u8BDD\uFF0C\u518D\u8FDB\u884C\u4FEE\u590D");
+    if (this.ctx.get("sessions")?.get(sessionId)) throw new Error("\u4F1A\u8BDD\u4ECD\u5728\u5BBF\u4E3B\u5185\u6253\u5F00\uFF0C\u8BF7\u5173\u95ED\u4F1A\u8BDD\u5E76\u91CD\u542F DSH \u540E\u4FEE\u590D");
+  }
+  async diagnoseSession(input) {
+    const { sessionId } = repairInputSchema.parse(input);
+    const result = { code: "unknown", sessionId, repairable: false, repaired: false, token: "", count: 0, reason: "", advice: "" };
+    try {
+      if (!await this.sessionKnown(sessionId)) throw new Error("\u4F1A\u8BDD\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5237\u65B0\u5217\u8868");
+      await this.readConversationEvents(sessionId);
+      return { ...result, code: "healthy", reason: "\u4F1A\u8BDD\u5DF2\u53EF\u6B63\u5E38\u8BFB\u53D6", advice: "\u5237\u65B0\u4F1A\u8BDD\u8BE6\u60C5\u5373\u53EF\uFF0C\u65E0\u9700\u4FEE\u590D\u3002" };
+    } catch (error) {
+      const diagnostic = classifySessionError(error);
+      result.code = diagnostic.code;
+      result.reason = diagnostic.reason;
+      result.advice = diagnostic.advice;
+    }
+    try {
+      const plan = await this.sessionRepairPlan(sessionId);
+      return {
+        ...result,
+        code: plan.correctingFrame ? "ready-frame" : "ready",
+        repairable: true,
+        token: plan.token,
+        count: plan.count,
+        reason: plan.correctingFrame ? "\u53D1\u73B0\u65E7\u7248\u4FEE\u590D\u7684\u538B\u7F29\u5E27\u95EE\u9898\uFF0C\u5DF2\u901A\u8FC7\u5BBF\u4E3B\u8BFB\u53D6\u6821\u9A8C" : `\u53D1\u73B0 ${plan.count} \u5904\u65E7\u81EA\u52A8\u5316\u6765\u6E90\uFF0C\u5DF2\u901A\u8FC7\u5BBF\u4E3B\u683C\u5F0F\u8F6C\u6362\u6821\u9A8C`,
+        advice: "\u5C06\u6765\u6E90\u8F6C\u6362\u4E3A dsh-automation \u63D2\u4EF6\u5F52\u5C5E\uFF0C\u4FDD\u7559\u4EFB\u52A1\u4FE1\u606F\u4E0E\u6B63\u6587\uFF0C\u751F\u6210\u65B0\u7248\u65E5\u5FD7\uFF1B\u65E7\u65E5\u5FD7\u539F\u6837\u4FDD\u7559\u3002\u8BF7\u786E\u4FDD\u5176\u4ED6 DSH \u8FDB\u7A0B\u672A\u6253\u5F00\u8BE5\u4F1A\u8BDD\u3002"
+      };
+    } catch (error) {
+      return {
+        ...result,
+        code: result.code === "unknown" ? "blocked" : result.code,
+        advice: (result.advice + " \u6682\u4E0D\u80FD\u81EA\u52A8\u4FEE\u590D\uFF1A" + errorMessage(error)).slice(0, 1e3)
+      };
+    }
+  }
+  async repairSession(input) {
+    const { sessionId, token } = repairInputSchema.parse(input);
+    if (!token) throw new Error("\u8BF7\u5148\u8BCA\u65AD\uFF0C\u518D\u786E\u8BA4\u4FEE\u590D");
+    return this.enqueueOperation(async () => {
+      const plan = await this.sessionRepairPlan(sessionId);
+      const persistence = this.ctx.get("sessionPersistence");
+      if (typeof persistence.acquireLease !== "function") throw new Error("\u5F53\u524D\u5BBF\u4E3B\u7F3A\u5C11\u4F1A\u8BDD\u5199\u9501\uFF0C\u65E0\u6CD5\u5B89\u5168\u4FEE\u590D");
+      const lease = await persistence.acquireLease(sessionId, void 0, dirname(plan.source));
+      try {
+        await plan.publish(token, () => this.ensureSessionRepairIdle(sessionId));
+      } finally {
+        await lease.release();
+      }
+      try {
+        await this.readConversationEvents(sessionId);
+      } catch {
+        return { sessionId, repairable: false, repaired: false, token: "", count: plan.count, code: "published-unreadable", reason: "\u65B0\u7248\u65E5\u5FD7\u5DF2\u751F\u6210\uFF0C\u4F46\u5BBF\u4E3B\u590D\u8BFB\u672A\u901A\u8FC7", advice: "\u65E7\u65E5\u5FD7\u4ECD\u4FDD\u7559\uFF0C\u8BF7\u91CD\u542F DSH \u540E\u91CD\u65B0\u8BCA\u65AD\uFF1B\u4E0D\u8981\u53CD\u590D\u4FEE\u590D\u6216\u5220\u9664\u65E5\u5FD7\u3002" };
+      }
+      return { sessionId, repairable: false, repaired: true, token: "", count: plan.count, code: "repaired", reason: "\u4FEE\u590D\u5B8C\u6210\uFF0C\u5BBF\u4E3B\u5DF2\u80FD\u6B63\u5E38\u8BFB\u53D6", advice: "\u65E7\u65E5\u5FD7\u4FDD\u7559\uFF0C\u5F52\u6863\u72B6\u6001\u4E0D\u53D8\uFF1B\u53EF\u4EE5\u91CD\u65B0\u9884\u89C8\u6216\u6253\u5F00\u4F1A\u8BDD\u3002" };
+    });
+  }
+  /** 已归档与未归档共用正文检索；只读已知会话，不激活或改变归档状态。 */
+  async searchSessionContent(input) {
+    const { sessionIds, query } = searchInputSchema.parse(input);
+    const items = [], failures = [];
+    for (const sessionId of sessionIds) {
+      try {
+        if (!await this.sessionKnown(sessionId)) throw new Error("\u4F1A\u8BDD\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5237\u65B0\u5217\u8868");
+        const messages = extractConversation(await this.readConversationEvents(sessionId));
+        if (!await this.sessionKnown(sessionId)) throw new Error("\u4F1A\u8BDD\u5DF2\u79FB\u9664\uFF0C\u8BF7\u5237\u65B0\u5217\u8868");
+        const match = findContentMatch(messages, query);
+        if (match) items.push({ sessionId, ...match });
+      } catch (error) {
+        failures.push({ sessionId, message: errorMessage(error).slice(0, 500) });
+      }
+    }
+    return { items, failures };
+  }
+  /** 输入为限定批次的归档 ID 和关键词，逐条返回命中或失败。 */
+  async searchArchivedContent(input) {
+    const { sessionIds, query } = searchInputSchema.parse(input);
+    const items = [], failures = [];
+    for (const sessionId of sessionIds) {
+      try {
+        const match = findContentMatch(await this.readArchivedConversation(sessionId), query);
+        if (match) items.push({ sessionId, ...match });
+      } catch (error) {
+        failures.push({ sessionId, message: errorMessage(error).slice(0, 500) });
+      }
+    }
+    return { items, failures };
+  }
+  /** 返回最近八条对话或关键词附近的八条，单条最多 2000 字，不写入宿主数据。 */
+  async previewArchivedSession(input) {
+    const { sessionId, query } = previewInputSchema.parse(input);
+    return { sessionId, ...previewConversation(await this.readArchivedConversation(sessionId), query) };
+  }
+  /** 独立收藏域不改变官方工作区数据结构；旧版本回退时可保留收藏。 */
+  async favoriteDomain() {
+    if (!this.favoriteDomainPromise) {
+      this.favoriteDomainPromise = this.ctx.storageDomain.open(favoriteDomainSpec).then((domain) => {
+        this.ctx.effect(() => () => domain.close(), "archive-manager: \u6536\u85CF\u5B58\u50A8\u5173\u95ED");
+        return domain;
+      }).catch((error) => {
+        this.favoriteDomainPromise = void 0;
+        throw error;
+      });
+    }
+    return this.favoriteDomainPromise;
+  }
+  /** 返回宿主保存的收藏；读取时清理已确认不存在的会话。 */
+  async favoriteSessions() {
+    return this.enqueueOperation(async () => {
+      const domain = await this.favoriteDomain();
+      const state = favoriteStateSchema.parse(domain.global.get());
+      const kept = [];
+      for (const id of state.favoriteSessionIds) {
+        if (this.ctx.get("sessions")?.get(id) !== void 0 || !await this.sessionArtifactMissing(id)) kept.push(id);
+      }
+      if (kept.length !== state.favoriteSessionIds.length) await domain.global.set({ favoriteSessionIds: kept });
+      return { favoriteSessionIds: kept };
+    });
+  }
+  /** 设置单条收藏，串行写入避免不同浏览器相互覆盖。 */
+  async setSessionFavorite(input) {
+    const { sessionId, favorite } = favoriteInputSchema.parse(input);
+    return this.enqueueOperation(async () => {
+      if (favorite && !await this.sessionKnown(sessionId)) throw new Error("\u4F1A\u8BDD\u4E0D\u5B58\u5728\uFF0C\u65E0\u6CD5\u6536\u85CF");
+      const domain = await this.favoriteDomain();
+      const state = favoriteStateSchema.parse(domain.global.get());
+      const ids = new Set(state.favoriteSessionIds);
+      if (favorite) ids.add(sessionId);
+      else ids.delete(sessionId);
+      const next = favoriteStateSchema.parse({ favoriteSessionIds: [...ids] });
+      await domain.global.set(next);
+      return next;
+    });
+  }
   /** 归档集合未变时复用反查表，避免每次 sessionPath 都扫全部工作区记账。 */
   archivedWorkspacePath(sessionId) {
     const state = this.requireState();
@@ -269,10 +499,10 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
       const archived = new Set(state.archivedSessionIds);
       const table = this.requireTable();
       for (const workspaceId of state.workspaceIds) {
-        const record = table.get(workspaceId);
-        if (record === void 0) continue;
-        for (const id of record.sessionIds) {
-          if (archived.has(id)) index.set(id, record.path);
+        const record2 = table.get(workspaceId);
+        if (record2 === void 0) continue;
+        for (const id of record2.sessionIds) {
+          if (archived.has(id)) index.set(id, record2.path);
         }
       }
       this.archivedSessionPathIndex = index;
@@ -491,9 +721,9 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
     if (path === void 0) return;
     const table = this.requireTable();
     for (const workspaceId of this.requireState().workspaceIds) {
-      const record = table.get(workspaceId);
-      if (record === void 0 || record.path !== path) continue;
-      if (record.sessionIds.includes(sessionId)) return;
+      const record2 = table.get(workspaceId);
+      if (record2 === void 0 || record2.path !== path) continue;
+      if (record2.sessionIds.includes(sessionId)) return;
       const entity = this.entities.get(workspaceId);
       if (entity !== void 0) await entity.attachSession(sessionId);
       return;
@@ -552,8 +782,8 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
     }
   }
   /** 以归档集合顺序解析批量目标，避免依赖浏览器尚未加载完整的摘要投影。 */
-  archivedSessionIdsForTarget(target) {
-    target = archivedBatchTargetSchema.parse(target);
+  archivedSessionIdsForTarget(input) {
+    const target = archivedBatchTargetSchema.parse(input);
     const state = this.requireState();
     const archivedSessionIds = [...new Set(state.archivedSessionIds)];
     if (target.scope === "all") return archivedSessionIds;
@@ -709,11 +939,11 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
   /** 统一旧版头部数组与 0.1.3 的持久化快照，供父类索引和本插件枚举共用。 */
   async listStoredHeaders() {
     return (await this.ctx.sessionPersistence.list()).map(
-      (item) => item.header ?? item
+      (item) => "header" in item && item.header ? item.header : item
     );
   }
   async indexHeaders(items) {
-    for (const item of items) await this.indexHeader(item.header ?? item);
+    for (const item of items) await this.indexHeader("header" in item && item.header ? item.header : item);
   }
   /** 为未处于实时状态的持久化会话发布相同的移除事件。 */
   async publishColdSessionRemoval(sessionId, sessions) {
@@ -760,7 +990,7 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
           try {
             stat = await lstat(path);
           } catch (error) {
-            if (error?.code === "ENOENT") continue;
+            if (errorCode(error) === "ENOENT") continue;
             throw error;
           }
           if (stat.isSymbolicLink())
@@ -791,8 +1021,8 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
     const table = this.requireTable();
     const state = this.requireState();
     for (const workspaceId of state.workspaceIds) {
-      const record = table.get(workspaceId);
-      if (record === void 0 || !record.sessionIds.includes(sessionId)) continue;
+      const record2 = table.get(workspaceId);
+      if (record2 === void 0 || !record2.sessionIds.includes(sessionId)) continue;
       const next = await table.update(workspaceId, (current) => ({
         ...current,
         sessionIds: current.sessionIds.filter((id) => id !== sessionId),