@skillbuilder/miniapp-simulator 0.2.2 → 0.2.4

package/lib/remote-client.js

@@ -1,6 +1,6 @@
-import { R as r, a as O, c as e } from "./client-_vNHVHSm.mjs";
+import { R as r, a as O, c as e } from "./client-BDt3WDu_.mjs";
 import { B as s, M as _ } from "./options-B34ipLmF.mjs";
-import { M } from "./index-D5AYVv8s.mjs";
+import { M } from "./index-7MeYFlk_.mjs";
 export {
   s as BusinessLine,
   _ as MINIAPP_SCREENSHOT_ERROR_CODE,

package/lib/types/host/shadow-host.d.ts

@@ -31,6 +31,16 @@ export interface MiniAppShadowHost {
     stage: HTMLElement;
     /** 宿主侧 overlay（如 toast）应挂载到的根：shadowRoot 或 host */
     overlayRoot: ShadowRoot | HTMLElement;
+    /**
+     * 与设备画布并排的侧栏槽位（评测面板等）。
+     *
+     * 默认宽度为 0 且不渲染，只有调用 setSidePanelWidth 打开后才占位。
+     * 走分栏而非浮层：浮层会直接盖住设备，而审核页把挂载点限制成手机尺寸，
+     * 盖住后审核员既看不到小工具也点不到它。
+     */
+    sidePanel: HTMLElement;
+    /** 设置侧栏宽度；传 0 收起。bounds 自动让出对应宽度并重新居中设备。 */
+    setSidePanelWidth(width: number): void;
     /** 销毁：移除创建的宿主元素 */
     destroy(): void;
 }

package/lib/types/injection/registry.d.ts

@@ -12,6 +12,11 @@ export declare class InjectionRegistry {
     private readonly order;
     register(module: InjectionModule): void;
     unregister(id: string): boolean;
+    /**
+     * 把指定模块移到末位。seal 会锁定大量内置原型，任何需要 hook 内置对象的模块
+     * 都必须排在它之前执行，否则属性已不可配置，hook 静默失效。
+     */
+    moveToEnd(id: string): boolean;
     has(id: string): boolean;
     /** 按注册顺序列出所有模块（拼 head/preload 时按此序） */
     list(): InjectionModule[];

package/lib/types/remote/audit-controller.d.ts

@@ -0,0 +1,56 @@
+import type { RemoteAuditStartArgs, RemoteAuditStartResult } from "./protocol";
+export interface AuditPackageSnapshot {
+    zipBytes: number;
+    files: Array<{
+        path: string;
+        size: number;
+    }>;
+}
+export interface AuditControllerDeps {
+    /** 当前 simulator 实例（需支持 registerInjection / reload） */
+    getSimulator(): unknown;
+    /** 最近一次加载的包快照；没有内容时返回 null */
+    getPackage(): AuditPackageSnapshot | null;
+    /** Apollo 下发的评测策略原始值；未下发时为 undefined */
+    getPolicy(): unknown;
+    getInteractionRegions(): readonly HTMLElement[];
+    /** 与当前 Runtime release 绑定的独立插件地址。 */
+    auditPluginUrl?: string;
+    /** 把评测进度 / 报告以事件推给宿主 */
+    emitEvent(event: string, payload: unknown): void;
+    /** 视口信息，用于 canvas 预算换算 */
+    getViewport(): {
+        dpr: number;
+        width: number;
+        height: number;
+    };
+    /** Mars 审核会话：建连后常驻面板，内容加载前自动开始监听。 */
+    autoRun?: boolean;
+}
+export interface AuditController {
+    /** 手动 RPC：当前内容已运行时通过 reload 安装 document-start 探针。 */
+    start(args?: RemoteAuditStartArgs): Promise<RemoteAuditStartResult>;
+    /** 正常结束并评分；不是 abort。 */
+    stop(): void;
+    status(): {
+        phase: string;
+        sessionId: string | null;
+    };
+    report(): unknown;
+    setPolicy(input: unknown): void;
+    /** 模拟器熔断 / guest 失联时调用，让本次会话作废而不是出一份截断的分 */
+    notifyGuardTriggered(reason: string): void;
+    /**
+     * Mars 在真正装载 guest document 前调用。探针先注册、再加载内容，首屏资源和后续
+     * 审核操作都属于同一轮采样；不通过 reload 重开页面。
+     */
+    beginForContent(): Promise<void>;
+    /** 内容本身无法装载时，及时收口已经预热的会话。 */
+    notifyContentLoadFailed(reason: string): void;
+    /** 必要评测证据失败时中断；普通封面截图失败不调用此接口。 */
+    notifyEvidenceFailure(reason: string): void;
+    /** Mars 建连即调用，加载独立资源并展示空态面板。 */
+    prepare(): Promise<void>;
+    destroy(): void;
+}
+export declare function createAuditController(deps: AuditControllerDeps): AuditController;

package/lib/types/remote/audit-leave-monitor.d.ts

@@ -0,0 +1,12 @@
+export declare const DEFAULT_AUDIT_AUTO_STOP_ON_LEAVE_MS = 30000;
+export declare function resolveAutoStopOnLeaveMs(value: unknown): number;
+/** 监听稳定的模拟器区域，不进入 guest DOM，也不把 iframe 内部切换当作离开。 */
+export declare function createAuditLeaveMonitor(options: {
+    regions: readonly HTMLElement[];
+    delayMs: number;
+    onCountdown(seconds: number | null): void;
+    onTimeout(): void;
+}): {
+    activity(): void;
+    dispose(): void;
+};

package/lib/types/remote/audit-telemetry.d.ts

@@ -0,0 +1,23 @@
+export type AuditApmFields = Record<string, string | number | null | undefined>;
+/** 候选点位和终态共用一份扁平契约；缺失值省略，布尔值转为 0/1。 */
+export declare function toAuditPaintFields(input: unknown): AuditApmFields;
+interface AuditTelemetryMetadata {
+    appType?: string;
+    declaredAppType?: string;
+    features?: string[];
+    policyVersion?: string;
+    rulesVersion?: string;
+    probeVersion?: string;
+}
+/** 只上报静态聚合，不把文件路径清单带入 APM。 */
+export declare function toAuditPackageFields(pkg: {
+    zipBytes: number;
+    files: Array<{
+        path: string;
+        size: number;
+    }>;
+}, metadata: AuditTelemetryMetadata, uncompressedJsThresholdBytes: number): AuditApmFields;
+/** 报告和派生指标转成 APM 可检索的扁平标量。 */
+export declare function toAuditResultFields(report: unknown, metrics?: unknown): AuditApmFields;
+export declare function compactFields(fields: AuditApmFields): AuditApmFields;
+export {};

package/lib/types/remote/audit-watchdog.d.ts

@@ -0,0 +1,14 @@
+import type { RemoteAuditReport } from "./protocol";
+export declare const RUNTIME_HUNG_CODE = "RUNTIME_HUNG";
+/** 宿主连续收不到 Runtime 进度时，认为与 guest 共用的主线程已经卡死。 */
+export declare const AUDIT_PROGRESS_STALL_TIMEOUT_MS = 12000;
+/** 正常最长会话结束后，额外留给评分和跨 iframe 消息的收口时间。 */
+export declare const AUDIT_FINALIZATION_GRACE_MS = 35000;
+export declare const RUNTIME_HUNG_TEMPLATE_REASON = "Runtime \u5728\u8BC4\u6D4B\u671F\u95F4\u5931\u53BB\u54CD\u5E94\uFF0C\u5C0F\u5DE5\u5177\u53EF\u80FD\u957F\u65F6\u95F4\u963B\u585E\u4E86\u4E3B\u7EBF\u7A0B";
+/**
+ * 将 Runtime 在 reload 前生成的 loadFailed 模板收敛为宿主 watchdog 的最终报告。
+ *
+ * 只复制结构化数据，不访问 guest / Runtime，也不执行用户代码；因此即使 Runtime 与
+ * guest 一同卡死，宿主页仍可安全地产出一个可被本地驱动和审核面板消费的三态报告。
+ */
+export declare function createRuntimeHungAuditReport(template: RemoteAuditReport, sawProgress: boolean): RemoteAuditReport;

package/lib/types/remote/client.d.ts

@@ -1,7 +1,13 @@
 import type { BusinessLine } from "../business-line";
 import type { MiniAppEventMap, MiniAppHostApiController, MiniAppHostApiEntry, MiniAppInspectorSelectionMode, MiniAppLoadFilesResult, MiniAppLoadZipResult, MiniAppPhoneFrame, MiniAppRedirectOptions, MiniAppSceneTreeSnapshot, MiniAppScreenShotResult, MiniAppSimulatorOptions, MiniAppSimulatorRoute, MiniAppViewport, VisualSelection, XhsNoteAppCardData, XhsNotePreviewData, XhsNotePreviewUser, XhsWidgetCoverData } from "../types";
 import { type RemoteLoadTiming } from "./load-timing";
-import { type RemoteMethodArgumentMap, type RemoteSimulatorGatewayOptions, type RemoteSimulatorMethod, type RemoteSimulatorReadyMessage, type RemoteSimulatorSerializableOptions } from "./protocol";
+import { type RemoteAuditContext, type RemoteAuditStartArgs, type RemoteAuditStartResult, type RemoteMethodArgumentMap, type RemoteSimulatorGatewayOptions, type RemoteSimulatorMethod, type RemoteSimulatorReadyMessage, type RemoteSimulatorSerializableOptions } from "./protocol";
+export interface RemoteTrackerDeliveryInfo {
+    ok: boolean;
+    status?: number;
+    attempts: number;
+    eventCount: number;
+}
 export interface RemoteMiniAppSimulatorOptions {
     mount: string | HTMLElement;
     /** 模拟器服务入口；SDK 会先请求 `/runtime-manifest` 选择协议对应的 Runtime。 */
@@ -14,6 +20,10 @@ export interface RemoteMiniAppSimulatorOptions {
     businessLine: BusinessLine;
     /** 是否启用远端 Runtime APM，默认启用。 */
     tracker?: boolean;
+    /** 单批 APM 请求完成后的诊断回调，不包含事件正文。 */
+    onTrackerDelivery?: (result: RemoteTrackerDeliveryInfo) => void;
+    /** Mars 审核队列项身份；用于关联评测证据和包版本。 */
+    auditContext?: RemoteAuditContext;
     /** 注入到 launchOptions.miniToolEnv.gateways 的宿主网关配置。 */
     gateway?: RemoteSimulatorGatewayOptions;
     /** 宿主自定义 bridge 行为；优先于 Runtime 按 businessLine 提供的默认行为。 */
@@ -79,6 +89,20 @@ export interface RemoteMiniAppSimulator {
         selectByRef(ref: string): Promise<VisualSelection | null>;
     };
     hostApi: MiniAppHostApiController;
+    /**
+     * 体验评测。仅当 ready 的 capabilities 含 "audit" 时可用；
+     * 老 Runtime 上调用会返回 PLUGIN_UNAVAILABLE 而不是握手失败。
+     */
+    audit: {
+        start(args?: RemoteAuditStartArgs): Promise<RemoteAuditStartResult>;
+        stop(): Promise<void>;
+        status(): Promise<{
+            phase: string;
+            sessionId: string | null;
+        }>;
+        report(): Promise<unknown>;
+        setPolicy(policy: unknown): Promise<void>;
+    };
     invoke<M extends RemoteSimulatorMethod>(method: M, ...args: RemoteMethodArgumentMap[M]): Promise<unknown>;
     on<E extends keyof MiniAppEventMap>(event: E, handler: (payload: MiniAppEventMap[E]) => void): () => void;
     on(event: string, handler: RemoteSimulatorEventHandler): () => void;

package/lib/types/remote/load-timing.d.ts

@@ -1,6 +1,10 @@
 import type { BusinessLine } from "../business-line";
+import { type DefaultTrackerDeliveryResult } from "../tracker/default-tracker";
 export interface RemoteLoadTiming {
     report(stage: string, fields?: RemoteLoadTimingFields): void;
+    reportEvent(name: string, fields: Record<string, string | number | null | undefined>, options?: {
+        flush?: boolean;
+    }): void;
     flush(): void;
 }
 /**
@@ -30,6 +34,7 @@ export interface RemoteLoadTimingOptions {
     sessionId: string;
     runtimeVersion?: string;
     resolveUserId?: () => Promise<string>;
+    onDelivery?: (result: DefaultTrackerDeliveryResult) => void;
 }
 /**
  * 远程模拟器启动链路复用统一加载点位，避免扩展 MessageChannel 消息并触发协议升级。

package/lib/types/remote/protocol.d.ts

@@ -9,6 +9,11 @@ export declare const REMOTE_SIMULATOR_PROTOCOL_VERSION: number;
 export declare const REMOTE_SIMULATOR_CONNECT = "miniapp-simulator:connect";
 /** Runtime 已包含可在圈选期间冻结 RAF/timer/CSS/media 的 guest 注入能力。 */
 export declare const REMOTE_INSPECTOR_PAUSE_RUNTIME_CAPABILITY = "inspectorPauseRuntime";
+/**
+ * Runtime 支持按需加载体验评测插件。以 capability 协商而非 bump 协议版本：
+ * 版本不一致会让老 runtime 直接握手失败，而评测是可选能力，缺失只应降级。
+ */
+export declare const REMOTE_AUDIT_CAPABILITY = "audit";
 export declare const REMOTE_SIMULATOR_CAPABILITIES: string[];
 export type RemoteSimulatorSerializableOptions = Omit<MiniAppSimulatorOptions, "mount" | "appId" | "renderer" | "serviceWorker" | "security" | "jsapi" | "hostApi" | "tracker" | "runtimeLimits" | "onEvent" | "onReady" | "onBeforeLoad" | "onLoad" | "onRenderDone" | "onError" | "onNavigation" | "onConsole" | "onNetwork" | "onDestroy" | "onRouterChange" | "onScreenShot"> & {
     appUrl?: string;
@@ -27,6 +32,7 @@ export interface RemoteSimulatorConnectMessage {
     appId: string;
     businessLine: BusinessLine;
     tracker: boolean;
+    auditContext?: RemoteAuditContext;
     gateway?: RemoteSimulatorGatewayOptions;
     userInfo?: Record<string, unknown>;
     hostApiMethods: string[];
@@ -35,6 +41,20 @@ export interface RemoteSimulatorConnectMessage {
     }>;
     options: RemoteSimulatorSerializableOptions;
 }
+/** Mars 队列项提供的稳定业务标识；随评测点位进入 APM，不进入被测 guest。 */
+export interface RemoteAuditContext {
+    reviewTaskId: string;
+    packageVersion: string;
+    /** 业务已有可信制品哈希时可直接传入；否则 Remote Client 在 load* 时计算。 */
+    packageHash?: string;
+}
+/** Runtime 发给宿主的内部评测点位；只允许扁平标量字段。 */
+export interface RemoteAuditTelemetryPayload {
+    name: "miniapp_audit_session" | "miniapp_audit_sample" | "miniapp_audit_paint" | "miniapp_audit_incident" | "miniapp_audit_package" | "miniapp_audit_result";
+    sessionId: string;
+    fields: Record<string, string | number | null | undefined>;
+    flush?: boolean;
+}
 export interface RemoteSimulatorReadyMessage {
     type: "ready";
     protocolVersion: number;
@@ -113,7 +133,7 @@ export type RemoteSimulatorPortMessage = {
     type: "worker-visibility";
     visible: boolean;
 } | RemoteSimulatorReadyMessage | RemoteSimulatorRequestMessage | RemoteSimulatorResponseMessage | RemoteSimulatorEventMessage | RemoteHostApiRequestMessage | RemoteHostApiResponseMessage | RemoteHostRequestMessage | RemoteHostRequestResponseMessage | RemoteHostRequestAbortMessage | RemoteHostRequestEventMessage;
-export type RemoteSimulatorMethod = "load" | "loadZip" | "loadFiles" | "loadApp" | "unload" | "reload" | "setViewport" | "switchContentMode" | "switchPhoneFrame" | "switchDevice" | "setTouchEmulation" | "permissionSheet.show" | "permissionSheet.hide" | "notePreview.update" | "notePreview.updateUser" | "notePreview.updateAppCard" | "widgetCover.update" | "router.redirectTo" | "router.getRoute" | "inspector.enable" | "inspector.disable" | "inspector.toggle" | "inspector.clear" | "inspector.setSelectionMode" | "inspector.getSelectionMode" | "inspector.getSceneTree" | "inspector.selectByRef" | "capture" | "screenShot" | "setAutoScreenShot" | "hostApi.sync" | "hostApi.emit" | "destroy";
+export type RemoteSimulatorMethod = "load" | "loadZip" | "loadFiles" | "loadApp" | "unload" | "reload" | "setViewport" | "switchContentMode" | "switchPhoneFrame" | "switchDevice" | "setTouchEmulation" | "permissionSheet.show" | "permissionSheet.hide" | "notePreview.update" | "notePreview.updateUser" | "notePreview.updateAppCard" | "widgetCover.update" | "router.redirectTo" | "router.getRoute" | "inspector.enable" | "inspector.disable" | "inspector.toggle" | "inspector.clear" | "inspector.setSelectionMode" | "inspector.getSelectionMode" | "inspector.getSceneTree" | "inspector.selectByRef" | "capture" | "screenShot" | "setAutoScreenShot" | "hostApi.sync" | "hostApi.emit" | "audit.start" | "audit.stop" | "audit.status" | "audit.report" | "audit.setPolicy" | "destroy";
 export interface RemoteLoadZipArgs {
     buffer: ArrayBuffer;
     options?: Omit<MiniAppLoadZipOptions, "jszip">;
@@ -161,5 +181,135 @@ export type RemoteMethodArgumentMap = {
         toast: string;
     }>];
     "hostApi.emit": [string, unknown];
+    "audit.start": [RemoteAuditStartArgs?];
+    "audit.stop": [];
+    "audit.status": [];
+    "audit.report": [];
+    "audit.setPolicy": [unknown];
     destroy: [string?];
 };
+/** 评测启动参数。阈值不在此传递——一律由 Runtime 侧策略下发，宿主不可越过配置提权。 */
+export interface RemoteAuditStartArgs {
+    /**
+     * 兼容旧调用方的请求值；Runtime 只会使用 Apollo 的 evaluationDurationMs，
+     * 不允许宿主把一次评测延长到策略上限之外。
+     */
+    durationMs?: number;
+    armingMs?: number;
+    declaredAppType?: "tool" | "game2d" | "game3d" | "video";
+}
+/**
+ * 评测报告的跨 iframe 序列化契约。
+ *
+ * 它属于 remote protocol，而不是 Runtime 对插件包的类型依赖：评分插件作为独立 ESM
+ * 发布、动态加载，宿主只需要理解可以传递、展示和 watchdog 收口的数据形状。
+ */
+export interface RemoteAuditReport {
+    stopReason?: "manual" | "pointer_leave_timeout" | "duration_limit" | "interrupted";
+    autoStopOnLeaveMs?: number;
+    paintTiming?: {
+        fcpMs: number | null;
+        lcpMs: number | null;
+        fcpStatus: "pending" | "measured" | "unsupported" | "hidden";
+        lcpStatus: "pending" | "measured" | "unsupported" | "hidden";
+        lcpFinalized: boolean;
+        finalizeReason?: "interaction" | "hidden" | "pagehide" | "audit-stop";
+        finalizeEvent?: string;
+        lcpFinalizedAtMs?: number;
+        lcpElementTag?: string;
+        lcpElementSize?: number;
+    };
+    status: "loadFailed" | "unscorable" | "scored";
+    blocking: {
+        passed: boolean;
+        enforced: boolean;
+        failures: Array<{
+            id: string;
+            code?: string;
+            measured?: number;
+            threshold?: number;
+            unit?: string;
+            message: string;
+        }>;
+    };
+    loadFailure?: {
+        code?: string;
+        message: string;
+    };
+    score?: {
+        total: number;
+        byCategory: Record<string, {
+            got: number;
+            max: number;
+        }>;
+    };
+    coverage: {
+        ratio: number;
+        applicable: string[];
+        naReasons: Record<string, string>;
+    };
+    items: Array<{
+        id: string;
+        category: string;
+        weight: number;
+        verdict: "pass" | "fail" | "na";
+        score?: number;
+        measured?: number;
+        threshold?: number;
+        unit?: string;
+        naReason?: string;
+        note?: string;
+        applicable?: boolean;
+    }>;
+    quality: {
+        effectiveMs: number;
+        complete: boolean;
+        truncatedReason?: string;
+        reloadCount: number;
+        probeSaturated: boolean;
+        sampleCount: number;
+        sufficient: boolean;
+        insufficientReasons: string[];
+        infrastructureErrorCount: number;
+        interactionCount: number;
+        firstInteractionAt?: number;
+    };
+    appType: "tool" | "game2d" | "game3d" | "video";
+    tagMismatch: boolean;
+    versions: {
+        policyVersion: string;
+        rulesVersion: string;
+        probeVersion: string;
+    };
+}
+export type RemoteAuditStartResult = {
+    ok: true;
+    sessionId: string;
+    /** 本轮由策略确定的最长采集时长。 */
+    evaluationDurationMs: number;
+    /** 探针就绪后的预热时长。 */
+    armingMs: number;
+    /**
+     * Runtime 在 reload 前生成的兜底报告。若 guest 与 Runtime 共用的主线程被用户代码卡住，
+     * 宿主仍可将它作为 `RUNTIME_HUNG` 的 loadFailed 终态发布。
+     */
+    runtimeHungReport?: RemoteAuditReport;
+}
+/** 插件未装载（构建未包含 / 懒加载失败）*/
+ | {
+    ok: false;
+    code: "PLUGIN_UNAVAILABLE";
+    message: string;
+}
+/** 策略侧关闭了评测 */
+ | {
+    ok: false;
+    code: "POLICY_DISABLED";
+    message: string;
+}
+/** 当前没有已加载的小工具内容 */
+ | {
+    ok: false;
+    code: "NO_CONTENT";
+    message: string;
+};

package/lib/types/remote/runtime.d.ts

@@ -10,5 +10,7 @@ export interface RemoteRuntimeConfig {
     serviceWorkerScope: string;
     allowedParentOrigins: string[];
     runtimeConfigUrl: string;
+    /** 与本 Runtime release 绑定的独立评测插件；仅 Mars 审核会话动态加载。 */
+    auditPluginUrl?: string;
 }
 export declare function startRemoteMiniAppSimulatorRuntime(): void;

package/lib/types/remote-client.d.ts

@@ -1,5 +1,5 @@
-export { createRemoteMiniAppSimulator, type RemoteMiniAppSimulator, type RemoteMiniAppSimulatorOptions, type RemoteSimulatorEventHandler, } from "./remote/client";
+export { createRemoteMiniAppSimulator, type RemoteMiniAppSimulator, type RemoteMiniAppSimulatorOptions, type RemoteSimulatorEventHandler, type RemoteTrackerDeliveryInfo, } from "./remote/client";
 export { BusinessLine } from "./business-line";
-export { REMOTE_INSPECTOR_PAUSE_RUNTIME_CAPABILITY, REMOTE_SIMULATOR_PROTOCOL_VERSION, type RemoteSimulatorGatewayOptions, type RemoteSimulatorSerializableOptions, } from "./remote/protocol";
+export { REMOTE_INSPECTOR_PAUSE_RUNTIME_CAPABILITY, REMOTE_SIMULATOR_PROTOCOL_VERSION, type RemoteAuditContext, type RemoteSimulatorGatewayOptions, type RemoteSimulatorSerializableOptions, } from "./remote/protocol";
 export { MiniAppJsApiErrorCode, MINIAPP_SCREENSHOT_ERROR_CODE } from "./types";
 export type { MiniAppContentMode, MiniAppLoadZipResult, MiniAppHostApiController, MiniAppHostApiEntry, MiniAppHostApiHandler, MiniAppHostApiRequest, MiniAppHostRequest, MiniAppHostRequestOptions, MiniAppHostRequestResponse, MiniAppViewport, VisualSelection, XhsNoteAppCardData, XhsNotePreviewUser, XhsWidgetCoverData, MiniAppSimulatorRoute, MiniAppRedirectOptions, MiniAppScreenShotResult, MiniAppScreenShotErrorCode, MiniAppRouterChangeEvent, MiniAppSimulatorOptions, } from "./types";

package/lib/types/sw/service-worker-host.d.ts

@@ -29,6 +29,10 @@ export interface ServiceWorkerHostLike {
     fileUrl(fsScope: string, path: string): string;
     mount(input: ServiceWorkerMountInput): Promise<string>;
     restoreMount(id: string): Promise<void>;
+    remount(id: string, patch: {
+        injectHead: string;
+        csp: string;
+    }): Promise<boolean>;
     fsInvoke(id: string, op: ServiceWorkerFileSystemOperation, args?: ServiceWorkerFileSystemArgs): Promise<unknown>;
     unmount(id: string): void;
 }
@@ -55,6 +59,17 @@ export declare class ServiceWorkerHost {
     mount(input: ServiceWorkerMountInput): Promise<string>;
     /** 重新挂载已知实例：用于 iframe 被卸载后再次加载虚拟 URL 前恢复 SW 代理。 */
     restoreMount(id: string): Promise<void>;
+    /**
+     * 就地替换已挂载实例的 head 注入与 CSP，虚拟 URL 保持不变。
+     *
+     * MOUNT 在 worker 侧按 id 覆盖写，所以重发一次即可让后续对同一 URL 的导航拿到新
+     * 注入。文件表复用快照副本（原始 ArrayBuffer 首次传输时已被 detach）。
+     * 返回 false 表示该 id 没有快照，调用方应回退到完整重新加载。
+     */
+    remount(id: string, patch: {
+        injectHead: string;
+        csp: string;
+    }): Promise<boolean>;
     /**
      * 文件系统调用（host→SW）：按 `op` 分派并返回 op 结果。
      */

package/lib/types/tracker/default-tracker.d.ts

@@ -5,6 +5,12 @@ export interface DefaultTracker {
     /** 立即发送缓冲中的所有打点 */
     flush(): void;
 }
+export interface DefaultTrackerDeliveryResult {
+    ok: boolean;
+    status?: number;
+    attempts: number;
+    eventCount: number;
+}
 export interface DefaultTrackerConfig {
     /** xray 上报端点 URL */
     endpoint: string;
@@ -14,6 +20,8 @@ export interface DefaultTrackerConfig {
     resolveUserId: () => Promise<string>;
     /** 打印到 console 而非真正上报；仅显式传 true 时开启。 */
     debug?: boolean;
+    /** 单批请求完成后的诊断回调，不包含事件正文。 */
+    onDelivery?: (result: DefaultTrackerDeliveryResult) => void;
 }
 /** 创建默认 Tracker：自定义点位缓冲后批量 POST 到 APM 端点 */
 export declare function createDefaultTracker(config: DefaultTrackerConfig): DefaultTracker;

package/lib/types/types/options.d.ts

@@ -4,6 +4,7 @@ import type { MiniAppPermissionKind, MiniAppPermissionSheetResult } from '../nat
 import type { MiniAppEventHandler, MiniAppEventName } from './events';
 import type { MiniAppInspectorController } from './inspector';
 import type { GestureDispatchInput, GestureDispatchResult } from '../gesture/types';
+import type { InjectionModule } from '../injection/types';
 export type { GestureDispatchAction, GestureDispatchInput, GestureDispatchResult } from '../gesture/types';
 /**
  * 配置与运行态类型（原 types.ts 段落 1）。
@@ -790,6 +791,29 @@ export interface MiniAppSimulator {
      * 宿主可据此在主进程把真 Chrome DevTools 嵌入自定义面板（setDevToolsWebContents）。
      */
     getWebContentsId(): number | null;
+    /**
+     * 注册扩展注入模块（评测探针等），下次 load / reload 生效。
+     * 内部会把 security 重排到末位，保证探针在 seal 锁定内置原型之前安装。
+     */
+    registerInjection(module: InjectionModule): void;
+    /** 注销扩展注入模块；下次 load / reload 生效。 */
+    unregisterInjection(id: string): boolean;
+    /**
+     * 重算 head 注入并就地替换 SW 已挂载实例的注入载荷；随后 reload 才会带上新注入。
+     * 返回 false 表示当前不是 SW 直供状态。
+     */
+    refreshInjection(): Promise<boolean>;
+    /** 打开与设备画布并排的侧栏，返回可挂载内容的容器。 */
+    openSidePanel(width: number): HTMLElement;
+    /** 收起侧栏并清空其内容。 */
+    closeSidePanel(): void;
+    /** 整块模拟器的交互区域（设备、侧栏及内部留白），用于边界监听。 */
+    getInteractionRegions(): readonly HTMLElement[];
+    /**
+     * 临时调整 guest 堆熔断线（字节），传 null 恢复建实例时的值。
+     * 改值后须 refreshInjection + reload 才会下发新阈值。
+     */
+    setHeapLimitOverride(maxHeapUsedBytes: number | false | null): void;
     destroy(reason?: string): void;
     on<E extends MiniAppEventName>(event: E, handler: MiniAppEventHandler<E>): () => void;
     once<E extends MiniAppEventName>(event: E, handler: MiniAppEventHandler<E>): () => void;

package/lib/workbench.js

@@ -1,4 +1,4 @@
-import { c as Mn } from "./client-_vNHVHSm.mjs";
+import { c as Mn } from "./client-BDt3WDu_.mjs";
 function Sn(a, i) {
   const e = /* @__PURE__ */ new Map();
   let v = 0, l = !1, w, b, L, m, u;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillbuilder/miniapp-simulator",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Designable Miniapp Simulator - 技术栈无关的小应用 PC 预览与审核模拟器 SDK",
   "main": "lib/index.js",
   "module": "lib/index.js",