minecodex 2.0.40 → 2.0.42

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/apps/dashboard/assets/preview-content.js

@@ -27,9 +27,12 @@ const content = {
   sites: [
     ['Codex 中的 Sites 页面。', '本地项目与常用网址分散在不同位置。', '收藏网址、发现正在运行的本地站点，并从 Sites 打开。'],
     ['The Sites page in Codex.', 'Local projects and saved links are scattered.', 'Save URLs, discover running local sites, and open them from Sites.']],
+  'composer-expand': [
+    ['Work 与 Codex 的输入框右上角。', '长指令受输入框高度限制，编辑时需要反复滚动。', '输入多行文字后点击展开；编辑完成后收起，草稿保持不变。'],
+    ['The upper-right corner of the Work and Codex composer.', 'Long drafts need repeated scrolling in a compact editor.', 'Enter a multiline draft and click Expand. Collapse when finished; your draft stays in place.']],
   'quick-chat': [
-    ['Codex 的浮动 Quick Chat 窗口。', '临时提问时需要切换主窗口，历史不易继续。', '通过快捷键打开 Quick Chat，发送后展开，恢复最小化输入框并固定聊天。'],
-    ['The floating Quick Chat window.', 'Quick questions and continuing recent chats require window switching.', 'Open Quick Chat with a shortcut, expand after sending, restore a minimized composer and pin the chat.']],
+    ['Codex 的浮动 Quick Chat 窗口。', '临时提问时需要切换主窗口，历史不易继续。', '从侧栏或快捷键打开 Quick Chat，发送后展开，恢复最小化输入框并查看历史。'],
+    ['The floating Quick Chat window.', 'Quick questions and continuing recent chats require window switching.', 'Open Quick Chat from the sidebar or shortcut, expand after sending, restore a minimized composer and browse history.']],
   'sidebar-focus': [
     ['Codex 左侧栏的分组标题。', '多个侧栏分组展开时，当前分组不容易聚焦。', '点击当前分组，一键收起其他分组；再次点击恢复先前的展开状态。'],
     ['Group headings in the Codex sidebar.', 'Several expanded groups make the current group harder to focus on.', 'Click a group to collapse other groups. Click again to restore their previous expanded state.']],

package/features/composer-expand/assets/maximize-2.svg

@@ -0,0 +1,16 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M15 3h6v6" />
+  <path d="m21 3-7 7" />
+  <path d="m3 21 7-7" />
+  <path d="M9 21H3v-6" />
+</svg>

package/features/composer-expand/codex-feature.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": 1,
+  "id": "composer-expand",
+  "version": "0.1.0",
+  "label": {
+    "en": "Expand Long Drafts",
+    "zh-CN": "长指令展开编辑"
+  },
+  "description": {
+    "en": "Expand long drafts in Work and Codex with the native editor layout.",
+    "zh-CN": "在 Work 与 Codex 中展开长指令，使用原生大尺寸输入框编辑。"
+  },
+  "entry": {
+    "kind": "page-script",
+    "script": "src/entry.mjs",
+    "sourceFactory": "src/injection-source.mjs"
+  },
+  "icon": {
+    "resource": "assets/maximize-2.svg"
+  },
+  "placement": {
+    "order": 76
+  }
+}

package/features/composer-expand/src/entry.mjs

@@ -0,0 +1 @@
+return installComposerExpand(signal,config);

package/features/composer-expand/src/injection-source.mjs

@@ -0,0 +1,7 @@
+import {readFile} from 'node:fs/promises';
+import {loadComposerExpandControls,createComposerExpandAdapter} from './native.mjs';
+import {composerCanExpand,installComposerExpand} from './install.mjs';
+export async function createPageScriptSource(){
+  return [loadComposerExpandControls,createComposerExpandAdapter,composerCanExpand,installComposerExpand]
+    .map(fn=>`const ${fn.name}=${fn.toString()};`).join('\n')+'\n'+await readFile(new URL('./entry.mjs',import.meta.url),'utf8');
+}

package/features/composer-expand/src/install.mjs

