minecodex 2.0.27 → 2.0.29

package/README.md

@@ -18,6 +18,8 @@ MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。
 | **文件级联浏览** · Cascading File Browser | 点击文件顶部路径，分列浏览文件夹并快速切换文件。 |
 | **图片集合** · Image Collection | 集中浏览生成的图片，查看提示词并复用创作思路。 |
 | **站点收藏** · Saved Sites | 发现项目正在运行的网页，收藏常用网址，随时打开。 |
+| **Quick Chat 退出修复** | 修复关闭快捷聊天后透明层残留、主页面无法点击的问题；可独立开关。 |
+| **快捷聊天增强** · Quick Chat | 补回 Codex 模式的 ⌘⌥N，恢复最小化输入框；发送后展开聊天，可固定内容窗口并查看原生聊天历史。 |
 | **侧栏聚焦** · Sidebar Focus | 一键收起侧栏中的其他分组，再次点击恢复原来的展开状态。 |
 | **隐藏额度推广** · Hide Usage Promotions | 隐藏输入框上方的套餐升级推广，让对话更清爽。 |
 

package/features/images/src/adapters/codex/image-sources.mjs

@@ -15,7 +15,9 @@ export function createImageSourcesAdapter(codex) {
       !node.closest("[data-minecodex-image-navigation]")
       && codex.props(node, isImageNavigation));
     if (!tabs) return null;
-    const navigation = tabs.parentElement?.parentElement;
+    // 26.1007 把来源工具栏包进独立 inset；图库仍是同级的 flex 内容区。
+    let navigation = tabs.parentElement?.parentElement;
+    while (navigation && !navigation.nextElementSibling) navigation = navigation.parentElement;
     const content = navigation?.nextElementSibling;
     const shell = navigation?.parentElement;
     if (!content || !shell) return null;

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

@@ -18,7 +18,7 @@ export function discoverFilePreviewComposerBindings(source) {
     if(found.length!==1)throw new Error("Native file preview Composer contract changed");
     return found[0];
   };
-  const scopeBody=requireBody(/draftId:[\w$]+,imageDataUrl:/);
+  const scopeBody=requireBody(/draftId:[\w$]+,(?:imageSrc|imageDataUrl):/);
   const homeBody=requireBody(/homeComposerController:[\w$]+,homeComposerMode:/);
   const composerBody=requireBody(/lockedLayout:`single-line`/);
   const localBody=requireBody(/prepareLocalConversationAttachments:/);
