minecodex 2.0.14 → 2.0.16

package/features/notes/src/frontend/entry.mjs

@@ -10,6 +10,7 @@ let addButton = null;
 let composerRoot = null;
 let composerThread = null;
 let composerEditable = null;
+let focusedEditable = null;
 let panel = null;
 let items = [];
 let generation = 0;
@@ -25,6 +26,9 @@ function appearanceLabel(key) {
 }
 function errorMessage(error) {
   const messages = {
+    "No available input in the focused window": "当前窗口没有可用输入框，请先打开聊天并确认 MCX 增强服务已开启。",
+    "Input changed before insertion": "输入框已切换，请重新选择提示词。",
+    "Enable Prompts in MineCodex first": "请先在 MineCodex 中开启提示词。",
     "Open a chat before using a prompt.": "请先打开一个对话，再使用提示词。",
     "Category was not found": "未找到该分类",
     "Prompt was not found": "未找到该提示词",
@@ -281,6 +285,8 @@ function renderList() {
         async () => {
           const current = generation;
           try {
+            if (!composerEditable?.isConnected || !config.codex.composer(composerEditable,{purpose:"insertion"}))
+              throw new Error("Input changed before insertion");
             window.__codexPersonalRuntime.insertText(item.body, composerEditable);
             // 插入同步成功后再记一次调用；失败和单纯浏览不计数。
             close();
@@ -338,10 +344,15 @@ function isOpenComposerMenu(node) {
     && (node.getAttribute("data-composer-navigation-target") === "add-context"
       || node.getAttribute("aria-haspopup") === "menu");
 }
+function insertionComposer() {
+  // 官方 App 获得 iframe 焦点时，保留用户最后操作的同窗口输入框。
+  const target = document.activeElement?.tagName === "IFRAME" ? focusedEditable : null;
+  return config.codex.composer(target,{purpose:"insertion"});
+}
 function sync() {
   if (disposed || signal.aborted) return;
-  syncNavigation();
-  const nativeComposer = config.codex.composer(null,{purpose:"insertion"});
+  if (config.management) return;
+  const nativeComposer = panel ? config.codex.composer(composerEditable,{purpose:"insertion"}) : insertionComposer();
   const add = nativeComposer?.add;
   const card = nativeComposer?.root;
   const thread = nativeComposer?.threadId ?? null;
@@ -357,6 +368,7 @@ function sync() {
     composerRoot = card;
   }
   composerEditable = nativeComposer?.editable ?? null;
+  insertionBridge?.remember(nativeComposer);
   if (!add) return;
   if (
     panel &&
@@ -402,8 +414,6 @@ function sync() {
 }
 // 页面与快捷调用面板共享数据；所有编辑只存在于页面。
 // 管理页面与编辑弹窗
-let navButton = null;
-let ownNavGroup = null;
 let page = null;
 let pageGeneration = 0;
 let activeCategory = "all";
@@ -414,8 +424,6 @@ let cardResizeObserver = null;
 let searchText = "";
 let editor = null;
 let pageFocus = null;
-const hiddenSurfaces = new Map();
-let navigationRail = null;
 
 function pageControl(label, handler, primary = false, tone = "secondary") {
   return config.ui.action(control(label, handler, `pm-command${primary ? " pm-primary" : ""}`), primary ? "primary" : tone);
@@ -428,23 +436,7 @@ function pageError(error) {
   (editor ?? page.querySelector(".pm-wrap") ?? page).append(message);
 }
 function positionPage() {
-  if (!page) return;
-  const rail = config.codex.rail();
-  if (!rail) {
-    closePage();
-    return;
-  }
-  const rect = rail.getBoundingClientRect();
-  page.style.left = `${rect.right}px`;
-  page.style.top = `${rect.top}px`;
-  page.style.right = "4px";
-  page.style.bottom = "4px";
-}
-function syncNavigationSelection() {
-  navigationRail?.select(Boolean(page));
-}
-function restoreNavigationSelection() {
-  navigationRail?.select(false);
+  if (page) Object.assign(page.style, {inset:"0",borderRadius:"0"});
 }
 function closePage(restoreFocus = false, restoreNavigation = true) {
   dragState?.cancel();
@@ -456,12 +448,7 @@ function closePage(restoreFocus = false, restoreNavigation = true) {
   if (page) config.ui.releasePage(page, { restoreNavigation });
   page?.remove();
   page = null;
-  restoreNavigationSelection();
   editor = null;
-  for (const [surface, inert] of hiddenSurfaces) surface.inert = inert;
-  hiddenSurfaces.clear();
-  navButton?.removeAttribute("data-selected");
-  navButton?.removeAttribute("aria-current");
   document.documentElement.removeAttribute("data-mcx-prompts-open");
   if (restoreFocus && pageFocus?.isConnected)
     pageFocus.focus({ preventScroll: true });
@@ -487,19 +474,9 @@ function openPage() {
   page = element("section");
   page.setAttribute(MARKER, "page");
   config.ui.page(page, { sidebar:"none", onNavigate:() => closePage(false, false) });
-  page.setAttribute("aria-label", text("Prompts", "提示词"));
+  page.setAttribute("aria-label", text("Prompt", "提示词"));
   document.body.append(page);
-  // 只隔离主内容的焦点，保留导航栏与原生窗口控件。
-  for (const surface of document.querySelectorAll(
-    '[class*="_PageSurface_"], [class*="_Workspace_"]',
-  )) {
-    hiddenSurfaces.set(surface, surface.inert);
-    surface.inert = true;
-  }
   document.documentElement.setAttribute("data-mcx-prompts-open", "");
-  navButton?.setAttribute("data-selected", "");
-  navButton?.setAttribute("aria-current", "page");
-  syncNavigationSelection();
   positionPage();
   page.append(element("div", "pm-empty", text("Loading…", "加载中…")));
   return loadPage();
@@ -666,7 +643,7 @@ function renderPage() {
     searchField,
     pageControl(text("New prompt", "新建提示词"), () => editPrompt(), true),
   );
-  heading.append(element("h1", "", text("Prompts", "提示词")), actions);
+  heading.append(element("h1", "", text("Prompt", "提示词")), actions);
   const tabs = element("div", "pm-tabs");
   tabs.setAttribute("role", "tablist");
   tabs.setAttribute("aria-label", text("Categories", "分类"));
@@ -818,31 +795,9 @@ function cardPreview(item) {
 }
 async function usePagePrompt(item, trigger) {
   trigger.disabled = true;
-  closePage();
-  try {
-    // Page 归还原路由后等待输入框挂载；不自动发送消息。
-    let editable = null;
-    for (let attempt = 0; attempt < 40 && !signal.aborted; attempt++) {
-      editable = config.codex.composer(null, { purpose: "insertion" })?.editable;
-      if (editable) break;
-      await new Promise((resolve) => setTimeout(resolve, 50));
-    }
-    if (signal.aborted) return;
-    if (!editable) throw new Error("Open a chat before using a prompt.");
-    window.__codexPersonalRuntime.insertText(item.body, editable);
-  } catch (error) {
-    await openPage();
-    pageError(error);
-    return;
-  }
-  try {
-    await api(`/api/prompts/${encodeURIComponent(item.id)}/use`, {
-      method: "POST", body: { action: "insert", success: true },
-    });
-  } catch (error) {
-    // 正文已插入，计数失败不能再次插入。
-    console.warn("[Prompts] Usage could not be saved", error);
-  }
+  try { await config.insertPrompt(item.id); if (!signal.aborted) await loadPage(); }
+  catch (error) { if (!signal.aborted) pageError(error); }
+  finally { trigger.disabled = false; }
 }
 let imagePreview = null;
 let imagePreviewAnchor = null;
@@ -1031,7 +986,7 @@ function emptyState(searching) {
   const empty = element("div", "pm-empty-state");
   const art = element("span", "pm-empty-art", searching ? "🔎" : "📖");
   art.setAttribute("role", "img");
-  art.setAttribute("aria-label", text("Prompts", "提示词"));
+  art.setAttribute("aria-label", text("Prompt", "提示词"));
   empty.append(
     art,
     element(
@@ -1620,70 +1575,16 @@ function editCategory(category = null) {
   name.focus();
 }
 // 原生导航挂载与卸载
-function syncNavigation() {
-  const rail = config.codex.rail();
-  if (!rail) {
-    navButton?.remove();
-    navButton = null;
-    if (page) closePage();
-    return;
-  }
-  const slot = config.codex.railSlot(ownNavGroup);
-  if (!slot) return;
-  const { template:source, scroll } = slot;
-  let group = slot.group;
-  if (!group) {
-    if (!ownNavGroup) {
-      ownNavGroup = element("div", "flex shrink-0 flex-col items-center gap-2");
-      ownNavGroup.setAttribute(MARKER, "nav-group");
-    }
-    if (ownNavGroup.parentElement !== scroll) scroll.append(ownNavGroup);
-    group = ownNavGroup;
-  }
-  if (!navButton?.isConnected) {
-    navigationRail?.restore();
-    navButton = source.cloneNode(false);
-    navButton.removeAttribute("id");
-    navButton.removeAttribute("title");
-    navButton.removeAttribute("aria-describedby");
-    navButton.removeAttribute("data-sidebar-destination");
-    navButton.removeAttribute("data-selected");
-    navButton.removeAttribute("aria-current");
-    navButton.removeAttribute("data-suppress-active-style");
-    navButton.setAttribute(MARKER, "nav");
-    navButton.setAttribute("aria-label", text("Prompts", "提示词"));
-    navButton.setAttribute("data-minecodex-tooltip", text("Prompts", "提示词"));
-    const inner = element("span", source.firstElementChild?.className ?? "");
-    const glyph = icon("prompt-nav");
-    glyph.setAttribute("aria-hidden", "true");
-    inner.append(glyph, element("span", "sr-only", text("Prompts", "提示词")));
-    navButton.append(inner);
-    navigationRail = config.ui.navigationRail(navButton, {
-      defaultIcon:glyph, selectedIcon:icon("prompt-nav-selected"),
-    });
-    navButton.addEventListener("click", openPage);
-  }
-  if (navButton.parentElement !== group || navButton !== group.lastElementChild)
-    group.append(navButton);
-  if (group !== ownNavGroup) ownNavGroup?.remove();
-  syncNavigationSelection();
-  positionPage();
-}
-document.addEventListener(
-  "click",
-  (event) => {
-    if (
-      page &&
-      event.target.closest("[data-app-navigation-rail] button") &&
-      !navButton?.contains(event.target)
-    )
-      closePage(false, false);
-  },
-  { signal, capture: true },
-);
-window.addEventListener("popstate", () => closePage(false, false), { signal });
 window.addEventListener("resize", positionPage, { signal });
 
+document.addEventListener("focusin", event => {
+  if (config.management) return;
+  const target = event.target.closest?.('[contenteditable="true"]');
+  const focused = target ? config.codex.composer(target,{purpose:"insertion"}) : null;
+  if (focused) focusedEditable = focused.editable;
+  sync();
+}, {signal});
+
 const observer = new MutationObserver(() => {
   if (syncQueued) return;
   syncQueued = true;
@@ -1692,7 +1593,7 @@ const observer = new MutationObserver(() => {
     sync();
   });
 });
-observer.observe(document.documentElement, {
+if (!config.management) observer.observe(document.documentElement, {
   childList: true,
   subtree: true,
   attributes: true,
@@ -1745,24 +1646,25 @@ document.addEventListener(
 );
 window.addEventListener("resize", () => { clearQuickPreview(true); position(); }, { signal });
 window.addEventListener("scroll", position, { signal, capture: true });
-sync();
+const insertionBridge = config.management ? null : installPromptInsertion(signal, {
+  codex:config.codex, api, insertText:(body,editable) => window.__codexPersonalRuntime.insertText(body,editable),
+});
+if (config.management) openPage(); else sync();
 
 config.registerSelfCheck?.(() => {
-  const rail=config.codex.railSlot(ownNavGroup), composer=config.codex.composer(null,{purpose:"insertion"});
-  const checks=[{name:"prompts-navigation-anchor",available:Boolean(rail && navButton?.isConnected)}];
-  if (composer) checks.push({name:"quick-prompts-anchor",available:Boolean(composer.add && button?.isConnected && composerRoot === composer.root)});
+  const composer=config.codex.composer(null,{purpose:"insertion"});
+  const checks=composer ? [{name:"quick-prompts-anchor",available:Boolean(composer.add && button?.isConnected && composerEditable === composer.editable)}] : [];
   const available=checks.every(check=>check.available);
-  return {state:available ? "available" : "unavailable",reason:available ? null : "prompts-anchor-unavailable",checks,
-    scopes:[{name:"navigation",element:navButton},{name:"composer",element:composer?.root},{name:"prompts-page",element:page},{name:"prompts-popup",element:pagePopup},{name:"quick-prompts",element:panel}]};
+  return {state:composer ? available ? "available" : "unavailable" : "not-applicable",reason:available ? null : "prompts-anchor-unavailable",checks,
+    scopes:[{name:"composer",element:composer?.root},{name:"quick-prompts",element:panel}]};
 });
 
 return () => {
   disposed = true;
+
   observer.disconnect();
   close();
   button?.remove();
   closePage();
-  navButton?.remove();
-  ownNavGroup?.remove();
   style.remove();
 };

package/features/notes/src/frontend/icons.json

@@ -8,8 +8,6 @@
   "back": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" aria-hidden=\"true\"><path d=\"M9.87117 11.6289C10.0762 11.8339 10.0762 12.166 9.87117 12.3711C9.66614 12.5761 9.334 12.5761 9.12898 12.3711L5.36433 8.60641C5.0296 8.27129 5.0296 7.72863 5.36433 7.39351L9.12898 3.62887C9.334 3.42384 9.66614 3.42384 9.87117 3.62887C10.0762 3.83389 10.0762 4.16603 9.87117 4.37105L6.24226 7.99996L9.87117 11.6289Z\" fill=\"currentColor\"/></svg>",
   "settings": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" aria-hidden=\"true\"><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M6.33374 8.97461C7.54786 8.97484 8.56163 9.83236 8.80347 10.9746H13.3337C13.6235 10.9749 13.8591 11.2102 13.8591 11.5C13.8591 11.7898 13.6235 12.0251 13.3337 12.0254H8.80347C8.56163 13.1676 7.54786 14.0252 6.33374 14.0254C5.11907 14.0254 4.10455 13.1673 3.86304 12.0244L2.66675 12.0254C2.37691 12.0253 2.14138 11.7899 2.14136 11.5C2.14136 11.2102 2.37693 10.9748 2.66675 10.9746H3.86304C4.10491 9.83221 5.11941 8.97461 6.33374 8.97461ZM6.33374 10.0254C5.51912 10.0254 4.85913 10.6854 4.85913 11.5C4.85913 12.3146 5.51912 12.9746 6.33374 12.9746C7.14814 12.9743 7.80835 12.3145 7.80835 11.5C7.80835 10.6855 7.14814 10.0257 6.33374 10.0254Z\" fill=\"currentColor\"/> <path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M9.66675 1.97461C10.881 1.97461 11.8935 2.83236 12.1355 3.97461H13.3328C13.6227 3.97459 13.8581 4.21005 13.8582 4.5C13.8581 4.78993 13.6227 5.02537 13.3328 5.02539H12.1365C11.8946 6.16774 10.881 7.02539 9.66675 7.02539C8.45245 7.02539 7.43893 6.16774 7.19702 5.02539H2.66675C2.3768 5.02539 2.14136 4.78995 2.14136 4.5C2.14136 4.21005 2.3768 3.97461 2.66675 3.97461H7.19702C7.43893 2.83226 8.45245 1.97461 9.66675 1.97461ZM9.66675 3.02539C8.85213 3.02539 8.19214 3.68538 8.19214 4.5C8.19214 5.31462 8.85213 5.97461 9.66675 5.97461C10.4814 5.97461 11.1414 5.31462 11.1414 4.5C11.1414 3.68538 10.4814 3.02539 9.66675 3.02539Z\" fill=\"currentColor\"/></svg>",
   "drag": "<svg\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"24\"\n  height=\"24\"\n  viewBox=\"0 0 24 24\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"2\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <path d=\"M4 5h16\" />\n  <path d=\"M4 12h16\" />\n  <path d=\"M4 19h16\" />\n</svg>\n",
-  "prompt-nav": "<svg\n  class=\"lucide lucide-book-open\"\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"20\"\n  height=\"20\"\n  viewBox=\"-1.5 -1.5 27 27\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"1.8\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <path d=\"M12 7v14 M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z\" />\n</svg>",
-  "prompt-nav-selected": "<svg width=\"20\" height=\"20\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 256 256\" fill=\"currentColor\"><path d=\"M240,56V200a8,8,0,0,1-8,8H160a24,24,0,0,0-24,23.94,7.9,7.9,0,0,1-5.12,7.55A8,8,0,0,1,120,232a24,24,0,0,0-24-24H24a8,8,0,0,1-8-8V56a8,8,0,0,1,8-8H88a32,32,0,0,1,32,32v87.73a8.17,8.17,0,0,0,7.47,8.25,8,8,0,0,0,8.53-8V80a32,32,0,0,1,32-32h64A8,8,0,0,1,240,56Z\"/></svg>",
   "layout-grid": "<!-- Lucide, ISC license; see assets/brand/references/lucide-LICENSE.txt -->\n<svg\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"24\"\n  height=\"24\"\n  viewBox=\"0 0 24 24\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"2\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <rect width=\"7\" height=\"7\" x=\"3\" y=\"3\" rx=\"1\" />\n  <rect width=\"7\" height=\"7\" x=\"14\" y=\"3\" rx=\"1\" />\n  <rect width=\"7\" height=\"7\" x=\"14\" y=\"14\" rx=\"1\" />\n  <rect width=\"7\" height=\"7\" x=\"3\" y=\"14\" rx=\"1\" />\n</svg>\n",
   "list": "<!-- Lucide, ISC license; see assets/brand/references/lucide-LICENSE.txt -->\n<svg\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"24\"\n  height=\"24\"\n  viewBox=\"0 0 24 24\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"2\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <path d=\"M3 5h.01\" />\n  <path d=\"M3 12h.01\" />\n  <path d=\"M3 19h.01\" />\n  <path d=\"M8 5h13\" />\n  <path d=\"M8 12h13\" />\n  <path d=\"M8 19h13\" />\n</svg>\n",
   "square-pen": "<!-- Lucide, ISC license; see assets/brand/references/lucide-LICENSE.txt -->\n<svg\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"24\"\n  height=\"24\"\n  viewBox=\"0 0 24 24\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"2\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <path d=\"M12 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7\" />\n  <path d=\"M18.375 2.625a1 1 0 0 1 3 3l-9.013 9.014a2 2 0 0 1-.853.505l-2.873.84a.5.5 0 0 1-.62-.62l.84-2.873a2 2 0 0 1 .506-.852z\" />\n</svg>\n"

package/features/notes/src/injection-source.mjs

@@ -0,0 +1,5 @@
+import {readFile} from 'node:fs/promises';
+import {installPromptInsertion} from './adapters/codex/insertion.mjs';
+export async function createPageScriptSource() {
+  return `const installPromptInsertion = ${installPromptInsertion.toString()};\n${await readFile(new URL('./frontend/entry.mjs',import.meta.url),'utf8')}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "2.0.14",
+  "version": "2.0.16",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -57,6 +57,7 @@
     "assets/brand/minecodex-icon.svg",
     "assets/brand/minecodex-icon-light.svg",
     "assets/brand/minecodex-icon-dark.svg",
+    "assets/brand/minecodex-icon-selected.svg",
     "assets/brand/references/lucide-LICENSE.txt",
     "assets/readme/hero.svg",
     "packages/ui/assets",
@@ -67,14 +68,18 @@
     "features/file-navigation/src",
     "features/file-navigation/codex-feature.json",
     "features/file-navigation/assets",
-    "features/file-navigation/vendor/lucide-LICENSE"
+    "features/file-navigation/vendor/lucide-LICENSE",
+    "apps/dashboard/transport.js",
+    "packages/plugin/src",
+    "packages/plugin/assets",
+    "packages/plugin/plugin.json"
   ],
   "engines": {
     "node": ">=22.5.0"
   },
   "scripts": {
     "start": "node packages/cli/bin/mcx.mjs serve",
-    "test": "node --test packages/cli/test/*.test.mjs packages/runtime-host/test/*.test.mjs features/model-slider/test/*.test.mjs features/notes/test/*.test.mjs features/images/test/*.test.mjs features/hide-upsell-banner/test/*.test.mjs features/session-status/test/*.test.mjs features/usage-meter/test/*.test.mjs apps/dashboard/test/*.test.mjs features/unread-inbox/test/*.test.mjs features/sidebar-focus/test/*.test.mjs features/sites/test/*.test.mjs packages/ui/test/*.test.mjs packages/codex-adapter/test/*.test.mjs features/markdown-reading/test/*.test.mjs features/file-navigation/test/*.test.mjs",
+    "test": "node --test packages/cli/test/*.test.mjs packages/runtime-host/test/*.test.mjs features/model-slider/test/*.test.mjs features/notes/test/*.test.mjs features/images/test/*.test.mjs features/hide-upsell-banner/test/*.test.mjs features/session-status/test/*.test.mjs features/usage-meter/test/*.test.mjs apps/dashboard/test/*.test.mjs features/unread-inbox/test/*.test.mjs features/sidebar-focus/test/*.test.mjs features/sites/test/*.test.mjs packages/ui/test/*.test.mjs packages/codex-adapter/test/*.test.mjs features/markdown-reading/test/*.test.mjs features/file-navigation/test/*.test.mjs packages/plugin/test/*.test.mjs",
     "test:cli": "node --test packages/cli/test/*.test.mjs",
     "test:runtime": "node --test packages/runtime-host/test/*.test.mjs",
     "check": "node scripts/check-syntax.mjs",
@@ -83,7 +88,9 @@
     "pack:audit": "node scripts/audit-package.mjs",
     "prepublishOnly": "npm test && npm run check && npm run pack:audit",
     "test:ui": "node --test packages/ui/test/*.test.mjs",
-    "build:icons": "node scripts/build-brand-icons.mjs"
+    "build:icons": "node scripts/build-brand-icons.mjs",
+    "build:plugin": "node scripts/build-plugin.mjs",
+    "test:plugin": "node --test packages/plugin/test/*.test.mjs"
   },
   "repository": {
     "type": "git",
@@ -105,6 +112,12 @@
     "win32"
   ],
   "dependencies": {
-    "acorn": "^8.18.0"
+    "@modelcontextprotocol/ext-apps": "^2.0.3",
+    "@modelcontextprotocol/sdk": "^1.32.0",
+    "acorn": "^8.18.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.2"
   }
 }

package/packages/cli/src/commands.mjs

@@ -85,6 +85,7 @@ Commands:
   mcx uninstall [--purge]  Remove integration; preserve data unless --purge is used
   mcx update               Update to the latest stable npm release
   mcx open                 Open the MineCodex plugin control panel
+  mcx plugin install       Register the official Codex plugin entry
   mcx status [--json]      Show installation and plugin status
   mcx restart              Restart Codex and apply saved plugin switches
   mcx --version             Print the installed version
@@ -447,6 +448,15 @@ export async function runCli(argv, {
   const [command = "--help", ...args] = argv;
   if (["--help", "-h", "help"].includes(command)) return printHelp(output);
   if (["--version", "-v"].includes(command)) return output(packageMetadata.version);
+  if (command === "plugin" && args[0] === "serve") {
+    const { servePlugin } = await import("../../plugin/src/server.mjs");
+    return servePlugin({ paths });
+  }
+  if (command === "plugin" && args[0] === "install") {
+    const { installPlugin } = await import("../../plugin/src/install.mjs");
+    await installPlugin({ paths });
+    return output("MineCodex plugin installed. Open Explore in Codex to find MineCodex.");
+  }
   if (command === "install") return installCommand({ paths, platform, cliPath, output, serviceProbe, fetchImpl, confirmRestart, nodeVersion });
   if (command === "open" || command === "gui") return openCommand({ paths, platform, output, serviceProbe, fetchImpl });
   if (command === "status") return statusCommand({ paths, platform, jsonOutput: args.includes("--json"), output, fetchImpl });

package/packages/codex-adapter/src/renderer/environment.mjs

@@ -65,12 +65,41 @@ export function createCodexEnvironment() {
     const group = [...(scroll?.children ?? [])].find(child => child !== ownGroup && child.classList.contains('flex-col') && child.classList.contains('shrink-0'));
     return node && template && scroll ? { rail:node, template, scroll, group } : null;
   }
+  // 导航与 MCP iframe 身份在 Adapter 内解释，功能不接触 React props。
+  function navigation() {
+    const scope = props(rail(), value => Boolean((value.router ?? value.value?.router)?.navigate));
+    const router = scope?.router ?? scope?.value?.router;
+    if (!router?.subscribe) return null;
+    const read = () => {
+      const location = router.state.location;
+      return {path:location.pathname + (location.search ?? "") + (location.hash ?? ""), key:location.key};
+    };
+    return {location:read, navigate:path => router.navigate(path, {replace:true}),
+      subscribe:callback => router.subscribe(state => {
+        if (!state.navigation?.state || state.navigation.state === "idle") callback(read());
+      })};
+  }
+  function mcpAppSource(sourceWindow, {server, pluginId, resourceUri}) {
+    for (const frame of document.querySelectorAll('[data-mcp-extension-surface] iframe')) {
+      let source = sourceWindow, matches = false;
+      // 官方 sandbox proxy 包含资源 iframe；WindowProxy.parent 可跨源读取。
+      for (let depth = 0; source && depth < 4; depth++) {
+        if (source === frame.contentWindow) {matches = true;break;}
+        try {if (source.parent === source) break; source = source.parent;} catch {break;}
+      }
+      if (!matches) continue;
+      const view = props(frame, value => value.view?.resourceUri != null)?.view;
+      if (view?.resourceUri === resourceUri && (view.server === server || view.pluginId === pluginId))
+        return {connected:() => frame.isConnected};
+    }
+    return null;
+  }
   function route() {
     const node = rail();
     const scope = node && props(node, value => Boolean((value.router ?? value.value?.router)?.state?.location));
     return (scope?.router ?? scope?.value?.router)?.state?.location?.pathname ?? null;
   }
-  return { composer, composerSurface, rail, railSlot, route, currentThreadId:element => composer(element)?.threadId ?? null,
+  return { composer, composerSurface, rail, railSlot, route, navigation, mcpAppSource, currentThreadId:element => composer(element)?.threadId ?? null,
     // 仅供 UI／插件 native Adapter 使用，交互层不读取 React props。
     currentFiber, props, report, diagnostics:() => [...capabilities.values()].map(item => ({...item})) };
 }