@@ -0,0 +1,91 @@
+export function composerCanExpand(controller,editor) {
+  const lineHeight=Number.parseFloat(getComputedStyle(editor).lineHeight);
+  return controller.view.state.doc.childCount>1||controller.getText().includes('\n')
+    ||(lineHeight>0&&editor.getBoundingClientRect().height>=lineHeight*5);
+}
+
+export async function installComposerExpand(signal,config,load=loadComposerExpandControls) {
+  const native=createComposerExpandAdapter(config.codex);
+  const mounts=new Map();
+  let disposed=false;
+  const controls=await load(signal);
+  if(signal.aborted)return()=>{};
+  const style=document.createElement('style');
+  style.textContent=`
+    [data-mcx-composer-expand-control]{position:absolute;inset-inline-end:calc(var(--spacing)*2.5);top:calc(var(--spacing)*2.5);z-index:20}
+    [data-mcx-composer-home-balanced]:not(:has([data-expanded-composer])){justify-content:center}
+    [data-mcx-composer-home-bottom]:has([data-expanded-composer]){justify-content:flex-end}
+    [data-mcx-composer-home-balanced]:not(:has([data-expanded-composer])) [data-mcx-composer-home-hero]{flex:0 0 auto;min-block-size:0}
+    [data-mcx-composer-home-balanced]:not(:has([data-expanded-composer])) [data-mcx-composer-home-slot]{flex:0 0 auto;position:static}
+    [data-mcx-composer-home-balanced]:not(:has([data-expanded-composer])) [data-mcx-composer-home-title-spacer]{min-height:0}
+  `;
+  document.head.append(style);
+  function mount(scope) {
+    const {body,editable,controller,home,bottomHome}=scope;
+    function balanceHome(value){
+      if(bottomHome){
+        if(value)bottomHome.setAttribute('data-mcx-composer-home-bottom','');
+        else bottomHome.removeAttribute('data-mcx-composer-home-bottom');
+      }
+      if(!home)return;
+      for(const [element,name]of [[home.layout,'balanced'],[home.hero,'hero'],[home.slot,'slot'],[home.titleSpacer,'title-spacer']]){
+        if(!element)continue;
+        const attribute=`data-mcx-composer-home-${name}`;
+        if(value)element.setAttribute(attribute,'');else element.removeAttribute(attribute);
+      }
+    }
+    let expanded=false,enterBehavior=null,visible=false;
+    const node=document.createElement('span');
+    node.setAttribute('data-mcx-composer-expand-control','');
+    const control=controls.mount(node,toggle);
+    function label(){return (document.documentElement.lang||navigator.language).startsWith('zh')?(expanded?'收起':'展开'):(expanded?'Collapse':'Expand');}
+    function setExpanded(value) {
+      if(expanded===value)return;
+      expanded=value;
+      if(value){enterBehavior=controller.getEnterBehavior();controller.setEnterBehavior('cmdAlways');}
+      else {if(!controller.view.isDestroyed)controller.setEnterBehavior(enterBehavior);enterBehavior=null;}
+      control.render(expanded,label());
+    }
+    function toggle(){setExpanded(!expanded);controller.focus();controller.view.dispatch(controller.view.state.tr.scrollIntoView());}
+    function update(){
+      if(controller.view.isDestroyed)return;
+      const available=body.getAttribute('data-composer-layout')==='multiline'&&composerCanExpand(controller,editable);
+      if(!available)setExpanded(false);
+      if(visible!==available){visible=available;balanceHome(available);if(available)body.append(node);else node.remove();}
+      if(available)control.render(expanded,label());
+    }
+    const resized=new ResizeObserver(update);
+    resized.observe(editable);
+    const unsubscribe=controls.subscribe(controller.view,update);
+    update();
+    return {...scope,update,dispose(){setExpanded(false);balanceHome(false);unsubscribe();resized.disconnect();control.dispose();node.remove();}};
+  }
+  function sync(){
+    if(signal.aborted||disposed)return;
+    const scopes=native.all(),active=new Map(scopes.map(s=>[s.editable,s]));
+    for(const [editable,m] of mounts){
+      const current=active.get(editable);
+      if(!current||current.controller!==m.controller||current.body!==m.body||current.home?.layout!==m.home?.layout||current.bottomHome!==m.bottomHome){m.dispose();mounts.delete(editable);}
+    }
+    for(const scope of scopes){if(!mounts.has(scope.editable))mounts.set(scope.editable,mount(scope));else mounts.get(scope.editable).update();}
+  }
+  let scheduled=false;
+  const observer=new MutationObserver(records=>{
+    const selector='[data-codex-composer-root],[data-chatgpt-composer]';
+    const relevant=records.some(record=>{
+      const target=record.target;
+      if(target.closest?.('[data-mcx-composer-expand-control],[contenteditable="true"]'))return false;
+      if(target.closest?.(selector))return true;
+      if(record.type==='attributes')return Boolean(target.querySelector?.(selector));
+      return [...record.addedNodes??[],...record.removedNodes??[]].some(node=>node.matches?.(selector)||node.querySelector?.(selector));
+    });
+    if(scheduled||!relevant)return;
+    scheduled=true;queueMicrotask(()=>{scheduled=false;sync();});
+  });
+  observer.observe(document.body,{subtree:true,childList:true,attributes:true,attributeFilter:['data-composer-layout','hidden','inert','aria-hidden','class','style']});
+  sync();
+  const unregister=config.registerSelfCheck?.(()=>({state:native.all().length?(mounts.size?'available':'unavailable'):'not-applicable',scopes:native.all().map(scope=>({name:'composer',element:scope.root}))}));
+  function dispose(){if(disposed)return;disposed=true;observer.disconnect();for(const mount of mounts.values())mount.dispose();mounts.clear();style.remove();unregister?.();}
+  signal.addEventListener('abort',dispose,{once:true});
+  return dispose;
+}

