@lokvis/runtime 0.2.0-beta.0 → 0.2.1

package/dist/memory-guard.js

@@ -0,0 +1,161 @@
+/**
+ * 内存阈值监测与 OPFS 溢出(W3.3)
+ *
+ * 目标(对应 whitepaper T1「浏览器内存/性能 ★★★★★」):
+ * 浏览器单 tab 内存有限(桌面典型 2-4GB,移动端更少),大图批量处理
+ * 极易触发 OOM 崩溃(整个 tab 被杀,丢失所有中间结果)。MemoryGuard 通过
+ * 显式追踪中间结果占用 + 周期性压力评估,在逼近预算时把中间 Blob 溢出
+ * 到 OPFS,把"OPFS 当虚拟内存用"——内存里只留当前活跃的一两个 Blob。
+ *
+ * 设计取舍:
+ * - tracked:显式登记的中间分配(decode 结果、canvas 输出等大对象)。
+ *   相比 `performance.memory`(Chrome-only、deprecated、MB 粒度、跨浏览器
+ *   不可用),tracked 是可控、可测、确定性的信号,适合做预算判定主依据。
+ * - budget:512MB(经验值——留出 JS runtime / DOM / 其他 tab 的余量,
+ *   实际由 RuntimeConfig.memoryBudget 传入,默认 512MB)。
+ * - pressure:low(<60%) / elevated(60-80%) / high(80-95%) / critical(≥95%)。
+ * - shouldSpill:pressure >= high 时建议把当前中间结果落 OPFS。
+ * - spill/restore/evict:经由 AssetStore(OPFS-backed when available;
+ *   runtime 已用 wrapAssetStoreWithQuota 包裹,溢出受 storageQuota 约束,
+ *   避免无限溢出把磁盘填满)。
+ *
+ * 集成方式(由 W3.4 degradation 编排):
+ *   const guard = new MemoryGuard({ budget, assetStore });
+ *   const alloc = guard.track(blob.size);          // 登记
+ *   if (guard.shouldSpill()) { const a = await guard.spill(blob); blob = null; }  // 溢出
+ *   ...
+ *   alloc.release();                                // 回退
+ */
+/** 默认内存预算:512MB(见上) */
+export const DEFAULT_MEMORY_BUDGET = 512 * 1024 * 1024;
+/**
+ * 估算解码后位图占用的内存(RGBA,4 字节/像素)。
+ *
+ * 一个 4000×3000 的 JPEG,blob 可能只有 2MB,但 decode 成 ImageBitmap 后
+ * 占 4000*3000*4 ≈ 46MB。追踪中间结果时应以此为准而非 blob.size,
+ * 否则严重低估内存压力。
+ */
+export function estimateDecodedBytes(width, height) {
+    return Math.max(0, Math.round(width * height * 4));
+}
+/** 估算 Blob 在内存中占用的字节数(对未解码的 Blob,以其 size 为准) */
+export function estimateBlobBytes(blob) {
+    return blob.size;
+}
+/** 内存守卫:追踪中间结果占用 + 触发 OPFS 溢出 */
+export class MemoryGuard {
+    tracked = 0;
+    budget;
+    elevatedRatio;
+    highRatio;
+    criticalRatio;
+    assetStore;
+    constructor(opts = {}) {
+        this.budget = opts.budget ?? DEFAULT_MEMORY_BUDGET;
+        this.elevatedRatio = opts.elevatedRatio ?? 0.6;
+        this.highRatio = opts.highRatio ?? 0.8;
+        this.criticalRatio = opts.criticalRatio ?? 0.95;
+        this.assetStore = opts.assetStore;
+        // 阈值单调性校验,避免配置错误导致 pressure 永远卡在某一档
+        if (!(this.elevatedRatio <= this.highRatio && this.highRatio <= this.criticalRatio)) {
+            throw new Error(`MemoryGuard thresholds must be non-decreasing: ` +
+                `elevated(${this.elevatedRatio}) <= high(${this.highRatio}) <= critical(${this.criticalRatio})`);
+        }
+    }
+    /** 当前已登记的字节数 */
+    get currentUsage() {
+        return this.tracked;
+    }
+    /** 总预算(字节) */
+    get budgetBytes() {
+        return this.budget;
+    }
+    /** 当前是否已配置可溢出的 AssetStore */
+    get canSpill() {
+        return this.assetStore !== undefined;
+    }
+    /**
+     * 登记一笔内存占用。返回 release 句柄,丢弃引用时调用以回退计数。
+     * 用于追踪 decode 结果 / canvas 输出等大对象的生命周期。
+     */
+    track(bytes) {
+        if (bytes < 0) {
+            throw new Error(`MemoryGuard.track: bytes must be non-negative, got ${bytes}`);
+        }
+        this.tracked += bytes;
+        let released = false;
+        return {
+            bytes,
+            release: () => {
+                if (released)
+                    return; // 幂等:重复 release 仅首次生效
+                released = true;
+                this.tracked = Math.max(0, this.tracked - bytes);
+            },
+        };
+    }
+    /** 当前压力等级(基于 tracked / budget) */
+    getPressure() {
+        const ratio = this.tracked / this.budget;
+        if (ratio >= this.criticalRatio)
+            return 'critical';
+        if (ratio >= this.highRatio)
+            return 'high';
+        if (ratio >= this.elevatedRatio)
+            return 'elevated';
+        return 'low';
+    }
+    /** 已用比例(0-1+) */
+    getUsageRatio() {
+        return this.tracked / this.budget;
+    }
+    /**
+     * 是否应溢出(pressure >= high)。无 assetStore 时永远 false(无法溢出,
+     * 交由降级阶梯 L3/L4 处理)。
+     */
+    shouldSpill() {
+        if (!this.assetStore)
+            return false;
+        const p = this.getPressure();
+        return p === 'high' || p === 'critical';
+    }
+    /**
+     * 把一个中间 Blob 溢出到 OPFS(assetStore.create),返回 Asset 句柄。
+     * 调用方应在 spill 后丢弃内存中的 Blob 引用,以真正释放内存。
+     *
+     * @param blob 要溢出的中间结果
+     * @param mimeType Blob 的 MIME(用于元数据);默认取 blob.type
+     * @param assetType 资产类型(默认 'image');video/pdf 管线可传对应类型
+     */
+    async spill(blob, mimeType, assetType = 'image') {
+        if (!this.assetStore) {
+            throw new Error('MemoryGuard.spill requires an assetStore (OPFS-backed). ' +
+                'Construct MemoryGuard with { assetStore } to enable spilling.');
+        }
+        const mime = mimeType || blob.type || 'application/octet-stream';
+        const metadata = {
+            mimeType: mime,
+            size: blob.size,
+            format: mime.split('/')[1] ?? 'bin',
+        };
+        return this.assetStore.create(blob, metadata, assetType);
+    }
+    /** 从 OPFS 读回之前 spill 的中间结果 */
+    async restore(asset) {
+        if (!this.assetStore) {
+            throw new Error('MemoryGuard.restore requires an assetStore');
+        }
+        return this.assetStore.getBlob(asset.blob);
+    }
+    /** 丢弃已 spill 的中间结果(处理完成后回收 OPFS 空间) */
+    async evict(asset) {
+        if (!this.assetStore)
+            return;
+        await this.assetStore.remove(asset.id);
+    }
+    /** 重置所有登记(用于工作流结束 / 取消后的清理,tracked 归零) */
+    reset() {
+        this.tracked = 0;
+    }
+}
+//# sourceMappingURL=memory-guard.js.map

