minecodex 2.0.26 → 2.0.28

package/README.md

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

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

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

@@ -0,0 +1,10 @@
+{
+  "schemaVersion": 1,
+  "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" } },
+  "icon": { "resource": "assets/history.svg" },
+  "placement": { "order": 75 }
+}

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/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,97 @@
+const native = createQuickChatAdapter(config.codex);
+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;
+  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), 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}))};
+});
+return () => { disposed = true; observer.disconnect(); for (const instance of instances.values()) remove(instance); instances.clear(); style.remove(); };

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

@@ -0,0 +1,8 @@
+import { readFile } from "node:fs/promises";
+import { createQuickChatAdapter } from "./adapters/codex/renderer.mjs";
+import { createSubmissionTracker } from "./domain/submission.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}`;
+}

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/adapters/opencodex/usage-log.mjs

@@ -10,26 +10,16 @@ function usageRecord(row) {
     || !Number.isFinite(row.timestamp) || !Number.isFinite(row.durationMs) || row.durationMs < 0) return null;
   return { id:row.requestId, conversationId:row.conversationId, start:row.timestamp,
     end:row.timestamp+row.durationMs, duration:row.durationMs,
-    first:row.firstOutputMs, generationStart:row.genStartMs, generationEnd:row.lastOutputMs,
     usageStatus:row.usageStatus, input:row.usage?.inputTokens, cached:row.usage?.cachedInputTokens ?? 0,
     output:row.usage?.outputTokens };
 }
 
-function decodeMeasurement(record) {
+function requestMeasurement(record) {
   const unavailable = reason => ({source:"ocx",output:record.output,elapsed:null,reason});
   if (record.usageStatus === "unsupported") return unavailable("usage_unsupported");
   if (!Number.isFinite(record.output) || record.output <= 0) return unavailable("output_missing");
-  let elapsed;
-  if (Number.isFinite(record.generationStart) && Number.isFinite(record.generationEnd)) {
-    elapsed=record.generationEnd-record.generationStart;
-  } else {
-    if (record.first === undefined) return unavailable("ttft_missing");
-    if (!Number.isFinite(record.first) || record.first < 0) return unavailable("invalid_duration");
-    elapsed=record.duration-record.first;
-  }
-  if (!Number.isFinite(elapsed) || elapsed <= 0) return unavailable("invalid_duration");
-  if (elapsed < 1000) return unavailable("decode_window_too_short");
-  return {source:"ocx",output:record.output,elapsed,reason:null};
+  if (!Number.isFinite(record.duration) || record.duration <= 0) return unavailable("invalid_duration");
+  return {source:"ocx",output:record.output,elapsed:record.duration,reason:null};
 }
 
 export class OpenCodexUsageReader {
@@ -85,6 +75,6 @@ export class OpenCodexUsageReader {
       owners.set(record.id,(owners.get(record.id) ?? 0)+1);
     }
     return new Map([...candidates].filter(([,record])=>owners.get(record.id) === 1)
-      .map(([id,record])=>[id,decodeMeasurement(record)]));
+      .map(([id,record])=>[id,requestMeasurement(record)]));
   }
 }

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,39 +110,33 @@ export function applySessionStatusEvent(state, event) {
   if (state.total || state.turns.size) state.updatedAt=event.at ?? state.updatedAt;
 }
 
