minecodex 2.0.15 → 2.0.17

package/README.md

@@ -50,11 +50,18 @@ mcx open
 | `mcx uninstall [--purge]` | 移除扩展；默认保留个人数据，带 `--purge` 参数才会清理 |
 | `mcx update` | 更新到最新的稳定版本 |
 | `mcx open` | 打开 MineCodex 控制台 |
+| `mcx plugin install` | 通过官方插件机制注册 Codex 内的 MineCodex 控制台入口 |
 | `mcx status [--json]` | 查看安装与插件运行状态 |
 | `mcx restart` | 重启 Codex 并应用插件开启/关闭状态 |
 
 关闭某项功能仅停用对应的扩展服务，不会删除任何个人数据；修改设置后运行 `mcx restart` 即可应用更改。
 
+运行 `mcx plugin install` 后，在 Codex 的 Explore／探索中打开 MineCodex，也可按原生
+导航设置固定到侧栏。该本地插件使用官方 MCP Apps 入口与面板，复用原有控制台。
+关闭面板不会停止增强；各项功能继续由 MineCodex 本地服务和注入运行时提供。
+当前正在运行的窗口若未刷新插件目录，下次正常启动后查看。安装命令不会重启 Codex。
+插件卸载使用 `codex plugin remove minecodex@minecodex-local`，不删除增强配置或数据。
+
 运行 `mcx uninstall` 会移除名为 MineCodex 的后台项目，并默认保留配置设置、Notes 笔记和 Images 图片索引；只有显式加上 `--purge` 参数，才会清理 MineCodex 产生的本地配置。MineCodex 绝不会删除 `~/.codex/generated_images` 中的原始图片或 Notes 引用的本地文件。
 
 ## 数据与图片操作
@@ -106,3 +113,5 @@ MineCodex 是非官方独立扩展项目，与 OpenAI 无关联。项目自有
 支持 Prompts 与分类、公网 Sites、模型收藏。模型旧收藏在新版模型滑条首次启动后收录，
 导入收藏在下次启动 Codex 后载入。图片文件、本地站点、账号信息与设备设置不包含在文件中；
 可迁移功能的特殊说明可通过 info 查看。这是手动迁移，不是自动云同步。文件包含提示词正文，请妥善保管。
+
+官方插件提供 MineCodex 控制台与 **Prompt** 两个入口，分别使用 MCX 品牌图标与 Prompt 图标。Prompt 仍由 MCX 管理，沿用原有提示词数据；输入框里的快捷提示词继续只填入、不发送。

package/apps/dashboard/app.js

@@ -1,4 +1,5 @@
 import {diagnosticReport} from "./assets/diagnostics.js";
+import {dashboardFetch} from "./transport.js";
 let savedLocale;
 try { savedLocale = localStorage.getItem("minecodex-language"); } catch { /* 存储不可用时跟随浏览器语言。 */ }
 const locale = ["en", "zh-CN"].includes(savedLocale) ? savedLocale
