dsh-plugin-update 0.2.0 → 0.3.0

package/dist/store.d.ts

@@ -0,0 +1,229 @@
+/**
+ * src/store.ts —— 更新任务的落盘与执行跑腿。
+ *
+ * 由 src/host/updateStore.js 改写拎入：只跑腿不决策。相对旧实现的增量（规格 #591）：
+ * 1. 状态目录按插件标识派生（第 3 条）：join(家目录, 'updates', 插件标识, 使用范围短指纹），
+ *    三文件名保持 state.json、install.lock、before.json 不变。
+ * 2. 默认旧路径冻结（第 14 条）：插件标识取旧值 dsh-mattpocock-skills-deck 时路径与旧原文
+ *    一字不差——下面的旧字面是永久冻结特例，注释永不删除（动默认即破冰）。
+ * 3. 读走双读、写只写新（第 7 条）：先读新路径，没有再回退读旧路径；写只写新路径，
+ *    旧路径只读不写永久留作只读影子。旧文件不动，清理另票再议。
+ * 4. 三处注入默认现状（第 4 条）：目标包名、官方源、安装时限经零件注入，默认值等于现状。
+ * 5. 安装执行日志带必填插件标识（第 8、13 条）：update.install.exec 加完标识后 5 键为基线。
+ *
+ * 安装执行按核心给的配方跑三条路由之一（第三方 Desktop 走桌面服务、官方桌面版交给宿主
+ * 进程内的插件管理器、普通 DSH 自己起进程），
+ * 本文件不按操作系统分支，也不拼 shell。决策顺序全在更新核心。测试一律用假零件，
+ * 不真写盘真跑命令（经可选的文件读写函数注入，默认走真文件系统）。
+ */
+import { type BatchSession } from './batch.js';
+import { type UpdateQueueState } from './queue.js';
+import type { EnvironmentKind, UpdateJob } from './ports.js';
+export interface UpdatePaths {
+    directory: string;
+    state: string;
+    lock: string;
+    backup: string;
+}
+/**
+ * 状态目录：家目录下按插件标识派生，短指纹只做同一性判断，不记原文。
+ * 插件标识取旧值时与旧原文一字不差（旧默认路径冻结，验收项）。
+ */
+export declare function pathsForUpdate(homeDir: string, pluginId: string, profileDir: string): UpdatePaths | null;
+/** 旧只读影子目录（规格 #591 第 7 条）：只读不写，永久留作回退读取用。 */
+export declare function legacyPathsForUpdate(homeDir: string, profileDir: string): UpdatePaths | null;
+export interface DiskPortsDeps {
+    readFileImpl?: (filename: string, encoding: string) => Promise<string>;
+    statImpl?: (filename: string) => Promise<{
+        size: number;
+    }>;
+}
+/**
+ * 建任务存取与锁：调用方按当前插件标识建一份，转交核心当零件。
+ * 读走双读（先新后旧），写只写新（旧影子只读不写）。
+ */
+export declare function createUpdateDiskPorts(homeDir: string, pluginId: string, profileDir: string, deps?: DiskPortsDeps): {
+    paths: UpdatePaths | null;
+    legacyPaths: UpdatePaths | null;
+    readJob: () => Promise<UpdateJob | null>;
+    writeJob: (job: UpdateJob | null) => Promise<void>;
+    tryAcquireLock: (lockId: string) => Promise<boolean>;
+    releaseLock: (lockId: string) => Promise<void>;
+    backupJob: (job: UpdateJob) => Promise<void>;
+};
+/** 跨插件队列的共享落盘（#15，新增强制串行的归属与持久化，不碰按插件隔离的旧树）。
+ *
+ * 归属：按使用范围共享——同一 (homeDir, profileDir) 的全部插件共用同一目录，
+ * 不同使用范围各用各的、可并行。父目录取 `update-queue`（与 `updates` 平级），
+ * 任何插件标识都撞不上（插件标识只能决定 `updates` 下的子目录名）。
+ * 文件：`queue.json`（owner + waiting，快照式整写），`global.lock`（执行互斥，
+ * 抢到才许装，一次只装一个）。
+ */
+export declare const QUEUE_DIR_SEGMENT = "update-queue";
+export declare const QUEUE_FILE = "queue.json";
+export declare const QUEUE_LOCK_FILE = "global.lock";
+/** 全局锁陈旧回收默认口径：15 分钟（与安装时限同口径，调用方可按注入覆盖）。 */
+export declare const QUEUE_LOCK_STALE_MS: number;
+export interface UpdateQueuePaths {
+    directory: string;
+    file: string;
+    lock: string;
+}
+/**
+ * 队列共享目录：家目录下按使用范围短指纹派生（短指纹算法与按插件隔离的旧树同一套，
+ * 只做同一性判断，不记原文）。入参非法返回 null，调用方按“无队列可用”放行安装，
+ * 绝不因队列自身故障挡住更新。
+ */
+export declare function queuePathsForUpdate(homeDir: string, profileDir: string): UpdateQueuePaths | null;
+export interface QueuePortsDeps {
+    readFileImpl?: (filename: string, encoding: string) => Promise<string>;
+    statImpl?: (filename: string) => Promise<{
+        size: number;
+    }>;
+    nowImpl?: () => number;
+}
+/**
+ * 建跨插件队列存取与全局锁：调用方按当前使用范围建一份（与插件标识无关），转交宿主入口组合进安装锁。
+ * 读走单读（队列文件只此一份，没有旧影子）；写原子整写；锁走独占建文件，过期可回收一次。
+ */
+export declare function createUpdateQueuePorts(homeDir: string, profileDir: string, deps?: QueuePortsDeps): {
+    paths: UpdateQueuePaths | null;
+    readQueue: () => Promise<UpdateQueueState>;
+    writeQueue: (state: UpdateQueueState) => Promise<void>;
+    tryAcquireGlobalLock: (lockId: string, pluginId: string, opts?: {
+        timeoutMs?: number;
+    }) => Promise<boolean>;
+    releaseGlobalLock: (lockId: string) => Promise<void>;
+};
+/** 批量会话账本的共享落盘（#25，与队列同一目录：同一使用范围一份，跨插件共用）。
+ *
+ * 归属：按使用范围共享（与跨插件队列同一套目录派生：`update-queue/<使用范围短指纹>`），
+ * 不同使用范围各用各的。文件只有一份 `batch.json` —— 「这一轮批量更新走到哪了」是全范围唯一的一份，
+ * 与按插件隔离的 `updates/<插件标识>/...` 那棵树完全分开（父目录不同，任何插件标识都撞不上）。
+ * 纪律与队列同一套：读坏自愈为空会话（缺文件、超大、JSON 坏掉、读失败都回空，绝不因账本坏掉挡住更新）；
+ * 写走原子整写（临时文件 + rename，写完删临时件）；清空写一份空会话（不是删文件，避免与并发读打架）。
+ */
+export declare const BATCH_FILE = "batch.json";
+/** 账本读入上限：1 MiB，超了当坏账本（正常一份几百字节）。 */
+export declare const BATCH_FILE_MAX_BYTES: number;
+export interface UpdateBatchPaths {
+    directory: string;
+    file: string;
+}
+/**
+ * 批量账本路径：与队列同一目录（`update-queue/<短指纹>/batch.json`）。
+ * 入参非法返回 null，调用方按「账本不可落盘」处理（诚实说明，绝不猜目录）。
+ */
+export declare function batchPathsForUpdate(homeDir: string, profileDir: string): UpdateBatchPaths | null;
+export interface BatchPortsDeps {
+    readFileImpl?: (filename: string, encoding: string) => Promise<string>;
+    statImpl?: (filename: string) => Promise<{
+        size: number;
+    }>;
+}
+/**
+ * 建批量账本存取：调用方按当前使用范围建一份（与插件标识无关），转交批量宿主入口。
+ * 读走单读自愈为空会话；写原子整写；清空写空会话。路径算不出来时不抛错（读回空、写抛 batch-unavailable）。
+ */
+export declare function createBatchDiskPorts(homeDir: string, profileDir: string, deps?: BatchPortsDeps): {
+    paths: UpdateBatchPaths | null;
+    readBatch: () => Promise<BatchSession>;
+    writeBatch: (session: BatchSession) => Promise<void>;
+    clearBatch: () => Promise<void>;
+};
+/** 按插件 + 版本持久化的跳过记录（#16，与三冻结落盘名并存的第四文件，不碰旧树）。
+ *
+ * 键：跳过只按「插件标识 + 版本」记——目录已按插件标识隔离（pathsForUpdate），
+ * 文件内只记版本集合。新版本恒重新提醒（跳过是 dismissal 不是全局静音）。
+ * 重置入口（第一性原理结论，见 #16）：已跳过版本留在同一更新横幅行展示为
+ * 「已跳过 X.Y.Z · 恢复」，点恢复即清掉该版本的跳过并重查；不藏进设置页。
+ * 文件：`skipped.json`（`{ skipped: [{ version, skippedAt }] }`，快照式整写，上限 50 条）。
+ */
+export interface SkippedVersionEntry {
+    version: string;
+    skippedAt: number;
+}
+/** 跳过文件上限：只留最近 50 条，避免无界增长（老条目自然淘汰）。 */
+export declare const MAX_SKIPPED_ENTRIES = 50;
+/** 跳过展示键：面板行展示与去重用（`插件标识@版本`）。 */
+export declare function skipKey(pluginId: string, version: string): string;
+/** 跳过记录归一化：只收发行合法版（stable + 预发布），非法条目丢弃（自愈不抛错）。 */
+export declare function normalizeSkipped(raw: unknown): SkippedVersionEntry[];
+/** 该版本是否已被跳过（版本须发行合法，否则为 false）。 */
+export declare function isVersionSkipped(skipped: readonly SkippedVersionEntry[] | unknown, version: unknown): boolean;
+/** 记一次跳过：同版本幂等（刷新 skippedAt），新版本追加并按上限裁剪。 */
+export declare function addSkipped(skipped: readonly SkippedVersionEntry[] | unknown, version: string, now: number): SkippedVersionEntry[];
+/** 重置跳过：给了版本只清该版本（面板「恢复」走这条），不给清全部。 */
+export declare function clearSkipped(skipped: readonly SkippedVersionEntry[] | unknown, version?: string): SkippedVersionEntry[];
+export interface SkipPortsDeps {
+    readFileImpl?: (filename: string, encoding: string) => Promise<string>;
+    statImpl?: (filename: string) => Promise<{
+        size: number;
+    }>;
+}
+/**
+ * 建跳过存取：调用方按当前插件标识建一份（目录与任务落盘同一套，无旧影子）。
+ * 读坏自愈为空（缺文件、超大、JSON 坏掉都回 []，绝不因跳过文件挡住更新）；
+ * 写走原子整写。
+ */
+export declare function createSkipDiskPorts(homeDir: string, pluginId: string, profileDir: string, deps?: SkipPortsDeps): {
+    file: string | null;
+    readSkipped: () => Promise<SkippedVersionEntry[]>;
+    writeSkipped: (skipped: readonly SkippedVersionEntry[] | unknown) => Promise<void>;
+    clearSkippedVersion: (version?: string) => Promise<SkippedVersionEntry[]>;
+};
+/**
+ * 从正在运行的入口反查 CLI 的 JS 入口：逐级向上找名字为 @deepseek-ai/dsh 的包，
+ * 且该文件必须正好是包声明的可执行入口（bin.dsh 或 bin 字符串）。对不上就返回 null，
+ * 绝不用 PATH 上的 `dsh` 命令名——否则可能装到别的使用范围或用错版本。
+ * 第二参只给测试注入假清单读取器与假路径解析用（默认都走真文件系统）。
+ */
+export declare function resolveCliEntry(argv1: string, deps?: {
+    readManifest?: (directory: string) => Promise<Record<string, unknown> | null>;
+    realpath?: (path: string) => Promise<string>;
+}): Promise<string | null>;
+export interface ExecutorParts {
+    profileName?: string | null | (() => string | null);
+    environmentKind?: EnvironmentKind | (() => EnvironmentKind);
+    profileDir?: string | (() => string);
+    subprocess?: unknown | (() => unknown);
+    desktopPnpm?: unknown | (() => unknown);
+    desktopProfiles?: unknown | (() => unknown);
+    /** 官方桌面版进程内的插件管理器（现取，不缓存跨代服务）。 */
+    pluginManager?: unknown | (() => unknown);
+    runtimeExecutable?: string | (() => string | undefined);
+    runtimeExecArgs?: string[] | (() => string[] | undefined);
+    cliEntry?: string | (() => string | undefined);
+    targetPackageName?: string | (() => string);
+    registryUrl?: string | (() => string);
+    installTimeoutMs?: number | (() => number);
+    pluginId?: string | (() => string);
+    log?: (level: string, event: string, fields: Record<string, unknown>) => void;
+}
+/**
+ * 真执行器：按核心给的配方跑安装（测试一律注入假零件，不走这里）。
+ *
+ * 路由只有三条，都由核心的 installRecipe 决定，本文件不按操作系统分支：
+ *   - desktop-service：桌面宿主公开的 desktopPnpm.runPlugin(参数数组, 使用范围目录)；
+ *   - desktop-manager：官方桌面版进程内的 pluginManager.installBundle(精确版本规格, 选项)；
+ *   - cli-process：subprocess.spawn({ argv: [运行时, …运行时参数, CLI 入口, 'plugin', '--profile', 名, …参数] })。
+ * 起进程只经宿主注入的子进程能力，不经 shell、不用 PATH 上的 `dsh` 命令名。
+ */
+export declare function createUpdateExecutor(parts?: ExecutorParts): (args?: {
+    version?: string;
+    profileName?: string | null;
+    environmentKind?: EnvironmentKind;
+}) => Promise<void>;
+export declare const __executorInternals: {
+    INSTALL_STDIO: {
+        stdin: string;
+        stdout: {
+            maxBytes: number;
+        };
+        stderr: {
+            maxBytes: number;
+        };
+    };
+    TERMINATION_GRACE_MS: number;
+    CLI_PACKAGE_NAME: string;
+};