+function responseSpeed(sample, measurements) {
+  const measurement = measurements.get(sample?.id);
+  const source = measurement?.source ?? "codex";
+  const elapsed = measurement ? measurement.elapsed : sample?.start == null ? null
+    : sample.end - sample.start - boundedToolWaitMs(sample.tools, sample.start, sample.end, sample.outputs);
+  const valid = Boolean(sample?.turnId) && Number.isFinite(elapsed) && elapsed > 0
+    && (source === "ocx" || elapsed >= 1000);
+  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()) {
-  let decodeTokens = 0;
-  let decodeMs = 0;
-  let speedSamples = 0;
-  const turnSpeeds = new Map();
-  let unavailableSource = "codex", unavailableReason = "timing_missing";
+  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 measurement = measurements.get(sample.id);
-    const source = measurement?.source ?? "codex";
-    const elapsed = measurement ? measurement.elapsed : sample.start == null ? null
-      : sample.end - sample.start - boundedToolWaitMs(sample.tools, sample.start, sample.end, sample.outputs);
-    if (!sample.turnId) continue;
-    unavailableSource=source;
-    unavailableReason=measurement?.reason ?? (Number.isFinite(elapsed) && elapsed > 0 && elapsed < 1000
-      ? "decode_window_too_short" : "timing_missing");
-    if (!Number.isFinite(elapsed) || elapsed < 1000) continue;
-    const turn = turnSpeeds.get(sample.turnId) ?? { tokens:0, ms:0, samples:0, sources:new Set() };
-    turn.tokens += measurement?.output ?? sample.output;
-    turn.ms += elapsed;
-    turn.samples += 1;
-    turn.sources.add(source);
-    turnSpeeds.set(sample.turnId, turn);
-  }
-  // 按回合顺序取最近五个有效回合；同轮多步合并，无数据的回合不占名额。
-  const recentTurns = [...state.turns].filter(id => turnSpeeds.has(id)).slice(-5);
-  const speedSources = new Set();
-  for (const id of recentTurns) {
-    const turn = turnSpeeds.get(id);
-    decodeTokens += turn.tokens;
-    decodeMs += turn.ms;
-    speedSamples += turn.samples;
-    for (const source of turn.sources) speedSources.add(source);
+    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;
@@ -154,11 +155,13 @@ export function sessionStatusSnapshot(state, threadId, measurements = new Map())
     uncachedInputTokens: total ? Math.max(0, input - cached - cacheWrite) : null,
     outputTokens: total?.output ?? null,
     cacheHitPercent: input > 0 ? Math.round(cached / input * 100) : null,
-    observedTps: decodeMs > 0 ? Math.round(decodeTokens / (decodeMs / 1000)) : null,
-    speedSamples,
-    speedSource: speedSources.size > 1 ? "mixed" : [...speedSources][0] ?? unavailableSource,
-    speedUnavailableReason: decodeMs > 0 ? null : unavailableReason,
-    observedModelMs: decodeMs,
+    observedTps: valid ? Math.round(output / (elapsed / 1000)) : null,
+    speedSamples: valid ? 1 : 0,
+    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,24 +4,24 @@ 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: "根据会话日志估算生成速度，包含推理输出。",
-  speedInfoOcx: "根据 OCX 记录估算生成速度，包含推理输出。",
-  speedInfoMixed: "根据 OCX 记录和会话日志估算生成速度，包含推理输出。",
-  speedWindow: "取最近 5 个有有效数据的回合，不足 5 轮时按已有数据计算，仅供参考。",
+  speedInfoOcx: "根据 OCX 记录计算响应速度，包含推理输出和请求等待时间。",
+  speedWindow: "取最近一次已完成响应的数据，仅供参考。",
+  speedWindowOcx: "取最近一次请求的记录，与 OCX 的 TPS 一致。",
   speedUnavailable: "有效计时不足，暂无法估算。",
 }, 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.",
-  speedInfoOcx: "Generation speed estimated from OCX records, including reasoning output.",
-  speedInfoMixed: "Generation speed estimated from OCX records and session logs, including reasoning output.",
-  speedWindow: "Uses the latest 5 turns with valid data, or fewer when unavailable. For reference only.",
+  speedInfoOcx: "Response speed calculated from OCX records, including reasoning output and request waiting time.",
+  speedWindow: "Uses the latest completed response. For reference only.",
+  speedWindowOcx: "Uses the latest request record, matching OCX TPS.",
   speedUnavailable: "Not enough valid timing data to estimate speed.",
 } };
 function selectedCopy() {
@@ -31,8 +31,9 @@ function selectedCopy() {
 
 function speedTooltip(value, copy) {
   const source = value.speedSource === "ocx" ? copy.speedInfoOcx
-    : value.speedSource === "mixed" ? copy.speedInfoMixed : copy.speedInfo;
-  return `${source} ${value.observedTps == null ? copy.speedUnavailable : copy.speedWindow}`;
+    : copy.speedInfo;
+  const window = value.speedSource === "ocx" ? copy.speedWindowOcx : copy.speedWindow;
+  return `${source} ${value.observedTps == null ? copy.speedUnavailable : window}`;
 }
 
 // 图标来自 Lucide Static 与 Phosphor Icons；许可见 vendor/。
@@ -376,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.26",
+  "version": "2.0.28",
   "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",