@michengai/dsh-archive-manager 1.0.0 → 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

@@ -1,9 +1,16 @@
+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");
@@ -11,7 +18,7 @@ function decodeRepairLog(bytes, compressed) {
   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 = zlib.zstdDecompressSync(bytes.subarray(offset), { info: true, maxOutputLength: LIMIT - size });
+    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;
@@ -20,25 +27,30 @@ function decodeRepairLog(bytes, compressed) {
   }
   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) => JSON.parse(line));
+  return text.trimEnd().split("\n").map((line) => record(JSON.parse(line)));
 }
 function normalizeAutomationSources(input) {
   const rows = structuredClone(input);
   let count = 0;
-  const fix = (message) => {
-    const source = message?.source;
+  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(source.scheduledFor))) {
+    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)) {
-    if (row.type === "user/message") fix(row.data);
-    if (["assistant/message", "tool/result"].includes(row.type)) fix(row.data?.message);
-    if (row.type === "agent/inbox/spliced") row.data?.inserted?.forEach(fix);
-    if (row.type === "session/title-llm-request") row.data?.messages?.forEach(fix);
+    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 };
 }
@@ -79,7 +91,7 @@ async function prepareAutomationRepair({ directory, target, sessionId, format })
     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 = zlib.zstdDecompressSync(previousTarget, { info: true, maxOutputLength: LIMIT });
+    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);

package/lib/workspace.js

@@ -1,3 +1,4 @@
+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";
@@ -13,6 +14,7 @@ const favoriteDomainSpec = defineDomain({
   name: "archive_manager_favorites",
   version: 1,
   tables: {},
+  // 宿主运行时仅调用 parse/safeParse；兼容早期同构 schema，不新增 Zod 运行依赖。
   global: { schema: favoriteStateSchema, initial: { favoriteSessionIds: [] } }
 });
 function jsonlSessionDirectory(persistence, header, location) {
@@ -58,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 {
@@ -76,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;
@@ -86,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;
@@ -107,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 [
@@ -126,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(
@@ -318,11 +326,11 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
             item.path = path;
           }
         } catch (error) {
-          item.error = "\u8DEF\u5F84\u4E0D\u53EF\u7528\uFF1A" + String(error?.message ?? error).slice(0, 350);
+          item.error = "\u8DEF\u5F84\u4E0D\u53EF\u7528\uFF1A" + errorMessage(error).slice(0, 350);
         }
         item.turnCount = countConversationTurns(await this.readConversationEvents(sessionId));
       } catch (error) {
-        item.error = String(error?.message ?? error).slice(0, 500);
+        item.error = errorMessage(error).slice(0, 500);
       }
       items.push(item);
     }
@@ -354,7 +362,7 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
   }
   async diagnoseSession(input) {
     const { sessionId } = repairInputSchema.parse(input);
-    const result = { sessionId, repairable: false, repaired: false, token: "", count: 0, reason: "", advice: "" };
+    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);
@@ -380,7 +388,7 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
       return {
         ...result,
         code: result.code === "unknown" ? "blocked" : result.code,
-        advice: (result.advice + " \u6682\u4E0D\u80FD\u81EA\u52A8\u4FEE\u590D\uFF1A" + String(error?.message ?? error)).slice(0, 1e3)
+        advice: (result.advice + " \u6682\u4E0D\u80FD\u81EA\u52A8\u4FEE\u590D\uFF1A" + errorMessage(error)).slice(0, 1e3)
       };
     }
   }
@@ -417,7 +425,7 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
         const match = findContentMatch(messages, query);
         if (match) items.push({ sessionId, ...match });
       } catch (error) {
-        failures.push({ sessionId, message: String(error?.message ?? error).slice(0, 500) });
+        failures.push({ sessionId, message: errorMessage(error).slice(0, 500) });
       }
     }
     return { items, failures };
@@ -431,7 +439,7 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
         const match = findContentMatch(await this.readArchivedConversation(sessionId), query);
         if (match) items.push({ sessionId, ...match });
       } catch (error) {
-        failures.push({ sessionId, message: String(error?.message ?? error).slice(0, 500) });
+        failures.push({ sessionId, message: errorMessage(error).slice(0, 500) });
       }
     }
     return { items, failures };
@@ -491,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;
@@ -713,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;
@@ -774,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;
@@ -931,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) {
@@ -982,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())
@@ -1013,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),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-archive-manager",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "NPM-installable DSH Web plugin for managing archived sessions.",
   "type": "module",
   "packageManager": "pnpm@11.22.0",
@@ -23,19 +23,20 @@
     "README.zh-CN.md",
     "LICENSE",
     "CHANGELOG.md",