package/dist/store.js

@@ -3,7 +3,11 @@ import { createHash, randomUUID } from "node:crypto";
 import { mkdir, open, readFile, rename, realpath, stat, unlink, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, join, resolve } from "node:path";
 import { installRecipe } from "./commands.js";
-import { BACKUP_FILE, LEGACY_PLUGIN_ID, LOCK_FILE, STATE_FILE } from "./config.js";
+import { BACKUP_FILE, LEGACY_PLUGIN_ID, LOCK_FILE, SKIPPED_FILE, STATE_FILE } from "./config.js";
+import { emptyBatchSession, normalizeBatchSession } from "./batch.js";
+import { normalizeQueueState } from "./queue.js";
+import { validReleaseVersion } from "./service.js";
+import { sanitizeDetail } from "./redaction.js";
 const LEGACY_SEGMENT = "updates";
 const LEGACY_DIR_PLUGIN = LEGACY_PLUGIN_ID;
 const JOB_STATES = ["installing", "verifying", "restart-required", "completed", "failed", "interrupted"];
@@ -173,6 +177,228 @@ function createUpdateDiskPorts(homeDir, pluginId, profileDir, deps = {}) {
   }
   return { paths, legacyPaths, readJob, writeJob, tryAcquireLock, releaseLock, backupJob };
 }