package/dist/memory-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-guard.js","sourceRoot":"","sources":["../src/memory-guard.ts"],"names":[],"mappings":"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"}

package/dist/opfs-asset-store.d.ts

@@ -1,10 +1,15 @@
 /**
  * OPFS Asset Store
  *
- * 大文件(blob)存 OPFS(Origin Private File System),元数据存内存 Map。
- * OPFS 是浏览器私有文件系统,blob 持久化(刷新后文件仍在),但元数据仅在内存 ——
- * 刷新后 list() 会返回空、get(id) 返回 undefined(除非元数据由上层持久化)。
- * 完整元数据持久化建议叠加 IdbAssetStore 或在 W3 补强。
+ * 大文件(blob)存 OPFS(Origin Private File System),元数据存内存 Map +
+ * IndexedDB(Dexie)持久化。OPFS 是浏览器私有文件系统,blob 持久化(刷新后
+ * 文件仍在);W6.6 起元数据也通过 Dexie 持久化,刷新后 list()/get() 能恢复。
+ *
+ * 持久化策略(W6.6):
+ * - 启动时:db.metadata.toArray() 预加载内存 Map(后续 get/list 零 IO)
+ * - import/create:写 OPFS 文件 + db.metadata.put + 内存 Map.set
+ * - remove:删 OPFS 文件 + db.metadata.delete + 内存 Map.delete
+ * - IndexedDB 不可用时降级为仅内存模式(刷新后丢失,与 W2 行为一致)
  *
  * 注:任务规格提及 FileSystemSyncAccessHandle(Worker 内同步句柄),
  * 但 AssetStore 接口本身为 async,主线程仅可使用 FileSystemFileHandle 异步 API,
@@ -12,6 +17,8 @@
  *
  * 降级链(W2.8 工厂):OPFS → IndexedDB → Memory
  */