-    "CHANGELOG.zh-CN.md",
-    "RELEASE_NOTES.md"
+    "CHANGELOG.zh-CN.md"
   ],
   "scripts": {
-    "build": "node scripts/build.mjs && node scripts/check-package.mjs",
-    "test": "pnpm build && node --test test/*.test.mjs",
+    "build": "pnpm typecheck && node scripts/build.mjs && node scripts/check-package.mjs",
+    "test": "pnpm build && node --import tsx --test test/*.test.mjs",
     "test:matrix": "pnpm build && node scripts/test-version-matrix.mjs",
     "test:latest": "pnpm build && node scripts/test-latest-compatibility.mjs",
-    "test:compat": "node scripts/test-legacy-compatibility.mjs && pnpm test:matrix",
+    "test:compat": "pnpm build && node scripts/test-legacy-compatibility.mjs && pnpm test:matrix",
     "pack:check": "pnpm pack --dry-run",
     "verify": "pnpm test && pnpm test:compat && pnpm pack:check && node scripts/check-generated.mjs",
     "release:preflight": "pwsh -NoProfile -File scripts/release-preflight.ps1",
-    "prepublishOnly": "pnpm verify"
+    "prepublishOnly": "pnpm verify",
+    "prepack": "pnpm build",
+    "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -90,12 +91,17 @@
     "@deepseek-ai/dsh-typert-protocol": "0.1.6-alpha.2",
     "@deepseek-ai/dsh-typert-registry": "0.1.6-alpha.2",
     "@deepseek-ai/dsh-workspace": "0.1.6-alpha.2",
-    "react": "18.3.1",
-    "react-dom": "18.3.1",
+    "@types/node": "^22.20.4",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.0.0",
     "esbuild": "0.25.0",
-    "zustand": "4.4.7",
     "immer": "10.1.1",
-    "semver": "7.7.2"
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "semver": "7.7.2",
+    "tsx": "^4.23.13",
+    "typescript": "5.9.3",
+    "zustand": "4.4.7"
   },
   "license": "Apache-2.0",
   "dsh": {

package/RELEASE_NOTES.md

@@ -1,113 +0,0 @@
-## 中文说明
-
-从 0.1.44 升级到首个 1.0 正式版本，集中完善会话整理、检索、预览与异常修复。沿用原有安装包名和数据，不要求迁移会话；现有归档、恢复、永久删除及原生会话导航继续保留。
-
-### 会话列表与统一筛选
-
-- 已归档、未归档两页统一支持标题／正文搜索、项目、收藏和更新时间范围筛选；默认只搜索标题，搜索框左侧切换范围，右侧打开日期选择器。结束日期包含本地当天，支持独立清除日期及点击外部关闭。
-- 使用紧凑项目分组列表，项目可折叠；标题点击打开原生会话，星标、恢复／归档使用右侧图标，更多菜单提供恢复打开、预览、复制与删除等适用操作。
-- 支持更新时间、创建时间、标题和轮次升降序排序；分组计数跟随筛选，空态区分当前页签。
-- 全选只覆盖当前筛选结果，包含折叠组中的匹配项；切页签清空选择，改变筛选保留选择并提示隐藏选中项。项目菜单仍操作整个项目，不受筛选影响。
-- 移除重复的页面级「全部恢复／全部删除」按钮；保留勾选批量操作及项目菜单，操作结果按页签隔离。
-
-### 收藏、闲置整理与批量操作
-
-- 两页均可收藏／取消收藏，通过下拉菜单只看收藏；收藏保存于宿主，归档、恢复和更换浏览器后保留。索引暂时未知或读取失败不会清除收藏，只有确证工件缺失时才清理。
-- 未归档页支持设置 1～36500 个整数闲置天数，结合当前筛选预览候选；确认清单可逐条取消。排除收藏、当前打开、正在执行及等待交互的会话，并考虑子代理活动；无有效活动时间不参与。
-- 归档前再次检查收藏和活动状态。批量归档、恢复、删除显示进度及成功／跳过／失败／未处理明细；遇到首个失败停止，允许只重试剩余项，删除重试仍需确认。
-- 支持「撤回本次归档」，恢复最近一批实际成功归档及重试成功的会话；仅当前管理页打开期间有效，不撤回永久删除。
-
-### 正文检索与快速预览
-
-- 在用户与助手的持久化正文中查找关键词，显示命中片段和高亮；读取失败显示明细并支持重试，更改筛选后旧响应不会覆盖新结果。
-- 已归档会话可不恢复直接预览，展示首个命中附近上下文或最近八条消息；未归档命中片段打开完整会话。
-- 预览支持 Markdown 表格、引用、代码块和角色区分，可切换原文高亮；加宽弹窗并补齐操作图标。
-- 修复大小写折叠引起的 Unicode 偏移错误、截断切开代理对、Esc 连带关闭设置，以及切换页签后预览自行重开。
-
-### 轮次统计与会话定位
-
-- 两页显示用户提交轮次，包括图片消息及分支继承的用户消息，不把助手回复、工具调用或插件注入算作轮次。
-- 提供轮次最多／最少排序，未知轮次始终置后；详情读取失败可查看并重试。
-- 更多菜单支持分别复制会话 ID 和路径。官方 JSONL 后端复制会话目录，其他后端使用宿主返回的有效路径；路径缺失和剪贴板失败均明确提示。
-
-### 异常诊断与定向修复
-
-- 已归档页汇总异常会话，包括缺少摘要的归档 ID；诊断区使用可折叠状态卡片，提供分类建议及技术详情。
-- 缺文件、权限、损坏等分类优先使用稳定错误码、兼容文案兜底；诊断发现不能自动修复时仍保留原分类，追加受限原因。
-- 对支持的旧自动化消息来源提供「诊断 → 确认修复」流程。以实际工件、宿主格式校验和写锁判断资格，不仅依赖错误措辞；要求已归档且未被任何 DSH 进程打开。
-- 保留原始日志、正文、任务归属和继承信息，经宿主重新编码与校验后发布新代际；修复文件使用私有权限。发布采用禁止覆盖策略，硬链接不可用时安全失败，不覆盖现有日志。
-
-### 界面、国际化与兼容性
-
-- 对齐官方主题的选中、复选框、焦点、警告、更新按钮及高亮配色；完善日期下拉、诊断卡片、星标和操作图标。
-- 补齐诊断、预览、更新入口和错误提示的中英文；切换语言不再额外触发详情读取，修复复制错误和空态文案。
-- 更新已归档／未归档截图及双语 README，完整说明筛选、撤回、修复与检索边界。
-- 保持既有 DSH 支持范围：0.1.0-rc.8、0.1.1-rc.2、0.1.2-rc.1、0.1.5-rc.1、0.1.5-rc.2、0.1.6-alpha.1、0.1.6-alpha.2；与 Codex UI 共存，不新增侧栏置顶或收藏功能。
-- 正式检索接口为 searchSessionContent，支持两种归档状态；searchArchivedContent 保留为旧宿主／客户端的归档专用兼容入口，不重复调用。
-
-### 使用边界与验证
-
-- 正文检索和轮次没有持久化索引；每批最多 20 条会话、批内逐条读取。大量或超长日志建议先缩小范围，尚无规模或时延承诺；在途批次不能中止，取消只阻止后续批次及旧结果回写。
-- 检索关键词最多 200 字符；不搜索工具输出、附件、推理、系统和插件注入。预览每条最多 2000 个 UTF-16 码元，保留完整 Unicode 字符；完整内容通过原生会话查看。
-- 没有后台定时归档；收藏保护仅适用于闲置整理。其他页面的收藏变更需重开管理页读取；撤回记录在关闭或刷新后消失。
-- 自动修复不是通用日志恢复工具：缺失、权限及不支持的损坏只提供建议，不删除或截断消息。永久删除不可撤销；本轮不新增任务摘要和 Markdown 导出。
-- 功能候选已通过本地回归、支持宿主隔离矩阵及真实 DSH 0.1.6-alpha.2 浏览器冒烟，覆盖检索、预览、收藏、批量操作、诊断与修复。真实模型发送、流式回复、工具审批和未知宿主版本不在本次验收承诺内。
-- 宿主设置窗口在极窄屏下的遮挡仍需宿主侧修复；未承诺所有移动端布局均可用。
-
----
-
-## English
-
-The first 1.0 release expands session organization, search, previews, and targeted repair since 0.1.44. The package name and existing data remain unchanged; no session migration is required. Existing archive, restore, permanent deletion, and native conversation navigation remain available.
-
-### Lists and shared filters
-
-- Archived and Unarchived share title/content search, project, favorites, and updated-date filters. Titles-only remains the default; switch scope on the left of the search box and open dates on the right. The end date includes the entire local day; dates can be cleared independently and the popover closes on outside clicks.
-- Compact collapsible project groups provide clickable titles, right-side stars and archive/restore icons, and applicable More actions for restore-and-open, preview, copying, and deletion.
-- Sort by update time, creation time, title, or most/fewest turns. Group counts follow filters and empty states match the active tab.
-- Select all covers filtered results, including collapsed groups. Switching tabs clears selection; filtering preserves it and reports hidden selections. Project-wide actions remain independent of filters.
-- Remove redundant page-wide Restore all / Delete all buttons while retaining selection-based and project actions. Operation results remain scoped to their tab.
-
-### Favorites, idle cleanup, and batch actions
-
-- Star or unstar on either tab and filter to favorites. Host-persisted favorites survive archive, restore, and browser changes. Unknown indexes and read failures do not remove favorites; cleanup requires confirmed artifact absence.
-- On Unarchived, preview idle candidates using 1–36,500 whole days and the current filters; deselect individual candidates before confirmation. Exclude favorites, the current conversation, running sessions, pending interactions, and sessions with active subagents or no valid activity time.
-- Recheck favorites and activity before archiving. Batch archive, restore, and delete show progress and successful/skipped/failed/remaining results. Stop at the first failure and retry only remaining items; delete retries still require confirmation.
-- Undo the most recent successful archive batch, including successful retries, while the management page remains open. Permanent deletion cannot be undone.
-
-### Content search and quick preview
-
-- Search persisted user and assistant text with snippets and highlights. Read failures remain visible and retryable; obsolete responses cannot replace results after filters change.
-- Preview archived sessions without restoring them, showing context around the first match or up to eight recent messages. Unarchived snippets open the full conversation.
-- Render Markdown tables, quotes, code blocks, and role labels, with a source/highlight mode, a wider dialog, and action icons.
-- Fix Unicode offsets after case folding, split surrogate pairs on truncation, Escape closing Settings as well as preview, and previews reopening after tab switches.
-
-### Turn counts and session location
-
-- Show user submission counts on both tabs, including image submissions and inherited branch messages; exclude assistant replies, tool calls, and injected messages.
-- Sort by most/fewest turns with unknown counts always last; inspect and retry detail failures.
-- Copy session IDs and paths separately from More. Official JSONL storage exposes the session directory; other backends use a valid host-provided path. Missing paths and clipboard failures are reported explicitly.
-
-### Diagnosis and targeted repair
-
-- Collect archived read failures, including IDs without summaries, in collapsible diagnostic cards with classified advice and technical details.
-- Prefer stable error codes for missing files, permissions, and corruption, with message-based compatibility fallbacks. Unavailable repair preserves the original classification and appends its limitation.
-- Diagnose and explicitly confirm repair for supported legacy automation message sources. Eligibility depends on artifacts, host format validation, and a write lease, not just error wording. Sessions must be archived and closed in every DSH process.
-- Retain original logs, text, automation attribution, and inheritance data. Publish a new generation only after host re-encoding and validation; create private repair files. Publication never overwrites existing logs and fails safely if hard links are unavailable.
-
-### UI, localization, and compatibility
-
-- Align selection, checkboxes, focus, warnings, updates, and highlights with official theme tokens; refine date controls, diagnostic cards, stars, and action icons.
-- Complete Chinese/English diagnosis, preview, update, and error messages. Language changes no longer cause extra detail reads; fix copy-error and empty-state text.
-- Refresh Archived/Unarchived screenshots and both READMEs, including filter, undo, repair, and search boundaries.
-- Retain support for DSH 0.1.0-rc.8, 0.1.1-rc.2, 0.1.2-rc.1, 0.1.5-rc.1, 0.1.5-rc.2, 0.1.6-alpha.1, and 0.1.6-alpha.2. Coexist with Codex UI; no new sidebar pinning or favorites features are introduced.
-- searchSessionContent is the canonical API for both archive states. Keep searchArchivedContent as the archived-only compatibility entry for older hosts/clients; do not dispatch duplicate searches.
-
-### Limits and validation
-
-- Content search and turn counts have no persistent index. Read at most 20 sessions per batch, sequentially. Narrow filters for large or long logs; no scale or latency guarantee is established. In-flight batches cannot be interrupted; cancellation prevents subsequent batches and stale results.
-- Queries accept up to 200 characters. Search excludes tools, attachments, reasoning, system messages, and plugin injections. Preview limits each message to 2,000 UTF-16 code units without splitting Unicode characters; open the native conversation for full content.
-- No scheduled background archiving. Favorite protection applies only to idle cleanup. Reopen management to see favorites changed elsewhere; closing or refreshing clears undo history.
-- Repair is not a general recovery tool: missing files, permissions, and unsupported corruption receive advice, never forced deletion or truncation. Permanent deletion is irreversible. Task summaries and Markdown export are not added.
-- The functional candidate passed local regressions, isolated supported-host matrices, and real DSH 0.1.6-alpha.2 browser smoke tests covering search, preview, favorites, batches, diagnosis, and repair. Real model submission, streaming, tool approvals, and unknown host versions are outside this validation claim.
-- The host Settings shell still has an extremely narrow-screen obstruction; full mobile layout support is not claimed.