minecodex 2.0.44 → 2.0.46

package/features/model-slider/src/injection-source.mjs

@@ -1,10 +1,11 @@
 import { createModelControllerAdapter } from "./adapters/codex/controller.mjs";
 import { createModelRules } from "./domain/model-rules.mjs";
-import { installModelSlider } from "./frontend/install.mjs";
+import { installModelSlider, replaceModelSliderShell } from "./frontend/install.mjs";
 
 // 两部分均显式序列化，Renderer 不捕获 Node imports。
 export function createModelSliderInstallerSource() {
   return `function installModelSliderFeature(signal, context) {
+    const replaceModelSliderShell = ${replaceModelSliderShell.toString()};
     return (${installModelSlider.toString()})(signal, context, (${createModelRules.toString()})(), ${createModelControllerAdapter.toString()});
   }`;
 }

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

@@ -0,0 +1,15 @@
+<!-- @license lucide-static v0.468.0 - ISC; source: lucide-icons/lucide icons/x.svg -->
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M18 6 6 18" />
+  <path d="m6 6 12 12" />
+</svg>

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

@@ -15,7 +15,8 @@
     "script": "src/frontend/entry.mjs",
     "sourceFactory": "src/injection-source.mjs",
     "resources": {
-      "history": "assets/history.svg"
+      "history": "assets/history.svg",
+      "close": "assets/close.svg"
     }
   },
   "icon": {

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

@@ -0,0 +1,27 @@
+// 从原生“丢弃 Quick Chat”动作中仅取关闭和草稿清理；不调用会话销毁，保留后台生成。
+export function quickChatLifecycleActions(source) {
+  const match = source.match(/let ([\w$]+)=([\w$]+)\.get\(([\w$]+)\);([\w$]+)\(\2\),\2\.set\(\3,null\),\1!=null&&\(([\w$]+)\(\2,\{draftKey:\1\.conversationId,content:null\}\),([\w$]+)\(\2,\1\.conversationId,[`"'][`"']\),\2\.set\(([\w$]+),\1\.conversationId,\[\]\)/);
+  if (!match) throw new Error('quick-chat-close-contract-unavailable');
+  const exports = source.slice(source.lastIndexOf('export{'));
+  const exported = local => {
+    const escaped = local.replace(/[.*+?^${}()|[\]\\]/g,'\\$&');
+    const name = exports.match(new RegExp(`(?:\\{|,)${escaped} as ([\\w$]+)(?:,|\\})`))?.[1];
+    if (!name) throw new Error('quick-chat-close-export-unavailable');
+    return name;
+  };
+  const roles = {session:exported(match[3]),close:exported(match[4]),draft:exported(match[5]),text:exported(match[6]),attachments:exported(match[7])};
+  const mode = source.match(/([\w$]+)=[\w$]+\([\w$]+,\(\{get:[\w$]+\}\)=>\{[\s\S]{0,700}?conversationDetailMode[\s\S]{0,700}?[`"']STEPS_PROSE[`"'][^{}]*\?[`"']work[`"']:[`"']codex[`"']/)?.[1];
+  if (mode) roles.mode=exported(mode);
+  return roles;
+}
+
+export function quickChatScope(codex, element) {
+  for (let fiber=codex.currentFiber(element),depth=0;fiber && depth++<200;fiber=fiber.return) {
+    const values=[];
+    for (let hook=fiber.memoizedState,count=0;hook && count++<150;hook=hook.next) values.push(hook.memoizedState?.current);
+    for (const row of fiber.updateQueue?.memoCache?.data ?? []) values.push(...row);
+    const scope=values.find(value=>typeof value?.get==='function' && typeof value.set==='function' && value.scope?.__scopeBrand==='AppScope');
+    if (scope) return scope;
+  }
+  return null;
+}

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

@@ -18,10 +18,14 @@ export function createQuickChatAdapter(codex) {
     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 expanded = Boolean(floating.presentation === "expanded" || floating.forceExpanded);
     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'));
+      const props = codex.props(button, props => (props.standalone === true || expanded) && typeof props.onMinimize === "function" && typeof props.isCompact === "boolean"
+        && Object.keys(props).every(key => ["standalone","isCompact","onMinimize"].includes(key)), 5);
+      return Boolean(props && button.checkVisibility({visibilityProperty:true}) && !button.hasAttribute('data-mcx-quick-chat-history') && !button.hasAttribute('data-mcx-quick-chat-close'));
     });
+    const drag = expanded && [...surface.querySelectorAll('header button[data-quick-chat-drag-handle]')]
+      .find(button => button.checkVisibility({visibilityProperty:true}));
     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;
@@ -41,13 +45,12 @@ export function createQuickChatAdapter(codex) {
     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);
     const emitter = controller?.eventEmitter;
     const subscribable = typeof emitter?.addListener === "function" && typeof emitter?.removeListener === "function";
     if (subscribable && !subscriptions.has(emitter)) subscriptions.set(emitter, nextSubscription++);
-    const snapshot = {surface, editable, minimize, projectRail, background:!session.hasConversation && floating.forceExpanded ? background : null, sessionId:session.conversationId, hasConversation:session.hasConversation,
+    const snapshot = {surface, editable, minimize, closeAnchor:drag || 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, subscriptionId:subscribable ? subscriptions.get(emitter) : 0,
-      expanded, showHistory:Boolean(minimize && !expanded), historyVisible:quickChatHistoryVisible(floating.renderTranscript?.()),
+      expanded, standalone:Boolean(minimize && codex.props(minimize,props=>props.standalone===true,5)), showHistory:Boolean(minimize && !expanded), showClose:Boolean(minimize && expanded), historyVisible:quickChatHistoryVisible(floating.renderTranscript?.()),
       expand:() => floating.onPresentationChange("expanded"),
       // 历史动作通过 forceExpanded 临时展开；不要覆盖最小化后的恢复形态。
       history:() => history.onSelect()};

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

@@ -1,3 +1,4 @@
+import {quickChatLifecycleActions, quickChatScope} from "./lifecycle.mjs";
 // 通过原生能力检查与已有会话分支定位打开动作，不依赖构建哈希或压缩名称。
 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\(/);
@@ -83,13 +84,13 @@ export function installQuickChatShortcut(signal, codex, discover = null) {
       const picker = codex.props(button, p => typeof p.onModeSelect === 'function' && typeof p.mode === 'string', 80);
       // 原生 ChatGPT 也使用 work 路由，具体产品由 workModeAccess 区分。
       if (picker?.mode !== 'codex' && !(picker?.mode === 'work' && picker.workModeAccess === 'chatgpt')) 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;
-      }
+      const scope=quickChatScope(codex,button);
+      if (scope) return scope;
+    }
+    // 侧栏可能卸载；从仍挂载的窗口内容取当前 scope，模式由原生状态判定。
+    if (bindings?.mode) for (const anchor of document.querySelectorAll('[data-app-navigation-rail], [data-codex-composer-root], [data-chatgpt-composer], main, #root > *, #app > *')) {
+      const scope=quickChatScope(codex,anchor);
+      if (scope && bindings.mode(scope)==='codex') return scope;
     }
     return null;
   }
@@ -120,12 +121,29 @@ export function installQuickChatShortcut(signal, codex, discover = null) {
       if (!response.ok) throw error;
       native=quickChatNativeCommand(await response.text());
     }
-    if (native) return {native:true};
-    const roles = quickChatLifecycleExports(source);
-    if (!module[roles.openState] && typeof module[roles.initialize] === 'function') module[roles.initialize]();
-    const open = module[roles.open], create = module[roles.create], openState = module[roles.openState];
-    if (typeof open !== 'function' || typeof create !== 'function' || !openState) throw new Error('quick-chat-open-action-unavailable');
-    return {native:false, open, create, isOpen:scope => scope.get(openState)};
+    const bindings={native};
+    if (!native) {
+      const roles = quickChatLifecycleExports(source);
+      if (!module[roles.openState] && typeof module[roles.initialize] === 'function') module[roles.initialize]();
+      const open = module[roles.open], create = module[roles.create], openState = module[roles.openState];
+      if (typeof open !== 'function' || typeof create !== 'function' || !openState) throw new Error('quick-chat-open-action-unavailable');
+      Object.assign(bindings,{open,create,isOpen:scope=>scope.get(openState)});
+    }
+    try {
+      const actions=quickChatLifecycleActions(source);
+      if (actions.mode && module[actions.mode]) bindings.mode=scope=>scope.get(module[actions.mode]);
+      if (['close','draft','text'].every(key=>typeof module[actions[key]]==='function') && module[actions.session] && module[actions.attachments]) {
+        bindings.close=(scope,id)=>{
+          if (scope.get(module[actions.session])?.conversationId!==id) return false;
+          module[actions.draft](scope,{draftKey:id,content:null});
+          module[actions.text](scope,id,'');
+          scope.set(module[actions.attachments],id,[]);
+          module[actions.close](scope);
+          return true;
+        };
+      }
+    } catch { codex.report('quick-chat-close',false,'quick-chat-close-contract-unavailable'); }
+    return bindings;
   }
   const ready = (discover ?? load)().then(value => {
     if (disposed || signal.aborted) return;
@@ -146,6 +164,12 @@ export function installQuickChatShortcut(signal, codex, discover = null) {
     }
     return true;
   }
+  function close(surface,id) {
+    const scope=quickChatScope(codex,surface);
+    if (!scope || !bindings?.close || disposed || signal.aborted) return false;
+    pendingFocus=null;
+    return bindings.close(scope,id);
+  }
   function keydown(event) {
     const primaryModifier = windows ? event.ctrlKey && !event.metaKey : event.metaKey && !event.ctrlKey;
     if (event.defaultPrevented || event.repeat || event.isComposing
@@ -156,5 +180,5 @@ export function installQuickChatShortcut(signal, codex, discover = null) {
   document.addEventListener('keydown', keydown, {signal});
   function dispose() { disposed = true; stopWaiting?.(); document.removeEventListener('keydown', keydown); bindings = null; pendingFocus=null; }
   signal.addEventListener('abort', dispose, {once:true});
-  return {ready, dispose, sync:focusNew, activate, available:() => Boolean(bindings && !bindings.native && !disposed && !signal.aborted)};
+  return {ready, dispose, sync:focusNew, activate, close, canClose:() => Boolean(bindings?.close && !disposed && !signal.aborted), available:() => Boolean(bindings && !bindings.native && !disposed && !signal.aborted)};
 }

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

@@ -6,13 +6,17 @@ 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-history],[data-mcx-quick-chat-close]{margin-inline-end:8px;flex-shrink:0}
+  [data-mcx-quick-chat-history]>svg,[data-mcx-quick-chat-close]>svg{width:16px;height:16px}
+  [data-mcx-quick-chat-close]{margin-inline-end:0}
   [data-mcx-quick-chat-minimize]{border-radius:calc(infinity * 1px)}
+  /* 单行输入沿用控件中线，消除原生编辑区换行布局留下的底部间距。 */
+  [data-mcx-quick-chat-compact] [data-composer-input]:has(>[data-composer-input-layout="single-line"]){margin-block:0;align-self:center}
+  [data-mcx-quick-chat-compact] [data-composer-input-layout="single-line"]{margin-block:0;align-self:center}
   [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}
+  [data-floating-chat-surface]>:has(>[data-mcx-quick-chat-history],>[data-mcx-quick-chat-close]){display:flex;align-items:center}
 `;
 document.head.append(style);
 function releaseBackground(instance) {
@@ -21,7 +25,7 @@ function releaseBackground(instance) {
   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 remove(instance) { instance.surface?.removeAttribute('data-mcx-quick-chat-compact'); 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;
   shortcut.sync();
@@ -32,13 +36,14 @@ function sync() {
     const selected = instance?.historyTracker.selected(snapshot);
     if (!instance || instance.sessionId !== snapshot.sessionId || instance.subscriptionId !== snapshot.subscriptionId) {
       if (instance) remove(instance);
-      instance = {sessionId:snapshot.sessionId, subscriptionId:snapshot.subscriptionId, tracker:createSubmissionTracker(), historyTracker:createHistoryTracker(), button:null};
+      instance = {surface:snapshot.surface, sessionId:snapshot.sessionId, subscriptionId:snapshot.subscriptionId, 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);
+    snapshot.surface.toggleAttribute('data-mcx-quick-chat-compact', !snapshot.expanded);
     if (instance.projectRail !== snapshot.projectRail) {
       releaseProjectRail(instance);
       instance.projectRail = snapshot.projectRail;
@@ -54,25 +59,34 @@ function sync() {
     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 (snapshot.standalone) 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) {
+    const kind=snapshot.showHistory ? 'history' : snapshot.showClose && shortcut.canClose() ? 'close' : null;
+    const anchor=kind==='close' ? snapshot.closeAnchor : minimize;
+    if (!minimize || !anchor || !kind) { instance.button?.remove(); instance.button = null; continue; }
+    if (!instance.button?.isConnected || instance.button.parentElement !== anchor.parentElement || instance.button.nextElementSibling!==anchor || instance.buttonKind!==kind) {
       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;
+      button.setAttribute(`data-mcx-quick-chat-${kind}`, '');
+      button.innerHTML = config.resources[kind];
       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;
+      button.addEventListener('pointerdown', event => {event.preventDefault();event.stopPropagation();}, {signal});
+      button.addEventListener('click', event => {
+        event.preventDefault(); event.stopPropagation();
+        instance.tracker.clear(); instance.historyTracker.clear();
+        const current=native.read(snapshot.surface);
+        if (!current || current.sessionId!==instance.sessionId) return;
+        if (kind==='history') current.history();
+        else if (!shortcut.close(snapshot.surface,current.sessionId)) config.codex.report('quick-chat-close',false,'quick-chat-close-action-unavailable');
+      }, {signal});
+      anchor.before(button); instance.button = button; instance.buttonKind=kind;
     }
     if (instance.button.className !== minimize.className) instance.button.className = minimize.className;
-    const label = text('Chat history', '聊天历史');
+    const label = kind==='history' ? text('Chat history', '聊天历史') : text('Close Quick Chat', '关闭快捷聊天');
     if (instance.button.getAttribute('aria-label') !== label) {
       instance.button.setAttribute('aria-label',label); instance.button.setAttribute('data-minecodex-tooltip',label);
     }
@@ -91,14 +105,15 @@ 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();
+void shortcut.ready.then(schedule);
 config.registerSelfCheck?.(() => {
-  const snapshots = native.surfaces(), anchors = snapshots.filter(item => item.showHistory);
-  const history = anchors.some(item => instances.get(item.surface)?.button?.isConnected), entry = sidebar.status();
+  const snapshots = native.surfaces(), anchors = snapshots.filter(item => item.showHistory || item.showClose);
+  const controls = anchors.every(item => instances.get(item.surface)?.button?.isConnected), entry = sidebar.status();
   const applicable = anchors.length > 0 || entry.applicable;
-  const available = (!anchors.length || history) && (!entry.applicable || entry.available);
+  const available = (!anchors.length || controls) && (!entry.applicable || entry.available);
   return {state:applicable ? available ? 'available' : 'unavailable' : 'not-applicable',
     reason:applicable ? available ? null : 'quick-chat-controls-unavailable' : 'no-classic-quick-chat-floating-controls',
-    checks:[...(anchors.length ? [{name:'quick-chat-history',available:history}] : []), ...(entry.applicable ? [{name:'quick-chat-sidebar-entry',available:entry.available}] : [])],
+    checks:[...(anchors.length ? [{name:'quick-chat-controls',available:controls}] : []), ...(entry.applicable ? [{name:'quick-chat-sidebar-entry',available:entry.available}] : [])],
     scopes:snapshots.map(item=>({name:'quick-chat',element:item.surface}))};
 });
 return () => { disposed = true; shortcut.dispose(); sidebar.dispose(); observer.disconnect(); for (const instance of instances.values()) remove(instance); instances.clear(); style.remove(); };

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

@@ -1,3 +1,4 @@
+import {quickChatLifecycleActions, quickChatScope} from "./adapters/codex/lifecycle.mjs";
 import {quickChatHistoryVisible} from "./adapters/codex/history.mjs";
 import { readFile } from "node:fs/promises";
 import { createQuickChatAdapter } from "./adapters/codex/renderer.mjs";
@@ -9,7 +10,7 @@ import { createHistoryTracker } from "./domain/history.mjs";
 export async function createPageScriptSource() {
   const source = await readFile(new URL("./frontend/entry.mjs", import.meta.url), "utf8");
   const functions = [quickChatHistoryVisible, loadQuickChatSidebarIcon, createQuickChatSidebarAdapter, installQuickChatSidebar,
-    quickChatOpenExport, quickChatLifecycleExports, quickChatNativeCommand, installQuickChatShortcut, createQuickChatAdapter,
+    quickChatLifecycleActions, quickChatScope, quickChatOpenExport, quickChatLifecycleExports, quickChatNativeCommand, installQuickChatShortcut, createQuickChatAdapter,
     createSubmissionTracker, createHistoryTracker];
   return functions.map(fn => `const ${fn.name}=${fn.toString()};`).join('\n') + '\n' + source;
 }

package/features/usage-meter/src/adapters/codex/renderer.mjs

@@ -44,6 +44,13 @@ function findAvatar(rail) {
     ?? buttons.findLast(button => button.querySelector('img[alt], img[src], [data-avatar]'))
     ?? null;
 }
+function findUsage(rail) {
+  // 原生图表的轨道 token 是语义锚点，避免依赖构建生成的 class 或界面语言。
+  return [...(rail?.querySelectorAll("button") ?? [])].find(button =>
+    !button.hasAttribute?.("data-minecodex-usage-meter") &&
+    (button.querySelector?.('[stroke="var(--color-usage-meter-track)"]') ||
+      /^(Usage|用量|使用量|使用情况|使用情況)$/.test(button.getAttribute("aria-label") ?? ""))) ?? null;
+}
 function avatarAnchor(avatar, rail) {
   // 头像内部是横向行；在最近的原生纵向容器中插入独立一项。
   let anchor = avatar;
@@ -58,13 +65,16 @@ function avatarAnchor(avatar, rail) {
       unsubscribe?.(); client=context.client;
       unsubscribe=client?.getQueryCache().subscribe(event=>{ if (event.query?.queryKey?.[0] === "rate-limit-status") invalidate(); });
     }
-    const windows=currentWindows(context), avatar=findAvatar(rail);
-    const available=Boolean(avatar && context.router && windows);
+    const windows=currentWindows(context), avatar=findAvatar(rail), usage=findUsage(rail);
+    const available=Boolean((usage || avatar) && context.router && windows);
     codex.report("usage-meter",available,available ? null : "account-quota-or-anchor-unavailable");
-    return { rail,avatar,windows,available,anchorAvailable:Boolean(avatar && context.router),
+    return { rail,avatar,usage,windows,available,anchorAvailable:Boolean((usage || avatar) && context.router),
       applicable:context.auth?.isLoading ? null : context.auth ? ["chatgpt","chatgptAuthTokens"].includes(context.auth.authMethod) : null };
   }
   function open(rail) { const {router}=nativeContext(rail); return router?.navigate("/settings/usage?tab=overview",{state:router.state?.location?.state}); }
   signal.addEventListener("abort",()=>unsubscribe?.(),{once:true});
-  return { read,open,anchor:avatarAnchor };
+  return { read,open,anchor:avatarAnchor,
+    conceal: usage => usage?.setAttribute("data-minecodex-native-usage", ""),
+    reveal: usage => usage?.removeAttribute("data-minecodex-native-usage") };
+
 }

package/features/usage-meter/src/usage-meter.mjs

@@ -17,9 +17,10 @@ let hoverTimer = null;
 const style = document.createElement("style");
 style.id = STYLE_ID;
 style.textContent = `
-[${MARKER}] { position:relative; display:flex; align-items:center; justify-content:center; flex:none; color:var(--mcx-color-text-tertiary); -webkit-app-region:no-drag; }
+[${MARKER}] { position:relative; display:flex; align-items:center; justify-content:center; flex:none; color:var(--mcx-color-usage-meter-fill,var(--mcx-color-text-tertiary)); -webkit-app-region:no-drag; }
+[data-minecodex-native-usage] { display:none !important; }
 [${MARKER}] .mcx-usage-ring { display:block; width:24px; height:24px; overflow:visible; }
-[${MARKER}] .mcx-usage-number { position:absolute; inset:0; display:flex; align-items:center; justify-content:center; color:inherit; font-family:var(--mcx-font-sans-default); font-size:calc(var(--mcx-text-xs) * 2 / 3); line-height:1; font-weight:var(--font-weight-medium,500); letter-spacing:0; font-variant-numeric:tabular-nums; pointer-events:none; }
+[${MARKER}] .mcx-usage-number { position:absolute; inset:0; display:flex; align-items:center; justify-content:center; color:var(--mcx-color-usage-meter-fill,var(--mcx-color-text-tertiary)); font-family:var(--mcx-font-sans-default); font-size:calc(var(--mcx-text-xs) * 2 / 3); line-height:1; font-weight:var(--font-weight-medium,500); letter-spacing:0; font-variant-numeric:tabular-nums; pointer-events:none; }
 #${TIP_ID} { width:max-content; max-width:calc(100vw - 16px); }
 #${TIP_ID}[hidden] { display:none; }
 #${TIP_ID} dl { display:grid; grid-template-columns:auto auto; gap:2px 16px; margin:0; }
@@ -31,13 +32,14 @@ style.textContent = `
 document.head.append(style);
 
 function svgNode(name, attributes) {
+  if (name === "path" || name === "circle") attributes = { ...attributes, "vector-effect": "non-scaling-stroke" };
   const node = document.createElementNS("http://www.w3.org/2000/svg", name);
   for (const [key, value] of Object.entries(attributes)) node.setAttribute(key, String(value));
   return node;
 }
 
 function quotaArc(start, end, clockwise) {
-  const radius = 43 / 3;
+  const radius = 44 / 3;
   const point = angle => {
     const radians = (angle - 90) * Math.PI / 180;
     return [16 + radius * Math.cos(radians), 16 + radius * Math.sin(radians)];
@@ -52,8 +54,8 @@ function draw(windows) {
   if (windows.fiveHour != null) {
     // 左下、右下各留 24° 圆头中心间距；两段都从左下切口扣减。
     for (const [key, start, end, clockwise] of [["fiveHour", 237, 483, true], ["weekly", 213, 147, false]]) {
-      const group = svgNode("g", { "data-window": key, fill: "none", stroke: "currentColor", "stroke-width": 10 / 3, "stroke-linecap": "round" });
-      group.append(svgNode("path", { d: quotaArc(start, end, clockwise), opacity: 0.18 }));
+      const group = svgNode("g", { "data-window": key, fill: "none", stroke: "currentColor", "stroke-width": 2, "stroke-linecap": "round" });
+      group.append(svgNode("path", { d: quotaArc(start, end, clockwise), stroke: "var(--mcx-color-usage-meter-track,color-mix(in srgb,currentColor 18%,transparent))" }));
       if (windows[key] > 0) {
         const remainingStart = start + (end - start) * (1 - windows[key] / 100);
         group.append(svgNode("path", { d: quotaArc(remainingStart, end, clockwise) }));
@@ -61,9 +63,9 @@ function draw(windows) {
       svg.append(group);
     }
   } else {
-    const key = "weekly", radius = 43 / 3;
-    const group = svgNode("g", { "data-window": key, fill: "none", stroke: "currentColor", "stroke-width": 10 / 3 });
-    group.append(svgNode("circle", { cx: 16, cy: 16, r: radius, opacity: 0.18 }));
+    const key = "weekly", radius = 44 / 3;
+    const group = svgNode("g", { "data-window": key, fill: "none", stroke: "currentColor", "stroke-width": 2 });
+    group.append(svgNode("circle", { cx: 16, cy: 16, r: radius, stroke: "var(--mcx-color-usage-meter-track,color-mix(in srgb,currentColor 18%,transparent))" }));
     if (windows[key] > 0) group.append(svgNode("circle", {
       cx: 16, cy: 16, r: radius, pathLength: 100,
       "stroke-dasharray": `${windows[key]} 100`, "stroke-linecap": "round", transform: "rotate(-90 16 16)",
@@ -127,6 +129,7 @@ function hideTooltip() {
 }
 function removeControl() {
   hideTooltip();
+  nativeUsage.reveal(record?.usage);
   record?.button.remove();
   record?.tooltip.remove();
   record = null;
@@ -136,21 +139,23 @@ function removeControl() {
 
 
 
-function mount(avatar, rail) {
-  // 克隆 Avatar 热区的外观，不携带原生账号菜单行为。
-  const button = avatar.cloneNode(false);
+function mount(avatar, rail, usage) {
+  // 复用原生 Usage 热区；旧版宿主才使用 Avatar 模板。
+  const button = (usage || avatar).cloneNode(false);
   for (const attribute of [...button.attributes]) {
-    if (attribute.name.startsWith("aria-") || ["id", "title", "data-state", "data-sidebar-destination", "data-testid"].includes(attribute.name)) button.removeAttribute(attribute.name);
+    if (attribute.name.startsWith("aria-") || ["id", "title", "data-state", "data-sidebar-destination", "data-testid", "data-minecodex-native-usage"].includes(attribute.name)) button.removeAttribute(attribute.name);
   }
   button.setAttribute(MARKER, "");
+  config.ui.theme.bindScope(button, ["--color-usage-meter-fill", "--color-usage-meter-track"]);
   const tooltip = document.createElement("div");
   tooltip.id = TIP_ID;
   config.ui.tooltipSurface(tooltip);
   tooltip.setAttribute("role", "tooltip");
   tooltip.hidden = true;
-  nativeUsage.anchor(avatar, rail).before(button);
+  (usage || nativeUsage.anchor(avatar, rail)).before(button);
+  nativeUsage.conceal(usage);
   document.body.append(tooltip);
-  record = { button, tooltip, rail, avatar, signature: null };
+  record = { button, tooltip, rail, avatar, usage, signature: null };
   button.addEventListener("pointerenter", () => { hoverTimer = setTimeout(showTooltip, 350); });
   button.addEventListener("pointerleave", hideTooltip);
   button.addEventListener("focus", showTooltip);
@@ -165,10 +170,10 @@ function mount(avatar, rail) {
 function sync() {
   queued = false;
   if (signal.aborted) return;
-  const { rail,avatar,windows,available } = nativeUsage.read();
+  const { rail,avatar,usage,windows,available } = nativeUsage.read();
   if (!available) { removeControl(); return; }
-  if (record?.avatar !== avatar || !record?.button.isConnected) { removeControl(); mount(avatar, rail); }
-  else if (record.button.nextElementSibling !== nativeUsage.anchor(avatar, rail)) nativeUsage.anchor(avatar, rail).before(record.button);
+  if (record?.avatar !== avatar || record?.usage !== usage || !record?.button.isConnected) { removeControl(); mount(avatar, rail, usage); }
+  else if (record.button.nextElementSibling !== (usage || nativeUsage.anchor(avatar, rail))) (usage || nativeUsage.anchor(avatar, rail)).before(record.button);
   const signature = JSON.stringify(windows);
   if (record.signature !== signature) { record.signature = signature; draw(windows); }
 }
@@ -196,8 +201,8 @@ config.registerSelfCheck?.(() => {
   const snapshot=nativeUsage.read();
   const available=Boolean(snapshot.available && record?.button.isConnected);
   return {state:available ? "available" : snapshot.applicable === false ? "not-applicable" : !snapshot.anchorAvailable && snapshot.rail ? "unavailable" : "unknown",reason:available ? null : "quota-data-or-anchor-unavailable",
-    checks:[{name:"account-anchor",available:Boolean(snapshot.avatar)},{name:"account-quota",available:Boolean(snapshot.windows)},{name:"usage-meter-mount",available:Boolean(record?.button.isConnected)}],
-    scopes:[{name:"account",element:snapshot.avatar}]};
+    checks:[{name:"usage-anchor",available:Boolean(snapshot.usage || snapshot.avatar)},{name:"account-quota",available:Boolean(snapshot.windows)},{name:"usage-meter-mount",available:Boolean(record?.button.isConnected)}],
+    scopes:[{name:"account",element:snapshot.usage || snapshot.avatar}]};
 });
 
 return cleanup;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "2.0.44",
+  "version": "2.0.46",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -30,8 +30,6 @@
     "features/images/src",
     "features/images/web",
     "features/images/codex-feature.json",
-    "features/hide-upsell-banner/src",
-    "features/hide-upsell-banner/codex-feature.json",
     "features/session-status/src",
     "features/session-status/codex-feature.json",
     "features/session-status/vendor/lucide-LICENSE",
@@ -73,6 +71,10 @@
     "features/markdown-reading/codex-feature.json",
     "features/markdown-reading/vendor/lucide-LICENSE",
     "features/markdown-reading/assets",
+    "features/files-auto-refresh/src",
+    "features/files-auto-refresh/codex-feature.json",
+    "features/files-auto-refresh/assets",
+    "features/files-auto-refresh/vendor/lucide-LICENSE",
     "features/file-navigation/src",
     "features/file-navigation/codex-feature.json",
     "features/file-navigation/assets",
@@ -94,7 +96,7 @@
   },
   "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/quick-chat/test/*.test.mjs features/composer-expand/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/mermaid-diagrams/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/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/composer-expand/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 features/files-auto-refresh/test/*.test.mjs packages/plugin/test/*.test.mjs features/mermaid-diagrams/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,14 +2,13 @@ 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", "mermaid-diagrams", "file-navigation", "quick-chat", "composer-expand"]);
+export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images", "session-status", "usage-meter", "sidebar-focus", "sites", "markdown-reading", "mermaid-diagrams", "file-navigation", "files-auto-refresh", "quick-chat", "composer-expand"]);
 export const DEFAULT_CONFIG = Object.freeze({
   schemaVersion: 1,
   features: Object.freeze({
     "model-slider": true,
     notes: true,
     images: true,
-    "hide-upsell-banner": true,
     "session-status": true,
     "usage-meter": true,
     "sidebar-focus": true,
@@ -17,6 +16,7 @@ export const DEFAULT_CONFIG = Object.freeze({
     "markdown-reading": true,
     "mermaid-diagrams": false,
     "file-navigation": true,
+    "files-auto-refresh": true,
     "quick-chat": true,
     "composer-expand": true,
   }),
@@ -44,6 +44,8 @@ export function normalizeConfig(value = {}) {
   };
   // 暂停的 Task 通知不继承旧配置，也不再提供开启入口。
   delete features["unread-inbox"];
+  // 已移除的额度推广隐藏功能不继承旧启用项。
+  delete features["hide-upsell-banner"];
   // 清理已退役的独立 Quick Chat 修复开关。
   delete features["quick-chat-repair"];
   return {

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", "mermaid-diagrams", "file-navigation", "images", "sites", "quick-chat", "composer-expand", "sidebar-focus", "hide-upsell-banner"];
+const DASHBOARD_FEATURE_ORDER = ["model-slider", "notes", "usage-meter", "session-status", "markdown-reading", "mermaid-diagrams", "file-navigation", "files-auto-refresh", "images", "sites", "quick-chat", "composer-expand", "sidebar-focus"];
 const CONTENT_TYPES = new Map([
   [".css", "text/css; charset=utf-8"],
   [".html", "text/html; charset=utf-8"],

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

@@ -102,6 +102,8 @@ export const CODEX_THEME_TOKENS = Object.freeze([
   "--color-text-primary",
   "--color-text-secondary",
   "--color-text-tertiary",
+  "--color-usage-meter-fill",
+  "--color-usage-meter-track",
   "--color-border-overlay",
   "--color-ring",
   "--color-dialog-overlay",

package/features/hide-upsell-banner/codex-feature.json

@@ -1,24 +0,0 @@
-{
-  "schemaVersion": 1,
-  "id": "hide-upsell-banner",
-  "version": "0.1.11",
-  "label": {
-    "en": "Hide Usage Promotions",
-    "zh-CN": "隐藏额度推广"
-  },
-  "description": {
-    "en": "Hide plan upgrade banners above the message box for a cleaner chat.",
-    "zh-CN": "隐藏输入框上方的套餐升级推广，让对话更清爽。"
-  },
-  "entry": {
-    "kind": "page-script",
-    "script": "src/hide-upsell-banner.mjs"
-  },
-  "icon": {
-    "viewBox": "0 0 24 24",
-    "markup": "<rect width=\"18\" height=\"12\" x=\"3\" y=\"6\" rx=\"2.5\"></rect><path d=\"m5 5 14 14\"></path>"
-  },
-  "placement": {
-    "order": 40
-  }
-}