minecodex 2.0.40 → 2.0.41

package/README.md

@@ -35,7 +35,9 @@ mcx open
 
 安装后重启 Codex 即可使用。在控制台按需开关功能，修改后运行 `mcx restart` 应用设置。
 
-如需在 Codex 内打开控制台和 Prompt 页面，先安装 [Codex CLI](https://developers.openai.com/codex/cli/)，再运行 `mcx plugin install`，从 Explore／探索中打开。
+如需在 Codex 内打开控制台和 Prompt 页面，先安装 [Codex CLI](https://developers.openai.com/codex/cli/)，再运行 `mcx plugin install`。这一步独立于后台增强安装；更换全局包或源码安装位置后，再运行一次以更新插件路径。
+
+注册后，在 Codex 的插件页点击刷新，再从 Explore／探索找到 MineCodex 和 Prompt。需要常驻 Navbar 时，分别点击它们旁边的“固定到侧边栏”。插件已安装、页面入口已发现、入口已固定是不同状态；未固定的入口不会常驻 Navbar。此路径已在 Codex 26.1013.4894.0 的 Windows 简体中文窗口验证。
 
 ## 常用命令
 

package/features/hide-upsell-banner/src/hide-upsell-banner.mjs

@@ -13,6 +13,8 @@ let disposed = false;
 
 function isUpsellBanner(element) {
   if (!(element instanceof window.HTMLElement)) return false;
+  // 文件侧栏也是 aside，正文中的用量说明不能使整个预览被隐藏。
+  if (element.querySelector("[role='tabpanel']")) return false;
   const text = (element.textContent ?? "").trim();
   if (!text) return false;
   const title = (

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.40",
+  "version": "2.0.41",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",

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/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/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];