@@ -36,7 +36,7 @@ export function discoverFilePreviewComposerBindings(source) {
   const roles={
     useComposerController:alias(scopeBody,controller,true),
     useHomeComposer:homeBody.match(/let [\w$]+=([\w$]+)\([\w$]+\),[\w$]+=[\w$]+\?\.composerProps/)?.[1],
-    Composer:composerBody.match(/jsx\)\(([\w$]+),\{\.\.\.[\w$]+,className:`mx-auto w-full max-w-2xl px-toolbar`/)?.[1],
+    Composer:composerBody.match(/jsx\)\(([\w$]+),\{\.\.\.[\w$]+,[^;]+?lockedLayout:`single-line`/)?.[1],
     ComposerSurface:composerBody.match(/jsx\)\(([\w$]+),\{placement:/)?.[1],
     ScopeProvider:scopeProvider,
     composerScope:alias(scopeBody,scopes[0][2]),
@@ -115,33 +115,34 @@ export function createNativeImageModules({read = async url => (await fetch(url))
   async function gallery() {
     if (!connecting) connecting = (async () => {
       const {React,ReactDOM,module,component,binding,initialUrl,initialSource,initial}=await bootstrap();
-      const [masonry,layout,sourceImage,menu,selection]=await Promise.all([
+      const [masonry,layout,sourceImage,menu,toolbar]=await Promise.all([
         module("library-masonry"),module("library-item-layout"),module("generated-image-source"),
         module("generated-image-context-menu"),module("library-selection-toolbar"),
       ]);
-      const [moveDialog,dialogs]=await Promise.all([module("library-move-dialog",selection.source),module("library-item-dialogs",selection.source)]);
+      // 26.1007 将选择状态与图库动作移到 selectable-library-item；工具栏保留按钮与材质。
+      const selection=await module("selectable-library-item",toolbar.source);
+      const [moveDialog,dialogs]=await Promise.all([module("library-move-dialog",selection.source),module("library-item-dialogs",toolbar.source)]);
       const routerLocal = selection.source.match(/get\(([\w$]+)\)\.prepareNavigation\(/)?.[1];
       const routerAtom = await binding(selection.source, selection.url, routerLocal);
       const switchLocal = discoverImageActionBinding(selection.source, "switchMode");
       const switchMode = await binding(selection.source, selection.url, switchLocal);
-      const draftLocal = selection.source.match(/let u=([\w$]+)\(e,\[\]\);e.set/)?.[1];
+      const draftLocal = selection.source.match(/let [\w$]+=([\w$]+)\([\w$]+,\[\]\);[\w$]+\.set/)?.[1];
       const createChatDraft = await binding(selection.source, selection.url, draftLocal);
       const dropdownLocal = selection.source.match(/\(0,[\w$]+\.jsxs?\)\(([\w$]+),\{contentWidth:`menu`/)?.[1];
       const itemsLocal = selection.source.match(/\(0,[\w$]+\.jsxs?\)\(([\w$]+)\.Item,\{/)?.[1];
-      const buttonLocal = selection.source.match(/\(0,[\w$]+\.jsx\)\(([\w$]+),\{ref:[^,]+,color:`mediaOverlay`/)?.[1];
-      const iconLocal = selection.source.match(/color:`mediaOverlay`[^;]+?children:\(0,[\w$]+\.jsx\)\(([\w$]+),\{\}\)/)?.[1];
-      const [Dropdown, Menu, Button, MoreIcon] = await Promise.all([dropdownLocal, itemsLocal, buttonLocal, iconLocal].map(local => binding(selection.source, selection.url, local)));
+      const buttonLocal = toolbar.source.match(/jsx\)\(([\w$]+),\{color:`mediaSolid`/)?.[1];
+      const iconLocal = toolbar.source.match(/id:`libraryNext.selection.more`[^;]+?children:\(0,[\w$]+\.jsx\)\(([\w$]+),\{\}\)/)?.[1];
+      const [Dropdown, Menu] = await Promise.all([dropdownLocal, itemsLocal].map(local => binding(selection.source, selection.url, local)));
+      const [Button, MoreIcon] = await Promise.all([buttonLocal, iconLocal].map(local => binding(toolbar.source, toolbar.url, local)));
       const checkboxFunction = component(selection.exports,source=>/onCheckedChange:/.test(source)&&/viewMode:/.test(source),"selection checkbox");
-      const checkboxLocal = String(checkboxFunction).match(/\(0,[\w$]+\.jsx\)\(([\w$]+),\{className:`cursor-interaction`,variant:/)?.[1];
+      const checkboxLocal = String(checkboxFunction).match(/jsx\)\(([\w$]+),\{className:`cursor-interaction`,/)?.[1];
       const Checkbox = await binding(selection.source,selection.url,checkboxLocal);
       const rangeSelection = component(selection.exports,source=>/^function [\w$]+\(\{orderedIds:/.test(source)&&/extendRange:/.test(source),"range selection");
-      const selectionLocal = selection.source.match(/\.set\(([\w$]+),new Set\)/)?.[1];
-      const selectionExport = selection.source.match(/export\{([^}]+)\}/)?.[1].split(",").map(value=>value.trim().split(/\s+as\s+/)).find(parts=>parts[0]===selectionLocal)?.at(-1);
-      const nativeSelectedIds = selection.exports[selectionExport];
-      if (!nativeSelectedIds) throw new Error("Native selection state contract changed");
-      const clearPrefix = selection.source.slice(selection.source.indexOf("id:`libraryNext.selection.clear`"));
+      const selectionLocal = toolbar.source.match(/\.set\(([\w$]+),new Set[,)]/)?.[1];
+      const nativeSelectedIds = await binding(toolbar.source,toolbar.url,selectionLocal);
+      const clearPrefix = toolbar.source.slice(toolbar.source.indexOf("id:`libraryNext.selection.clear`"));
       const clearLocal = clearPrefix.match(/\(0,[\w$]+\.jsx\)\(([\w$]+),\{\}\)/)?.[1];
-      const ClearIcon = await binding(selection.source,selection.url,clearLocal);
+      const ClearIcon = await binding(toolbar.source,toolbar.url,clearLocal);
       const dialogLocal = dialogs.source.match(/\(0,[\w$]+\.jsx\)\(([\w$]+),\{open:[^,]+,showDialogClose:!1/)?.[1];
       const contentLocal = dialogs.source.match(/\(0,[\w$]+\.jsx\)\(([\w$]+),\{as:`form`,onSubmit:/)?.[1];
       const [Dialog,DialogContent] = await Promise.all([dialogLocal,contentLocal].map(local=>binding(dialogs.source,dialogs.url,local)));
@@ -154,8 +155,9 @@ export function createNativeImageModules({read = async url => (await fetch(url))
       const attachLocal = discoverImageActionBinding(imageActionSource, "attachChatImages");
       const downloadLocal = imageActionSource.match(/await ([\w$]+)\(\{downloadSrc:/)?.[1];
       const [imageFile,attachChatImages,downloadImage] = await Promise.all([imageFileLocal,attachLocal,downloadLocal].map(local=>binding(menuCoreSource,menuCoreUrl,local)));
-      const toolbarClass = selection.source.match(/className:`(pointer-events-auto flex h-toolbar[^`]+)`/)?.[1];
-      const toolbarPositionClass = selection.source.match(/className:`(pointer-events-none fixed inset-x-4 bottom-6[^`]+)`/)?.[1];
+      const toolbarClass = toolbar.source.match(/=\`(_Toolbar_[^`]+)\`/)?.[1];
+      const toolbarContainer = toolbar.source.match(/=\`(_Container_[^`]+)\`/)?.[1];
+      const toolbarPositionClass = toolbarContainer && `${toolbarContainer} fixed`;
       if (!toolbarClass || !toolbarPositionClass) throw new Error("Native selection toolbar layout changed");
       const libraryIcon = async label => {
         const marker = selection.source.indexOf(`defaultMessage:\`${label}\``);
@@ -180,8 +182,11 @@ export function createNativeImageModules({read = async url => (await fetch(url))
       const favoriteIconOwner = favoritePrefix.slice(0,favoriteIconLocal).match(/\(0,[\w$]+\.jsx\)\(([\w$]+),\{$/)?.[1];
       const [FavoriteIcon, savedSmall, savedMedium, emptySmall, emptyMedium] = await Promise.all([favoriteIconOwner,...favoriteAsset.slice(1)].map(local => binding(selection.source,selection.url,local)));
       const favoriteIcon = saved => React.createElement(FavoriteIcon,{icon:{assets:saved?{16:savedSmall,20:savedMedium}:{16:emptySmall,20:emptyMedium}}});
-      const [chatIcon, downloadIcon, folderIcon, deleteIcon] = await Promise.all([
-        libraryIcon("Chat about this"), libraryIcon("Download"), libraryIcon("Add to folder"), libraryIcon("{kind, select, directory {Delete folder} other {Delete}}"),
+      const chatLocal = toolbar.source.match(/children:[\w$]+\?[^;]+?:\(0,[\w$]+\.jsxs\)\([\w$]+\.Fragment,\{children:\[\(0,[\w$]+\.jsx\)\(([\w$]+),\{\}\),\(0,[\w$]+\.jsx\)\([\w$]+,\{id:`libraryNext.selection.chat`/)?.[1];
+      const ChatIcon = await binding(toolbar.source,toolbar.url,chatLocal);
+      const chatIcon = React.createElement(ChatIcon,{});
+      const [downloadIcon, folderIcon, deleteIcon] = await Promise.all([
+        libraryIcon("Download"), libraryIcon("Move to folder"), libraryIcon("{kind, select, directory {Delete folder} other {Delete}}"),
       ]);
       if (!React.createElement || !ReactDOM.createRoot || !Menu.Item) throw new Error("Native Images rendering contract changed");
       return {

package/features/model-slider/src/frontend/install.mjs

@@ -35,6 +35,11 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
       position: sticky; top: 0; z-index: 1; flex-shrink: 0; padding: 2px 8px 8px;
       background: var(--mcx-color-surface-elevated-secondary);
     }
+    /* sticky 保留菜单的 6px 内边距，补齐顶部遮挡而不改变布局高度。 */
+    [data-codex-model-slider-search-header]::before {
+      content: ""; position: absolute; top: -6px; left: -6px; right: -6px; height: 6px;
+      background: inherit; pointer-events: none;
+    }
     [data-codex-model-slider-search] {
       width: 100%; height: 28px; border: 0; outline: none; padding: 0;
       background: transparent; color: var(--mcx-color-text-primary);
@@ -722,7 +727,7 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
         .reduce((sum, value) => sum + (Number.parseFloat(value) || 0), 0);
       const last = items[Math.max(1, maxVisibleItems) - 1];
       const resultsHeight = last ? last.offsetTop + last.offsetHeight - content.offsetTop : content.offsetHeight;
-      const available = modelSelectorControllerMenu.parentMenu.getBoundingClientRect().bottom - 8;
+      const available = (modelSelectorControllerMenu.parentMenu.getBoundingClientRect().bottom - 8) / (menu.currentCSSZoom || 1);
       menu.style.height = `${Math.ceil(Math.min(chrome + header.offsetHeight + resultsHeight, available))}px`;
       menu.style.overflowY = "auto";
       return;
@@ -1003,7 +1008,8 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
   }
 
   function animateControllerModelMenu(record, opening, onFinish) {
-    const height = record.menu.getBoundingClientRect().height;
+    // height 写入 CSS 动画，必须使用布局尺寸，不能重复计入原生 zoom 和开场 scale。
+    const height = Number.parseFloat(getComputedStyle(record.menu).height);
     clearTimeout(record.motionTimer);
     record.animations?.forEach((animation) => animation.cancel());
     record.animations = [];
@@ -1134,14 +1140,14 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
       resetKeyboard();
       const record = modelSelectorControllerMenu;
       if (!record || record.menu !== menu || record.closing) return;
-      const previousHeight = menu.getBoundingClientRect().height;
+      const previousHeight = Number.parseFloat(getComputedStyle(menu).height);
       clearTimeout(record.motionTimer);
       record.animations?.forEach((animation) => animation.cancel());
       record.animations = [];
       menu.scrollTop = 0;
       renderEnhancedModelMenu(menu, selector);
       sizeModelMenuViewport(menu, selector.maxVisibleItems);
-      record.listHeight = menu.getBoundingClientRect().height;
+      record.listHeight = Number.parseFloat(getComputedStyle(menu).height);
       if (matchMedia("(prefers-reduced-motion: reduce)").matches) return;
       const motion = menu.animate([{ height: `${previousHeight}px` }, { height: `${record.listHeight}px` }],
         { duration: 320, easing: "cubic-bezier(.19,1,.22,1)" });
@@ -1237,7 +1243,7 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
       placeholderText,
       position: parentMenu.style.position,
       overflow: parentMenu.style.overflow,
-      sliderHeight: parentMenu.getBoundingClientRect().height,
+      sliderHeight: Number.parseFloat(getComputedStyle(parentMenu).height),
     };
     parentMenu.style.position = "relative";
     parentMenu.style.overflow = "visible";
@@ -1246,7 +1252,7 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
     modelButton.setAttribute("aria-expanded", "true");
     search.focus({ preventScroll: true });
     const record = modelSelectorControllerMenu;
-    record.listHeight = menu.getBoundingClientRect().height;
+    record.listHeight = Number.parseFloat(getComputedStyle(menu).height);
     animateControllerModelMenu(record, true, () => {
       if (modelSelectorControllerMenu !== record || record.closing) return;
       record.animations.forEach((animation) => animation.cancel());

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

@@ -377,6 +377,9 @@ function sync() {
     close();
   if (!button) {
     button = add.cloneNode(false);
+    // Add 的附件加载状态不属于只填入文字的提示词入口。
+    button.removeAttribute("disabled");
+    button.removeAttribute("aria-disabled");
     button.removeAttribute("title");
     button.removeAttribute("aria-describedby");
     button.removeAttribute("id");

package/features/quick-chat/assets/history.svg

@@ -0,0 +1,17 @@
+<!-- @license lucide-static v0.468.0 - ISC -->
+<svg
+  class="lucide lucide-history"
+  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="M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8" />
+  <path d="M3 3v5h5" />
+  <path d="M12 7v5l4 2" />
+</svg>

package/features/quick-chat/assets/pin.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 17v5"/><path d="M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7a1 1 0 0 1 1-1 2 2 0 0 0 0-4H8a2 2 0 0 0 0 4 1 1 0 0 1 1 1z"/></svg>

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

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "id": "quick-chat",
+  "version": "0.1.0",
+  "label": { "en": "Quick Chat", "zh-CN": "快捷聊天增强" },
+  "description": { "en": "Restore Quick Chat shortcuts, expand after sending, pin classic chats, and open native chat history.", "zh-CN": "恢复 Quick Chat 快捷键，发送后展开聊天，可固定经典聊天窗口并查看原生历史。" },
+  "entry": { "kind": "page-script", "script": "src/frontend/entry.mjs", "sourceFactory": "src/injection-source.mjs", "resources": { "history": "assets/history.svg", "pin": "assets/pin.svg" } },
+  "icon": { "resource": "assets/history.svg" },
+  "placement": { "order": 75 }
+}

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

@@ -0,0 +1,34 @@
+export function createQuickChatPinAdapter(codex) {
+  const layerSelector = '.fixed.inset-0.zoom-adjusted-viewport.pointer-events-auto';
+  function historyVisible(node) {
+    if (Array.isArray(node)) return node.some(historyVisible);
+    const props = node?.props;
+    if (!props || props.hidden || props.inert || props['aria-hidden']) return false;
+    if (Array.isArray(props.conversations) && typeof props.onConversationSelect === 'function' && typeof props.onNewChat === 'function') return true;
+    return historyVisible(props.children);
+  }
+  function surfaces() {
+    const inCodex = [...document.querySelectorAll('button[aria-haspopup="menu"]')].some(button => button.checkVisibility({visibilityProperty:true})
+      && codex.props(button, p => typeof p.onModeSelect === 'function' && typeof p.mode === 'string', 80)?.mode === 'codex');
+    if (!inCodex) return [];
+    return [...document.querySelectorAll('[data-floating-chat-surface]')].flatMap(surface => {
+      const layer = surface.closest(layerSelector);
+      if (!layer || layer.closest('[hidden], [inert], [aria-hidden="true"]')) return [];
+      if (!codex.props(surface, p => p.name === 'QuickChatWindow', 120)) return [];
+      const presence = codex.props(surface, p => typeof p.isPresent === 'boolean' && typeof p.onExitComplete === 'function', 120);
+      if (presence?.isPresent === false) return [];
+      const editable = surface.querySelector('[data-chatgpt-composer] [contenteditable="true"]');
+      const composer = editable && codex.props(editable, p => typeof p.isWorkConversation === 'boolean' && p.conversationId);
+      const session = codex.props(surface, p => p.session?.conversationId)?.session;
+      const floating = codex.props(surface, p => typeof p.onMinimizedChange === 'function' && typeof p.renderMenu === 'function');
+      if (!composer || composer.isWorkConversation || composer.annotationSubmitTarget || composer.isWidgetOverlay || !session?.hasConversation || !floating) return [];
+      const anchor = surface.querySelector('header button[data-quick-chat-drag-handle]');
+      const expanded = floating.presentation === 'expanded' || floating.forceExpanded;
+      const history = historyVisible(floating.renderTranscript?.());
+      return [{surface, layer, sessionId:session.conversationId, anchor, minimized:Boolean(floating.isMinimized), expanded:Boolean(expanded), history,
+        expand:() => floating.onPresentationChange('expanded'),
+        showPin:Boolean(anchor && expanded && !floating.isMinimized && !history)}];
+    });
+  }
+  return {surfaces};
+}

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

@@ -0,0 +1,63 @@
+export function createQuickChatAdapter(codex) {
+  const receipts = new WeakMap();
+  let nextReceipt = 1;
+  const surfaceSelector = '[data-floating-chat-surface]';
+  function historyList(node) {
+    if (Array.isArray(node)) return node.some(historyList);
+    const props = node?.props;
+    if (!props || props.hidden || props.inert || props['aria-hidden']) return false;
+    if (Array.isArray(props.conversations) && typeof props.onConversationSelect === 'function' && typeof props.onNewChat === 'function') return true;
+    return historyList(props.children);
+  }
+  function read(surface) {
+    if (!surface?.isConnected || surface.closest('[hidden], [inert], [aria-hidden="true"]')) return null;
+    const editable = surface.querySelector('[data-chatgpt-composer] [contenteditable="true"]');
+    if (!editable) return null;
+    const composer = codex.props(editable, props => typeof props.isWorkConversation === "boolean" && props.conversationId);
+    const session = codex.props(surface, props => props.session?.conversationId)?.session;
+    const floating = codex.props(surface, props => typeof props.onPresentationChange === "function" && typeof props.renderMenu === "function");
+    // Work 的页面横条没有经典 Chat 的历史动作，不能接入此功能。
+    if (!composer || composer.isWorkConversation || composer.annotationSubmitTarget || composer.isWidgetOverlay || !session || !floating) return null;
+    const history = floating.renderMenu({})?.props?.items?.find(item => item.id === "history" && typeof item.onSelect === "function");
+    if (!history) return null;
+    const state = codex.props(editable, props => typeof props.submitDisabled === "boolean" && props.conversationId);
+    const controller = codex.props(editable, props => props.composerController?.eventEmitter)?.composerController;
+    const minimize = [...surface.querySelectorAll('button')].find(button => {
+      const props = codex.props(button, props => props.standalone === true && typeof props.onMinimize === "function" && typeof props.isCompact === "boolean", 5);
+      return Boolean(props && button.checkVisibility({visibilityProperty:true}) && !button.hasAttribute('data-mcx-quick-chat-history'));
+    });
+    let receipt = null;
+    for (let fiber = codex.currentFiber(surface), depth = 0; fiber && depth < 80; depth++, fiber = fiber.return) {
+      if (fiber.memoizedProps?.session?.conversationId !== session.conversationId) continue;
+      for (let hook = fiber.memoizedState, count = 0; hook && count < 140; hook = hook.next, count++) {
+        const value = hook.memoizedState;
+        if (value?.conversationId === session.conversationId && "owner" in value && typeof value.presentation === "string") receipt = value;
+      }
+      if (receipt) break;
+    }
+    // 发送确认回调写入新记录；拒绝发送不会写入。记录身份只映射为窗口内序号。
+    if (receipt && !receipts.has(receipt)) receipts.set(receipt, nextReceipt++);
+    const frame = surface.closest('[role="dialog"]');
+    const background = frame && [...frame.children].find(node => codex.props(node, props => props.asChild === true && typeof props.unstyled === "boolean", 8));
+    const project = [...surface.querySelectorAll('[data-composer-rail-item] button')].find(button =>
+      codex.props(button, props => props.variant === "composer" && typeof props.onProjectChange === "function"));
+    const projectRail = project?.closest('[data-composer-rail-item]') ?? null;
+    const expanded = Boolean(floating.presentation === "expanded" || floating.forceExpanded);
+    return {surface, editable, minimize, projectRail, background:!session.hasConversation && floating.forceExpanded ? background : null, sessionId:session.conversationId, hasConversation:session.hasConversation,
+      canSubmit:Boolean(state && !state.submitDisabled && !state.submitLoading), receiptId:receipt ? receipts.get(receipt) : 0, receiptPresentation:receipt?.presentation ?? null, emitter:controller?.eventEmitter,
+      expanded, showHistory:Boolean(minimize && !expanded), historyVisible:historyList(floating.renderTranscript?.()),
+      expand:() => floating.onPresentationChange("expanded"),
+      // 历史动作通过 forceExpanded 临时展开；不要覆盖最小化后的恢复形态。
+      history:() => history.onSelect()};
+  }
+  function surfaces() { return [...document.querySelectorAll(surfaceSelector)].map(read).filter(Boolean); }
+  function subscribe(snapshot, listener) {
+    const emitter = snapshot.emitter;
+    if (!emitter?.addListener || !emitter?.removeListener) return () => {};
+    // 不改变原生 emit 的 handled 结果，也不接管发送。
+    const submit = () => { listener(); return false; };
+    emitter.addListener("submit", submit);
+    return () => emitter.removeListener("submit", submit);
+  }
+  return {surfaces, read, subscribe};
+}

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

@@ -0,0 +1,83 @@
+// 通过原生能力检查与已有会话分支定位打开动作，不依赖构建哈希或压缩名称。
+export function quickChatOpenExport(source) {
+  const match = source.match(/function ([\w$]+)\(([\w$]+),[\w$]+=\{\}\)\{if\(!\2\.get\([\w$]+,\{name:[`"']chatgpt\.quick-chat[`"']\}\)\.isCapable\)return;let [\w$]+=\2\.get\([\w$]+\),[\w$]+=\2\.get\([\w$]+\);if\(/);
+  if (!match) throw new Error('quick-chat-open-contract-unavailable');
+  const escaped = match[1].replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const name = source.slice(source.lastIndexOf('export{')).match(new RegExp(`(?:\\{|,)${escaped} as ([\\w$]+)(?:,|\\})`))?.[1];
+  if (!name) throw new Error('quick-chat-open-export-unavailable');
+  return name;
+}
+
+export function installQuickChatShortcut(signal, codex, discover = null) {
+  let bindings = null, disposed = false;
+  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');
+      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');
+      if (!restore) continue;
+      button.click();
+      return true;
+    }
+    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');
+      if (!floating || floating.isMinimized || floating.isHidden) continue;
+      const editable = surface.querySelector('[data-chatgpt-composer] [contenteditable="true"]');
+      if (!editable?.checkVisibility({visibilityProperty:true})) continue;
+      editable.focus({preventScroll:true});
+      return true;
+    }
+    return false;
+  }
+  function context() {
+    for (const button of document.querySelectorAll('button[aria-haspopup="menu"]')) {
+      if (!button.checkVisibility({visibilityProperty:true})) continue;
+      const mode = codex.props(button, p => typeof p.onModeSelect === 'function' && typeof p.mode === 'string', 80)?.mode;
+      if (mode !== 'codex') continue;
+      for (let fiber = codex.currentFiber(button), depth = 0; fiber && depth++ < 200; fiber = fiber.return) {
+        const values = [];
+        for (let hook = fiber.memoizedState, n = 0; hook && n++ < 150; hook = hook.next) values.push(hook.memoizedState?.current);
+        for (const row of fiber.updateQueue?.memoCache?.data ?? []) values.push(...row);
+        const scope = values.find(v => typeof v?.get === 'function' && typeof v.set === 'function' && v.scope?.__scopeBrand === 'AppScope');
+        if (scope) return scope;
+      }
+    }
+    return null;
+  }
+  async function load() {
+    const url = [...document.querySelectorAll('link[rel="modulepreload"],script[src]')].map(e => e.href || e.src).find(url => /\/app-initial-[^/]+\.js(?:$|\?)/.test(url));
+    if (!url) throw new Error('quick-chat-module-unavailable');
+    const source = await (await fetch(url, {signal})).text();
+    const module = await import(url);
+    const commands = Object.values(module).find(v => Array.isArray(v) && v.some(c => c?.id === 'temporaryChat') && v.some(c => c?.id === 'newTask'));
+    if (!commands) throw new Error('quick-chat-command-catalog-unavailable');
+    if (commands.some(c => c.id === 'quickChat')) return {native:true};
+    const open = module[quickChatOpenExport(source)];
+    if (typeof open !== 'function') throw new Error('quick-chat-open-action-unavailable');
+    return {native:false, open};
+  }
+  const ready = (discover ?? load)().then(value => {
+    if (disposed || signal.aborted) return;
+    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;
+    if (!activateExisting()) {
+      const scope = bindings && context();
+      if (!scope) return;
+      bindings.open(scope);
+    }
+    event.preventDefault();
+    event.stopPropagation();
+  }
+  document.addEventListener('keydown', keydown, {signal});
+  function dispose() { disposed = true; document.removeEventListener('keydown', keydown); bindings = null; }
+  signal.addEventListener('abort', dispose, {once:true});
+  return {ready, dispose};
+}

package/features/quick-chat/src/domain/history.mjs

@@ -0,0 +1,12 @@
+export function createHistoryTracker() {
+  let origin = null;
+  return {
+    open(snapshot) { if (snapshot.historyVisible) origin = snapshot.sessionId; },
+    selected(snapshot) {
+      if (origin === null || origin === snapshot.sessionId) return false;
+      origin = null;
+      return snapshot.hasConversation;
+    },
+    clear() { origin = null; },
+  };
+}

package/features/quick-chat/src/domain/submission.mjs

@@ -0,0 +1,15 @@
+// 发送确认会写入同会话的新呈现记录；拒绝发送不会更新该记录。
+export function createSubmissionTracker() {
+  let pending = null;
+  return {
+    begin(snapshot) { pending = snapshot.canSubmit ? {sessionId:snapshot.sessionId, receiptId:snapshot.receiptId} : null; },
+    accepted(snapshot) {
+      if (!pending) return false;
+      if (pending.sessionId !== snapshot.sessionId) { pending = null; return false; }
+      if (!snapshot.hasConversation || !snapshot.receiptId || snapshot.receiptId === pending.receiptId) return false;
+      pending = null;
+      return snapshot.receiptPresentation !== "minimized";
+    },
+    clear() { pending = null; },
+  };
+}

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

@@ -0,0 +1,104 @@
+const native = createQuickChatAdapter(config.codex);
+const shortcut = installQuickChatShortcut(signal, config.codex);
+const pin = installQuickChatPin(signal, config);
+const instances = new Map();
+let scheduled = false, disposed = false;
+const text = (en,zh) => (document.documentElement.lang || navigator.language).startsWith('zh') ? zh : en;
+const style = document.createElement('style');
+style.textContent = `
+  [data-mcx-quick-chat-history]{margin-inline-end:8px;flex-shrink:0}
+  [data-mcx-quick-chat-history]>svg{width:16px;height:16px}
+  [data-mcx-quick-chat-minimize]{border-radius:calc(infinity * 1px)}
+  [data-mcx-quick-chat-project-rail]{display:none!important}
+  /* 隐藏唯一的项目栏时，一并收起原生 rail 的圆角留白与负 margin。 */
+  [data-composer-rail]:has(>[data-mcx-quick-chat-project-rail]):not(:has(>:not([data-mcx-quick-chat-project-rail]):not(:empty))){display:none!important}
+  [data-floating-chat-surface]>:has(>[data-mcx-quick-chat-history]){display:flex;align-items:center}
+`;
+document.head.append(style);
+function releaseBackground(instance) {
+  if (!instance.background) return;
+  instance.background.removeAttribute('data-mcx-ui-surface'); instance.background.removeAttribute('data-mcx-ui-variant');
+  instance.background = null;
+}
+function releaseProjectRail(instance) { instance.projectRail?.removeAttribute('data-mcx-quick-chat-project-rail'); instance.projectRail = null; }
+function remove(instance) { releaseBackground(instance); releaseProjectRail(instance); instance.minimize?.removeAttribute('data-mcx-quick-chat-minimize'); instance.unsubscribe(); instance.button?.remove(); instance.tracker.clear(); instance.historyTracker.clear(); }
+function sync() {
+  if (disposed) return;
+  pin.sync();
+  const snapshots = native.surfaces(), active = new Set();
+  for (const snapshot of snapshots) {
+    active.add(snapshot.surface);
+    let instance = instances.get(snapshot.surface);
+    const selected = instance?.historyTracker.selected(snapshot);
+    if (!instance || instance.sessionId !== snapshot.sessionId || instance.emitter !== snapshot.emitter) {
+      if (instance) remove(instance);
+      instance = {sessionId:snapshot.sessionId, emitter:snapshot.emitter, tracker:createSubmissionTracker(), historyTracker:createHistoryTracker(), button:null};
+      const begin = () => { const current = native.read(snapshot.surface); if (current) instance.tracker.begin(current); };
+      instance.unsubscribe = native.subscribe(snapshot, begin);
+      instances.set(snapshot.surface, instance);
+    }
+    if (selected || instance.tracker.accepted(snapshot)) snapshot.expand();
+    instance.historyTracker.open(snapshot);
+    if (instance.projectRail !== snapshot.projectRail) {
+      releaseProjectRail(instance);
+      instance.projectRail = snapshot.projectRail;
+      instance.projectRail?.setAttribute('data-mcx-quick-chat-project-rail','');
+    }
+    if (instance.background !== snapshot.background) {
+      releaseBackground(instance);
+      if (snapshot.background) {
+        instance.background = snapshot.background;
+        config.ui.surface(snapshot.background,'floating-panel');
+      }
+    }
+    const minimize = snapshot.minimize;
+    if (instance.minimize !== minimize) {
+      instance.minimize?.removeAttribute('data-mcx-quick-chat-minimize'); instance.minimize = minimize;
+      minimize?.setAttribute('data-mcx-quick-chat-minimize','');
+    }
+    if (!minimize || !snapshot.showHistory) { instance.button?.remove(); instance.button = null; continue; }
+    if (!instance.button?.isConnected || instance.button.parentElement !== minimize.parentElement) {
+      instance.button?.remove();
+      const button = minimize.cloneNode(false);
+      for (const attr of ['id','disabled','aria-disabled','aria-describedby','aria-expanded','title']) button.removeAttribute(attr);
+      button.removeAttribute('data-mcx-quick-chat-minimize');
+      button.type = 'button';
+      button.setAttribute('data-mcx-quick-chat-history', '');
+      button.innerHTML = config.resources.history;
+      const icon = button.querySelector('svg');
+      if (icon) { icon.setAttribute('width','16'); icon.setAttribute('height','16'); icon.setAttribute('aria-hidden','true'); }
+      button.addEventListener('pointerdown', event => event.preventDefault(), {signal});
+      button.addEventListener('click', () => { instance.tracker.clear(); native.read(snapshot.surface)?.history(); }, {signal});
+      minimize.before(button); instance.button = button;
+    }
+    if (instance.button.className !== minimize.className) instance.button.className = minimize.className;
+    const label = text('Chat history', '聊天历史');
+    if (instance.button.getAttribute('aria-label') !== label) {
+      instance.button.setAttribute('aria-label',label); instance.button.setAttribute('data-minecodex-tooltip',label);
+    }
+  }
+  for (const [surface, instance] of instances) if (!active.has(surface)) { remove(instance); instances.delete(surface); }
+}
+function schedule() { if (disposed || scheduled) return; scheduled = true; queueMicrotask(() => { scheduled = false; sync(); }); }
+function begin(event) {
+  const snapshot = native.surfaces().find(item => item.surface.contains(event.target));
+  if (!snapshot) return;
+  if (event.type === 'click' && !event.target.closest('button[type="submit"]')) { instances.get(snapshot.surface)?.tracker.clear(); return; }
+  instances.get(snapshot.surface)?.tracker.begin(snapshot);
+}
+document.addEventListener('click',begin,{capture:true,signal});
+document.addEventListener('submit',begin,{capture:true,signal});
+const observer = new MutationObserver(schedule);
+observer.observe(document.documentElement,{subtree:true,childList:true,attributes:true,attributeFilter:['aria-hidden','inert','hidden','lang']});
+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);
+  return {state:applicable ? available ? 'available' : 'unavailable' : 'not-applicable',
+    reason:applicable ? available ? null : 'quick-chat-controls-unavailable' : 'no-classic-quick-chat-floating-controls',
+    checks:[...(anchors.length ? [{name:'quick-chat-history',available:history}] : []), ...(pinned.applicable ? [{name:'quick-chat-pin',available:pinned.available}] : [])],
+    scopes:snapshots.map(item=>({name:'quick-chat',element:item.surface}))};
+});
+return () => { disposed = true; shortcut.dispose(); pin.dispose(); observer.disconnect(); for (const instance of instances.values()) remove(instance); instances.clear(); style.remove(); };

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

@@ -0,0 +1,54 @@
+export function installQuickChatPin(signal, config) {
+  const native = createQuickChatPinAdapter(config.codex), instances = new Map();
+  const style = document.createElement('style');
+  // 保留原生可交互子元素的 pointer-events-auto，仅让透明背景穿透。
+  style.textContent = '[data-mcx-quick-chat-pinned-layer]{pointer-events:none!important}';
+  document.head.append(style);
+  const text = (en,zh) => (document.documentElement.lang || navigator.language).startsWith('zh') ? zh : en;
+  function render(instance) {
+    if (instance.pinned) instance.layer.setAttribute('data-mcx-quick-chat-pinned-layer','');
+    else instance.layer.removeAttribute('data-mcx-quick-chat-pinned-layer');
+    const button = instance.button;
+    if (!button) return;
+    button.setAttribute('aria-pressed',String(instance.pinned));
+    const label = instance.pinned ? text('Unpin chat','取消固定聊天') : text('Pin chat','固定聊天');
+    button.setAttribute('aria-label',label); button.setAttribute('data-minecodex-tooltip',label);
+    button.querySelector('svg path:last-child')?.setAttribute('fill',instance.pinned ? 'currentColor' : 'none');
+  }
+  function release(instance) { instance.layer.removeAttribute('data-mcx-quick-chat-pinned-layer'); instance.button?.remove(); }
+  function sync() {
+    const live = new Set();
+    for (const snapshot of native.surfaces()) {
+      live.add(snapshot.sessionId);
+      let instance = instances.get(snapshot.sessionId);
+      if (!instance) { instance={pinned:false,layer:snapshot.layer,button:null}; instances.set(snapshot.sessionId,instance); }
+      if (instance.layer !== snapshot.layer) { release(instance); instance.layer=snapshot.layer; instance.button=null; }
+      if (snapshot.minimized || snapshot.history) instance.pinned=false;
+      if (instance.pinned && !snapshot.minimized && !snapshot.expanded && !snapshot.history) snapshot.expand();
+      if (!snapshot.showPin) { instance.button?.remove(); instance.button=null; render(instance); continue; }
+      const anchor = snapshot.anchor;
+      if (!instance.button?.isConnected || instance.button.parentElement !== anchor.parentElement) {
+        instance.button?.remove();
+        const button = document.createElement('button');
+        button.type='button'; button.setAttribute('data-mcx-quick-chat-pin',''); button.innerHTML=config.resources.pin;
+        const icon=button.querySelector('svg'), original=anchor.querySelector('svg');
+        for (const attr of ['width','height','class']) if (original?.hasAttribute(attr)) icon?.setAttribute(attr,original.getAttribute(attr));
+        icon?.setAttribute('aria-hidden','true');
+        button.addEventListener('pointerdown',event=>event.stopPropagation(),{signal});
+        button.addEventListener('click',event=>{event.stopPropagation();instance.pinned=!instance.pinned;render(instance);},{signal});
+        anchor.before(button); instance.button=button;
+      }
+      if (instance.button.className !== anchor.className) instance.button.className=anchor.className;
+      render(instance);
+    }
+    for (const [id,instance] of instances) if (!live.has(id)) { release(instance); instances.delete(id); }
+  }
+  function escape(event) {
+    if (event.key !== 'Escape' || event.defaultPrevented || event.repeat || event.isComposing) return;
+    for (const instance of instances.values()) if (instance.layer.contains(event.target)) { instance.pinned=false; render(instance); }
+  }
+  document.addEventListener('keydown',escape,{capture:true,signal});
+  function dispose() { document.removeEventListener('keydown',escape,true); for (const instance of instances.values()) release(instance); instances.clear(); style.remove(); }
+  function status() { const applicable=native.surfaces().some(snapshot=>snapshot.showPin); return {applicable,available:applicable && [...instances.values()].some(instance=>instance.button?.isConnected)}; }
+  return {sync,dispose,status};
+}

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

@@ -0,0 +1,11 @@
+import { readFile } from "node:fs/promises";
+import { createQuickChatAdapter } from "./adapters/codex/renderer.mjs";
+import { quickChatOpenExport, 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 { createHistoryTracker } from "./domain/history.mjs";
+export async function createPageScriptSource() {
+  const source = await readFile(new URL("./frontend/entry.mjs", import.meta.url), "utf8");
+  return `const createQuickChatPinAdapter=${createQuickChatPinAdapter.toString()};\nconst installQuickChatPin=${installQuickChatPin.toString()};\nconst quickChatOpenExport=${quickChatOpenExport.toString()};\nconst installQuickChatShortcut=${installQuickChatShortcut.toString()};\nconst createQuickChatAdapter=${createQuickChatAdapter.toString()};\nconst createSubmissionTracker=${createSubmissionTracker.toString()};\nconst createHistoryTracker=${createHistoryTracker.toString()};\n${source}`;
+}

package/features/quick-chat/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/quick-chat-repair/assets/history.svg

@@ -0,0 +1,17 @@
+<!-- @license lucide-static v0.468.0 - ISC -->
+<svg
+  class="lucide lucide-history"
+  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="M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8" />
+  <path d="M3 3v5h5" />
+  <path d="M12 7v5l4 2" />
+</svg>

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

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "id": "quick-chat-repair",
+  "version": "0.1.0",
+  "label": {"en":"Quick Chat Exit Repair", "zh-CN":"Quick Chat 退出修复"},
+  "description": {"en":"Fix the native transparent layer that blocks clicks after closing Quick Chat.", "zh-CN":"修复关闭 Quick Chat 后透明层残留、主页面无法点击的问题。"},
+  "entry": {"kind":"page-script", "script":"src/frontend/entry.mjs", "sourceFactory":"src/injection-source.mjs"},
+  "icon": {"resource":"assets/history.svg"},
+  "placement": {"order":76}
+}

package/features/quick-chat-repair/src/adapters/codex/presence.mjs

@@ -0,0 +1,74 @@
+export function createQuickChatExitAdapter(codex) {
+  const completed = new WeakSet();
+  const selector = '.fixed.inset-0.zoom-adjusted-viewport.pointer-events-auto';
+  function currentLayer(layer) {
+    const attached = codex.currentFiber(layer);
+    let host = attached;
+    while (host?.return) host = host.return;
+    const current = host?.stateNode?.current;
+    if (!current) return attached;
+    // Host props 可原样复用，DOM 上的 Fiber 因此可能仍指向上一棵树。
+    const pending = [current];
+    let visited = 0;
+    while (pending.length && visited++ < 10000) {
+      const fiber = pending.pop();
+      if (fiber.stateNode === layer) return fiber;
+      for (let child = fiber.child; child; child = child.sibling) pending.push(child);
+    }
+    return null;
+  }
+  function presence(fiber) {
+    for (let dependency = fiber.dependencies?.firstContext; dependency; dependency = dependency.next) {
+      const context = dependency.memoizedValue;
+      if (context?.isPresent === false && typeof context.register === 'function' && typeof context.onExitComplete === 'function') return context;
+    }
+    return null;
+  }
+  function completion(fiber) {
+    const props = fiber.memoizedProps;
+    if (props?.propagate !== true || fiber.child || typeof fiber.type !== 'function') return null;
+    const source = Function.prototype.toString.call(fiber.type);
+    if (!source.includes('presenceAffectsLayout:') || !source.includes('propagate:') || !source.includes('.useState)')) return null;
+    const context = presence(fiber);
+    if (!context) return null;
+    for (let hook = fiber.memoizedState, count = 0; hook && count < 40; hook = hook.next, count++) {
+      const value = hook.memoizedState;
+      if (!Array.isArray(value) || typeof value[0] !== 'function') continue;
+      const deps = value[1];
+      if (!Array.isArray(deps) || deps.length !== 3 || typeof deps[0] !== 'string' || deps[1] !== context.onExitComplete || deps[2] !== true) continue;
+      // 仅补齐仍未完成的 usePresence 登记，不绕过父层或其他子动画。
+      for (let parent = fiber.return, depth = 0; parent && depth < 40; parent = parent.return, depth++) {
+        if (parent.memoizedProps?.value !== context) continue;
+        for (let owner = parent.return, level = 0; owner && level < 5; owner = owner.return, level++) {
+          for (let state = owner.memoizedState, n = 0; state && n < 20; state = state.next, n++) {
+            const map = state.memoizedState?.current;
+            if (map instanceof Map && map.get(deps[0]) === false) return value[0];
+          }
+        }
+        return null;
+      }
+    }
+    return null;
+  }
+  function repair(layer) {
+    if (!layer.isConnected) return 0;
+    let root = currentLayer(layer);
+    for (let depth = 0; root && depth < 40; root = root.return, depth++) {
+      if (typeof root.memoizedProps?.isPresent === 'boolean' && typeof root.memoizedProps?.onExitComplete === 'function') break;
+    }
+    if (!root || root.memoizedProps.isPresent !== false) return 0;
+    const pending = [root];
+    const completions = [];
+    let quickChat = false, count = 0, visited = 0;
+    while (pending.length && visited++ < 1000) {
+      const fiber = pending.pop(), finish = completion(fiber);
+      if (fiber.memoizedProps?.name === 'QuickChatWindow') quickChat = true;
+      if (finish && !completed.has(finish)) completions.push(finish);
+      for (let child = fiber.child; child; child = child.sibling) pending.push(child);
+    }
+    if (!quickChat || pending.length) return 0;
+    for (const finish of completions) { completed.add(finish); finish(); count++; }
+    return count;
+  }
+  return { selector, repair, reconcile:() => [...document.querySelectorAll(selector)].reduce((count, layer) => count + repair(layer), 0) };
+}

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

@@ -0,0 +1,12 @@
+const native = createQuickChatExitAdapter(config.codex);
+let scheduled = false, disposed = false;
+function schedule() {
+  if (scheduled || disposed) return;
+  scheduled = true;
+  queueMicrotask(() => { scheduled = false; if (!disposed) native.reconcile(); });
+}
+const observer = new MutationObserver(schedule);
+observer.observe(document.documentElement, {subtree:true, childList:true, attributes:true, attributeFilter:['style']});
+schedule();
+config.registerSelfCheck?.(() => ({state:'available', checks:[{name:'native-exit-observer', available:!disposed}], scopes:[]}));
+return () => { disposed = true; observer.disconnect(); };

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

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

package/features/quick-chat-repair/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/session-status/src/adapters/codex/session-log.mjs

@@ -68,7 +68,7 @@ export function sessionFacts(record) {
   if (record?.type === "event_msg") {
     if (p.type === "context_compacted") emit("context-reset");
     if (p.type === "task_started" && p.turn_id) emit("turn-started", { id:p.turn_id });
-    if (["task_complete", "task_interrupted", "turn_aborted"].includes(p.type)) emit("turn-ended", { id:p.turn_id });
+    if (["task_complete", "task_interrupted", "turn_aborted"].includes(p.type)) emit("turn-ended", { id:p.turn_id, completed:p.type === "task_complete" });
     if (p.type === "task_complete" && Number.isFinite(p.time_to_first_token_ms)) emit("first-token-measured", { elapsed:p.time_to_first_token_ms });
     if (p.type === "item_completed") {
       if (p.item?.type === "ContextCompaction") emit("compaction-finished");

package/features/session-status/src/domain/session-stats.mjs

@@ -9,6 +9,7 @@ export function createSessionState() {
     turns: new Set(),
     currentTurnId: null,
     runningTurns: new Set(),
+    completedTurns: new Set(),
     responses: new Set(),
     hasResponseUsage: false,
     total: null,
@@ -66,8 +67,14 @@ export function applySessionStatusEvent(state, event) {
       if (Number.isFinite(event.contextWindow)) state.contextWindow=event.contextWindow;
       state.baseInstructionTokens=event.instructionTokens; break;
     case "context-reset": state.compactionEvents++; state.last=null; reset(); break;
-    case "turn-started": reset(); state.currentTurnId=event.id; state.turns.add(event.id); state.runningTurns.add(event.id); break;
-    case "turn-ended": reset(); state.currentTurnId=null; if (event.id) state.runningTurns.delete(event.id); else state.runningTurns.clear(); break;
+    case "turn-started": reset(); state.currentTurnId=event.id; state.turns.add(event.id); state.runningTurns.add(event.id); state.completedTurns.delete(event.id); break;
+    case "turn-ended": {
+      const id = event.id ?? state.currentTurnId;
+      if (event.completed && id) state.completedTurns.add(id);
+      reset(); state.currentTurnId=null;
+      if (id) state.runningTurns.delete(id); else state.runningTurns.clear();
+      break;
+    }
     case "first-token-measured": state.ttftTotalMs+=event.elapsed; state.ttftSamples++; break;
     case "compaction-finished": state.compactionCompleted++; break;
     case "output-observed":
@@ -103,8 +110,7 @@ export function applySessionStatusEvent(state, event) {
   if (state.total || state.turns.size) state.updatedAt=event.at ?? state.updatedAt;
 }
 
-export function sessionStatusSnapshot(state, threadId, measurements = new Map()) {
-  const sample = state.speedMeasurements.at(-1);
+function responseSpeed(sample, measurements) {
   const measurement = measurements.get(sample?.id);
   const source = measurement?.source ?? "codex";
   const elapsed = measurement ? measurement.elapsed : sample?.start == null ? null
@@ -114,6 +120,23 @@ export function sessionStatusSnapshot(state, threadId, measurements = new Map())
   const output = measurement?.output ?? sample?.output;
   const unavailableReason = measurement?.reason ?? (Number.isFinite(elapsed) && elapsed > 0 && elapsed < 1000
     ? "decode_window_too_short" : "timing_missing");
+  return { source, elapsed, valid, output, unavailableReason };
+}
+
+export function sessionStatusSnapshot(state, threadId, measurements = new Map()) {
+  const { source, elapsed, valid, output, unavailableReason } = responseSpeed(state.speedMeasurements.at(-1), measurements);
+  // 窗口先按完成回合截取；缺少计时不能让更早回合补进最新十轮。
+  const recentTurns = new Map([...state.completedTurns].slice(-10).map(id => [id, { output:0, elapsed:0 }]));
+  for (const sample of state.speedMeasurements) {
+    const turn = recentTurns.get(sample.turnId);
+    if (!turn) continue;
+    const speed = responseSpeed(sample, measurements);
+    if (!speed.valid) continue;
+    turn.output += speed.output;
+    turn.elapsed += speed.elapsed;
+  }
+  const turnSpeeds = [...recentTurns.values()].filter(turn => turn.elapsed > 0)
+    .map(turn => turn.output / (turn.elapsed / 1000));
   const total = state.total;
   const input = total?.input ?? 0;
   const cached = total?.cached ?? 0;
@@ -137,6 +160,8 @@ export function sessionStatusSnapshot(state, threadId, measurements = new Map())
     speedSource: source,
     speedUnavailableReason: valid ? null : unavailableReason,
     observedModelMs: valid ? elapsed : 0,
+    averageTps: turnSpeeds.length ? Math.round(turnSpeeds.reduce((sum, speed) => sum + speed, 0) / turnSpeeds.length) : null,
+    averageTpsTurns: turnSpeeds.length,
     toolMs: state.toolMs,
     averageFirstTokenMs: state.ttftSamples > 0 ? Math.round(state.ttftTotalMs / state.ttftSamples) : null,
     contextUsedTokens: contextUsed,

package/features/session-status/src/session-status.mjs

@@ -4,7 +4,7 @@ const STYLE_ID = "minecodex-session-status-style";
 const copyByLocale = { "zh-CN": {
   turns: "回合", steps: "步", speed: "TPS", cache: "缓存", cacheDetail: "缓存命中",
   statistics: "会话统计", usage: "Token 用量", context: "上下文详情", total: "总量",
-  firstToken: "平均首字延迟", input: "输入", cached: "缓存输入", output: "输出",
+  firstToken: "平均首字延迟", averageSpeed: "平均 TPS", input: "输入", cached: "缓存输入", output: "输出",
   sum: "合计", capacity: "窗口容量", contextShare: "上下文占用", compactions: "压缩次数",
   instructions: "指令", messages: "消息", toolHistory: "工具交互", other: "未分类",
   speedHelp: "关于 TPS", speedInfo: "根据会话日志估算生成速度，包含推理输出。",
@@ -15,7 +15,7 @@ const copyByLocale = { "zh-CN": {
 }, en: {
   turns: "turns", steps: "steps", speed: "TPS", cache: "Cache", cacheDetail: "Cache hit",
   statistics: "Session stats", usage: "Token usage", context: "Context", total: "Total",
-  firstToken: "Avg first token", input: "Input", cached: "Cached input", output: "Output",
+  firstToken: "Avg first token", averageSpeed: "Avg TPS", input: "Input", cached: "Cached input", output: "Output",
   sum: "Sum", capacity: "Window size", contextShare: "Context used", compactions: "Compactions",
   instructions: "Instructions", messages: "Messages", toolHistory: "Tool activity", other: "Unclassified",
   speedHelp: "About TPS", speedInfo: "Generation speed estimated from session logs, including reasoning output.",
@@ -377,6 +377,7 @@ function showPanel(kind) {
     row(dl, copy.turns, number(snapshot.turns));
     row(dl, copy.steps, number(snapshot.steps));
     row(dl, copy.firstToken, duration(snapshot.averageFirstTokenMs));
+    row(dl, copy.averageSpeed, snapshot.averageTps == null ? "—" : `${number(snapshot.averageTps)} tok/s`);
     const speedLabel = row(dl, copy.speed, snapshot.observedTps == null ? "—" : `${number(snapshot.observedTps)} tok/s`);
     speedLabel.className = "tps-label";
     tpsInfo.setAttribute("aria-label", copy.speedHelp);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "2.0.27",
+  "version": "2.0.29",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -44,6 +44,10 @@
     "README.md",
     "features/usage-meter/src",
     "features/usage-meter/codex-feature.json",
+    "features/quick-chat/src",
+    "features/quick-chat/assets",
+    "features/quick-chat/vendor/lucide-LICENSE",
+    "features/quick-chat/codex-feature.json",
     "features/sidebar-focus/src",
     "features/sidebar-focus/codex-feature.json",
     "features/sidebar-focus/vendor/lucide-LICENSE",
@@ -72,14 +76,18 @@
     "apps/dashboard/transport.js",
     "packages/plugin/src",
     "packages/plugin/assets",
-    "packages/plugin/plugin.json"
+    "packages/plugin/plugin.json",
+    "features/quick-chat-repair/src",
+    "features/quick-chat-repair/assets",
+    "features/quick-chat-repair/vendor/lucide-LICENSE",
+    "features/quick-chat-repair/codex-feature.json"
   ],
   "engines": {
     "node": ">=22.5.0"
   },
   "scripts": {
     "start": "node packages/cli/bin/mcx.mjs serve",
-    "test": "node --test packages/cli/test/*.test.mjs packages/runtime-host/test/*.test.mjs features/model-slider/test/*.test.mjs features/notes/test/*.test.mjs features/images/test/*.test.mjs features/hide-upsell-banner/test/*.test.mjs features/session-status/test/*.test.mjs features/usage-meter/test/*.test.mjs apps/dashboard/test/*.test.mjs features/unread-inbox/test/*.test.mjs features/sidebar-focus/test/*.test.mjs features/sites/test/*.test.mjs packages/ui/test/*.test.mjs packages/codex-adapter/test/*.test.mjs features/markdown-reading/test/*.test.mjs features/file-navigation/test/*.test.mjs 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/quick-chat-repair/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"]);
+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", "quick-chat-repair"]);
 export const DEFAULT_CONFIG = Object.freeze({
   schemaVersion: 1,
   features: Object.freeze({
@@ -16,6 +16,8 @@ export const DEFAULT_CONFIG = Object.freeze({
     sites: true,
     "markdown-reading": true,
     "file-navigation": true,
+    "quick-chat": true,
+    "quick-chat-repair": 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", "sidebar-focus", "hide-upsell-banner"];
+const DASHBOARD_FEATURE_ORDER = ["model-slider", "notes", "usage-meter", "session-status", "markdown-reading", "file-navigation", "images", "sites", "quick-chat", "quick-chat-repair", "sidebar-focus", "hide-upsell-banner"];
 const CONTENT_TYPES = new Map([
   [".css", "text/css; charset=utf-8"],
   [".html", "text/html; charset=utf-8"],

package/packages/ui/src/foundation/surfaces.mjs

@@ -13,15 +13,16 @@ export function installSurfaces(signal, ui) {
     [data-mcx-ui-surface=popover] { box-shadow:0 0 0 var(--mcx-popover-overlay-ring-width,.5px) var(--mcx-color-border-overlay),var(--mcx-shadow-popover-overlay,var(--mcx-shadow-lg)); }
     [data-mcx-ui-surface=popover][data-mcx-ui-variant=translucent] { background:color-mix(in oklab,var(--mcx-color-surface-elevated-secondary) 90%,transparent); }
     [data-mcx-ui-surface=composer-menu] { border:var(--mcx-suggestion-menu-border-width,1px) solid var(--mcx-color-border); border-radius:var(--mcx-radius-suggestion-menu,var(--mcx-radius-2xl)); box-shadow:var(--mcx-suggestion-menu-shadow,none); }
+    [data-mcx-ui-surface=floating-panel] { box-shadow:0 0 0 .5px var(--mcx-color-border),var(--mcx-shadow-2xl); }
     [data-mcx-ui-surface=page] { border-radius:var(--mcx-radius-xl-base); background:var(--mcx-color-surface); box-shadow:none; }
     [data-mcx-ui-surface=page][data-mcx-ui-variant=transparent] { background:transparent; }
   `;
   document.head.append(style);
   signal.addEventListener("abort", () => style.remove(), { once:true });
   function surface(node, kind = "popover", { variant, opaque = true } = {}) {
-    const defaults = { dialog:"opaque", dropdown:"menu", popover:opaque ? "opaque" : "translucent", "composer-menu":"floating", page:"opaque" };
+    const defaults = { dialog:"opaque", dropdown:"menu", popover:opaque ? "opaque" : "translucent", "composer-menu":"floating", page:"opaque", "floating-panel":"opaque" };
     if (!(kind in defaults)) throw new Error(`Unknown UI surface: ${kind}`);
-    if (kind !== "dialog" && kind !== "page") ui.layer(node, "floating");
+    if (kind !== "dialog" && kind !== "page" && kind !== "floating-panel") ui.layer(node, "floating");
     node.setAttribute("data-mcx-ui-surface", kind);
     node.setAttribute("data-mcx-ui-variant", variant ?? defaults[kind]);
     return node;

package/packages/ui/src/native/tokens.mjs

@@ -96,6 +96,7 @@ export const CODEX_THEME_TOKENS = Object.freeze([
   "--radius-3xl",
   "--shadow-md",
   "--shadow-lg",
+  "--shadow-2xl",
   "--shadow-xl",
   "--color-surface",
   "--color-text-primary",