minecodex 2.0.55 → 2.1.1

package/packages/runtime-host/src/codex-runtime.mjs

@@ -1,54 +1,36 @@
 import { assertPromptsRequest } from "../../../features/notes/src/adapters/codex/requests.mjs";
 import { LocalImageSource } from "../../../features/images/src/backend/local-image-source.mjs";
-import { cloudImagesAction } from "../../../features/images/src/backend/cloud-library.mjs";
 // CodexRuntime：Codex Renderer 生命周期与 host action 执行。
 // 注入源（createInjectionSource）与 CDP 客户端分别在 codex-injection.mjs / codex-cdp.mjs。
 
 import { randomBytes } from "node:crypto";
-import { mkdir, stat } from "node:fs/promises";
+import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import {
   CODEX_APP_ORIGIN,
   HOST_BINDING_NAME,
-  LOOPBACK_SURFACE_HOSTS,
   RUNTIME_VERSION,
-  SURFACE_FRAME_PREFIX,
-  SURFACE_LOAD_ACTION,
   createDocumentBootstrapSource,
   createInjectionSource,
-  documentWithBase,
-  findFrameByName,
   pageScriptServiceOrigin,
-  requireDeclaredLoopbackSurface,
 } from "./codex-injection.mjs";
 import {
   connect,
-  evaluationValue,
   processChildHasExited,
   requireCdpWebSocketUrl,
   waitForExpression,
   waitForProcessChildExit,
 } from "./codex-cdp.mjs";
-import {
-  attachFileToComposer,
-  attachFilesToComposer,
-  createImageEditThread,
-} from "./host-actions.mjs";
 import { ModelFavorites } from "../../../features/model-slider/src/backend/favorites.mjs";
 import { SitesService } from "../../../features/sites/src/backend/sites-service.mjs";
 import { SessionStatusReader, threadIdFromLocation } from "../../../features/session-status/src/adapters/codex/session-reader.mjs";
 import { createCodexEnvironment } from "../../codex-adapter/src/renderer/environment.mjs";
 
 
