minecodex 2.0.45 → 2.0.46

package/apps/dashboard/assets/preview-content.js

@@ -21,6 +21,9 @@ const content = {
   'file-navigation': [
     ['Codex 文件预览上方的路径区域。', '浏览相邻目录和文件需要额外跳转。', '点击路径展开分列目录，逐级浏览并打开另一个文件。'],
     ['The path above a file preview in Codex.', 'Browsing nearby files and folders takes extra navigation.', 'Open the path to browse cascading folder columns and choose another file.']],
+  'files-auto-refresh': [
+    ['Codex Side Panel 的 Files 目录列表。', 'Agent 改变项目文件后，需要反复收起、展开才能看到新列表。', '保持 Files 打开，自动同步根目录和已展开目录；保留当前文件与浏览位置。'],
+    ['The Files tree in the Codex side panel.', 'File changes can require collapsing and reopening the tree.', 'Keep Files open to refresh the root and expanded folders while preserving the current file and browsing position.']],
   images: [
     ['Codex Library 的图片集合与图片查看器。', '查找图片及其提示词需要来回切换。', '浏览图片集合，打开图片查看大图及可追溯的提示词信息。'],
     ['Image collections in Codex Library and the image viewer.', 'Finding images and their prompts requires switching views.', 'Browse collections, open an image, and inspect available prompt provenance.']],

package/features/files-auto-refresh/assets/folder-sync.svg

@@ -0,0 +1,7 @@
+<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="M9 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v.5" />
+  <path d="M12 10v4h4" />
+  <path d="m12 14 1.535-1.605a5 5 0 0 1 8 1.5" />
+  <path d="M22 22v-4h-4" />
+  <path d="m22 18-1.535 1.605a5 5 0 0 1-8-1.5" />
+</svg>

package/features/files-auto-refresh/codex-feature.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "id": "files-auto-refresh",
+  "version": "0.1.0",
+  "label": { "en": "Files Auto Refresh", "zh-CN": "Files 自动刷新" },
+  "description": {
+    "en": "Keep the open Files tree up to date as files and folders are created, removed or renamed.",
+    "zh-CN": "文件或文件夹新增、删除、重命名后，自动更新打开的 Files 目录列表。"
+  },
+  "entry": {
+    "kind": "page-script",
+    "script": "src/entry.mjs",
+    "sourceFactory": "src/injection-source.mjs"
+  },
+  "icon": { "resource": "assets/folder-sync.svg" },
+  "placement": { "order": 92 }
+}

package/features/files-auto-refresh/src/adapters/codex/directories.mjs