+const QUEUE_DIR_SEGMENT = "update-queue";
+const QUEUE_FILE = "queue.json";
+const QUEUE_LOCK_FILE = "global.lock";
+const QUEUE_LOCK_STALE_MS = 15 * 6e4;
+function queuePathsForUpdate(homeDir, profileDir) {
+  if (typeof homeDir !== "string" || !homeDir || typeof profileDir !== "string" || !profileDir) return null;
+  const directory = join(homeDir, QUEUE_DIR_SEGMENT, shortHash(profileDir));
+  return { directory, file: join(directory, QUEUE_FILE), lock: join(directory, QUEUE_LOCK_FILE) };
+}
+function queueFail() {
+  return Object.assign(new Error("queue-unavailable"), { code: "queue-unavailable" });
+}
+function createUpdateQueuePorts(homeDir, profileDir, deps = {}) {
+  const paths = queuePathsForUpdate(homeDir, profileDir);
+  const readText = deps.readFileImpl ?? ((filename, encoding) => readFile(filename, encoding));
+  const statFile = deps.statImpl ?? ((filename) => stat(filename));
+  const now = deps.nowImpl ?? Date.now;
+  async function readQueue() {
+    if (!paths) throw queueFail();
+    try {
+      if ((await statFile(paths.file)).size > 10 * 1024 * 1024) throw queueFail();
+      return normalizeQueueState(JSON.parse(await readText(paths.file, "utf8")));
+    } catch (error) {
+      if (error && error.code === "ENOENT") {
+        return normalizeQueueState(null);
+      }
+      throw error && error.code ? error : queueFail();
+    }
+  }
+  async function writeQueue(state) {
+    if (!paths) throw queueFail();
+    try {
+      await mkdir(paths.directory, { recursive: true, mode: 448 });
+      const temporary = `${paths.file}.${randomUUID()}.tmp`;
+      try {
+        await writeFile(temporary, `${JSON.stringify(normalizeQueueState(state), null, 2)}
+`, { mode: 384, flag: "wx" });
+        await rename(temporary, paths.file);
+      } catch {
+        throw queueFail();
+      } finally {
+        await unlink(temporary).catch(() => {
+        });
+      }
+    } catch (error) {
+      throw error && error.code ? error : queueFail();
+    }
+  }
+  async function readLockRaw() {
+    if (!paths) return null;
+    try {
+      if ((await statFile(paths.lock)).size > 1024 * 1024) return null;
+      return JSON.parse(await readText(paths.lock, "utf8"));
+    } catch {
+      return null;
+    }
+  }
+  async function tryAcquireGlobalLock(lockId, pluginId, opts = {}) {
+    if (!paths) return false;
+    if (typeof lockId !== "string" || !lockId || typeof pluginId !== "string" || !pluginId) return false;
+    const timeoutMs = typeof opts.timeoutMs === "number" && Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : QUEUE_LOCK_STALE_MS;
+    try {
+      await mkdir(paths.directory, { recursive: true, mode: 448 });
+      const handle = await open(paths.lock, "wx", 384);
+      try {
+        await handle.writeFile(JSON.stringify({ id: lockId, pluginId, pid: process.pid, startedAt: now() }));
+      } finally {
+        await handle.close();
+      }
+      return true;
+    } catch (error) {
+      if (!error || error.code !== "EEXIST") return false;
+      try {
+        const current = await readLockRaw();
+        const startedAt = current && typeof current["startedAt"] === "number" ? current["startedAt"] : 0;
+        if (!current || now() - startedAt < timeoutMs) return false;
+        await unlink(paths.lock).catch(() => {
+        });
+        const handle = await open(paths.lock, "wx", 384);
+        try {
+          await handle.writeFile(JSON.stringify({ id: lockId, pluginId, pid: process.pid, startedAt: now() }));
+        } finally {
+          await handle.close();
+        }
+        return true;
+      } catch {
+        return false;
+      }
+    }
+  }
+  async function releaseGlobalLock(lockId) {
+    if (!paths) return;
+    try {
+      const current = await readLockRaw();
+      if (current && current.id === lockId) await unlink(paths.lock).catch(() => {
+      });
+    } catch {
+    }
+  }
+  return { paths, readQueue, writeQueue, tryAcquireGlobalLock, releaseGlobalLock };
+}
+const BATCH_FILE = "batch.json";
+const BATCH_FILE_MAX_BYTES = 1024 * 1024;
+function batchPathsForUpdate(homeDir, profileDir) {
+  const queue = queuePathsForUpdate(homeDir, profileDir);
+  if (!queue) return null;
+  return { directory: queue.directory, file: join(queue.directory, BATCH_FILE) };
+}
+function batchFail() {
+  return Object.assign(new Error("batch-unavailable"), { code: "batch-unavailable" });
+}
+function createBatchDiskPorts(homeDir, profileDir, deps = {}) {
+  const paths = batchPathsForUpdate(homeDir, profileDir);
+  const readText = deps.readFileImpl ?? ((filename, encoding) => readFile(filename, encoding));
+  const statFile = deps.statImpl ?? ((filename) => stat(filename));
+  async function readBatch() {
+    if (!paths) return emptyBatchSession();
+    try {
+      if ((await statFile(paths.file)).size > BATCH_FILE_MAX_BYTES) return emptyBatchSession();
+      return normalizeBatchSession(JSON.parse(await readText(paths.file, "utf8")));
+    } catch {
+      return emptyBatchSession();
+    }
+  }
+  async function writeBatch(session) {
+    if (!paths) throw batchFail();
+    const normalized = normalizeBatchSession(session);
+    try {
+      await mkdir(paths.directory, { recursive: true, mode: 448 });
+      const temporary = `${paths.file}.${randomUUID()}.tmp`;
+      try {
+        await writeFile(temporary, `${JSON.stringify(normalized, null, 2)}
+`, { mode: 384, flag: "wx" });
+        await rename(temporary, paths.file);
+      } catch {
+        throw batchFail();
+      } finally {
+        await unlink(temporary).catch(() => {
+        });
+      }
+    } catch (error) {
+      throw error && error.code ? error : batchFail();
+    }
+  }
+  async function clearBatch() {
+    if (!paths) return;
+    await writeBatch(emptyBatchSession());
+  }
+  return { paths, readBatch, writeBatch, clearBatch };
+}
+const MAX_SKIPPED_ENTRIES = 50;
+function skipKey(pluginId, version) {
+  return `${String(pluginId)}@${String(version)}`;
+}
+function normalizeSkipped(raw) {
+  if (!raw || typeof raw !== "object") return [];
+  const list = raw.skipped;
+  if (!Array.isArray(list)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const item of list) {
+    if (!item || typeof item !== "object") continue;
+    const version = item.version;
+    const skippedAt = item.skippedAt;
+    if (!validReleaseVersion(version) || seen.has(version)) continue;
+    seen.add(version);
+    out.push({ version, skippedAt: typeof skippedAt === "number" && Number.isFinite(skippedAt) ? skippedAt : 0 });
+  }
+  return out.slice(0, MAX_SKIPPED_ENTRIES);
+}
+function isVersionSkipped(skipped, version) {
+  if (!validReleaseVersion(version)) return false;
+  return normalizeSkipped({ skipped }).some((entry) => entry.version === version);
+}
+function addSkipped(skipped, version, now) {
+  if (!validReleaseVersion(version)) throw fail("install-failed");
+  const at = typeof now === "number" && Number.isFinite(now) ? now : Date.now();
+  const rest = normalizeSkipped({ skipped }).filter((entry) => entry.version !== version);
+  return [{ version, skippedAt: at }, ...rest].slice(0, MAX_SKIPPED_ENTRIES);
+}
+function clearSkipped(skipped, version) {
+  const base = normalizeSkipped({ skipped });
+  if (version === void 0) return [];
+  return base.filter((entry) => entry.version !== version);
+}
+function createSkipDiskPorts(homeDir, pluginId, profileDir, deps = {}) {
+  const paths = pathsForUpdate(homeDir, pluginId, profileDir);
+  const file = paths ? join(paths.directory, SKIPPED_FILE) : null;
+  const readText = deps.readFileImpl ?? ((filename, encoding) => readFile(filename, encoding));
+  const statFile = deps.statImpl ?? ((filename) => stat(filename));
+  async function readSkipped() {
+    if (!file) return [];
+    try {
+      if ((await statFile(file)).size > 64 * 1024) return [];
+      return normalizeSkipped(JSON.parse(await readText(file, "utf8")));
+    } catch {
+      return [];
+    }
+  }
+  async function writeSkipped(skipped) {
+    if (!file || !paths) throw fail("install-failed");
+    const normalized = normalizeSkipped({ skipped });
+    await mkdir(paths.directory, { recursive: true, mode: 448 });
+    const temporary = `${file}.${randomUUID()}.tmp`;
+    try {
+      await writeFile(temporary, `${JSON.stringify({ skipped: normalized }, null, 2)}
+`, { mode: 384, flag: "wx" });
+      await rename(temporary, file);
+    } catch {
+      throw fail("install-failed");
+    } finally {
+      await unlink(temporary).catch(() => {
+      });
+    }
+  }
+  async function clearSkippedVersion(version) {
+    const next = clearSkipped(await readSkipped(), version);
+    await writeSkipped(next);
+    return next;
+  }
+  return { file, readSkipped, writeSkipped, clearSkippedVersion };
+}
 const CLI_PACKAGE_NAME = "@deepseek-ai/dsh";
 const INSTALL_STDIO = { stdin: "ignore", stdout: { maxBytes: 64 * 1024 }, stderr: { maxBytes: 64 * 1024 } };
 const TERMINATION_GRACE_MS = 3e3;