-// 保持公共入口兼容：历史 import 从本文件继续可用。
 export {
-  RESPONSIVE_SUMMARY_LAYOUT,
   createInjectionSource,
   createRuntimeReadyContract,
   pageScriptServiceOrigin,
-  responsiveSummaryContentShift,
-  responsiveSummaryDisplayMode,
-  responsiveSummaryVisibleSurface,
 } from "./codex-injection.mjs";
 
 export const SESSION_STATUS_THREAD_ID_EXPRESSION = `(() => {
@@ -71,9 +53,6 @@ export class CodexRuntime {
     availabilityTimeoutMs = 20_000,
     availabilityPollMs = 500,
     monitorIntervalMs = 2_000,
-    surfaceLoadTimeoutMs = 5_000,
-    surfaceFramePollMs = 25,
-    featureInstanceId = null,
     codexBuild = null,
     runtimeSessionId = randomBytes(16).toString("hex"),
     onStatusChange = null,
@@ -94,9 +73,6 @@ export class CodexRuntime {
     this.availabilityTimeoutMs = availabilityTimeoutMs;
     this.availabilityPollMs = availabilityPollMs;
     this.monitorIntervalMs = monitorIntervalMs;
-    this.surfaceLoadTimeoutMs = surfaceLoadTimeoutMs;
-    this.surfaceFramePollMs = surfaceFramePollMs;
-    this.featureInstanceId = featureInstanceId;
     this.codexBuild = codexBuild;
     this.runtimeSessionId = runtimeSessionId;
     this.onStatusChange = onStatusChange;
@@ -408,124 +384,6 @@ export class CodexRuntime {
     await client.send("Runtime.evaluate", { expression, awaitPromise: true, returnByValue: true });
   }
 
-  async fetchSurfaceResource(url, label) {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), this.surfaceLoadTimeoutMs);
-    try {
-      return await this.fetchImpl(url, {
-        cache: "no-store",
-        headers: { origin: CODEX_APP_ORIGIN },
-        signal: controller.signal,
-      });
-    } catch (error) {
-      if (controller.signal.aborted) {
-        throw Object.assign(new Error(`${label} timed out`), { code: "SURFACE_LOAD_TIMEOUT" });
-      }
-      throw error;
-    } finally {
-      clearTimeout(timeout);
-    }
-  }
-
-  async verifiedSurfaceDocument(feature, surfaceUrl) {
-    requireDeclaredLoopbackSurface(feature, surfaceUrl);
-    if (!this.featureInstanceId || !feature.healthUrl) {
-      throw Object.assign(new Error("Surface service identity is unavailable"), {
-        code: "SURFACE_IDENTITY_UNAVAILABLE",
-      });
-    }
-    const healthResponse = await this.fetchSurfaceResource(feature.healthUrl, "Surface health check");
-    if (!healthResponse?.ok) {
-      throw Object.assign(new Error(`Surface health returned HTTP ${healthResponse?.status ?? "error"}`), {
-        code: "SURFACE_HEALTH_FAILED",
-      });
-    }
-    let health;
-    try {
-      health = await healthResponse.json();
-    } catch {
-      throw Object.assign(new Error("Surface health returned invalid JSON"), {
-        code: "SURFACE_HEALTH_FAILED",
-      });
-    }
-    if (
-      health?.ok !== true
-      || health.service !== feature.id
-      || health.protocolVersion !== 1
-      || health.instanceId !== this.featureInstanceId
-    ) {
-      throw Object.assign(new Error("Surface service identity does not match this RuntimeHost"), {
-        code: "SURFACE_IDENTITY_MISMATCH",
-      });
-    }
-
-    const response = await this.fetchSurfaceResource(surfaceUrl, "Surface document request");
-    if (!response?.ok) {
-      throw Object.assign(new Error(`Surface document returned HTTP ${response?.status ?? "error"}`), {
-        code: "SURFACE_DOCUMENT_FAILED",
-      });
-    }
-    const contentType = String(response.headers?.get?.("content-type") ?? "").toLowerCase();
-    if (!contentType.startsWith("text/html")) {
-      throw Object.assign(new Error("Surface document must be HTML"), {
-        code: "SURFACE_DOCUMENT_INVALID",
-      });
-    }
-    return documentWithBase(await response.text(), surfaceUrl);
-  }
-
-  async loadSurfaceIntoFrame(client, feature, payload = {}) {
-    const frameName = payload.frameName;
-    if (
-      typeof frameName !== "string"
-      || !frameName.startsWith(SURFACE_FRAME_PREFIX)
-      || frameName.length > 256
-    ) {
-      throw Object.assign(new Error("Surface frame identity is invalid"), {
-        code: "SURFACE_FRAME_INVALID",
-      });
-    }
-    const surfaceUrl = payload.surfaceUrl;
-    const html = await this.verifiedSurfaceDocument(feature, surfaceUrl);
-    const deadline = Date.now() + this.surfaceLoadTimeoutMs;
-    let frame = null;
-    while (!frame && Date.now() < deadline) {
-      const { frameTree } = await client.send("Page.getFrameTree");
-      frame = findFrameByName(frameTree, frameName);
-      if (!frame) await this.sleep(this.surfaceFramePollMs);
-    }
-    if (!frame) {
-      throw Object.assign(new Error("Surface frame was not discovered"), {
-        code: "SURFACE_FRAME_NOT_FOUND",
-      });
-    }
-    if (frame.url !== "about:blank") {
-      throw Object.assign(new Error("Surface frame must remain at about:blank before loading"), {
-        code: "SURFACE_FRAME_INVALID",
-      });
-    }
-    await client.send("Page.setDocumentContent", { frameId: frame.id, html });
-    return { loaded: true };
-  }
-
-  // 薄转发：host action 实现已迁至 host-actions.mjs，
-  // 保留方法入口以稳定测试与 handleBindingCalled 路由。
-  attachFileToComposer(client, filePath, requestId) {
-    return attachFileToComposer(client, filePath, requestId);
-  }
-
-  attachFilesToComposer(client, filePaths, requestId) {
-    return attachFilesToComposer(client, filePaths, requestId);
-  }
-
-  createImageEditThread(client, feature, payload, requestId) {
-    return createImageEditThread(client, feature, payload, requestId, {
-      fetchImpl: this.fetchImpl,
-      attachFiles: (_client, filePaths, _requestId) => this.attachFilesToComposer(client, filePaths, requestId),
-    });
-  }
-
-
   async handleBindingCalled(targetId, client, params) {
     if (params.name !== HOST_BINDING_NAME) return;
     let request;
@@ -542,18 +400,6 @@ export class CodexRuntime {
       }
       return;
     }
-    if (feature && request.action === SURFACE_LOAD_ACTION) {
-      try {
-        const result = await this.loadSurfaceIntoFrame(client, feature, request.payload);
-        await this.resolveHostAction(client, request.requestId, { ok: true, result });
-      } catch (error) {
-        await this.resolveHostAction(client, request.requestId, {
-          ok: false,
-          error: { code: error.code ?? "SURFACE_LOAD_FAILED", message: error.message },
-        });
-      }
-      return;
-    }
     if (!feature?.hostActions?.includes(request.action)) {
       await this.resolveHostAction(client, request.requestId, {
         ok: false,
@@ -608,55 +454,10 @@ export class CodexRuntime {
       }
       return;
     }
-    if (request.action === "import-generated-image") {
-      await this.importGeneratedImage(feature, request.payload);
-      return;
-    }
-    if (["list-cloud-images", "import-cloud-image"].includes(request.action)) {
-      try {
-        let result = await cloudImagesAction(
-          async (expression, options) => evaluationValue(await client.send("Runtime.evaluate", {
-            expression, awaitPromise:true, returnByValue:true,
-          }, options)),
-          request.action === "list-cloud-images" ? "list" : "import", request.payload,
-        );
-        if (request.action === "import-cloud-image" && !result.skipped) {
-          result = await this.importGeneratedImage(feature, result);
-        }
-        await this.resolveHostAction(client, request.requestId, { ok: true, result });
-      } catch (error) {
-        await this.resolveHostAction(client, request.requestId, { ok: false, error: { code: "CLOUD_IMAGES_FAILED", message: error.message } });
-      }
-      return;
-    }
-    try {
-      const result = request.action === "create-image-edit-thread"
-        ? await this.createImageEditThread(client, feature, request.payload, request.requestId)
-        : await this.attachFileToComposer(client, request.payload?.path, request.requestId);
-      await this.resolveHostAction(client, request.requestId, { ok: true, result });
-    } catch (error) {
-      await this.resolveHostAction(client, request.requestId, {
-        ok: false,
-        error: { code: error.code ?? "ATTACH_FAILED", message: error.message },
-      });
-    }
-  }
-
-  async importGeneratedImage(feature, payload) {
-    const origin = pageScriptServiceOrigin(feature);
-    if (!origin) throw new Error("Generated image import service is unavailable");
-    const response = await this.fetchImpl(new URL("/api/import-generated-image", origin), {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Origin: CODEX_APP_ORIGIN,
-      },
-      body: JSON.stringify(payload),
+    await this.resolveHostAction(client, request.requestId, {
+      ok: false,
+      error: { code: "ACTION_NOT_IMPLEMENTED", message: "Host action has no RuntimeHost handler" },
     });
-    if (!response?.ok) {
-      throw new Error(`Generated image import returned HTTP ${response?.status ?? "error"}`);
-    }
-    return response.json();
   }
 
   async refreshTargets() {

package/packages/runtime-host/src/feature-registry.mjs

@@ -6,24 +6,15 @@ import path from "node:path";
 import { pathToFileURL } from "node:url";
 
 const MANIFEST_NAME = "codex-feature.json";
+// 每项都必须有功能在 codex-feature.json 中声明，并由 CodexRuntime 实现。
 const HOST_ACTIONS = new Set([
   "sites",
   "model-favorites",
   "quick-prompts",
-  "insert-text",
-  "attach-file",
-  "open-detail-tab",
-  "open-editor-modal",
-  "open-sidebar",
-  "resolve-file-paths",
-  "import-generated-image",
-  "list-cloud-images",
   "local-image-source",
-  "import-cloud-image",
-  "create-image-edit-thread",
 ]);
 
-const PAGE_SCRIPT_ENTRY_KINDS = new Set(["page-script"]);
+const ENTRY_KINDS = new Set(["page-script", "composer-model-selector"]);
 const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "[::1]"]);
 
 export const FEATURE_PROTOCOL_VERSION = 1;
@@ -172,9 +163,9 @@ async function normalizeModelSelector(modelSelector, projectDir) {
 }
 
 async function normalizePageScript(manifest, projectDir) {
-  const resource = manifest.entry?.script ?? manifest.pageScript?.resource ?? manifest.script;
+  const resource = manifest.entry?.script;
   if (!resource) {
-    throw new Error("page-script entries require entry.script or script.resource");
+    throw new Error("page-script entries require entry.script");
   }
   const scriptPath = path.resolve(projectDir, resource);
   const relative = path.relative(projectDir, scriptPath);
@@ -218,69 +209,15 @@ async function normalizeFeature(manifest, projectDir, env) {
   }
 
   const label = normalizeLocalizedText(manifest.label, "label");
-  const entryKind = manifest.entry?.kind ?? "sidebar";
-  if (!new Set(["sidebar", "conversation-toolbar", "composer-model-selector", ...PAGE_SCRIPT_ENTRY_KINDS]).has(entryKind)) {
-    throw new Error("entry.kind must be sidebar, conversation-toolbar, composer-model-selector, or page-script");
-  }
-  const isModelSelector = entryKind === "composer-model-selector";
-  const isPageScript = PAGE_SCRIPT_ENTRY_KINDS.has(entryKind);
-  if (!isModelSelector && !isPageScript && !manifest.surfaceUrl) {
-    throw new Error("surfaceUrl is required for rendered features");
-  }
-  if (entryKind === "conversation-toolbar" && !manifest.entry?.ariaLabel) {
-    throw new Error("conversation-toolbar entries require entry.ariaLabel");
-  }
-  if (entryKind === "conversation-toolbar" && !manifest.pinnedSummary?.surfaceUrl) {
-    throw new Error("conversation-toolbar entries require pinnedSummary.surfaceUrl");
-  }
-  const summaryPresentation = manifest.pinnedSummary?.presentation ?? "responsive-summary";
-  if (summaryPresentation !== "responsive-summary") {
-    throw new Error("pinnedSummary.presentation must be responsive-summary");
-  }
-
-  const detailTabs = await Promise.all((manifest.detailTabs ?? []).map(async (detail) => {
-    if (!detail.id || !detail.label || !detail.surfaceUrl) {
-      throw new Error("each detailTabs entry requires id, label, and surfaceUrl");
-    }
-    const detailLabel = normalizeLocalizedText(detail.label, `detailTabs.${detail.id}.label`);
-    return {
-      id: String(detail.id),
-      label: detailLabel.value,
-      labels: detailLabel.locales,
-      surfaceUrl: normalizeUrl(detail.surfaceUrl, `detailTabs.${detail.id}.surfaceUrl`),
-      icon: await normalizeIcon(detail.icon, projectDir),
-    };
-  }));
-  if (new Set(detailTabs.map((detail) => detail.id)).size !== detailTabs.length) {
-    throw new Error("detailTabs ids must be unique");
+  const entryKind = manifest.entry?.kind;
+  if (!ENTRY_KINDS.has(entryKind)) {
+    throw new Error("entry.kind must be page-script or composer-model-selector");
   }
   const hostActions = (manifest.hostActions ?? []).map(String);
   if (hostActions.some((action) => !HOST_ACTIONS.has(action))) {
     throw new Error("hostActions contains an unsupported action");
   }
-
-  const pageScript = manifest.pageScript
-    ? await normalizePageScript({ ...manifest, entry: { ...(manifest.entry ?? {}), script: manifest.pageScript.resource } }, projectDir)
-    : null;
-
   const { surfaceUrl, healthUrl } = normalizeRuntimeUrls(manifest, env);
-  const entryLabel = normalizeLocalizedText(manifest.entry?.ariaLabel ?? manifest.label, "entry.ariaLabel");
-  const summaryLabel = manifest.pinnedSummary
-    ? normalizeLocalizedText(manifest.pinnedSummary.label ?? manifest.label, "pinnedSummary.label")
-    : null;
-  const overlayLabel = manifest.pinnedSummary
-    ? normalizeLocalizedText(manifest.pinnedSummary.overlayLabel ?? manifest.label, "pinnedSummary.overlayLabel")
-    : null;
-  const pinnedLabel = manifest.pinnedSummary
-    ? normalizeLocalizedText(
-      manifest.pinnedSummary.pinnedLabel
-        ?? manifest.entry?.ariaLabel
-        ?? (typeof manifest.label === "string"
-          ? `Toggle pinned ${manifest.label.toLowerCase()}`
-          : manifest.label),
-      "pinnedSummary.pinnedLabel",
-    )
-    : null;
 
   return {
     id: String(manifest.id),
@@ -288,30 +225,13 @@ async function normalizeFeature(manifest, projectDir, env) {
     labels: label.locales,
     surfaceUrl,
     healthUrl,
-    icon: await normalizeIcon(manifest.icon, projectDir),
-    entry: {
-      kind: entryKind,
-      ariaLabel: entryLabel.value,
-      ariaLabels: entryLabel.locales,
-    },
-    pinnedSummary: manifest.pinnedSummary ? {
-      label: summaryLabel.value,
-      labels: summaryLabel.locales,
-      surfaceUrl: normalizeUrl(manifest.pinnedSummary.surfaceUrl, "pinnedSummary.surfaceUrl"),
-      presentation: summaryPresentation,
-      overlayLabel: overlayLabel.value,
-      overlayLabels: overlayLabel.locales,
-      pinnedLabel: pinnedLabel.value,
-      pinnedLabels: pinnedLabel.locales,
-    } : null,
-    detailTabs,
+    entry: { kind: entryKind },
     hostActions,
-    modelSelector: isModelSelector
+    modelSelector: entryKind === "composer-model-selector"
       ? await normalizeModelSelector(manifest.modelSelector, projectDir)
       : null,
-    pageScript: isPageScript ? await normalizePageScript(manifest, projectDir) : pageScript,
+    pageScript: entryKind === "page-script" ? await normalizePageScript(manifest, projectDir) : null,
     placement: {
-      after: manifest.placement?.after ?? "sites",
       order: Number(manifest.placement?.order ?? 100),
     },
     command: Array.isArray(manifest.command) ? manifest.command.map(String) : null,
@@ -335,7 +255,6 @@ export async function discoverFeatures(featuresRoot, { env = process.env } = {})
     }
     try {
       const manifest = JSON.parse(source);
-      if (manifest.disabled === true) continue;
       features.push(await normalizeFeature(manifest, projectDir, env));
     } catch (error) {
       throw new Error(`Invalid ${entry.name}/${MANIFEST_NAME}: ${error.message}`);

package/packages/runtime-host/src/main.mjs

@@ -73,7 +73,6 @@ featureProcesses = await startFeatureProcesses(features, {
 
 runtime = new CodexRuntime({
   features,
-  featureInstanceId,
   codexBuild:process.env.MINECODEX_CODEX_BUILD || null,
   profileDir,
   cdpPort,

package/packages/ui/src/native/tokens.mjs

@@ -144,33 +144,5 @@ export const CODEX_THEME_TOKENS = Object.freeze([
   "--color-text-danger-solid",
 ]);
 
-// images 图片编辑器可用性依赖的项目 token 子集。
-// 与 features/images/web/app.js 的 editorTokens 保持同一来源（一致性由测试锁定）。
-export const EDITOR_TOKEN_NAMES = Object.freeze([
-  "--mcx-color-surface-tertiary",
-  "--mcx-color-surface-elevated-secondary",
-  "--mcx-color-border-subtle",
-  "--mcx-color-background-primary-ghost-hover",
-  "--mcx-color-chart-blue",
-  "--mcx-color-text-inverse",
-  "--mcx-color-token-main-surface-primary",
-  "--mcx-color-token-input-foreground",
-  "--mcx-color-text-foreground",
-  "--mcx-color-text-foreground-tertiary",
-  "--mcx-color-text-on-accent",
-  "--mcx-color-border",
-  "--mcx-color-border-focus",
-  "--mcx-color-token-list-hover-background",
-  "--mcx-color-text-accent",
-  "--mcx-font-sans-default",
-  "--mcx-font-weight-normal",
-  "--mcx-text-sm",
-  "--mcx-text-sm--line-height",
-  "--mcx-radius-md",
-  "--mcx-radius-xl",
-  "--mcx-shadow-md",
-  "--mcx-shadow-xl",
-]);
-
 // 插件只消费 MineCodex 命名空间，原生名称变化集中在此映射。
 export const MINECODEX_THEME_BINDINGS = Object.freeze(Object.fromEntries(CODEX_THEME_TOKENS.map(name => [name, "--mcx-" + name.slice(2)])));

package/apps/dashboard/assets/feature-previews.js

@@ -1,206 +0,0 @@
-import {previewContent} from './preview-content.js';
-
-export function installFeaturePreviews(grid, locale) {
-  let zh = locale === 'zh-CN';
-  const t = (cn, en) => zh ? cn : en;
-  const lifetime = new AbortController();
-  const on = (node, type, fn, options = {}) => node.addEventListener(type, fn, {...options, signal: lifetime.signal});
-  const fine = matchMedia('(hover: hover) and (pointer: fine)');
-  const reduced = matchMedia('(prefers-reduced-motion: reduce)');
-  let current = null, panel = null, video = null, enterTimer, leaveTimer, replayTimer, pinned = false, generation = 0, restoring = false, mediaAbort = null;
-  let manifest, hoveredCard = null, hoveredPanel = false, pendingCard = null;
-  const media = () => manifest ??= window.minecodexPreviewMedia !== undefined
-    ? Promise.resolve(window.minecodexPreviewMedia)
-    : fetch('/assets/previews/manifest.json').then(r => r.ok ? r.json() : {}).then(value => value && typeof value === 'object' ? value : {}).catch(() => ({}));
-  const node = (tag, cls, text) => {
-    const el = document.createElement(tag); el.className = cls; if (text) el.textContent = text; return el;
-  };
-  async function resourceUrl(id, kind, value, signal) {
-    if (!window.minecodexMcpApp) return `/assets/previews/${value}`;
-    const response = await window.minecodexMcpApp.readServerResource({uri:`resource://minecodex/previews/${id}/${kind}`}, {signal});
-    const resource = response.contents?.[0];
-    if (!resource?.blob) throw new Error('Preview resource unavailable');
-    return `data:${resource.mimeType};base64,${resource.blob}`;
-  }
-  function close({restore = false} = {}) {
-    clearTimeout(enterTimer); clearTimeout(leaveTimer); clearTimeout(replayTimer); generation++;
-    mediaAbort?.abort(); mediaAbort = null;
-    // 先释放状态再移除节点，避免焦点退出事件重入清理。
-    const closingPanel = panel, card = current, player = video;
-    panel = null; current = null; video = null; pinned = false;
-    if (player) { player.pause(); player.removeAttribute('src'); player.load(); }
-    const trigger = card?.querySelector('.preview-entry');
-    trigger?.setAttribute('aria-expanded', 'false');
-    trigger?.removeAttribute('aria-controls');
-    card?.classList.remove('is-previewing');
-    grid.classList.remove('has-preview');
-    closingPanel?.remove();
-    if (restore && trigger?.isConnected) { restoring = true; trigger.focus({preventScroll: true}); restoring = false; }
-  }
-  function position() {
-    if (!current || !panel) return;
-    const rect = current.getBoundingClientRect();
-    const width = Math.min(360, innerWidth - 32);
-    panel.style.width = `${width}px`;
-    panel.style.maxHeight = `${Math.max(120, innerHeight - 32)}px`;
-    const height = panel.getBoundingClientRect().height;
-    let left, top;
-    if (innerWidth - rect.right >= width + 24) left = rect.right + 8;
-    else if (rect.left >= width + 24) left = rect.left - width - 8;
-    else {
-      left = Math.max(16, Math.min(rect.left, innerWidth - width - 16));
-      // 窄屏把面板放到开关下方，避免挡住当前操作。
-      const below = innerHeight - rect.bottom - 24, above = rect.top - 24;
-      if (below >= Math.min(height, 180)) {
-        panel.style.maxHeight = `${below}px`; top = rect.bottom + 8;
-      } else if (above >= Math.min(height, 180)) {
-        panel.style.maxHeight = `${above}px`; top = Math.max(16, rect.top - height - 8);
-      } else {
-        top = Math.max(16, rect.top + current.querySelector('.plugin-topline').getBoundingClientRect().height + 32);
-        panel.style.maxHeight = `${Math.max(100, innerHeight - top - 16)}px`;
-      }
-    }
-    top ??= Math.max(16, Math.min(rect.top, innerHeight - height - 16));
-    Object.assign(panel.style, {left: `${left}px`, top: `${top}px`, visibility: 'visible'});
-  }
-  function scheduleClose() {
-    if (!pinned && !hoveredCard && !hoveredPanel) leaveTimer = setTimeout(() => close(), 100);
-  }
-  async function addMedia(id, host, state, ticket) {
-    const resources = (await media())?.[id];
-    if (ticket !== generation || !panel || !resources) return;
-    mediaAbort = new AbortController();
-    const mediaSignal = mediaAbort.signal;
-    let posterUrl, videoUrl, resourceFailed = false;
-    state.textContent = t('正在加载预览…', 'Loading preview…');
-    const urls = await Promise.all(['poster', 'video'].map(async kind => {
-      if (!resources[kind]) return null;
-      try { return await resourceUrl(id, kind, resources[kind], mediaSignal); }
-      catch { resourceFailed = true; return null; }
-    }));
-    if (ticket !== generation) return;
-    [posterUrl, videoUrl] = urls;
-    state.textContent = resourceFailed ? t('资源暂不可用 · 请参考说明', 'Preview unavailable · See description') : t('演示视频准备中', 'Demo video coming soon');
-    let poster = null;
-    if (posterUrl) {
-      poster = node('img', 'preview-poster'); poster.alt = t('功能静态预览', 'Static feature preview');
-      poster.addEventListener('load', position, {once: true});
-      poster.addEventListener('error', () => { poster.remove(); resourceFailed = true; if (!video) state.textContent = t('资源暂不可用 · 请参考说明', 'Preview unavailable · See description'); position(); }, {once: true});
-      poster.src = posterUrl; host.append(poster);
-      state.textContent = t('静态预览', 'Static preview');
-    }
-    if (!videoUrl) { position(); return; }
-    if (reduced.matches) { position(); return; }
-    const player = node('video', 'preview-video'); video = player;
-    player.muted = true; player.playsInline = true; player.preload = 'metadata'; player.hidden = true;
-    const fallback = () => {
-      panel.classList.remove('is-media-only');
-      if (poster) poster.hidden = false;
-    };
-    const failed = () => {
-      if (ticket !== generation) return;
-      clearTimeout(replayTimer); player.pause(); player.removeAttribute('src'); player.load(); player.remove(); video = null; fallback();
-      state.textContent = poster?.isConnected ? t('视频暂不可用 · 静态预览', 'Video unavailable · Static preview') : t('视频暂不可用 · 请参考说明', 'Video unavailable · See description'); position();
-    };
-    player.addEventListener('error', failed, {once: true});
-    player.addEventListener('loadeddata', () => {
-      if (ticket !== generation) return;
-      position();
-    });
-    player.addEventListener('play', () => {
-      if (ticket !== generation) return;
-      player.hidden = false; if (poster) poster.hidden = true;
-      panel.classList.add('is-media-only'); position();
-    });
-    const playVideo = async () => {
-      if (ticket !== generation) return;
-      try { await player.play(); }
-      catch {
-        if (ticket === generation && video === player && player.isConnected) {
-          player.hidden = true; fallback();
-          state.textContent = poster?.isConnected ? t('静态预览', 'Static preview') : t('演示视频准备中', 'Demo video coming soon'); position();
-        }
-      }
-    };
-    player.addEventListener('ended', () => {
-      clearTimeout(replayTimer);
-      replayTimer = setTimeout(() => {
-        if (ticket !== generation || video !== player) return;
-        player.currentTime = 0; void playVideo();
-      }, 2000);
-    });
-    host.append(player); state.textContent = t('正在加载演示…', 'Loading demo…');
-    player.src = videoUrl;
-    void playVideo();
-    position();
-  }
-  function open(card, fixed = false) {
-    clearTimeout(enterTimer); clearTimeout(leaveTimer);
-    if (card === current) { pinned ||= fixed; return; }
-    close(); hoveredPanel = false; current = card; pinned = fixed;
-    panel = node('section', 'feature-preview'); panel.id = 'feature-preview'; panel.setAttribute('role', 'region');
-    const title = node('h3', 'preview-title', card.querySelector('.plugin-name').textContent);
-    title.id = 'feature-preview-title'; panel.setAttribute('aria-labelledby', title.id);
-    const dismiss = node('button', 'button quiet preview-close', t('关闭', 'Close')); dismiss.type = 'button';
-    dismiss.addEventListener('click', () => close({restore: pinned || panel.contains(document.activeElement)}));
-    const heading = node('div', 'preview-heading'); heading.append(title, dismiss); panel.append(heading);
-    const host = node('div', 'preview-media'); panel.append(host);
-    const details = node('dl', 'preview-details');
-    const labels = [t('出现位置', 'Location'), t('解决问题', 'Problem'), t('操作与效果', 'Action and result')];
-    previewContent(card.dataset.featureId, locale).forEach((value, index) => {
-      details.append(node('dt', '', labels[index]), node('dd', '', value));
-    });
-    const state = node('p', 'preview-resource-state', t('演示视频准备中', 'Demo video coming soon'));
-    panel.append(details, state);
-    panel.addEventListener('pointerenter', () => { hoveredPanel = true; clearTimeout(leaveTimer); });
-    panel.addEventListener('pointerleave', () => { hoveredPanel = false; scheduleClose(); });
-    panel.addEventListener('focusin', () => { clearTimeout(leaveTimer); });
-    panel.addEventListener('focusout', event => { if (!panel?.contains(event.relatedTarget) && !current?.contains(event.relatedTarget)) close(); });
-    document.querySelector('.dashboard-surface').append(panel);
-    card.classList.add('is-previewing'); grid.classList.add('has-preview');
-    const trigger = card.querySelector('.preview-entry'); trigger.setAttribute('aria-expanded', 'true'); trigger.setAttribute('aria-controls', panel.id);
-    position(); void addMedia(card.dataset.featureId, host, state, generation);
-  }
-  function attach(card) {
-    const entry = node('button', 'preview-entry'); entry.type = 'button'; entry.setAttribute('aria-expanded', 'false');
-    entry.setAttribute('aria-label', `${t('查看效果', 'See how it works')} · ${card.querySelector('.plugin-name').textContent || card.dataset.featureId}`);
-    card.append(entry);
-    on(card, 'pointerenter', () => {
-      if (!fine.matches) return;
-      hoveredCard = card; pendingCard = card;
-
-      clearTimeout(enterTimer); clearTimeout(leaveTimer);
-      enterTimer = setTimeout(() => { pendingCard = null; open(card); }, 200);
-    });
-    on(card, 'pointerleave', () => {
-      if (hoveredCard === card) hoveredCard = null;
-      if (pendingCard === card) { clearTimeout(enterTimer); pendingCard = null; }
-      scheduleClose();
-    });
-    on(entry, 'focus', () => { if (!restoring) open(card); });
-    on(entry, 'click', () => open(card, true));
-    on(card, 'focusout', event => { if (!card.contains(event.relatedTarget) && !panel?.contains(event.relatedTarget) && document.documentElement.dataset.input === 'keyboard') close(); });
-  }
-  on(document, 'keydown', event => {
-    if (event.key === 'Escape' && current) { event.preventDefault(); const restore = pinned || panel.contains(document.activeElement); close({restore}); }
-  });
-  on(document, 'pointerdown', event => {
-    if (!current) return;
-    if (!current.contains(event.target) && !panel.contains(event.target)) close();
-  });
-  on(window, 'scroll', event => {
-    if (panel?.contains(event.target)) return;
-    close();
-  }, {capture: true});
-  on(window, 'resize', () => close());
-  on(document, 'visibilitychange', () => { if (document.hidden) close(); });
-  on(window, 'blur', () => close());
-  on(document.querySelector('#data-dialog'), 'toggle', () => close());
-  on(document.querySelector('#language-menu'), 'toggle', () => close());
-  on(window, 'pagehide', () => { close(); lifetime.abort(); });
-  function setLocale(next) {
-    close(); locale = next; zh = locale === 'zh-CN';
-    for (const card of grid.querySelectorAll('.plugin-card')) card.querySelector('.preview-entry')?.setAttribute('aria-label', `${t('查看效果', 'See how it works')} · ${card.querySelector('.plugin-name').textContent}`);
-  }
-  return {attach, close, setLocale};
-}