+import Dexie, { type Table } from 'dexie';
+import type { Asset, AssetId } from '@lokvis/schema';
 import type { AssetStore } from './asset-store.js';
 /** OPFS 不可用或初始化失败时抛出 */
 export declare class OpfsUnavailableError extends Error {
@@ -19,6 +26,23 @@ export declare class OpfsUnavailableError extends Error {
 }
 /** OPFS 文件存储路径前缀(出现在 BlobHandle.path 中) */
 export declare const OPFS_PATH_PREFIX = "opfs";
+/**
+ * OPFS 元数据持久化数据库(W6.6)。
+ *
+ * 仅存 { id, asset }(不含 blob,blob 在 OPFS 文件里),用于刷新后恢复内存 Map。
+ * 数据库名独立于 IdbAssetStore 的 'lokvis-assets',避免与全持久化 store 冲突。
+ */
+export declare class OpfsMetadataDatabase extends Dexie {
+    metadata: Table<OpfsMetadataRecord, AssetId>;
+    constructor(name?: string);
+}
+/** OPFS 元数据记录 */
+export interface OpfsMetadataRecord {
+    /** 主键 = Asset.id */
+    id: AssetId;
+    /** 资产元数据(blob 在 OPFS 文件,不在此存) */
+    asset: Asset;
+}
 /** OPFS AssetStore 配置 */
 export interface OpfsAssetStoreOptions {
     /** OPFS 根目录下的命名空间目录名(默认 'lokvis') */
@@ -30,6 +54,13 @@ export interface OpfsAssetStoreOptions {
      * 默认使用 navigator.storage.getDirectory()。
      */
     rootHandle?: FileSystemDirectoryHandle;
+    /**
+     * 测试注入:自定义元数据库实例(W6.6 持久化)。
+     * 默认在 IndexedDB 可用时自动创建 OpfsMetadataDatabase。
+     */
+    metadataDb?: OpfsMetadataDatabase;
+    /** 元数据库名(默认 'lokvis-opfs-metadata';仅 metadataDb 未注入时生效) */
+    metadataDbName?: string;
 }
 /** 检测当前环境是否支持 OPFS */
 export declare function isOpfsSupported(): boolean;

package/dist/opfs-asset-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opfs-asset-store.d.ts","sourceRoot":"","sources":["../src/opfs-asset-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,wBAAwB;AACxB,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAKvC,yBAAyB;AACzB,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC;AAED,sBAAsB;AACtB,wBAAgB,eAAe,IAAI,OAAO,CAMzC;AA0CD,2BAA2B;AAC3B,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,UAAU,CAAC,CA+DrB"}
+{"version":3,"file":"opfs-asset-store.d.ts","sourceRoot":"","sources":["../src/opfs-asset-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,EAAE,KAAK,KAAK,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnD,wBAAwB;AACxB,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAKvC;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,EAAG,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;gBAElC,IAAI,SAAyB;CAM1C;AAED,iBAAiB;AACjB,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,iCAAiC;IACjC,KAAK,EAAE,KAAK,CAAC;CACd;AAED,yBAAyB;AACzB,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,sBAAsB;AACtB,wBAAgB,eAAe,IAAI,OAAO,CAMzC;AAwFD,2BAA2B;AAC3B,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,UAAU,CAAC,CAsFrB"}

package/dist/opfs-asset-store.js

@@ -1,10 +1,15 @@
 /**
  * OPFS Asset Store
  *
- * 大文件(blob)存 OPFS(Origin Private File System),元数据存内存 Map。
- * OPFS 是浏览器私有文件系统,blob 持久化(刷新后文件仍在),但元数据仅在内存 ——
- * 刷新后 list() 会返回空、get(id) 返回 undefined(除非元数据由上层持久化)。
- * 完整元数据持久化建议叠加 IdbAssetStore 或在 W3 补强。
+ * 大文件(blob)存 OPFS(Origin Private File System),元数据存内存 Map +
+ * IndexedDB(Dexie)持久化。OPFS 是浏览器私有文件系统,blob 持久化(刷新后
+ * 文件仍在);W6.6 起元数据也通过 Dexie 持久化,刷新后 list()/get() 能恢复。
+ *
+ * 持久化策略(W6.6):
+ * - 启动时:db.metadata.toArray() 预加载内存 Map(后续 get/list 零 IO)
+ * - import/create:写 OPFS 文件 + db.metadata.put + 内存 Map.set
+ * - remove:删 OPFS 文件 + db.metadata.delete + 内存 Map.delete
+ * - IndexedDB 不可用时降级为仅内存模式(刷新后丢失,与 W2 行为一致)
  *
  * 注:任务规格提及 FileSystemSyncAccessHandle(Worker 内同步句柄),
  * 但 AssetStore 接口本身为 async,主线程仅可使用 FileSystemFileHandle 异步 API,
@@ -12,7 +17,9 @@
  *
  * 降级链(W2.8 工厂):OPFS → IndexedDB → Memory
  */
+import Dexie, {} from 'dexie';
 import { buildAsset, generateId, parseBlobPath, prepareImport, } from './asset-store.js';
+import { isIdbSupported } from './idb-asset-store.js';
 /** OPFS 不可用或初始化失败时抛出 */
 export class OpfsUnavailableError extends Error {
     constructor(message) {
@@ -24,6 +31,21 @@ export class OpfsUnavailableError extends Error {
 export const OPFS_PATH_PREFIX = 'opfs';
 /** OPFS 文件名后缀 */
 const OPFS_FILE_SUFFIX = '.bin';
+/**
+ * OPFS 元数据持久化数据库(W6.6)。
+ *
+ * 仅存 { id, asset }(不含 blob,blob 在 OPFS 文件里),用于刷新后恢复内存 Map。
+ * 数据库名独立于 IdbAssetStore 的 'lokvis-assets',避免与全持久化 store 冲突。
+ */
+export class OpfsMetadataDatabase extends Dexie {
+    metadata;
+    constructor(name = 'lokvis-opfs-metadata') {
+        super(name);
+        this.version(1).stores({
+            metadata: 'id',
+        });
+    }
+}
 /** 检测当前环境是否支持 OPFS */
 export function isOpfsSupported() {
     return (typeof navigator !== 'undefined' &&
@@ -59,22 +81,77 @@ async function writeOpfsFile(dir, fileName, blob) {
     }
     return fileHandle;
 }
+/**
+ * 初始化元数据库(W6.6)。
+ *
+ * 优先用 options.metadataDb(测试注入);否则在 IndexedDB 可用时创建新实例。
+ * IndexedDB 不可用时返回 undefined,调用方降级为仅内存模式。
+ */
+function resolveMetadataDb(options) {
+    if (options.metadataDb)
+        return options.metadataDb;
+    if (!isIdbSupported())
+        return undefined;
+    try {
+        return new OpfsMetadataDatabase(options.metadataDbName);
+    }
+    catch (err) {
+        console.warn('[lokvis] OPFS metadata db init failed, falling back to memory-only:', err);
+        return undefined;
+    }
+}
+/** 安全写入元数据库(失败仅 warn,不阻断主流程) */
+async function persistMetadata(db, id, asset) {
+    if (!db)
+        return;
+    try {
+        await db.metadata.put({ id, asset });
+    }
+    catch (err) {
+        console.warn(`[lokvis] OPFS metadata persist failed for ${id}:`, err);
+    }
+}
+/** 安全删除元数据(失败仅 warn) */
+async function deleteMetadata(db, id) {
+    if (!db)
+        return;
+    try {
+        await db.metadata.delete(id);
+    }
+    catch (err) {
+        console.warn(`[lokvis] OPFS metadata delete failed for ${id}:`, err);
+    }
+}
 /** 创建 OPFS 版 AssetStore */
 export async function createOpfsAssetStore(options = {}) {
     const assetsDir = await resolveAssetsDir(options);
-    /** 元数据缓存(内存中;持久化由 IdbAssetStore 负责) */
+    /** 元数据缓存(内存中;W6.6 起启动时从 Dexie 预加载) */
     const assets = new Map();
-    /** id → 文件句柄(用于 getBlob/remove) */
+    /** id → 文件句柄(用于 getBlob/remove;刷新后丢失,按需重建) */
     const fileHandles = new Map();
+    /** 元数据库(W6.6 持久化;undefined 时仅内存模式) */
+    const db = resolveMetadataDb(options);
+    // 启动时预加载已持久化的元数据(刷新后恢复 list/get)
+    if (db) {
+        try {
+            const records = await db.metadata.toArray();
+            for (const r of records)
+                assets.set(r.id, r.asset);
+        }
+        catch (err) {
+            console.warn('[lokvis] OPFS metadata preload failed:', err);
+        }
+    }
     /** 从 id 派生 OPFS 文件名 */
     const fileName = (id) => `${id}${OPFS_FILE_SUFFIX}`;
     return {
         async import(source) {
-            const { id, blob, metadata, type } = prepareImport(source);
+            const { id, blob, metadata, type } = await prepareImport(source);
             const handle = await writeOpfsFile(assetsDir, fileName(id), blob);
             fileHandles.set(id, handle);
             const asset = buildAsset(id, blob, metadata, type, OPFS_PATH_PREFIX);
             assets.set(id, asset);
+            await persistMetadata(db, id, asset);
             return asset;
         },
         async get(id) {
@@ -84,7 +161,7 @@ export async function createOpfsAssetStore(options = {}) {
             const id = parseBlobPath(handle.path, OPFS_PATH_PREFIX);
             let fileHandle = fileHandles.get(id);
             if (!fileHandle) {
-                // 可能是进程重启后元数据丢失但句柄仍可恢复
+                // 可能是进程重启后内存句柄丢失,从 OPFS 重新获取
                 try {
                     fileHandle = await assetsDir.getFileHandle(fileName(id));
                     fileHandles.set(id, fileHandle);
@@ -102,9 +179,15 @@ export async function createOpfsAssetStore(options = {}) {
             try {
                 await assetsDir.removeEntry(fileName(id));
             }
-            catch {
-                // 文件不存在视为已删除,静默忽略
+            catch (err) {
+                // NotFoundError 是幂等删除的预期场景(文件已不存在),静默忽略;
+                // 其他错误(权限/IO 等)记录 warn,便于排查孤儿 OPFS 文件长期累积
+                // 无论文件删除是否成功,都继续清理 IDB metadata(见下方)
+                if (!(err instanceof DOMException && err.name === 'NotFoundError')) {
+                    console.warn(`[lokvis] OPFS removeEntry unexpected failure for asset ${id}:`, err);
+                }
             }
+            await deleteMetadata(db, id);
         },
         async list() {
             return Array.from(assets.values());
@@ -115,6 +198,7 @@ export async function createOpfsAssetStore(options = {}) {
             fileHandles.set(id, handle);
             const asset = buildAsset(id, blob, metadata, type, OPFS_PATH_PREFIX);
             assets.set(id, asset);
+            await persistMetadata(db, id, asset);
             return asset;
         },
     };

package/dist/opfs-asset-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"opfs-asset-store.js","sourceRoot":"","sources":["../src/opfs-asset-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"opfs-asset-store.js","sourceRoot":"","sources":["../src/opfs-asset-store.ts"],"names":[],"mappings":"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"}

package/dist/runtime.d.ts

@@ -3,12 +3,14 @@
  *
  * Runtime 是整个系统的"浏览器操作系统"，唯一职责：Input → Run → Output。
  */
-import type { Asset, AssetId, AssetSource, Capability, HistoryEntry, McpManifest } from '@lokvis/schema';
+import type { Asset, AssetId, AssetSource, Capability, ExifData, HistoryEntry, McpManifest, MetadataReader } from '@lokvis/schema';
 import type { Workflow, WorkflowResult } from '@lokvis/schema';
-import type { LokvisRuntime, RuntimeConfig, RuntimeStatus, ToMcpManifestOptions } from './types.js';
+import type { LokvisRuntime, PluginInstallEntry, RuntimeConfig, RuntimeStatus, ToMcpManifestOptions } from './types.js';
 import type { EventBus } from '@lokvis/schema';
 import { type AssetStore } from './asset-store.js';
 import { CapabilityRegistry } from './capability-registry.js';
+import { BatchProcessor } from './batch-processor.js';
+import { MemoryGuard } from './memory-guard.js';
 export declare const RUNTIME_VERSION = "0.1.0";
 /** 存储配额超限时抛出(W2.9) */
 export declare class QuotaExceededError extends Error {
@@ -23,21 +25,71 @@ export declare class LokvisRuntimeImpl implements LokvisRuntime {
     readonly eventBus: EventBus;
     private config;
     private _status;
+    /**
+     * AssetStore 实例。类型为 QuotaAwareAssetStore —— 由 wrapAssetStoreWithQuota
+     * 返回(在构造函数中无条件包裹,即使是注入的 assetStore 也会被包装以提供配额校验)。
+     * 保留 _getQuotaUsage 内部 API 供 getStorageUsage O(1) 读取 usage。
+     * 注:外部注入的 assetStore 在 wrapAssetStoreWithQuota 中同样被包装,
+     * 因此所有路径下 this.assetStore 都是 QuotaAwareAssetStore。
+     */
     private assetStore;
     private capabilityRegistry;
     private executor;
+    private memoryGuard;
+    private batchProcessor;
     /**
      * 每个工作流独立的 HistoryStack。
-     * 注意:历史栈仅在内存中,刷新页面后丢失(资产可能仍存于 OPFS/IDB,
-     * 但因元数据/索引未持久化而无法恢复)—— 跨会话恢复属 W3 范畴。
+     * W7.2 起,栈快照(entries + cursor)连同 initialInputs / currentOutputs
+     * 通过 historyStore 持久化到 IndexedDB,刷新后可恢复。
      */
     private historyStacks;
     /** 记录每个工作流的初始输入 AssetId(undo 回到初始时使用) */
     private initialInputsMap;
     /** 记录每个工作流当前的输出 AssetId(undo/redo 后切换"当前") */
     private currentOutputsMap;
+    /**
+     * 历史持久化存储(W7.2)。undefined 时退化为仅内存历史(刷新后丢失)。
+     * 由 createRuntime 在 enableIndexedDB 时自动创建,或通过 config 注入。
+     */
+    private historyStore;
+    /**
+     * 加载持久化历史快照期间的守卫标志。
+     * restore() 会触发 onChanged → persistHistory,此时跳过写回,
+     * 避免把刚读出的数据又重复写入(冗余 IO + 潜在覆盖竞态)。
+     */
+    private isLoadingHistory;
+    /**
+     * 加载期间被 onChanged 标记为"dirty"的工作流 ID 集合(W7.2 review 修复)。
+     *
+     * 原实现:isLoadingHistory 期间所有 persistHistory 调用直接 return,
+     * 若加载期间有其他来源(run / undo / 外部事件)触发 onChanged,
+     * 这些变更会被永久丢弃(加载结束后不会重发 persist)。
+     *
+     * 现策略:加载期间被跳过的 persistHistory 把 workflowId 加入此 Set,
+     * loadPersistedHistory 结束后逐个补 persist,确保不丢变更。
+     * (restore() 自身触发的 onChanged 也加入,但其内容与刚读出的相同,
+     *  补 persist 仅多一次等价写回,幂等无害。)
+     */
+    private dirtyDuringLoad;
+    /**
+     * 元数据读取器注册表(W7.3/7.4 长期方案:MetadataReader 依赖反转)。
+     *
+     * Plugin(plugin-image)通过 PluginContext.registerMetadataReader 注册
+     * 查询函数(如 'image.read-exif'),Runtime 持有引用并按名调用。
+     * 解决了 readExif(Blob→ExifData)不符合 Engine 层 Blob↔Blob 纯函数约束、
+     * 也不符合 CapabilityImplementation Asset[]→Asset[] 契约的问题。
+     * UI 经 runtime.readAssetExif 间接调用,不直接依赖 plugin/engine。
+     */
+    private metadataReaders;
+    /**
+     * 注册元数据读取器(由 PluginContext.registerMetadataReader 转发)。
+     * 下划线前缀表示内部 API,不暴露在 LokvisRuntime 公开接口。
+     */
+    _registerMetadataReader(name: string, reader: MetadataReader): void;
     constructor(config?: RuntimeConfig);
     get status(): RuntimeStatus;
+    get isPro(): boolean;
+    get batch(): BatchProcessor;
     run(workflow: Workflow, inputs: AssetId[] | Asset[], options?: import('./types.js').RunOptions): Promise<WorkflowResult>;
     cancel(workflowId: string): Promise<void>;
     pause(workflowId: string): Promise<void>;
@@ -59,13 +111,34 @@ export declare class LokvisRuntimeImpl implements LokvisRuntime {
      */
     disposeWorkflow(workflowId: string): Promise<void>;
     history(workflowId: string): Promise<HistoryEntry[]>;
+    getHistoryState(workflowId: string): Promise<{
+        entries: HistoryEntry[];
+        cursor: number;
+    }>;
     undo(workflowId: string): Promise<void>;
     redo(workflowId: string): Promise<void>;
+    jumpTo(workflowId: string, index: number): Promise<void>;
     importAsset(source: AssetSource): Promise<AssetId>;
     getAsset(id: AssetId): Promise<Asset>;
     exportAsset(id: AssetId, format?: string): Promise<Blob>;
+    /**
+     * 读取 image 资产的 EXIF 元数据(W7.3/7.4 长期方案:MetadataReader 依赖反转)。
+     *
+     * Runtime 持有 plugin-image 通过 ctx.registerMetadataReader('image.read-exif', fn)
+     * 注册的 reader 引用,按名调用。reader 内部调 readExifFromBlob(exifr)。
+     * Plugin 未安装时优雅降级返回 null(不抛错)。
+     *
+     * 架构决策:readExif 是 Blob→ExifData 查询,不符合 Engine 层 Blob↔Blob 纯函数
+     * 约束,也不符合 Capability Asset[]→Asset[] 契约,故走 MetadataReader 机制,
+     * 不进 engine-image、不走 Capability execute。
+     */
+    readAssetExif(id: AssetId): Promise<ExifData | null>;
     removeAsset(id: AssetId): Promise<void>;
     listAssets(): Promise<Asset[]>;
+    getStorageUsage(): Promise<{
+        usage: number;
+        quota: number;
+    }>;
     capabilities(): Promise<Capability[]>;
     hasCapability(name: string): Promise<boolean>;
     /**
@@ -78,10 +151,30 @@ export declare class LokvisRuntimeImpl implements LokvisRuntime {
      * - resource 固定为 capabilities 与 workflows 两个清单
      */
     toMcpManifest(options?: ToMcpManifestOptions): McpManifest;
-    /** 获取 AssetStore（内部用） */
+    /**
+     * 在本 Runtime 上安装一个插件(实现 LokvisRuntime.installPlugin 接口)。
+     *
+     * 步骤:
+     * 1. 注册能力声明(plugin.config.capabilities → CapabilityRegistry)
+     * 2. 构造受限 PluginContext(只暴露受限 Runtime API + 注册器 + 日志)
+     * 3. 调用 plugin.install(ctx),让插件注册 CapabilityImplementation
+     * 4. 发射 `plugin:loaded` 事件
+     *
+     * 不吞错:plugin.install 抛出的错误原样上抛,由 SDK 包成 PluginLoadError。
+     *
+     * 此前 SDK 通过 `instanceof LokvisRuntimeImpl` + `_getAssetStore()` /
+     * `_getCapabilityRegistry()` 反向访问内部依赖,现改为公共接口调用,
+     * SDK 不再依赖具体实现类。
+     */
+    installPlugin(plugin: PluginInstallEntry): Promise<void>;
+    /** 获取 AssetStore(仅测试用,SDK 通过 installPlugin 间接访问) */
     _getAssetStore(): AssetStore;
-    /** 获取 CapabilityRegistry（内部用） */
+    /** 获取 CapabilityRegistry(仅测试用,SDK 通过 installPlugin 间接访问) */
     _getCapabilityRegistry(): CapabilityRegistry;
+    /**
+     * 获取 MemoryGuard(内部用,供集成测试驱动内存压力验证 BatchProcessor 收缩)。
+     */
+    _getMemoryGuard(): MemoryGuard;
     /** 获取工作流当前输出 AssetId（undo/redo 后的"当前"状态,内部用） */
     _getCurrentOutputs(workflowId: string): AssetId[];
     /** 获取工作流当前输出 AssetId（公开 API，供 UI / MCP 查询） */
@@ -101,6 +194,37 @@ export declare class LokvisRuntimeImpl implements LokvisRuntime {
     private collectInputAssetIds;
     /** 监听 node:finished 事件,自动 append 到对应工作流的 HistoryStack */
     private recordHistoryFromNodeEvent;
+    /**
+     * 把指定工作流的当前历史状态快照写入 historyStore。
+     *
+     * 时序修复:currentOutputs 从 stack snapshot 派生(cursor === -1 用
+     * initialInputs,否则用 entries[cursor].outputs),而非读 currentOutputsMap。
+     * 原因:onChanged 在 undo/redo/jumpTo/run 内部同步触发时,map 尚未更新,
+     * 会读到旧值(例如 run 后 append 触发 onChanged,但 currentOutputsMap 在
+     * append 返回后才 set)。
+     *
+     * 竞态安全:多个 fire-and-forget save 的 IDB readwrite 事务由 IndexedDB
+     * 引擎按发起顺序串行化(同 object store 不重叠),无需应用层加链。
+     *
+     * - entries 为空时改为 delete,避免残留空记录(reset/clear 后自然清理)
+     * - 加载期间(isLoadingHistory=true)跳过写回,但把 workflowId 加入
+     *   dirtyDuringLoad,loadPersistedHistory 结束后补 persist(避免丢变更)
+     */
+    private persistHistory;
+    /**
+     * 从 historyStore 预加载所有持久化的历史快照,恢复到内存。
+     *
+     * 由 createRuntime 工厂在构造完 impl 后调用一次。加载期间置 isLoadingHistory
+     * 守卫,使 restore() 触发的 onChanged → persistHistory 跳过冗余写回;
+     * 但被跳过的 workflowId 记入 dirtyDuringLoad,加载结束后补 persist,
+     * 避免加载期间其他来源(run / undo / 外部事件)的变更被永久丢弃。
+     *
+     * 注意:restore 会 emit history:changed 事件,但此时 UI 尚未订阅
+     * (runtime-slice.init 在 createRuntime resolve 后才订阅),故无副作用。
+     *
+     * 非 LokvisRuntime 接口的一部分,仅为 impl 的初始化钩子(工厂调用)。
+     */
+    loadPersistedHistory(): Promise<void>;
 }
 /**
  * 创建 Runtime 实例(W2.8 + W2.9)。

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}