@@ -294,19 +520,11 @@ async function runDesktopService(recipe, parts) {
   if (code !== 0) throw withExit(fail("install-failed"), code);
   return code;
 }
-const DETAIL_MAX = 300;
 const MANAGER_OK = ["applied", "restart-required", "overridden"];
 function withDetail(error, detail) {
   if (detail) error.detail = detail;
   return error;
 }
-const ABSOLUTE_PATH_RE = /[A-Za-z]:\\[^\s"']*|(^|\s)\/[^\s"']+/g;
-function sanitizeDetail(text) {
-  const flat = String(text ?? "").replace(/\s+/g, " ").trim();
-  if (!flat) return "";
-  const noPath = flat.replace(ABSOLUTE_PATH_RE, (_whole, lead) => `${lead || ""}<\u8DEF\u5F84>`);
-  return noPath.length > DETAIL_MAX ? `${noPath.slice(0, DETAIL_MAX)}\u2026` : noPath;
-}
 function detailText(error) {
   if (typeof error === "string") return sanitizeDetail(error);
   if (error instanceof Error) return sanitizeDetail(error.message);
@@ -315,7 +533,12 @@ function detailText(error) {
     const code = typeof shape.code === "string" ? shape.code : "";
     const said = typeof shape.diagnostic === "string" ? shape.diagnostic : typeof shape.message === "string" ? shape.message : "";
     const line = [code, said].filter(Boolean).join(": ");
-    if (line) return sanitizeDetail(line);
+    if (line) {
+      const clean = sanitizeDetail(line);
+      if (clean) return clean;
+      if (code) return sanitizeDetail(code);
+      return "";
+    }
     try {
       return sanitizeDetail(JSON.stringify(error));
     } catch {
@@ -460,7 +683,6 @@ function createUpdateExecutor(parts = {}) {
       emitInstall(parts, recipe, false, error?.exitCode ?? exitCode, Date.now() - startedAt);
       const detail = error?.detail;
       throw Object.assign(fail("install-failed"), {
-        debug: String(error?.stack || error),
         ...typeof detail === "string" && detail ? { detail } : {}
       });
     }
@@ -468,10 +690,27 @@ function createUpdateExecutor(parts = {}) {
 }
 const __executorInternals = { INSTALL_STDIO, TERMINATION_GRACE_MS, CLI_PACKAGE_NAME };
 export {
+  BATCH_FILE,
+  BATCH_FILE_MAX_BYTES,
+  MAX_SKIPPED_ENTRIES,
+  QUEUE_DIR_SEGMENT,
+  QUEUE_FILE,
+  QUEUE_LOCK_FILE,
+  QUEUE_LOCK_STALE_MS,
   __executorInternals,
+  addSkipped,
+  batchPathsForUpdate,
+  clearSkipped,
+  createBatchDiskPorts,
+  createSkipDiskPorts,
   createUpdateDiskPorts,
   createUpdateExecutor,
+  createUpdateQueuePorts,
+  isVersionSkipped,
   legacyPathsForUpdate,
+  normalizeSkipped,
   pathsForUpdate,
-  resolveCliEntry
+  queuePathsForUpdate,
+  resolveCliEntry,
+  skipKey
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-update",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "可复用的更新系统装成的 npm 包：任何 DSH 插件照文档能集成检查更新等功能（地图 #579）",
   "license": "MIT",
   "author": "王辰浩",
@@ -12,8 +12,32 @@
     "node": ">=22"
   },
   "type": "module",
+  "types": "./dist/host.d.ts",
   "exports": {
-    ".": "./dist/host.js",
+    ".": {
+      "types": "./dist/host.d.ts",
+      "default": "./dist/host.js"
+    },
+    "./panel": {
+      "types": "./dist/panel.d.ts",
+      "default": "./dist/panel.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./batch": {
+      "types": "./dist/host-batch.d.ts",
+      "default": "./dist/host-batch.js"
+    },
+    "./panel-batch": {
+      "types": "./dist/panel-batch.d.ts",
+      "default": "./dist/panel-batch.js"
+    },
+    "./entry": {
+      "types": "./dist/entry.d.ts",
+      "default": "./dist/entry.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -21,6 +45,7 @@
     "derive-client-values.mjs",
     "event-list.template.json",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "publishConfig": {