minecodex 2.0.39 → 2.0.41

package/features/mermaid-diagrams/vendor/lucide-LICENSE

@@ -0,0 +1,43 @@
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/features/quick-chat/src/adapters/codex/shortcut.mjs

@@ -25,6 +25,7 @@ export function quickChatLifecycleExports(source) {
 }
 
 export function installQuickChatShortcut(signal, codex, discover = null) {
+  const windows = navigator.platform.startsWith('Win');
   let bindings = null, disposed = false, pendingFocus = null;
   function activateExisting() {
     // 原生恢复按钮同时恢复 presentation、取消最小化并聚焦输入框。
@@ -97,8 +98,9 @@ export function installQuickChatShortcut(signal, codex, discover = null) {
     codex.report('quick-chat-shortcut', true);
   }).catch(() => { if (!disposed && !signal.aborted) codex.report('quick-chat-shortcut', false, 'native-shortcut-contract-unavailable'); });
   function keydown(event) {
+    const primaryModifier = windows ? event.ctrlKey && !event.metaKey : event.metaKey && !event.ctrlKey;
     if (disposed || signal.aborted || bindings?.native || event.defaultPrevented || event.repeat || event.isComposing
-      || !event.metaKey || !event.altKey || event.ctrlKey || event.shiftKey || event.code !== 'KeyN') return;
+      || !primaryModifier || !event.altKey || event.shiftKey || event.code !== 'KeyN') return;
     const scope = bindings && context();
     if (scope && bindings.isOpen(scope) === false) {
       pendingFocus={scope,previous:new Set([...document.querySelectorAll('[data-floating-chat-surface]')].map(sessionId))};

package/features/session-status/src/adapters/codex/context-usage.mjs

@@ -38,12 +38,17 @@ export function createContextUsageAdapter(signal, codex, onChange, loadFamily =
   }
   async function discover() {
     if (loadFamily) return loadFamily();
-    const url=[...document.querySelectorAll('link[rel=modulepreload]')].map(link=>link.href).find(url=>/\/app-shared-[^/]+\.js(?:$|\?)/.test(url));
-    if (!url) throw new Error("context-bundle-unavailable");
-    const source=await (await fetch(url,{signal})).text();
-    const exported=contextUsageExport(source);
-    if (!exported) throw new Error("context-export-unavailable");
-    return (await import(url))[exported];
+    const urls=[...document.querySelectorAll('link[rel=modulepreload],script[src]')].map(node=>node.href || node.src);
+    const initial=urls.find(url=>/\/app-initial-[^/]+\.js(?:$|\?)/.test(url));
+    const shared=urls.find(url=>/\/app-shared-[^/]+\.js(?:$|\?)/.test(url));
+    if (!initial && !shared) throw new Error("context-bundle-unavailable");
+    // 当前 Codex 将上下文接口放在 app-initial，按实际导出识别。
+    for (const url of [initial,shared].filter(Boolean)) {
+      const source=await (await fetch(url,{signal})).text();
+      const exported=contextUsageExport(source);
+      if (exported) return (await import(url))[exported];
+    }
+    throw new Error("context-export-unavailable");
   }
   void discover().then(value=>{ if (!signal.aborted) { family=value; connect(thread,composer); } })
     .catch(()=>codex.report("context-usage",false,"context-capability-unavailable"));

package/features/sidebar-focus/src/adapters/codex/renderer.mjs

@@ -1,13 +1,18 @@
 export function createFocusAdapter(codex) {
   const sectionSelector="[data-app-action-sidebar-section]", projectSelector="[data-app-action-sidebar-project-row]";
 const props = (element,predicate) => codex.props(element,predicate,30) ?? {};
+const visible = element => element.checkVisibility({visibilityProperty:true});
+function activity() {
+  return [...document.querySelectorAll('#app-shell-sidebar button[aria-pressed]')]
+    .find(element => visible(element) && /activity|活动|动态/i.test(element.getAttribute("aria-label") || ""));
+}
 function branches() {
-  return [...document.querySelectorAll("#app-shell-sidebar " + sectionSelector)].map(element => {
+  return [...document.querySelectorAll("#app-shell-sidebar " + sectionSelector)].filter(visible).map(element => {
     const native = props(element, p => !!p.sectionKey);
     const data = props(element, p => Array.isArray(p.section?.threadKeys)).section;
     return { element, key:"section:" + native.sectionKey, data, expanded:element.dataset.appActionSidebarSectionCollapsed === "false",
       toggle:() => native.onCollapsedChange?.(element.dataset.appActionSidebarSectionCollapsed === "false") };
-  }).concat([...document.querySelectorAll("#app-shell-sidebar " + projectSelector)].map(element => ({
+  }).concat([...document.querySelectorAll("#app-shell-sidebar " + projectSelector)].filter(visible).map(element => ({
     element, key:"project:" + element.dataset.appActionSidebarProjectId,
     data:props(element, p => !!p.group?.projectId).group,
     expanded:element.getAttribute("aria-expanded") === "true",
@@ -15,14 +20,15 @@ function branches() {
   })));
 }
 function target(items) {
-  const selected = document.querySelector('#app-shell-sidebar [data-app-action-sidebar-thread-selected="true"]');
+  // 两种模式的侧栏同时挂载，只在当前分支中读取原生选中身份。
+  const selected = items.map(b => b.element.querySelector?.('[data-app-action-sidebar-thread-selected="true"], [data-sidebar-chatgpt-conversation-key]:has([aria-current="page"])')).find(Boolean);
   const id = codex.currentThreadId();
-  const key = selected?.dataset.appActionSidebarThreadId || (id ? "local:" + id : null);
+  const key = selected?.dataset.appActionSidebarThreadId || selected?.dataset.sidebarChatgptConversationKey || (id ? "local:" + id : null);
   const activeProject = items.map(b => props(b.element, p => p.activeProjectId != null).activeProjectId).find(Boolean);
   const project = items.find(b => b.key.startsWith("project:") && (b.data?.threadKeys?.includes(key) || b.data?.projectId === activeProject));
   const section = items.find(b => b.key.startsWith("section:") && (b.data?.threadKeys?.includes(key) || (activeProject && b.data?.itemKeys?.includes("codex:project:" + activeProject))))
     || items.find(b => b.key.startsWith("section:") && (selected && b.element.contains(selected) || project && b.element.contains(project.element)));
   return section ? { section, project } : null;
 }
-  return {branches,target,isBranchToggle:element=>!!element.closest("[data-app-action-sidebar-section-toggle], " + projectSelector)};
+  return {activity,branches,target,isBranchToggle:element=>!!element.closest("[data-app-action-sidebar-section-toggle], " + projectSelector)};
 }

package/features/sidebar-focus/src/sidebar-focus.mjs

@@ -4,7 +4,7 @@ const EXPAND_GLYPH = "<svg aria-hidden=\"true\"\n  xmlns=\"http://www.w3.org/200
 
 
 const states = new Map();
-let active = false, restoring = false, button, timer = null, disposed = false;
+let active = false, restoring = false, button, currentBell, timer = null, disposed = false;
 const text = (en, cn) => (document.documentElement.lang || navigator.language).startsWith("zh") ? cn : en;
 
 
@@ -15,8 +15,10 @@ function remember(items) {
 function reconcile() {
   if (disposed) return;
   const sidebar = document.querySelector("#app-shell-sidebar");
-  const bell = [...(sidebar?.querySelectorAll("button[aria-pressed]") || [])].find(e => /activity|活动|动态/.test(e.getAttribute("aria-label") || ""));
+  const bell = nativeFocus.activity();
   if (!bell) { button?.remove(); button = null; return; }
+  if (currentBell !== bell) { button?.remove(); button = null; }
+  currentBell = bell;
   if (!button?.isConnected) {
     button = bell.cloneNode(false);
     button.removeAttribute("id");
@@ -93,7 +95,7 @@ const observer = new MutationObserver(records => {
   )) schedule();
 });
 observer.observe(document.documentElement, { subtree:true, childList:true, attributes:true, attributeFilter:[
-  "aria-expanded", "aria-pressed", "data-app-action-sidebar-thread-selected",
+  "aria-expanded", "aria-pressed", "aria-current", "style", "class", "data-app-action-sidebar-thread-selected",
   "data-app-action-sidebar-section-collapsed", "data-above-composer-conversation-id", "lang"
 ] });
 reconcile();

package/features/sites/src/adapters/codex/renderer.mjs

@@ -34,7 +34,7 @@ function pageInfo() {
   const ownershipTabs=[...page.querySelectorAll('[role="tablist"]')].find(node=>!node.closest(`[${owned}]`)&&nativeProps(node,p=>p.tabs?.some(tab=>tab.key==="owned")&&p.tabs?.some(tab=>tab.key==="shared")));
   const ownership=ownershipTabs&&nativeProps(ownershipTabs,p=>p.tabs?.some(tab=>tab.key==="owned")&&p.tabs?.some(tab=>tab.key==="shared"));
   const shared = ownership ? ownership.selectedKey === "shared" : native ? !!native.shared : [...page.querySelectorAll("button[aria-pressed=true]")].some(b => /Shared with you|与你共享|與你共用/.test(b.textContent));
-  const create = [...(plus ? page : page.firstElementChild).querySelectorAll("button")].find(b => visible(b) && (plus ? /^(Create Site|创建站点|建立網站)$/ : /^(New|新建|新增)$/).test(b.textContent.trim()) && !b.hasAttribute(owned));
+  const create = [...(plus ? page : page.firstElementChild).querySelectorAll("button")].find(b => visible(b) && (plus ? /^(Create Site|创建站点|创建新站点|建立網站)$/ : /^(New|新建|新增)$/).test(b.textContent.trim()) && !b.hasAttribute(owned));
   codex.report("sites-page",true);
   return { page, input, content, list, grid, shared, create, plus, ownershipTabs:plus?(ownershipTabs??null):null, accountKey:account.read().key, empty: list ? null : [...content.children].findLast(e => !e.hasAttribute(owned)) };
 }

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

@@ -36,6 +36,7 @@ function setButtonDisabled(button, disabled) {
   button.disabled = disabled; button.setAttribute("aria-disabled", String(disabled)); button.toggleAttribute("data-disabled", disabled);
 }
 function notice(message) {
+  if (disposed || signal.aborted) return;
   document.querySelector(`[${owned}=notice]`)?.remove();
   const n = element("div", "", message); n.setAttribute(owned, "notice"); n.setAttribute("role", "status"); document.body.append(n);
   setTimeout(() => n.remove(), 7000);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "2.0.39",
+  "version": "2.0.41",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -77,16 +77,20 @@
     "packages/plugin/src",
     "packages/plugin/assets",
     "packages/plugin/plugin.json",
-    "features/markdown-reading/vendor/qv/LICENSE",
-    "features/markdown-reading/vendor/qv/provenance.json",
-    "features/markdown-reading/vendor/qv/THIRD_PARTY_NOTICES.txt"
+    "features/mermaid-diagrams/vendor/qv/LICENSE",
+    "features/mermaid-diagrams/vendor/qv/provenance.json",
+    "features/mermaid-diagrams/vendor/qv/THIRD_PARTY_NOTICES.txt",
+    "features/mermaid-diagrams/src",
+    "features/mermaid-diagrams/assets",
+    "features/mermaid-diagrams/codex-feature.json",
+    "features/mermaid-diagrams/vendor/lucide-LICENSE"
   ],
   "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/quick-chat/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": "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/quick-chat/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 features/mermaid-diagrams/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",

package/packages/cli/src/config.mjs

@@ -2,7 +2,7 @@ import { randomBytes } from "node:crypto";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import path from "node:path";
 
-export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images", "hide-upsell-banner", "session-status", "usage-meter", "sidebar-focus", "sites", "markdown-reading", "file-navigation", "quick-chat"]);
+export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images", "hide-upsell-banner", "session-status", "usage-meter", "sidebar-focus", "sites", "markdown-reading", "mermaid-diagrams", "file-navigation", "quick-chat"]);
 export const DEFAULT_CONFIG = Object.freeze({
   schemaVersion: 1,
   features: Object.freeze({
@@ -15,6 +15,7 @@ export const DEFAULT_CONFIG = Object.freeze({
     "sidebar-focus": true,
     sites: true,
     "markdown-reading": true,
+    "mermaid-diagrams": false,
     "file-navigation": true,
     "quick-chat": true,
   }),

package/packages/cli/src/control-server.mjs

@@ -14,7 +14,7 @@ import { createDataTransfer, MAX_TRANSFER_BYTES } from "./data-transfer/service.
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../..");
 const packageMetadata = JSON.parse(await readFile(path.join(packageRoot, "package.json"), "utf8"));
 const MAX_BODY_BYTES = 64 * 1024;
-const DASHBOARD_FEATURE_ORDER = ["model-slider", "notes", "usage-meter", "session-status", "markdown-reading", "file-navigation", "images", "sites", "quick-chat", "sidebar-focus", "hide-upsell-banner"];
+const DASHBOARD_FEATURE_ORDER = ["model-slider", "notes", "usage-meter", "session-status", "markdown-reading", "mermaid-diagrams", "file-navigation", "images", "sites", "quick-chat", "sidebar-focus", "hide-upsell-banner"];
 const CONTENT_TYPES = new Map([
   [".css", "text/css; charset=utf-8"],
   [".html", "text/html; charset=utf-8"],

package/packages/cli/src/paths.mjs

@@ -25,9 +25,10 @@ export function resolvePaths({ homeDir = os.homedir(), platform = process.platfo
       supportDir,
       logsDir,
       serviceDir,
-      // Windows 无 .app 服务包；服务入口是计划任务拉起的 cmd 脚本。
+      // Windows 通过隐藏启动器等待 cmd 服务，保留计划任务的退出状态。
       serviceBundleSource: null,
       serviceAppPath: winPath.join(serviceDir, "MineCodexService.cmd"),
+      serviceLauncherPath: winPath.join(serviceDir, "MineCodexService-hidden.vbs"),
       serviceManagerPath: null,
       serviceRuntimeConfigPath: winPath.join(supportDir, "service-runtime.json"),
       configPath: winPath.join(supportDir, "config.json"),

package/packages/cli/src/platform.mjs

@@ -217,6 +217,20 @@ export function buildWindowsServiceCommand({ nodePath, cliPath, paths }) {
   ].join("\r\n");
 }
 
+export function buildWindowsServiceLauncher(paths) {
+  const serviceCmd = String(paths.serviceAppPath).replaceAll('"', '""');
+  return [
+    "Option Explicit",
+    "Dim shell, command, exitCode",
+    'Set shell = CreateObject("WScript.Shell")',
+    "' 隐藏窗口并等待服务退出，向计划任务传递真实退出码。",
+    'command = Chr(34) & shell.ExpandEnvironmentStrings("%ComSpec%") & Chr(34) & " /d /s /c " & Chr(34) & Chr(34) & "' + serviceCmd + '" & Chr(34) & Chr(34)',
+    "exitCode = shell.Run(command, 0, True)",
+    "WScript.Quit exitCode",
+    "",
+  ].join("\r\n");
+}
+
 // cmd 的引号转义是内部双引号翻倍，与 JSON 转义规则不同，不能混用。
 function cmdQuote(value) {
   return '"' + String(value).replaceAll('"', '""') + '"';
@@ -907,6 +921,8 @@ export class WindowsPlatformAdapter {
 
   async writeServiceCommand(paths, content) {
     await this.fileSystem.writeFile(paths.serviceAppPath, content, { mode: 0o700 });
+    // WSH 用 UTF-16 BOM 识别中文路径，避免依赖系统 ANSI 代码页。
+    await this.fileSystem.writeFile(paths.serviceLauncherPath, Buffer.from("\uFEFF" + buildWindowsServiceLauncher(paths), "utf16le"), { mode: 0o700 });
   }
 
   async snapshotServiceState(paths) {
@@ -956,8 +972,9 @@ export class WindowsPlatformAdapter {
   async registerServiceTask(paths) {
     // ExecutionTimeLimit 0 表示不限时：服务是常驻进程，不能被默认 72h 限制回收。
     const script = [
-      "$serviceCmd = '" + String(paths.serviceAppPath).replaceAll("'", "''") + "';",
-      '$action = New-ScheduledTaskAction -Execute \'cmd.exe\' -Argument (\'/c ""\' + $serviceCmd + \'""\');',
+      "$launcher = '" + String(paths.serviceLauncherPath).replaceAll("'", "''") + "';",
+      "$serviceDir = '" + String(paths.serviceDir).replaceAll("'", "''") + "';",
+      '$action = New-ScheduledTaskAction -Execute (Join-Path $env:SystemRoot \'System32\\wscript.exe\') -Argument (\'//B //Nologo "\' + $launcher + \'"\') -WorkingDirectory $serviceDir;',
       "$trigger = New-ScheduledTaskTrigger -AtLogOn;",
       "$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable -ExecutionTimeLimit ([TimeSpan]::Zero) -RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1);",
       "Register-ScheduledTask -TaskName '" + WINDOWS_SERVICE_TASK_NAME + "' -Action $action -Trigger $trigger -Settings $settings -Force | Out-Null;",
@@ -1179,18 +1196,32 @@ export class WindowsPlatformAdapter {
 
   async openNativeCodex({ cdpPort } = {}) {
     const installation = await this.codex();
-    if (!Number.isInteger(cdpPort) || cdpPort <= 0 || cdpPort > 65_535) {
-      await this.powershell("Start-Process -FilePath '" + String(installation.executable).replaceAll("'", "''") + "'");
-      return null;
-    }
-    const existingPids = new Set((await this.listCodexProcesses()).map(({ pid }) => pid));
-    const safeExecutable = String(installation.executable).replaceAll("'", "''");
+    const withCdp = Number.isInteger(cdpPort) && cdpPort > 0 && cdpPort <= 65_535;
+    const existingPids = new Set(withCdp ? (await this.listCodexProcesses()).map(({ pid }) => pid) : []);
+    const appId = `${installation.packageFamilyName}!App`.replaceAll("'", "''");
+    const args = withCdp
+      ? `--remote-debugging-address=127.0.0.1 --remote-debugging-port=${cdpPort} --remote-allow-origins=http://127.0.0.1:${cdpPort}`
+      : "";
+    // 通过已注册应用入口激活，保留任务栏身份及扩展所需参数。
     await this.powershell([
-      "Start-Process -FilePath '" + safeExecutable + "' -ArgumentList @(",
-      "  '--remote-debugging-address=127.0.0.1',",
-      "  '--remote-debugging-port=" + cdpPort + "',",
-      "  '--remote-allow-origins=http://127.0.0.1:" + cdpPort + "');",
+      "Add-Type -TypeDefinition @'",
+      "using System;",
+      "using System.Runtime.InteropServices;",
+      "public static class MineCodexRegisteredLaunch {",
+      "  [ComImport, Guid(\"2E941141-7F97-4756-BA1D-9DECDE894A3D\"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]",
+      "  interface Activation {",
+      "    [PreserveSig] int ActivateApplication([MarshalAs(UnmanagedType.LPWStr)] string id, [MarshalAs(UnmanagedType.LPWStr)] string args, uint options, out uint pid);",
+      "  }",
+      "  public static uint Launch(string id, string args) {",
+      "    object manager = Activator.CreateInstance(Type.GetTypeFromCLSID(new Guid(\"45BA127D-10A8-46EA-8AB7-56EA9078943C\")));",
+      "    try { uint pid; Marshal.ThrowExceptionForHR(((Activation)manager).ActivateApplication(id, args, 0, out pid)); return pid; }",
+      "    finally { Marshal.ReleaseComObject(manager); }",
+      "  }",
+      "}",
+      "'@",
+      `[MineCodexRegisteredLaunch]::Launch('${appId}', '${args}') | Out-Null`,
     ].join("\n"));
+    if (!withCdp) return null;
     return this.waitForNativeCodex({ cdpPort, excludedPids: existingPids });
   }
 

package/packages/codex-adapter/src/markdown/block-actions.mjs

@@ -0,0 +1,107 @@
+import { loadNativeMarkdownRenderer } from './markdown-native.mjs';
+
+export function markdownExportAlias(source, name) {
+  const start = source.lastIndexOf('export{');
+  if (start < 0) return undefined;
+  const entries = source.slice(start + 7).split('}')[0].split(',');
+  for (const entry of entries) {
+    const [local, alias = local] = entry.trim().split(/\s+as\s+/);
+    if (local === name) return alias;
+  }
+  return undefined;
+}
+
+// 从 Chat Markdown 的公开组件发现悬浮操作栏和控件，不绑定构建 hash。
+export async function loadNativeMarkdownTableActions(native) {
+  const url = [...document.querySelectorAll('link[rel="modulepreload"],script[src]')]
+    .map((n) => n.href || n.src)
+    .find((url) => /\/app-initial-[^/]+\.js/.test(url));
+  const response = await fetch(url);
+  if (!response.ok) throw new Error('native-table-actions-source-unavailable');
+  const source = await response.text();
+  const section = (marker) => {
+    const at = source.indexOf(marker),
+      start = source.lastIndexOf('function ', at),
+      end = source.indexOf('function ', at);
+    if (at < 0 || start < 0 || end < 0) throw new Error('native-table-actions-contract-changed');
+    return source.slice(start, end);
+  };
+  const actions = section('"data-block-actions":!0'),
+    table = section('id:`markdown.expandTable`');
+  const exported = source.slice(source.lastIndexOf('export{'));
+  const module = await import(url);
+  const publicBinding = (name) => {
+    const alias = markdownExportAlias(exported, name);
+    if (!alias || !module[alias]) throw new Error('native-table-actions-export-unavailable');
+    return module[alias];
+  };
+  // 初始化原生 lazy module，再使用其公开 React 组件。
+  const initializer = source
+    .slice(source.indexOf(table) + table.length)
+    .match(/^function ([\w$]+)\(\)\{return\(\1=/)?.[1];
+  if (!initializer) throw new Error('native-table-actions-initializer-unavailable');
+  publicBinding(initializer)();
+  const imports = new Map();
+  for (const match of source.matchAll(/import\{([^}]+)\}from["']([^"']+)["']/g))
+    for (const entry of match[1].split(',')) {
+      const parts = entry.trim().split(/\s+as\s+/);
+      imports.set(parts.at(-1), { name: parts[0], url: new URL(match[2], url).href });
+    }
+  const binding = async (name) => {
+    const item = imports.get(name);
+    if (!item) throw new Error('native-table-actions-dependency-unavailable');
+    return (await import(item.url))[item.name];
+  };
+  const sharedUrl = [...imports.values()].find((item) => /\/app-shared-[^/]+\.js/.test(item.url))?.url;
+  if (!sharedUrl) throw new Error('native-code-wrap-module-unavailable');
+  const sharedSource = await (await fetch(sharedUrl)).text(),
+    shared = await import(sharedUrl);
+  const wrapAt = sharedSource.indexOf('id:`codeSnippet.wrap.disable`');
+  const wrapSection = sharedSource.slice(
+    sharedSource.lastIndexOf('function ', wrapAt),
+    sharedSource.indexOf('function ', wrapAt),
+  );
+  const wrapPair = wrapSection.match(
+    /children:[\w$]+\?\(0,[\w$]+\.jsx\)\(([\w$]+),\{\}\):\(0,[\w$]+\.jsx\)\(([\w$]+),\{\}\)/,
+  );
+  if (wrapAt < 0 || !wrapPair) throw new Error('native-code-wrap-icons-unavailable');
+  const sharedExports = sharedSource.slice(sharedSource.lastIndexOf('export{'));
+  const sharedBinding = (name) => shared[markdownExportAlias(sharedExports, name)];
+  const assignment = sharedSource.indexOf(`${wrapPair[1]}=`);
+  const initialize = sharedSource
+    .slice(sharedSource.lastIndexOf('function ', assignment))
+    .match(/^function ([\w$]+)\(\)/)?.[1];
+  if (initialize && typeof sharedBinding(initialize) === 'function') sharedBinding(initialize)();
+  const wrapIcons = { disable: sharedBinding(wrapPair[1]), enable: sharedBinding(wrapPair[2]) };
+  if (!wrapIcons.disable || !wrapIcons.enable) throw new Error('native-code-wrap-icon-exports-unavailable');
+  const button = table.match(/jsx\)\(([\w$]+),\{"aria-label":[\w$]+,"aria-expanded"/)?.[1];
+  const copy = table.match(/jsx\)\(([\w$]+),\{ariaLabel:[\w$]+,buttonText:/)?.[1];
+  const tooltip = table.match(/jsx\)\(([\w$]+),\{tooltipContent:[\w$]+,delayOpen:!0/)?.[1];
+  if (!button || !copy || !tooltip) throw new Error('native-table-actions-controls-unavailable');
+  const [Button, CopyButton, Tooltip] = await Promise.all([binding(button), binding(copy), binding(tooltip)]);
+  const previewName = table.match(/jsx\)\(([\w$]+),\{src:``,alt:/)?.[1];
+  const tableName = table.match(/jsx\)\(([\w$]+),\{className:[\w$]+,children:[\w$]+\}/)?.[1];
+  const classesName = table.match(/([\w$]+)\.MarkdownTablePreview/)?.[1];
+  const icon = table.match(/children:\(0,[\w$]+\.jsx\)\(([\w$]+),\{icon:\{16:([\w$]+),20:([\w$]+)\}\}\)/);
+  if (!previewName || !tableName || !classesName || !icon)
+    throw new Error('native-table-preview-contract-unavailable');
+  const [Icon, small, medium, renderer] = await Promise.all([
+    binding(icon[1]),
+    binding(icon[2]),
+    binding(icon[3]),
+    loadNativeMarkdownRenderer(source, url, module),
+  ]);
+  return {
+    ...native,
+    ...renderer,
+    TablePreview: publicBinding(previewName),
+    Table: publicBinding(tableName),
+    tableClasses: publicBinding(classesName),
+    ExpandIcon: () => native.React.createElement(Icon, { icon: { 16: small, 20: medium } }),
+    Actions: publicBinding(actions.match(/^function ([\w$]+)/)[1]),
+    Button,
+    wrapIcons,
+    CopyButton,
+    Tooltip,
+  };
+}

package/packages/codex-adapter/src/markdown/editor-api.mjs

@@ -0,0 +1,26 @@
+// 使用当前编辑器所属的原生 CodeMirror 实例，避免引入第二套编辑器依赖。
+export async function loadMarkdownListAPI(view) {
+  const links = [...document.querySelectorAll('link[rel="modulepreload"]')];
+  for (const link of links) {
+    if (!/\/dist-[\w-]+\.js$/.test(link.href)) continue;
+    const exports = Object.values(await import(link.href));
+    if (!exports.includes(view.constructor)) continue;
+    const Decoration = exports.find((value) => value?.line && value?.replace && value?.mark);
+    const ViewPlugin = exports.find((value) => value?.fromClass && value?.define);
+    const StateEffect = exports.find((value) => value?.appendConfig && value?.reconfigure);
+    const Compartment = exports.find(
+      (value) => value?.prototype?.reconfigure && value?.prototype?.of && value?.prototype?.get,
+    );
+    const WidgetType = exports.find(
+      (value) => value?.prototype?.eq && value?.prototype?.ignoreEvent && value?.prototype?.updateDOM,
+    );
+    const StateField = exports.find(
+      (value) =>
+        value?.define && value?.prototype?.slot && value?.prototype?.init && value?.prototype?.create,
+    );
+    const Prec = exports.find((value) => value?.highest && value?.lowest && value?.high);
+    if (Decoration && ViewPlugin && StateEffect && Compartment && WidgetType && Prec && StateField)
+      return { Decoration, ViewPlugin, StateEffect, Compartment, WidgetType, Prec, StateField };
+  }
+  throw new Error('native-markdown-list-api-unavailable');
+}

package/{features/markdown-reading/src/adapters/codex → packages/codex-adapter/src/markdown}/markdown-native.mjs

@@ -13,16 +13,19 @@ export async function loadNativeMarkdownRenderer(source, url, module) {
   ].find((m) => m[2].includes(`${init}()`) && binding(m[1]));
   if (!initializer || !binding(markdownName)) throw new Error('native-rich-markdown-contract-unavailable');
   binding(initializer[1])();
-  let lexer, sharedUrl;
   const lexerName = source.match(/tokens:([\w$]+)\(e,void 0\)/)?.[1];
-  for (const m of source.matchAll(/import\{([^}]+)\}from["']([^"']+)["']/g))
+  let lexer = lexerName ? binding(lexerName) : undefined, sharedUrl;
+  // lexer 可在入口模块本地导出；代码组件仍从独立的共享模块加载。
+  for (const m of source.matchAll(/import\{([^}]+)\}from["']([^"']+)["']/g)) {
+    const importUrl = new URL(m[2], url).href;
+    if (/\/app-shared-[^/]+\.(?:js|mjs)$/.test(importUrl)) sharedUrl = importUrl;
     for (const entry of m[1].split(',')) {
       const parts = entry.trim().split(/\s+as\s+/);
       if (parts.at(-1) === lexerName) {
-        sharedUrl = new URL(m[2], url).href;
-        lexer = (await import(sharedUrl))[parts[0]];
+        lexer = (await import(importUrl))[parts[0]];
       }
     }
+  }
   if (!sharedUrl || typeof lexer !== 'function') throw new Error('native-markdown-lexer-unavailable');
   return { Markdown: binding(markdownName), lexer, sharedUrl };
 }

package/{features/markdown-reading/src/adapters/codex → packages/codex-adapter/src/markdown}/preview.mjs

@@ -1,8 +1,5 @@
-import { createMarkdownReadingRuntime } from './reading-runtime.mjs';
-
 // 当前原生 Markdown Preview 是 CodeMirror 视图；Source 与 Pages 不属于此契约。
-export function createMarkdownPreviewAdapter(codex, resources) {
-  let runtime;
+export function createMarkdownPreviewAdapter(codex, attach) {
   function preview(editor) {
     if (!editor.isConnected || !editor.closest('[data-editor-search-surface]')) return null;
     const content = editor.querySelector('.cm-content[data-language="markdown"]');
@@ -30,9 +27,6 @@ export function createMarkdownPreviewAdapter(codex, resources) {
   return {
     preview,
     previews,
-    attach(item) {
-      runtime ??= createMarkdownReadingRuntime(codex, undefined, resources);
-      return runtime.attach(item);
-    },
+    attach(item) { return attach(item); },
   };
 }

package/{features/markdown-reading/src/adapters/codex → packages/codex-adapter/src/markdown}/toc-native.mjs

@@ -69,7 +69,7 @@ export async function loadNativeMarkdownToc() {
   )?.[1];
   const Tooltip = await binding(tooltipLocal);
   const layoutUrl = [...imports.values()].find((item) =>
-    item.url.includes('/floating-navigation-rail-layout-'),
+    /\/floating-navigation-rail-(?:layout-)?[\w-]+\.js(?:$|\?)/.test(item.url),
   )?.url;
   if (!layoutUrl) throw new Error('native-page-toc-layout-unavailable');
   const layout = await import(layoutUrl);
@@ -84,7 +84,7 @@ export async function loadNativeMarkdownToc() {
       mainImports.set(parts.at(-1), { name: parts[0], url: new URL(match[2], mainUrl).href });
     }
   const ReactDOM = (await binding(rootFactory, mainImports))();
-  const css = initial.match(/["']\.\/((?:floating-navigation-rail-layout)-[\w-]+\.css)["']/)?.[1];
+  const css = initial.match(/["']\.\/((?:floating-navigation-rail(?:-layout)?)-[\w-]+\.css)["']/)?.[1];
   if (!css) throw new Error('native-page-toc-styles-unavailable');
   const cssUrl = new URL(css, initialUrl).href;
   if (![...document.querySelectorAll('link[rel="stylesheet"]')].some((n) => n.href === cssUrl)) {
@@ -114,9 +114,10 @@ export async function loadNativeMarkdownToc() {
   const classes = {
     rail: requireClass(railBody, /ref:[\w$]+,className:`([^`]+)`,"data-floating-navigation-rail-list"/),
     railButton: requireClass(railBody, /className:`([^`]+)`,"aria-current"/),
-    menu: requireClass(listBody, /ref:[\w$]+,className:`([^`]+)`,children:/),
+    menu: requireClass(listBody, /ref:[\w$]+,className:`([^`]+)`,(?:variant:`viewer`,)?children:/),
     menuButton: requireClass(listBody, /className:[\w$]+\(`([^`]+)`/),
-    nav: requireClass(source, /className:`(absolute top-1\/2 left-1\.5[^`]+)`/),
+    // 按 TOC 调用角色找导航样式，避免绑定随布局变化的 top utility。
+    nav: requireClass(bodyMatching(/skipDelayKey:`page-table-of-contents`/), /jsx\)\(`nav`,\{"aria-label":[\w$]+,className:`([^`]+)`/),
   };
   const indentName = listBody.match(/`block`,([\w$]+)\[e\.level\]/)?.[1];
   const indentValue = indentName && source.match(new RegExp(`\\b${indentName}=(\\[[^\\]]+\\])`))?.[1];