minecodex 2.0.28 → 2.0.29

package/README.md

@@ -19,7 +19,7 @@ MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。
 | **图片集合** · Image Collection | 集中浏览生成的图片，查看提示词并复用创作思路。 |
 | **站点收藏** · Saved Sites | 发现项目正在运行的网页，收藏常用网址，随时打开。 |
 | **Quick Chat 退出修复** | 修复关闭快捷聊天后透明层残留、主页面无法点击的问题；可独立开关。 |
-| **快捷聊天增强** · 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

@@ -727,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;
@@ -1008,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 = [];
@@ -1139,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)" });
@@ -1242,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";
@@ -1251,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/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

@@ -3,8 +3,8 @@
   "id": "quick-chat",
   "version": "0.1.0",
   "label": { "en": "Quick Chat", "zh-CN": "快捷聊天增强" },
-  "description": { "en": "Expand Quick Chat after sending and open native chat history before starting a conversation.", "zh-CN": "发送后自动展开 Quick Chat，尚未发送时也能打开原生聊天历史。" },
-  "entry": { "kind": "page-script", "script": "src/frontend/entry.mjs", "sourceFactory": "src/injection-source.mjs", "resources": { "history": "assets/history.svg" } },
+  "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/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/frontend/entry.mjs

@@ -1,4 +1,6 @@
 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;
@@ -22,6 +24,7 @@ function releaseProjectRail(instance) { instance.projectRail?.removeAttribute('d
 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);
@@ -89,9 +92,13 @@ 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), available = anchors.some(item => instances.get(item.surface)?.button?.isConnected);
-  return {state:anchors.length ? available ? 'available' : 'unavailable' : 'not-applicable',
-    reason:anchors.length ? available ? null : 'quick-chat-history-anchor-unavailable' : 'no-classic-quick-chat-floating-controls',
-    checks:[{name:'quick-chat-history',available}],scopes:snapshots.map(item=>({name:'quick-chat',element:item.surface}))};
+  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; observer.disconnect(); for (const instance of instances.values()) remove(instance); instances.clear(); style.remove(); };
+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

@@ -1,8 +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 createQuickChatAdapter=${createQuickChatAdapter.toString()};\nconst createSubmissionTracker=${createSubmissionTracker.toString()};\nconst createHistoryTracker=${createHistoryTracker.toString()};\n${source}`;
+  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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "2.0.28",
+  "version": "2.0.29",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",