package/features/composer-expand/src/native.mjs

@@ -0,0 +1,79 @@
+export async function loadComposerExpandControls(signal) {
+  const urls = [...document.querySelectorAll('link[rel="modulepreload"],script[src]')].map(node => node.href || node.src);
+  const initialUrl = urls.find(url => /\/app-initial-[^/]+\.js/.test(url));
+  const mainUrl = urls.find(url => /\/app-main-[^/]+\.js/.test(url));
+  if (!initialUrl || !mainUrl) throw new Error('composer-expand-modules-unavailable');
+  const read = async url => { const response=await fetch(url,{signal}); if(!response.ok) throw new Error('composer-expand-source-unavailable'); return response.text(); };
+  const [initialSource,mainSource] = await Promise.all([read(initialUrl),read(mainUrl)]);
+  const file = initialSource.match(/["'`]\.\/(app-primary-[\w-]+\.js)["'`]/)?.[1];
+  if (!file) throw new Error('composer-expand-primary-unavailable');
+  const primaryUrl = new URL(file,initialUrl).href;
+  const source = await read(primaryUrl);
+  async function binding(source,url,local) {
+    if (!local) throw new Error('composer-expand-binding-unavailable');
+    const escaped = local.replace(/[.*+?^${}()|[\]\\]/g,'\\$&');
+    const alias = source.slice(source.lastIndexOf('export{')).match(new RegExp(`(?:\\{|,)${escaped} as ([\\w$]+)(?:,|\\})`))?.[1];
+    if (alias) return (await import(url))[alias];
+    for (const match of source.matchAll(/import\{([^}]+)\}from["'`]([^"'`]+)["'`]/g)) {
+      for (const entry of match[1].split(',')) {
+        const parts=entry.trim().split(/\s+as\s+/);
+        if (parts.at(-1)===local) return (await import(new URL(match[2],url).href))[parts[0]];
+      }
+    }
+    throw new Error('composer-expand-binding-unavailable');
+  }
+  // 语义定位原生展开按钮，导入它实际使用的控件和成对图标。
+  const start=source.indexOf('function ',source.lastIndexOf('function ',source.indexOf('data-composer-expand-toggle')));
+  const control=source.slice(start,source.indexOf('var ',start));
+  const button=control.match(/jsx\)\(([\w$]+),\{"aria-label"/ )?.[1];
+  const icons=control.match(/children:[\w$]+\?\(0,[\w$]+\.jsx\)\(([\w$]+),\{\}\):\(0,[\w$]+\.jsx\)\(([\w$]+),\{\}\)/);
+  const reactOwner=initialSource.match(/([\w$]+)\.useRef\b/)?.[1];
+  const reactInit=reactOwner&&initialSource.match(new RegExp(`${reactOwner}=([\\w$]+)\\(\\)`))?.[1];
+  const rootOwner=mainSource.match(/\(0,([\w$]+)\.createRoot\)/)?.[1];
+  const rootInit=rootOwner&&mainSource.match(new RegExp(`${rootOwner}=([\\w$]+)\\(\\)`))?.[1];
+  const transactionObserver=initialSource.match(/function ([\w$]+)\([^)]*\)\{let\{eventTarget:/)?.[1];
+  const [reactFactory,rootFactory,Button,Collapse,Expand,subscribe]=await Promise.all([
+    binding(initialSource,initialUrl,reactInit),binding(mainSource,mainUrl,rootInit),
+    binding(source,primaryUrl,button),binding(source,primaryUrl,icons?.[1]),binding(source,primaryUrl,icons?.[2]),
+    binding(initialSource,initialUrl,transactionObserver),
+  ]);
+  const React=reactFactory(),ReactDOM=rootFactory();
+  return {subscribe:(view,listener)=>subscribe(view,changed=>{if(changed)listener();}),mount(container,onToggle) {
+    const root=ReactDOM.createRoot(container);
+    let previous;
+    return {render(expanded,label) {
+      const key=JSON.stringify([expanded,label]);if(key===previous)return;previous=key;
+      root.render(React.createElement(Button,{'aria-label':label,'aria-pressed':expanded,
+        color:'ghostSecondary',size:'iconCircle','data-composer-expand-toggle':'',
+        'data-expanded-composer':expanded?'':undefined,'data-minecodex-tooltip':label,
+        onPointerDown:event=>event.preventDefault(),onClick:onToggle,
+        children:React.createElement(expanded?Collapse:Expand,{})}));
+    },dispose:()=>root.unmount()};
+  }};
+}
+
+export function createComposerExpandAdapter(codex) {
+  function read(editable) {
+    const root=editable.closest('[data-codex-composer-root],[data-chatgpt-composer]');
+    const body=editable.closest('[data-composer-body]');
+    if (!root||!body||!editable.isConnected||!editable.checkVisibility({visibilityProperty:true})
+      ||editable.closest('[hidden],[inert],[aria-hidden="true"],[data-floating-chat-surface],[data-right-panel-composer-overlay-content]')) return null;
+    const work=codex.props(editable,p=>typeof p.isWorkConversation==='boolean');
+    if (!root.hasAttribute('data-codex-composer-root')&&!work?.isWorkConversation) return null;
+    const controller=codex.props(editable,p=>p.composerController?.view?.dom===editable)?.composerController;
+    if (!controller?.getEnterBehavior||!controller.setEnterBehavior) return null;
+    const layout=root.getAttribute('data-composer-placement')==='home'
+      ?root.closest('[class~="group/home-composer-layout"]'):null;
+    const hero=layout?.querySelector('.home-composer-anchor');
+    const titleSpacer=hero?.querySelector('[class~="min-h-28"]');
+    const slot=hero&&[...hero.parentElement.children].find(node=>node!==hero&&node.contains(root));
+    let bottomSlot=null;
+    for(let node=root.parentElement;layout&&node&&node!==layout;node=node.parentElement){
+      if(node.classList.contains('flex-col')&&node.classList.contains('justify-end')){bottomSlot=node;break;}
+    }
+    return {root,body,editable,controller,
+      home:layout&&hero&&slot?{layout,hero,slot,titleSpacer}:null,
+      bottomHome:layout&&bottomSlot?layout:null};
+  }
+  return {read,all:()=>[...document.querySelectorAll('[contenteditable="true"][data-composer-markdown]')].map(read).filter(Boolean)};
+}

package/features/composer-expand/vendor/lucide-LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) for portions of Lucide are held by Cole Bemis 2013-2022 as part of Feather (MIT). All other copyright (c) for Lucide are held by Lucide Contributors 2022.
+
+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.

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/images/codex-feature.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "images",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "label": {
     "en": "Image Collection",
     "zh-CN": "图片集合"

package/features/images/src/adapters/codex/native-image-modules.mjs

@@ -73,12 +73,18 @@ export function createNativeImageModules({read = async url => (await fetch(url))
       const mainUrl = urls.find(url => /\/app-main-[^/]+\.js/.test(url));
       if (!initialUrl || !mainUrl) throw new Error("Native Images modules are unavailable");
       const [initialSource, mainSource] = await Promise.all([read(initialUrl), read(mainUrl)]);
+      const initial = await load(initialUrl);
       const asset = (name, references = initialSource) => {
         const file = references.match(new RegExp(`(?:["'./])(${name}-[\\w-]+\\.js)`))?.[1];
         if (!file) throw new Error(`Native Images capability is unavailable: ${name}`);
         return new URL(file, initialUrl).href;
       };
       const module = async (name,references) => {
+        // 26.1013 将图库排布与卡片合入入口，其他能力仍按独立模块发现。
+        if (["library-masonry", "library-item-layout"].includes(name)
+          && !new RegExp(`(?:["'./])(${name}-[\\w-]+\\.js)`).test(references ?? initialSource)) {
+          return {url:initialUrl, source:initialSource, exports:initial};
+        }
         const url = asset(name,references);
         const [source, exports] = await Promise.all([read(url), load(url)]);
         // 调用产物公开的惰性初始化器，不扫描或执行任意导出函数。
@@ -94,6 +100,10 @@ export function createNativeImageModules({read = async url => (await fetch(url))
       };
       const binding = async (source, url, local) => {
         if (!local) throw new Error("Native Images component contract changed");
+        const exported = source.slice(source.lastIndexOf("export{"));
+        const escaped = local.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");
+        const alias = exported.match(new RegExp(`(?:\\{|,)${escaped} as ([\\w$]+)(?:,|\\})`))?.[1];
+        if (alias) return (await load(url))[alias];
         const importedBinding = imported(source, local);
         return (await load(new URL(importedBinding.file, url).href))[importedBinding.name];
       };
@@ -106,7 +116,6 @@ export function createNativeImageModules({read = async url => (await fetch(url))
         binding(masonry.source, masonry.url, reactInit), binding(mainSource, mainUrl, rootInit),
       ]);
       const React = reactFactory(), ReactDOM = rootFactory();
-      const initial = await load(initialUrl);
       return {React,ReactDOM,module,component,binding,initialUrl,initialSource,initial};
     })().catch(error=>{starting=null;throw error;});
     return starting;

package/features/quick-chat/codex-feature.json

@@ -1,22 +1,21 @@
 {
   "schemaVersion": 1,
   "id": "quick-chat",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "label": {
     "en": "Enhance Quick Chat",
     "zh-CN": "快捷聊天增强"
   },
   "description": {
-    "en": "Start fresh after closing, restore minimized chats, expand after sending, pin conversations, and repair native exit layers.",
-    "zh-CN": "关闭后开启全新聊天，恢复最小化输入框、发送后展开、固定聊天，并修复退出后的透明遮罩残留。"
+    "en": "Open Quick Chat from the Codex sidebar, restore minimized chats, expand after sending, and browse chat history.",
+    "zh-CN": "从 Codex 侧栏打开快捷聊天，恢复最小化输入框、发送后展开并查看聊天历史。"
   },
   "entry": {
     "kind": "page-script",
     "script": "src/frontend/entry.mjs",
     "sourceFactory": "src/injection-source.mjs",
     "resources": {
-      "history": "assets/history.svg",
-      "pin": "assets/pin.svg"
+      "history": "assets/history.svg"
     }
   },
   "icon": {

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

@@ -25,12 +25,15 @@ export function quickChatLifecycleExports(source) {
 }
 
 export function installQuickChatShortcut(signal, codex, discover = null) {
+  const windows = navigator.platform.startsWith('Win');
   let bindings = null, disposed = false, pendingFocus = null;
+  const floatingAt = element => codex.props(element, p => typeof p.onMinimizedChange === 'function' && typeof p.onPresentationChange === 'function'
+    && (p.unifiedDocking === true || typeof p.dockThreadKey === 'string' && typeof p.renderMenu === 'function'));
   function activateExisting() {
     // 原生恢复按钮同时恢复 presentation、取消最小化并聚焦输入框。
     for (const button of document.querySelectorAll('button')) {
       if (!button.checkVisibility({visibilityProperty:true})) continue;
-      const floating = codex.props(button, p => p.unifiedDocking === true && typeof p.onMinimizedChange === 'function' && typeof p.onPresentationChange === 'function');
+      const floating = floatingAt(button);
       if (!floating?.isMinimized || floating.isHidden) continue;
       const restore = codex.props(button, p => p.uniform === true && p.size === 'composer' && typeof p.onClick === 'function'
         && typeof p.onPointerEnter === 'function' && typeof p.onPointerDown === 'function' && typeof p.onKeyDown === 'function');
@@ -40,7 +43,7 @@ export function installQuickChatShortcut(signal, codex, discover = null) {
     }
     for (const surface of document.querySelectorAll('[data-floating-chat-surface]')) {
       if (surface.closest('[hidden], [inert], [aria-hidden="true"]')) continue;
-      const floating = codex.props(surface, p => p.unifiedDocking === true && typeof p.onMinimizedChange === 'function' && typeof p.onPresentationChange === 'function');
+      const floating = floatingAt(surface);
       if (!floating || floating.isMinimized || floating.isHidden) continue;
       const editable = surface.querySelector('[data-chatgpt-composer] [contenteditable="true"]');
       if (!editable?.checkVisibility({visibilityProperty:true})) continue;
@@ -96,23 +99,28 @@ export function installQuickChatShortcut(signal, codex, discover = null) {
     bindings = value;
     codex.report('quick-chat-shortcut', true);
   }).catch(() => { if (!disposed && !signal.aborted) codex.report('quick-chat-shortcut', false, 'native-shortcut-contract-unavailable'); });
-  function keydown(event) {
-    if (disposed || signal.aborted || bindings?.native || event.defaultPrevented || event.repeat || event.isComposing
-      || !event.metaKey || !event.altKey || event.ctrlKey || event.shiftKey || event.code !== 'KeyN') return;
+  function activate() {
+    if (disposed || signal.aborted || !bindings || bindings.native) return false;
     const scope = bindings && context();
     if (scope && bindings.isOpen(scope) === false) {
       pendingFocus={scope,previous:new Set([...document.querySelectorAll('[data-floating-chat-surface]')].map(sessionId))};
       bindings.create(scope);
       focusNew();
     } else if (!activateExisting()) {
-      if (!scope) return;
+      if (!scope) return false;
       bindings.open(scope);
     }
+    return true;
+  }
+  function keydown(event) {
+    const primaryModifier = windows ? event.ctrlKey && !event.metaKey : event.metaKey && !event.ctrlKey;
+    if (event.defaultPrevented || event.repeat || event.isComposing
+      || !primaryModifier || !event.altKey || event.shiftKey || event.code !== 'KeyN' || !activate()) return;
     event.preventDefault();
     event.stopPropagation();
   }
   document.addEventListener('keydown', keydown, {signal});
   function dispose() { disposed = true; document.removeEventListener('keydown', keydown); bindings = null; pendingFocus=null; }
   signal.addEventListener('abort', dispose, {once:true});
-  return {ready, dispose, sync:focusNew};
+  return {ready, dispose, sync:focusNew, activate, available:() => Boolean(bindings && !bindings.native && !disposed && !signal.aborted)};
 }

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

@@ -0,0 +1,35 @@
+export async function loadQuickChatSidebarIcon(signal) {
+  const urls = [...document.querySelectorAll('link[rel="modulepreload"],script[src]')].map(node => node.href || node.src);
+  const initialUrl = urls.find(url => /\/app-initial-[^/]+\.js/.test(url));
+  if (!initialUrl) throw new Error('quick-chat-icon-module-unavailable');
+  const initial = await (await fetch(initialUrl,{signal})).text();
+  const file = initial.match(/["']\.\/(quick-chat-floating-surface-[\w-]+\.js)["']/)?.[1];
+  if (!file) throw new Error('quick-chat-icon-module-unavailable');
+  const url = new URL(file,initialUrl).href;
+  const source = await (await fetch(url,{signal})).text();
+  // 原生 Restore 在未传 minimizedIcon 时使用的默认聊天图标。
+  const local = source.match(/children:[\w$]+\?\?\(0,[\w$]+\.jsx\)\(([\w$]+),\{\}\)/)?.[1];
+  for (const match of source.matchAll(/import\{([^}]+)\}from["']([^"']+)["']/g))
+    for (const entry of match[1].split(',')) {
+      const parts = entry.trim().split(/\s+as\s+/);
+      if (parts.at(-1) !== local) continue;
+      const icon = (await import(new URL(match[2],url).href))[parts[0]];
+      if (typeof icon?.createElement !== 'function') break;
+      return icon;
+    }
+  throw new Error('quick-chat-icon-contract-unavailable');
+}
+
+export function createQuickChatSidebarAdapter(codex) {
+  return {read() {
+    for (const row of document.querySelectorAll('#app-shell-sidebar button')) {
+      if (!row.checkVisibility({visibilityProperty:true})) continue;
+      const item = codex.props(row, p => p.animatedIcon === 'sidebar-new-chat' && p.excludeFromNavigation === true, 8);
+      const mode = item && codex.props(row, p => typeof p.sidebarMode === 'string', 30)?.sidebarMode;
+      const svg = mode === 'codex' && row.querySelector('svg');
+      const slot = svg && svg.closest('.icon-leading-slot');
+      if (svg && slot && row.parentElement) return {row, container:row.parentElement,svg,slot};
+    }
+    return null;
+  }};
+}

package/features/quick-chat/src/frontend/entry.mjs

@@ -1,7 +1,6 @@
-const exitRepair = installQuickChatExitRepair(signal, createQuickChatExitAdapter(config.codex));
 const native = createQuickChatAdapter(config.codex);
 const shortcut = installQuickChatShortcut(signal, config.codex);
-const pin = installQuickChatPin(signal, config);
+const sidebar = installQuickChatSidebar(signal, config, shortcut);
 const instances = new Map();
 let scheduled = false, disposed = false;
 const text = (en,zh) => (document.documentElement.lang || navigator.language).startsWith('zh') ? zh : en;
@@ -26,7 +25,6 @@ function remove(instance) { releaseBackground(instance); releaseProjectRail(inst
 function sync() {
   if (disposed) return;
   shortcut.sync();
-  pin.sync();
   const snapshots = native.surfaces(), active = new Set();
   for (const snapshot of snapshots) {
     active.add(snapshot.surface);
@@ -95,12 +93,12 @@ observer.observe(document.documentElement,{subtree:true,childList:true,attribute
 sync();
 config.registerSelfCheck?.(() => {
   const snapshots = native.surfaces(), anchors = snapshots.filter(item => item.showHistory);
-  const history = anchors.some(item => instances.get(item.surface)?.button?.isConnected), pinned = pin.status();
-  const applicable = anchors.length > 0 || pinned.applicable;
-  const available = (!anchors.length || history) && (!pinned.applicable || pinned.available);
+  const history = anchors.some(item => instances.get(item.surface)?.button?.isConnected), entry = sidebar.status();
+  const applicable = anchors.length > 0 || entry.applicable;
+  const available = (!anchors.length || history) && (!entry.applicable || entry.available);
   return {state:applicable ? available ? 'available' : 'unavailable' : 'not-applicable',
     reason:applicable ? available ? null : 'quick-chat-controls-unavailable' : 'no-classic-quick-chat-floating-controls',
-    checks:[{name:"native-exit-observer",available:exitRepair.status()}, ...(anchors.length ? [{name:'quick-chat-history',available:history}] : []), ...(pinned.applicable ? [{name:'quick-chat-pin',available:pinned.available}] : [])],
+    checks:[...(anchors.length ? [{name:'quick-chat-history',available:history}] : []), ...(entry.applicable ? [{name:'quick-chat-sidebar-entry',available:entry.available}] : [])],
     scopes:snapshots.map(item=>({name:'quick-chat',element:item.surface}))};
 });
-return () => { disposed = true; exitRepair.dispose(); shortcut.dispose(); pin.dispose(); observer.disconnect(); for (const instance of instances.values()) remove(instance); instances.clear(); style.remove(); };
+return () => { disposed = true; shortcut.dispose(); sidebar.dispose(); observer.disconnect(); for (const instance of instances.values()) remove(instance); instances.clear(); style.remove(); };

package/features/quick-chat/src/frontend/sidebar.mjs

@@ -0,0 +1,63 @@
+export function installQuickChatSidebar(signal, config, action, loadIcon = loadQuickChatSidebarIcon) {
+  const native = createQuickChatSidebarAdapter(config.codex);
+  let mounted = null, disposed = false, scheduled = false, icon = null;
+  const style = document.createElement('style');
+  style.textContent = `
+    [data-mcx-quick-chat-entry-row]{position:relative}
+    [data-mcx-quick-chat-entry-row]:hover>.sidebar-item{background-color:var(--color-background-primary-ghost-hover)}
+    [data-mcx-quick-chat-entry]{position:absolute;inset-inline-end:var(--padding-row-cell-x,var(--padding-row-x));top:50%;transform:translateY(-50%);opacity:0;pointer-events:none}
+    [data-mcx-quick-chat-entry-row]:hover>[data-mcx-quick-chat-entry],
+    [data-mcx-quick-chat-entry-row]:focus-within>[data-mcx-quick-chat-entry]{opacity:1;pointer-events:auto}
+    @media(hover:none){[data-mcx-quick-chat-entry]{opacity:1;pointer-events:auto}}
+  `;
+  document.head.append(style);
+  function release() {
+    mounted?.button.remove();
+    mounted?.container.removeAttribute('data-mcx-quick-chat-entry-row');
+    mounted = null;
+  }
+  function sync() {
+    if (disposed || signal.aborted) return;
+    const entry = native.read();
+    if (!entry || !action.available() || !icon) { release(); return; }
+    if (mounted?.row !== entry.row || !mounted.button.isConnected) {
+      release();
+      const button = document.createElement('button');
+      button.type = 'button';
+      button.setAttribute('data-mcx-quick-chat-entry','');
+      button.className = 'flex size-7 shrink-0 cursor-interaction items-center justify-center rounded-md text-default hover:bg-primary-ghost-hover focus-visible:outline-2 focus-visible:outline-ring';
+      const slot = entry.slot.cloneNode(true);
+      const svg = icon.createElement(document,entry.svg.getAttribute('class'));
+      for (const name of ['width','height']) if (entry.svg.hasAttribute(name)) svg.setAttribute(name,entry.svg.getAttribute(name));
+      slot.querySelector('svg').replaceWith(svg);
+      button.append(slot);
+      button.addEventListener('pointerdown', event => event.stopPropagation(), {signal});
+      button.addEventListener('click', event => { event.preventDefault(); event.stopPropagation(); action.activate(); }, {signal});
+      entry.container.setAttribute('data-mcx-quick-chat-entry-row','');
+      entry.container.append(button);
+      mounted = {...entry, button};
+    }
+    const label = (document.documentElement.lang || navigator.language).startsWith('zh') ? '打开快捷聊天' : 'Open Quick Chat';
+    if (mounted.button.getAttribute('aria-label') !== label) {
+      mounted.button.setAttribute('aria-label',label);
+      mounted.button.setAttribute('data-minecodex-tooltip',label);
+    }
+  }
+  function schedule(records) {
+    if (disposed || scheduled || !records.some(record => record.target.closest?.('#app-shell-sidebar')
+      || record.attributeName === 'lang'
+      || [...record.addedNodes ?? [], ...record.removedNodes ?? []].some(node => node.matches?.('#app-shell-sidebar') || node.querySelector?.('#app-shell-sidebar')))) return;
+    scheduled = true;
+    queueMicrotask(() => { scheduled = false; sync(); });
+  }
+  const observer = new MutationObserver(schedule);
+  observer.observe(document.documentElement,{subtree:true,childList:true,attributes:true,attributeFilter:['class','style','hidden','inert','aria-hidden','lang']});
+  void Promise.all([action.ready,loadIcon(signal)]).then(([,value]) => {
+    if (disposed || signal.aborted) return;
+    icon = value;
+    sync();
+  }).catch(() => { if (!disposed && !signal.aborted) config.codex.report('quick-chat-sidebar',false,'native-quick-chat-icon-unavailable'); });
+  function dispose() { disposed = true; observer.disconnect(); release(); style.remove(); }
+  signal.addEventListener('abort',dispose,{once:true});
+  return {dispose,sync,status:() => ({applicable:Boolean(native.read()),available:Boolean(mounted?.button.isConnected)})};
+}

package/features/quick-chat/src/injection-source.mjs

@@ -1,14 +1,15 @@
 import {quickChatHistoryVisible} from "./adapters/codex/history.mjs";
-import {createQuickChatExitAdapter} from "./adapters/codex/presence.mjs";
-import {installQuickChatExitRepair} from "./frontend/exit.mjs";
 import { readFile } from "node:fs/promises";
 import { createQuickChatAdapter } from "./adapters/codex/renderer.mjs";
 import { quickChatOpenExport, quickChatLifecycleExports, installQuickChatShortcut } from "./adapters/codex/shortcut.mjs";
 import { createSubmissionTracker } from "./domain/submission.mjs";
-import { createQuickChatPinAdapter } from "./adapters/codex/pin.mjs";
-import { installQuickChatPin } from "./frontend/pin.mjs";
+import { createQuickChatSidebarAdapter, loadQuickChatSidebarIcon } from "./adapters/codex/sidebar.mjs";
+import { installQuickChatSidebar } from "./frontend/sidebar.mjs";
 import { createHistoryTracker } from "./domain/history.mjs";
 export async function createPageScriptSource() {
   const source = await readFile(new URL("./frontend/entry.mjs", import.meta.url), "utf8");
-  return `const quickChatHistoryVisible=${quickChatHistoryVisible.toString()};\nconst createQuickChatExitAdapter=${createQuickChatExitAdapter.toString()};\nconst installQuickChatExitRepair=${installQuickChatExitRepair.toString()};\nconst createQuickChatPinAdapter=${createQuickChatPinAdapter.toString()};\nconst installQuickChatPin=${installQuickChatPin.toString()};\nconst quickChatOpenExport=${quickChatOpenExport.toString()};\nconst quickChatLifecycleExports=${quickChatLifecycleExports.toString()};\nconst installQuickChatShortcut=${installQuickChatShortcut.toString()};\nconst createQuickChatAdapter=${createQuickChatAdapter.toString()};\nconst createSubmissionTracker=${createSubmissionTracker.toString()};\nconst createHistoryTracker=${createHistoryTracker.toString()};\n${source}`;
+  const functions = [quickChatHistoryVisible, loadQuickChatSidebarIcon, createQuickChatSidebarAdapter, installQuickChatSidebar,
+    quickChatOpenExport, quickChatLifecycleExports, installQuickChatShortcut, createQuickChatAdapter,
+    createSubmissionTracker, createHistoryTracker];
+  return functions.map(fn => `const ${fn.name}=${fn.toString()};`).join('\n') + '\n' + source;
 }

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"));