@@ -0,0 +1,75 @@
+export function createDirectoryRefreshAdapter(codex, signal = new AbortController().signal) {
+  const visible = element => element.isConnected && !element.closest('[hidden],[inert],[aria-hidden="true"]')
+    && element.checkVisibility({ visibilityProperty: true }) && element.getClientRects().length > 0;
+
+  function context(anchor) {
+    let directory = null, client = null, expanded = [];
+    codex.props(anchor, props => {
+      if (Array.isArray(props.initialExpandedPaths) && 'files' in props && 'renderTree' in props)
+        expanded = props.initialExpandedPaths;
+      if (!directory && typeof props.root === 'string' && typeof props.hostId === 'string'
+        && 'includeHidden' in props && 'renderTree' in props) directory = props;
+      for (const value of [props.value, props.client, props.queryClient, props.value?.queryClient])
+        if (!client && typeof value?.getQueryCache === 'function' && typeof value.setQueryData === 'function') client = value;
+      return Boolean(directory && client);
+    }, 360);
+    return { directory, client, expanded };
+  }
+
+  function directoryQueries(client, directory, expanded) {
+    const directories = new Set([null, ...expanded]);
+    return client.getQueryCache().getAll().filter(query => {
+      const key = query.queryKey;
+      if (key?.[0] !== 'vscode' || key[1] !== 'workspace-directory-entries' || !query.isActive()
+        || typeof query.options?.queryFn !== 'function') return false;
+      let params;
+      try { params = JSON.parse(key.at(-1)); } catch { return false; }
+      return params?.hostId === directory.hostId && params.workspaceRoot === directory.root
+        && params.includeHidden === directory.includeHidden && directories.has(params.directoryPath);
+    });
+  }
+
+  return {
+    scan() {
+      const views = [], roots = new Set();
+      // 搜索框在空目录时也存在，不能只依赖文件树节点。
+      const anchors = [...document.querySelectorAll('file-tree-container'), ...document.querySelectorAll('[id="workspace-directory-tree-search"]')];
+      for (const anchor of anchors) {
+        if (!visible(anchor)) continue;
+        const { directory, client, expanded } = context(anchor);
+        if (!directory) continue;
+        const key = JSON.stringify([directory.hostId, directory.environmentId, directory.root]);
+        if (roots.has(key)) continue;
+        roots.add(key);
+        const available = Boolean(client && directory.environmentId == null);
+        const current = () => {
+          if (signal.aborted || document.visibilityState === 'hidden' || !visible(anchor)) return false;
+          const next = context(anchor);
+          return next.client === client && next.directory?.hostId === directory.hostId
+            && next.directory?.root === directory.root && next.directory?.environmentId === directory.environmentId
+            && next.directory?.includeHidden === directory.includeHidden;
+        };
+        views.push({
+          key, anchor, available, current, boundary: anchor.closest('[data-app-shell-pane-content-viewport]'),
+          // 每轮重新取得 active queries，已收起的分支不会继续请求。
+          queries: available ? directoryQueries(client, directory, expanded).map(query => ({
+            async refresh() {
+              if (!current() || !query.isActive() || query.state.fetchStatus === 'fetching') return;
+              const path = JSON.parse(query.queryKey.at(-1)).directoryPath;
+              if (path !== null && !context(anchor).expanded.includes(path)) return;
+              const before = query.state.data, updatedAt = query.state.dataUpdatedAt;
+              // 失败不进入原生 query 的 error 状态，避免原生树用错误页替换已有列表。
+              const data = await query.options.queryFn({ client, queryKey: query.queryKey, meta: query.options.meta, signal });
+              if (!Array.isArray(data?.entries)) throw new Error('directory-refresh-response-unavailable');
+              if (!current() || !query.isActive() || query.state.fetchStatus === 'fetching'
+                || query.state.data !== before || query.state.dataUpdatedAt !== updatedAt) return;
+              if (path !== null && !context(anchor).expanded.includes(path)) return;
+              client.setQueryData(query.queryKey, data);
+            },
+          })) : [],
+        });
+      }
+      return views;
+    },
+  };
+}

package/features/files-auto-refresh/src/entry.mjs