@@ -221,7 +222,7 @@ function updatePluginCard(card, feature) {
   const dot = card.querySelector(".plugin-state .status-dot");
   const stateLabel = card.querySelector(".plugin-state-label");
   card.dataset.featureId = feature.id;
-  image.src = `${feature.iconUrl}?v=resource-1`;
+  image.src = feature.iconUrl.startsWith("data:") ? feature.iconUrl : `${feature.iconUrl}?v=resource-1`;
   name.textContent = feature.label;
   description.textContent = feature.description;
   input.checked = Boolean(feature.enabled);
@@ -310,7 +311,7 @@ function replaceFeatureInState(featureId, patch) {
 async function load() {
   elements.loadError.hidden = true;
   try {
-    const response = await fetch("/api/status", { headers: { "Accept-Language": locale } });
+    const response = await dashboardFetch("/api/status", { headers: { "Accept-Language": locale } });
     if (!response.ok) throw new Error(`HTTP ${response.status}`);
     const fresh = await response.json();
     if (pendingFeatureIds.size && state) fresh.features = fresh.features.map(feature =>
@@ -339,7 +340,7 @@ elements.pluginList.addEventListener("change", async (event) => {
   updatePluginCard(card, state.features.find((feature) => feature.id === featureId));
   elements.saveState.textContent = copy.saving;
   try {
-    const response = await fetch(`/api/features/${encodeURIComponent(featureId)}`, {
+    const response = await dashboardFetch(`/api/features/${encodeURIComponent(featureId)}`, {
       method: "PATCH",
       headers: { "Content-Type": "application/json", "Accept-Language": locale },
       body: JSON.stringify({ enabled: input.checked }),
@@ -369,7 +370,7 @@ elements.restartButton.addEventListener("click", async () => {
   elements.restartButton.disabled = true;
   elements.restartButton.querySelector(".button-label").textContent = copy.restarting;
   try {
-    const response = await fetch("/api/restart", {
+    const response = await dashboardFetch("/api/restart", {
       method: "POST",
       headers: { "Content-Type": "application/json", "Accept-Language": locale },
       body: "{}",
@@ -404,7 +405,7 @@ elements.updateButton.addEventListener("click", async () => {
   elements.updateButton.querySelector(".button-label").textContent = copy.checkingUpdates;
   elements.updateResult.hidden = true;
   try {
-    const response = await fetch("/api/update");
+    const response = await dashboardFetch("/api/update");
     if (!response.ok) throw new Error(`HTTP ${response.status}`);
     const update = await response.json();
     elements.updateResult.textContent = update.available ? copy.updateAvailable(update.latest) : copy.current;
@@ -422,7 +423,8 @@ const systemTheme = matchMedia("(prefers-color-scheme: dark)");
 let selectedTheme = null;
 try { selectedTheme = localStorage.getItem("minecodex-appearance"); } catch { /* 存储不可用时仍允许本次切换。 */ }
 function applyTheme() {
-  const dark = selectedTheme === "dark" || (selectedTheme !== "light" && systemTheme.matches);
+  const hostDark = window.minecodexHostTheme ? window.minecodexHostTheme === "dark" : systemTheme.matches;
+  const dark = selectedTheme === "dark" || (selectedTheme !== "light" && hostDark);
   document.documentElement.dataset.theme = dark ? "dark" : "light";
   elements.themeToggle.setAttribute("aria-label", locale === "zh-CN" ? "外观" : "Appearance");
   for (const button of elements.themeButtons) {
@@ -447,6 +449,7 @@ elements.languageToggle.addEventListener("click", (event) => {
   location.reload();
 });
 systemTheme.addEventListener("change", applyTheme);
+window.addEventListener("minecodex-host-theme", applyTheme);
 document.addEventListener("keydown", () => { document.documentElement.dataset.input = "keyboard"; });
 document.addEventListener("pointerdown", () => { document.documentElement.dataset.input = "pointer"; });
 applyStaticCopy();

package/apps/dashboard/assets/data-transfer.js

@@ -1,4 +1,5 @@
 import { installFeatureTooltips } from './ui-tooltip.js';
+import {dashboardFetch} from '../transport.js';
 const tooltipLifetime = new AbortController();
 const { tooltipSurface } = installFeatureTooltips(tooltipLifetime.signal);
 window.addEventListener('pagehide', event => { if (!event.persisted) tooltipLifetime.abort(); });
@@ -20,7 +21,7 @@ document.querySelector('#data-close').setAttribute('aria-label', t('关闭', 'Cl
 exportButton.querySelector('.button-label').textContent = t('导出', 'Export');
 importButton.querySelector('.button-label').textContent = t('导入', 'Import');
 async function request(url, data) {
-  const response = await fetch(url, data ? { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(data) } : {});
+  const response = await dashboardFetch(url, data ? { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(data) } : {});
   if (!response.ok) throw new Error(String(response.status));
   return response.json();
 }

package/apps/dashboard/transport.js

@@ -0,0 +1,18 @@
+// 浏览器继续走同源 HTTP；官方插件面板通过 MCP 调用同一套本地服务。
+export async function dashboardFetch(url, options = {}) {
+  const app = window.minecodexMcpApp;
+  if (!app) return fetch(url, options);
+  const method = options.method ?? "GET";
+  const result = await app.callServerTool({
+    name: method === "GET" ? "minecodex_read" : "minecodex_write",
+    arguments: {
+      route: url,
+      method,
+      locale: new Headers(options.headers).get("Accept-Language") ?? document.documentElement.lang,
+      ...(options.body ? { body: JSON.parse(options.body) } : {}),
+    },
+  });
+  if (result.isError) throw new Error(result.content?.find(item => item.type === "text")?.text ?? "MineCodex request failed");
+  const { status, body } = result.structuredContent;
+  return new Response(JSON.stringify(body), { status, headers: { "Content-Type": "application/json" } });
+}

package/assets/brand/minecodex-icon-selected.svg

@@ -0,0 +1,4 @@
+<!-- Generated by scripts/build-brand-icons.mjs from assets/brand/minecodex-icon.svg. -->
+<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24"><defs><mask id="pickaxe-cutout" maskUnits="userSpaceOnUse" x="0" y="0" width="24" height="24" style="mask-type:luminance"><rect width="24" height="24" fill="white"/><g id="pickaxe" transform="translate(6.24 6.24) scale(.48)" fill="black">
+    <path d="M15.686 4.314 16.3 3.7a1 1 0 0 1 1.4 0l2.6 2.6a1 1 0 0 1 0 1.4l-.614.614a12.501 12.501 0 0 1 1.356 10.225 1 1 0 0 1-1.751-.119 22 22 0 0 0-3.393-6.319l-.198.199a1 1 0 0 1-1.4 0l-.219.169L6.619 20.38a1 1 0 1 1-3-3l7.912-7.912.169.232a1 1 0 0 1 0-1.4l.198-.197A22 22 0 0 0 5.58 4.71a1 1 0 0 1-.119-1.752 12.5 12.5 0 0 1 10.225 1.356Z"/>
+  </g></mask></defs><path fill="currentColor" mask="url(#pickaxe-cutout)" d="M9.3316 2.03768C11.1644 1.54688 13.0268 2.04668 14.356 3.20174C16.0859 2.86512 17.9511 3.36418 19.2935 4.70663C20.6356 6.04882 21.1326 7.91288 20.7964 9.64217C21.9527 10.9716 22.4534 12.8349 21.9625 14.6685C21.4711 16.5025 20.1051 17.8657 18.439 18.439C17.8658 20.1047 16.503 21.47 14.6695 21.9615C12.8356 22.4528 10.9727 21.9519 9.64312 20.7955C7.91371 21.1319 6.04993 20.635 4.70757 19.2926C3.36558 17.9505 2.86659 16.0866 3.20269 14.357C2.04693 13.0273 1.54757 11.1638 2.03863 9.33065C2.52997 7.49759 3.89436 6.13282 5.56011 5.55917C6.13382 3.8935 7.49837 2.52891 9.3316 2.03768Z"/></svg>

package/features/notes/assets/icons/prompt-entry-selected.svg

@@ -0,0 +1 @@
+<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>

package/features/notes/assets/icons/prompt-entry.svg

@@ -0,0 +1,16 @@
+<!-- @license lucide-static v0.577.0 - ISC -->
+<svg
+  class="lucide lucide-book-open"
+  xmlns="http://www.w3.org/2000/svg"
+  width="20"
+  height="20"
+  viewBox="-1.5 -1.5 27 27"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="1.8"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M12 7v14" />
+  <path d="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" />
+</svg>

package/features/notes/codex-feature.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "notes",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "label": {
     "en": "Prompt Library",
     "zh-CN": "提示词库"
@@ -19,7 +19,8 @@
       "icons": "src/frontend/icons.json",
       "styles": "src/frontend/styles.css",
       "previews": "assets/prompt-previews.json"
-    }
+    },
+    "sourceFactory": "src/injection-source.mjs"
   },
   "placement": {
     "order": 20

package/features/notes/src/adapters/codex/insertion.mjs

@@ -0,0 +1,92 @@
+// 请求只到达发起 App 所在窗口，不经共享服务队列寻找任意聚焦窗口。
+export function installPromptInsertion(signal, {codex, api, insertText}) {
+  const navigation = codex.navigation();
+  let remembered = null, busy = false;
+  function remember(composer) {
+    const location = navigation?.location();
+    if (!location || location.path.startsWith('/mcp-app/') || !composer) return;
+    remembered = {location, editable:composer.editable, threadId:composer.threadId,
+      placement:composer.root.getAttribute('data-composer-placement')};
+  }
+  function available() {
+    const target = remembered?.editable;
+    return codex.composer(target ?? null, {purpose:'insertion'});
+  }
+  function waitForComposer(valid, original, deadline) {
+    return new Promise((resolve,reject) => {
+      let observer, timer;
+      const finish = (error, value) => {observer?.disconnect();clearTimeout(timer);error ? reject(error) : resolve(value);};
+      const check = () => {
+        if (!valid()) return finish(new Error('Input changed before insertion'));
+        const candidates = [...document.querySelectorAll('[contenteditable="true"]')]
+          .map(editable => codex.composer(editable,{purpose:'insertion'}))
+          .filter(composer => composer && composer.threadId === original.threadId
+            && composer.root.getAttribute('data-composer-placement') === original.placement);
+        if (candidates.length > 1) return finish(new Error('Input changed before insertion'));
+        if (candidates.length === 1) finish(null,candidates[0]);
+      };
+      observer = new MutationObserver(check);
+      observer.observe(document.documentElement,{childList:true,subtree:true,attributes:true,attributeFilter:['hidden','inert','aria-hidden']});
+      timer = setTimeout(() => finish(new Error('No available input in the focused window')),Math.max(0,Math.min(2000,deadline-Date.now())));
+      check();
+    });
+  }
+  async function receive(event) {
+    if (event.data?.type !== 'minecodex:insert-prompt' || typeof event.data.promptId !== 'string') return;
+    const port = event.ports?.[0];
+    const source = codex.mcpAppSource(event.source,{server:'minecodex',pluginId:'minecodex@minecodex-local',resourceUri:'ui://minecodex/prompts.html'});
+    if (!source || !port) return;
+    if (busy || !document.hasFocus()) {port.postMessage({error:'Input changed before insertion'});port.close();return;}
+    busy = true;
+    const deadline = Math.min(Date.now() + 4000, event.data.expiresAt ?? Infinity);
+    let cancelled = false, navigating = false, restoring = false, expected = navigation?.location(), inserted = false;
+    const target = available();
+    const original = target ? {editable:target.editable,threadId:target.threadId,placement:target.root.getAttribute('data-composer-placement')} : remembered;
+    const onBlur = () => {queueMicrotask(() => {if (!document.hasFocus()) cancelled = true;});};
+    const onFocus = event => {
+      const editable = event.target.closest?.('[contenteditable="true"]');
+      if (editable && editable !== original?.editable) {
+        const focused = codex.composer(editable,{purpose:'insertion'});
+        if (!restoring || navigation.location().path !== remembered?.location.path
+          || focused?.threadId !== original?.threadId
+          || focused?.root.getAttribute('data-composer-placement') !== original?.placement) cancelled = true;
+      }
+    };
+    window.addEventListener('blur',onBlur);
+    document.addEventListener('focusin',onFocus);
+    const unsubscribe = navigation?.subscribe(location => {
+      if (navigating && location.path === remembered?.location.path) {expected = location;navigating = false;}
+      else if (location.key !== expected?.key) cancelled = true;
+    });
+    const valid = () => !cancelled && !signal.aborted && Date.now() < deadline && document.hasFocus();
+    try {
+      const state = await api('/api/state');
+      const prompt = state.prompts.find(item => item.id === event.data.promptId);
+      if (!prompt) throw new Error('Prompt was not found');
+      if (!valid() || !source.connected()) throw new Error('Input changed before insertion');
+      let composer = target && codex.composer(target.editable,{purpose:'insertion'});
+      if (target && !composer) throw new Error('Input changed before insertion');
+      if (!composer) {
+        if (!original || !remembered || !navigation) throw new Error('No available input in the focused window');
+        navigating = restoring = true;
+        let timer;
+        try {await Promise.race([navigation.navigate(remembered.location.path),new Promise((_,reject) => {
+          timer = setTimeout(() => {cancelled = true;reject(new Error('No available input in the focused window'));},2000);
+        })]);} finally {clearTimeout(timer);}
+        composer = await waitForComposer(valid,original,deadline);
+      }
+      if (!valid() || composer.threadId !== original?.threadId
+        || composer.root.getAttribute('data-composer-placement') !== original?.placement
+        || (!navigating && navigation && navigation.location().key !== expected?.key)) throw new Error('Input changed before insertion');
+      // 校验与同步填入之间不再等待；成功后计数失败不报告为可重试的插入失败。
+      insertText(prompt.body,composer.editable);
+      inserted = true;
+      port.postMessage({ok:true});
+      try {await api(`/api/prompts/${encodeURIComponent(prompt.id)}/use`,{method:'POST',body:{action:'insert',success:true}});}
+      catch (error) {console.warn('[Prompts] Usage could not be saved',error);}
+    } catch (error) {if (!inserted) port.postMessage({error:error.message});}
+    finally {unsubscribe?.();window.removeEventListener('blur',onBlur);document.removeEventListener('focusin',onFocus);port.close();busy=false;}
+  }
+  window.addEventListener('message',receive,{signal});
+  return {remember};
+}

package/features/notes/src/adapters/codex/requests.mjs

@@ -0,0 +1,7 @@
+export function assertPromptsRequest(route, method = 'GET') {
+  const allowed = (route === '/api/state' && method === 'GET')
+    || (['/api/prompts', '/api/categories', '/api/reorder'].includes(route) && method === 'POST')
+    || (/^\/api\/(prompts|categories)\/[a-zA-Z0-9-]+$/.test(route) && ['PATCH','DELETE'].includes(method))
+    || (/^\/api\/prompts\/[a-zA-Z0-9-]+\/use$/.test(route) && method === 'POST');
+  if (!allowed) throw new Error('Unsupported Prompts operation');
+}

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')}`;
+}