@@ -0,0 +1,58 @@
+const reads = new AbortController();
+const adapter = createDirectoryRefreshAdapter(config.codex, reads.signal);
+const failures = new Map();
+let views = [], frame = null;
+const isVisible = () => !signal.aborted && document.visibilityState === 'visible';
+const loop = createDirectoryRefreshLoop({
+  scan() {
+    views = adapter.scan();
+    for (const [key, item] of failures) if (!views.some(view => view.key === key && view.anchor === item.anchor)) {
+      item.button.remove(); failures.delete(key);
+    }
+    return views;
+  },
+  isVisible,
+  onResult(view, failed) {
+    if (!failed) { failures.get(view.key)?.button.remove(); failures.delete(view.key); return; }
+    if (!view.boundary) return;
+    let button = failures.get(view.key)?.button;
+    if (!button) {
+      button = document.createElement('button');
+      button.type = 'button'; button.setAttribute('data-mcx-directory-refresh-retry', '');
+      button.className = 'cursor-interaction rounded-md border border-default bg-surface px-2 py-1 text-sm text-secondary';
+      button.textContent = config.locale === 'zh-CN' ? '目录尚未同步 · 重试' : 'Directory not synced · Retry';
+      button.addEventListener('click', () => { loop.pause(); loop.request(); });
+      button.style.position = 'fixed'; button.style.zIndex = '1';
+      view.boundary.append(button); failures.set(view.key, { anchor: view.anchor, button });
+    }
+    // 提示放在列表底部，不把全高目录向下挤，也不改变原生容器的定位规则。
+    const bounds = view.boundary.getBoundingClientRect();
+    button.style.left = `${bounds.left + 8}px`; button.style.maxWidth = `${Math.max(0, bounds.width - 16)}px`;
+    button.style.top = `${Math.max(bounds.top + 8, bounds.bottom - button.offsetHeight - 8)}px`;
+  },
+});
+function reconcile() {
+  frame = null;
+  if (isVisible()) loop.request(); else loop.pause();
+}
+const observer = new MutationObserver(records => {
+  if (records.every(record => record.target.closest?.('[data-mcx-directory-refresh-retry],.cm-content'))) return;
+  if (frame === null) frame = requestAnimationFrame(reconcile);
+});
+observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['hidden', 'inert', 'aria-hidden', 'class', 'style'] });
+document.addEventListener('visibilitychange', reconcile);
+config.registerSelfCheck?.(() => {
+  const current = adapter.scan();
+  return {
+    state: !current.length ? 'not-applicable' : current.every(view => view.available && view.queries.length && !failures.has(view.key)) ? 'available' : 'unavailable',
+    checks: current.map(view => ({ name: 'native-directory-query', available: view.available && view.queries.length > 0 && !failures.has(view.key) })),
+  };
+});
+function dispose() {
+  reads.abort(); loop.dispose(); observer.disconnect(); document.removeEventListener('visibilitychange', reconcile);
+  if (frame !== null) cancelAnimationFrame(frame);
+  for (const item of failures.values()) item.button.remove(); failures.clear(); views = [];
+}
+signal.addEventListener('abort', dispose, { once: true });
+reconcile();
+return dispose;

package/features/files-auto-refresh/src/injection-source.mjs

@@ -0,0 +1,8 @@
+import { readFile } from 'node:fs/promises';
+import { createDirectoryRefreshAdapter } from './adapters/codex/directories.mjs';
+import { createDirectoryRefreshLoop } from './refresh.mjs';
+
+export async function createPageScriptSource() {
+  return [createDirectoryRefreshAdapter, createDirectoryRefreshLoop].map(fn => `const ${fn.name} = ${fn.toString()};`).join('\n')
+    + '\n' + await readFile(new URL('./entry.mjs', import.meta.url), 'utf8');
+}

package/features/files-auto-refresh/src/refresh.mjs

@@ -0,0 +1,32 @@
+export function createDirectoryRefreshLoop({ scan, onResult, isVisible, schedule = setTimeout, cancel = clearTimeout, interval = 1000 }) {
+  let timer = null, running = false, disposed = false;
+  async function tick() {
+    timer = null;
+    if (disposed || !isVisible()) return;
+    running = true;
+    let views = [];
+    try {
+      views = scan();
+      for (const view of views) {
+        let failed = false;
+        // 限制并发；刷新只触达原生已订阅目录，不扫描未知子目录。
+        for (let index = 0; index < view.queries.length; index += 4) {
+          if (disposed || !isVisible() || !view.current()) break;
+          const results = await Promise.allSettled(view.queries.slice(index, index + 4).map(query => query.refresh()));
+          failed ||= results.some(result => result.status === 'rejected');
+        }
+        if (!disposed && isVisible() && view.current()) onResult(view, failed);
+      }
+    } finally {
+      running = false;
+      if (!disposed && isVisible() && views.length) timer = schedule(tick, interval);
+    }
+  }
+  return {
+    request() {
+      if (!disposed && !running && timer === null && isVisible()) timer = schedule(tick, 0);
+    },
+    pause() { if (timer !== null) cancel(timer); timer = null; },
+    dispose() { disposed = true; if (timer !== null) cancel(timer); timer = null; },
+  };
+}

package/features/files-auto-refresh/vendor/lucide-LICENSE

@@ -0,0 +1,43 @@
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+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.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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.45",
+  "version": "2.0.46",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -71,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",
@@ -92,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/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,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", "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({
@@ -16,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,
   }),

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"];
+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",