minecodex 1.2.1 → 2.0.0

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

@@ -18,7 +18,6 @@ function selectedCopy() {
   const language = document.documentElement.lang || navigator.languages?.[0] || navigator.language || "en";
   return String(language).toLowerCase().startsWith("zh") ? copyByLocale["zh-CN"] : copyByLocale.en;
 }
-let copy = selectedCopy();
 
 // 图标来自 Lucide Static 与 Phosphor Icons；许可见 vendor/。
 const icons = {
@@ -30,11 +29,23 @@ document.getElementById(STYLE_ID)?.remove();
 const style = document.createElement("style");
 style.id = STYLE_ID;
 style.textContent = `
-  [${MARKER}] { box-sizing:border-box; display:flex; flex-wrap:wrap; justify-content:center; align-items:center; gap:0 12px; margin:-2px auto -6px; padding-top:2px; max-width:100%; min-height:24px; min-width:0; font-family:var(--font-sans-default,inherit); font-size:var(--text-xs,12px); line-height:16px; font-variant-numeric:tabular-nums; color:var(--color-text-tertiary); }
+  [${MARKER}] { box-sizing:border-box; display:flex; flex-wrap:wrap; justify-content:center; align-items:center; gap:0 12px; margin:0 auto; padding-top:2px; max-width:100%; min-height:24px; min-width:0; font-family:var(--font-sans-default,inherit); font-size:var(--text-xs,12px); line-height:16px; font-variant-numeric:tabular-nums; color:var(--color-text-tertiary); }
   [${MARKER}][hidden] { display:none; }
-  [${MARKER}]:not([hidden]) { animation:mcx-session-status-enter 160ms ease-out both; }
-  @keyframes mcx-session-status-enter { from { opacity:0; transform:translateY(4px); } to { opacity:1; transform:translateY(0); } }
-  @media (prefers-reduced-motion: reduce) { [${MARKER}]:not([hidden]) { animation:none; } }
+  [data-minecodex-session-reveal] { display:grid; grid-template-rows:0fr; opacity:0; transition:grid-template-rows 200ms ease,opacity 160ms ease; }
+  [data-minecodex-session-reveal][data-expanded] { grid-template-rows:1fr; opacity:1; }
+  @starting-style { [data-minecodex-session-reveal][data-expanded] { grid-template-rows:0fr; opacity:0; } }
+  [data-minecodex-session-reveal] > div { min-height:0; overflow:hidden; }
+  [data-minecodex-session-reveal]:not([data-expanded]) { pointer-events:none; }
+  [data-minecodex-session-reveal][hidden] { display:none; }
+  [data-minecodex-context-trigger] { display:inline-flex; align-items:center; justify-content:center; flex:none; width:24px; height:var(--height-token-button-composer,28px); padding:0; border:0; border-radius:var(--radius-full); background:transparent; color:var(--color-text-tertiary); cursor:pointer; }
+  [data-minecodex-context-trigger][hidden] { display:none; }
+  [data-context-progress] { transition:stroke-dashoffset 120ms ease-out; }
+  [data-minecodex-context-trigger]:hover { background:var(--color-background-primary-ghost-hover); }
+  [data-minecodex-context-trigger]:focus-visible { outline:2px solid var(--color-ring); }
+  [data-minecodex-context-trigger] svg { width:12px; height:12px; }
+  [data-minecodex-native-context] { display:none !important; }
+  [data-minecodex-context-tooltip] { position:fixed; z-index:2147483000; pointer-events:none; width:max-content; padding:5px 12px; border:1px solid var(--color-border-tooltip); border-radius:var(--radius-2xl); background:var(--color-background-tooltip); color:var(--color-text-tooltip); box-shadow:var(--shadow-tooltip); font-family:var(--font-sans-default); font-size:var(--text-sm); line-height:18px; text-align:center; white-space:pre-line; }
+  @media (prefers-reduced-motion:reduce) { [data-minecodex-session-reveal], [data-context-progress] { transition:none; } }
   [${MARKER}] button { box-sizing:border-box; display:inline-flex; align-items:center; gap:5px; height:22px; color:inherit; font:inherit; border:0; border-radius:var(--radius-xl,12px); background:transparent; padding:3px 7px; cursor:pointer; white-space:nowrap; }
   [${MARKER}] svg, [data-minecodex-session-status-panel] h3 svg { width:14px; height:14px; flex:none; stroke-width:1.75; }
   [${MARKER}] [data-kind="context"] svg, [data-minecodex-session-status-panel] h3 .context-ring { width:12px; height:12px; stroke-width:2; }
@@ -64,6 +75,33 @@ style.textContent = `
 `;
 document.head.append(style);
 
+const instances = new Map();
+const expansionKey = "minecodex:session-status:expanded";
+let globalExpanded = localStorage.getItem(expansionKey) !== "false";
+let instanceSequence = 0;
+function setGlobalExpanded(value) {
+  globalExpanded = value;
+  localStorage.setItem(expansionKey, String(value));
+  for (const instance of instances.values()) instance.setExpanded(value);
+}
+window.addEventListener("storage", (event) => {
+  if (event.key !== expansionKey) return;
+  globalExpanded = event.newValue !== "false";
+  for (const instance of instances.values()) instance.setExpanded(globalExpanded);
+}, { signal });
+// Codex 会把离屏输入框搬到 Quick Chat 浮层；节点仍连接不代表当前页面是聊天。
+function isActiveComposer(composer) {
+  const card = composer.closest('[data-codex-composer-root]');
+  return Boolean(composer.isConnected
+    && card?.getAttribute('data-composer-placement') === 'thread'
+    && !composer.closest('[hidden], [inert], [aria-hidden="true"], [data-floating-chat-surface], [data-right-panel-composer-overlay-content]')
+    && composer.checkVisibility({ visibilityProperty: true }));
+}
+function createInstance(composerElement) {
+let copy = selectedCopy();
+const controller = new AbortController();
+const signal = controller.signal;
+const instanceId = ++instanceSequence;
 const root = document.createElement("div");
 root.setAttribute(MARKER, "");
 root.hidden = true;
@@ -90,6 +128,71 @@ function createContextRing() {
   }
   return svg;
 }
+const reveal = document.createElement("div");
+reveal.dataset.minecodexSessionReveal = "";
+const clip = document.createElement("div");
+clip.append(root);
+reveal.append(clip);
+root.id = `minecodex-session-details-${instanceId}`;
+const trigger = document.createElement("button");
+trigger.type = "button";
+trigger.dataset.minecodexContextTrigger = "";
+trigger.setAttribute("aria-controls", root.id);
+trigger.append(createContextRing());
+const tooltip = document.createElement("div");
+tooltip.id = `minecodex-context-tooltip-${instanceId}`;
+tooltip.dataset.minecodexContextTooltip = "";
+tooltip.setAttribute("role", "tooltip");
+tooltip.hidden = true;
+document.body.append(tooltip);
+let expanded = globalExpanded;
+let collapseTimer = null;
+let collapsing = false;
+const nativeIndicators = new Set();
+function setExpanded(value) {
+  clearTimeout(collapseTimer);
+  collapsing = expanded && !value && !matchMedia("(prefers-reduced-motion: reduce)").matches;
+  expanded = value;
+  if (collapsing) collapseTimer = setTimeout(() => {
+    collapsing = false;
+    syncVisibility(findComposer());
+  }, 200);
+  reveal.toggleAttribute("data-expanded", expanded);
+  clip.inert = !expanded;
+  trigger.setAttribute("aria-expanded", String(expanded));
+  tooltip.hidden = true;
+  if (expanded) reveal.hidden = false;
+  syncVisibility(findComposer());
+  if (!expanded) closePanel();
+}
+trigger.addEventListener("click", () => setGlobalExpanded(!expanded), { signal });
+function hideTooltip() { tooltip.hidden = true; trigger.removeAttribute("aria-describedby"); }
+function showContextTooltip() {
+  const value = snapshot;
+  const percent = value?.contextPercent;
+  const zh = copy === copyByLocale["zh-CN"];
+  const status = percent == null ? "—" : percent >= 50
+    ? (zh ? `已占用 ${percent}%` : `${percent}% full`)
+    : (zh ? `已使用 ${percent}%（剩余 ${100 - percent}%）` : `${percent}% used (${100 - percent}% left)`);
+  const tokens = value?.contextWindow == null ? "" : `${zh ? "已使用 " : ""}${Math.round(value.contextUsedTokens / 1000)}k / ${Math.round(value.contextWindow / 1000)}k ${zh ? "Token" : "tokens used"}`;
+  tooltip.replaceChildren();
+  for (const [text, muted] of [[zh ? "上下文窗口：" : "Context window:", true], [status, percent >= 50], [tokens, false]]) {
+    if (!text) continue;
+    const line = document.createElement("div");
+    line.textContent = text;
+    if (muted) line.style.opacity = "0.6";
+    tooltip.append(line);
+  }
+  tooltip.hidden = false;
+  trigger.setAttribute("aria-describedby", tooltip.id);
+  const rect = trigger.getBoundingClientRect();
+  tooltip.style.left = `${Math.max(8, Math.min(innerWidth - tooltip.offsetWidth - 8, rect.left + (rect.width - tooltip.offsetWidth) / 2))}px`;
+  tooltip.style.top = `${rect.top - tooltip.offsetHeight - 4}px`;
+}
+trigger.addEventListener("pointerenter", showContextTooltip, { signal });
+trigger.addEventListener("focus", showContextTooltip, { signal });
+trigger.addEventListener("pointerleave", hideTooltip, { signal });
+trigger.addEventListener("blur", hideTooltip, { signal });
 const buttons = ["statistics", "usage", "context"].map((kind) => {
   const button = document.createElement("button");
   button.type = "button";
@@ -104,11 +207,27 @@ const buttons = ["statistics", "usage", "context"].map((kind) => {
   root.append(button);
   return button;
 });
+const collapse = document.createElement("button");
+collapse.type = "button";
+// Lucide chevron-up，与状态栏其余线性图标保持相同笔画。
+collapse.innerHTML = '<svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"><path d="m18 15-6-6-6 6"/></svg>';
+collapse.addEventListener("click", () => { setGlobalExpanded(false); trigger.focus(); hideTooltip(); }, { signal });
+root.append(collapse);
 let snapshot = null;
 let panel = null;
 let openKind = null;
 let rescanQueued = false;
+let activeThreadId = null;
+let refreshTimer = null;
+let refreshSequence = 0;
+let disposed = false;
+let lastRevision = 0;
 
+function cachePercent(value) {
+  const percent = value?.inputTokens > 0 && value.cachedInputTokens != null
+    ? value.cachedInputTokens / value.inputTokens * 100 : value?.cacheHitPercent;
+  return percent == null ? "—" : `${percent > 99 ? percent.toFixed(1) : Math.round(percent)}%`;
+}
 function number(value) { return value == null ? "—" : new Intl.NumberFormat().format(value); }
 function compact(value) {
   if (value == null) return "—";
@@ -211,7 +330,7 @@ function showPanel(kind) {
     row(dl, copy.input, tokenValue(otherInput)).dataset.tone = "blue";
     row(dl, copy.cached, tokenValue(snapshot.cachedInputTokens)).dataset.tone = "green";
     divider(dl);
-    row(dl, copy.cacheDetail, snapshot.cacheHitPercent == null ? "—" : `${snapshot.cacheHitPercent}%`);
+    row(dl, copy.cacheDetail, cachePercent(snapshot));
   } else {
     if (snapshot.contextPercent != null) {
       const head = document.createElement("div");
@@ -261,36 +380,178 @@ function showPanel(kind) {
 }
 
 function findComposer() {
-  return document.querySelector('[data-codex-composer="true"][contenteditable="true"]')
-    ?? document.querySelector('[contenteditable="true"][role="textbox"]');
+  return isActiveComposer(composerElement) ? composerElement : null;
+}
+function currentThreadId(composer) {
+  if (!composer) return null;
+  const card = composer.closest('[data-codex-composer-root]');
+  const portal = card?.querySelector('[data-above-composer-portal]');
+  // 只认 Codex 输入框绑定的会话；侧栏和 URL 在切换模式时可能仍指向旧会话。
+  if (card?.getAttribute('data-composer-placement') !== 'thread') return null;
+  const value = portal?.getAttribute('data-above-composer-conversation-id');
+  return value?.match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i)?.[0] ?? null;
+}
+// 与原生 Context 指示器订阅同一会话状态；不以日志百分比覆盖它。
+const emptyNativeContext = () => ({ contextUsedTokens: null, contextWindow: null, contextPercent: null });
+let nativeContext = emptyNativeContext();
+let nativeContextFamily = null;
+let nativeContextSubscription = null;
+let nativeContextThread = null;
+function findNativeScope(element) {
+  let fiber;
+  for (let node = element; node && !fiber; node = node.parentElement) {
+    fiber = node[Object.keys(node).find((key) => key.startsWith("__reactFiber"))];
+  }
+  for (let depth = 0; fiber && depth < 200; depth++, fiber = fiber.return) {
+    const chain = fiber.memoizedProps?.value;
+    if (!(chain instanceof Map)) continue;
+    for (const node of chain.values()) {
+      if (node?.token?.__scopeBrand === "AppScope" && typeof node.store?.sub === "function") {
+        return { node, chain };
+      }
+    }
+  }
+  return null;
+}
+function contextFromNativeUsage(usage) {
+  const windowSize = usage?.modelContextWindow;
+  const total = usage?.last?.totalTokens;
+  if (!Number.isFinite(windowSize) || windowSize <= 0 || !Number.isFinite(total) || total < 0) {
+    return emptyNativeContext();
+  }
+  const used = Math.min(total, windowSize);
+  return { contextUsedTokens: used, contextWindow: windowSize, contextPercent: Math.round(used / windowSize * 100) };
+}
+function syncNativeContext(composer) {
+  if (nativeContextThread === activeThreadId && nativeContextSubscription) return;
+  nativeContextSubscription?.();
+  nativeContextSubscription = null;
+  nativeContextThread = null;
+  nativeContext = emptyNativeContext();
+  if (!activeThreadId || !nativeContextFamily) return;
+  const scope = findNativeScope(composer);
+  if (!scope) return;
+  try {
+    const threadId = activeThreadId;
+    const descriptor = nativeContextFamily.resolve(scope.node, scope.chain, threadId);
+    const atom = descriptor.resolve(scope.node, scope.chain);
+    const update = () => {
+      if (disposed || activeThreadId !== threadId) return;
+      nativeContext = contextFromNativeUsage(scope.node.store.get(atom));
+      render();
+    };
+    nativeContextThread = threadId;
+    nativeContextSubscription = scope.node.store.sub(atom, update);
+    update();
+  } catch {
+    nativeContextThread = null;
+  }
+}
+async function loadNativeContextFamily() {
+  try {
+    const url = [...document.querySelectorAll("link[rel=modulepreload]")].map((link) => link.href)
+      .find((name) => /\/app-shared-[^/]+\.js(?:$|\?)/.test(name));
+    if (!url) return;
+    const source = await (await fetch(url, { signal })).text();
+    // 从当前构建解析导出，避免依赖每次更新都会变化的压缩符号或资源哈希。
+    const local = source.match(/([\w$]+)=[\w$]+\(\(\{latestTokenUsageInfo:/)?.[1];
+    if (!local) return;
+    const exported = [...source.matchAll(/([\w$]+) as ([\w$]+)/g)]
+      .find((match) => match[1] === local)?.[2];
+    if (!exported) return;
+    const module = await import(url);
+    if (signal.aborted || disposed) return;
+    nativeContextFamily = module[exported];
+    syncNativeContext(findComposer());
+  } catch { /* 原生接口不可用时保留占位，不显示过期的日志百分比。 */ }
+}
+function requestRefresh() {
+  if (!activeThreadId || signal.aborted) return;
+  if (typeof window[config.bindingName] === "function") {
+    window[config.bindingName](JSON.stringify({
+      token: config.bindingToken,
+      featureId: config.featureId,
+      requestId: `session-status:${++refreshSequence}`,
+      action: "refresh-session-status",
+    }));
+  }
+}
+function scheduleRefresh() {
+  clearTimeout(refreshTimer);
+  refreshTimer = null;
+  if (!activeThreadId || signal.aborted) return;
+  const waiting = snapshot?.turns == null || (snapshot.turns === 0 && snapshot.totalTokens == null);
+  const delay = waiting ? Math.max(500, snapshot?.retryAfterMs ?? 500) : snapshot?.isRunning ? 500 : 0;
+  if (!delay) return;
+  refreshTimer = setTimeout(() => {
+    refreshTimer = null;
+    requestRefresh();
+    scheduleRefresh();
+  }, delay);
 }
 function syncVisibility(composer) {
-  const portal = composer?.closest('[data-codex-composer-root]')?.querySelector('[data-above-composer-portal]');
-  const activeThreadId = portal?.getAttribute('data-above-composer-conversation-id');
-  const hasData = snapshot && (snapshot.turns > 0 || snapshot.totalTokens != null);
-  root.hidden = !hasData || (portal && snapshot.threadId !== activeThreadId);
-  if (root.hidden) closePanel();
+  const threadId = currentThreadId(composer);
+  root.hidden = !threadId || snapshot?.threadId !== threadId;
+  // 收起时退出布局，避免空 grid 仍触发原生 flex gap。
+  reveal.hidden = root.hidden || (!expanded && !collapsing);
+  trigger.hidden = root.hidden || expanded;
+  if (root.hidden) { closePanel(); hideTooltip(); }
 }
 function ensurePosition() {
+  if (disposed || signal.aborted) return;
   const composer = findComposer();
-  if (!composer) { root.remove(); closePanel(); return; }
+  const threadId = currentThreadId(composer);
+  if (threadId !== activeThreadId) {
+    activeThreadId = threadId;
+    nativeContext = emptyNativeContext();
+    // 会话建立后先展示占位，不让日志落盘速度决定状态栏是否出现。
+    snapshot = threadId ? { threadId } : null;
+    closePanel();
+    render();
+    requestRefresh();
+    scheduleRefresh();
+  }
+  syncNativeContext(composer);
+  if (!composer) { reveal.remove(); trigger.remove(); closePanel(); return; }
   const form = composer.closest("form");
   const card = composer.closest("[data-codex-composer-root]") ?? form ?? composer.parentElement?.parentElement;
   if (!card?.parentElement) return;
-  if (root.previousElementSibling !== card || root.parentElement !== card.parentElement) {
-    card.after(root);
+  const model = card.querySelector('[data-composer-navigation-target="reasoning"]');
+  // 沿模型按钮的包装层找到横向控制组，不依赖本地化文案。
+  let anchor = model;
+  while (anchor?.parentElement && !anchor.parentElement.classList.contains("items-center")) anchor = anchor.parentElement;
+  if (anchor && trigger.nextElementSibling !== anchor) anchor.before(trigger);
+  for (const indicator of nativeIndicators) {
+    if (!threadId || !indicator.isConnected) {
+      indicator.removeAttribute("data-minecodex-native-context");
+      nativeIndicators.delete(indicator);
+    }
+  }
+  for (const indicator of threadId ? card.querySelectorAll('[role="img"][aria-label]') : []) {
+    if (!indicator.querySelector('svg circle')) continue;
+    indicator.setAttribute("data-minecodex-native-context", "");
+    nativeIndicators.add(indicator);
+  }
+  if (reveal.previousElementSibling !== card || reveal.parentElement !== card.parentElement) {
+    card.after(reveal);
     closePanel();
   }
   syncVisibility(composer);
 }
 function render() {
+  if (snapshot) snapshot = { ...snapshot, ...nativeContext };
   syncVisibility(findComposer());
   if (root.hidden) return;
+  trigger.querySelector("[data-context-progress]").setAttribute("stroke-dashoffset", String(100 - (snapshot.contextPercent ?? 0)));
+  trigger.setAttribute("aria-label", `${copy.context}: ${snapshot.contextPercent == null ? "—" : `${snapshot.contextPercent}%`}`);
+  collapse.setAttribute("aria-label", copy === copyByLocale["zh-CN"] ? "收起会话状态" : "Collapse session status");
+  if (!tooltip.hidden) showContextTooltip();
   buttons[0].querySelector(".status-label").textContent = `${number(snapshot.turns)} ${copy.turns} ${number(snapshot.steps)} ${copy.steps} · ${snapshot.observedTps == null ? "—" : number(snapshot.observedTps)} tok/s`;
-  buttons[1].querySelector(".status-label").textContent = `${compact(snapshot.totalTokens)} · ${copy.cache} ${snapshot.cacheHitPercent == null ? "—" : `${snapshot.cacheHitPercent}%`}`;
+  buttons[1].querySelector(".status-label").textContent = `${compact(snapshot.totalTokens)} · ${copy.cache} ${cachePercent(snapshot)}`;
   buttons[2].querySelector(".status-label").textContent = snapshot.contextPercent == null ? "—" : `${snapshot.contextPercent}%`;
   buttons[2].querySelector("[data-context-progress]").setAttribute("stroke-dashoffset", String(100 - (snapshot.contextPercent ?? 0)));
   buttons[2].setAttribute("aria-label", `${copy.context}: ${snapshot.contextPercent == null ? "—" : `${snapshot.contextPercent}%`}`);
+  for (const ring of [trigger, buttons[2]]) ring.querySelector("[data-context-progress]").setAttribute("opacity", snapshot.contextPercent > 0 ? "1" : "0");
   if (openKind) showPanel(openKind);
 }
 for (const button of buttons) button.addEventListener("click", () => {
@@ -309,7 +570,10 @@ const observer = new MutationObserver(() => {
   rescanQueued = true;
   queueMicrotask(() => { rescanQueued = false; ensurePosition(); });
 });
-observer.observe(document.documentElement, { childList: true, subtree: true });
+observer.observe(document.documentElement, {
+  childList: true, subtree: true, attributes: true,
+  attributeFilter: ["data-above-composer-conversation-id", "data-composer-placement"],
+});
 const localeObserver = new MutationObserver(() => {
   const nextCopy = selectedCopy();
   if (nextCopy === copy) return;
@@ -317,21 +581,62 @@ const localeObserver = new MutationObserver(() => {
   render();
 });
 localeObserver.observe(document.documentElement, { attributes: true, attributeFilter: ["lang"] });
+setExpanded(globalExpanded);
 ensurePosition();
-const previous = window.__minecodexSessionStatus;
+void loadNativeContextFamily();
 const receiver = {
-  update(value) {
-    snapshot = value;
+  update(value, revision) {
     ensurePosition();
+    // 切换会话期间的迟到快照不得覆盖新会话，也不清除其占位。
+    if (!activeThreadId || value?.threadId !== activeThreadId) return;
+    if (Number.isSafeInteger(revision)) {
+      if (revision <= lastRevision) return;
+      lastRevision = revision;
+    }
+    snapshot = value;
     render();
+    scheduleRefresh();
   },
 };
-window.__minecodexSessionStatus = receiver;
-return () => {
+return { update: receiver.update, setExpanded, dispose() {
+  controller.abort();
+  disposed = true;
+  nativeContextSubscription?.();
+  clearTimeout(refreshTimer);
+  clearTimeout(collapseTimer);
   observer.disconnect();
   localeObserver.disconnect();
   closePanel();
-  root.remove();
+  reveal.remove();
+  trigger.remove();
+  tooltip.remove();
+  for (const indicator of nativeIndicators) indicator.removeAttribute("data-minecodex-native-context");
+} };
+}
+function syncInstances() {
+  for (const [composer, instance] of instances) {
+    if (!isActiveComposer(composer)) { instance.dispose(); instances.delete(composer); }
+  }
+  for (const composer of document.querySelectorAll('[data-codex-composer="true"][contenteditable="true"]')) {
+    if (isActiveComposer(composer) && !instances.has(composer)) instances.set(composer, createInstance(composer));
+  }
+}
+const previous = window.__minecodexSessionStatus;
+const receiver = { update(value, revision) {
+  syncInstances();
+  for (const instance of instances.values()) instance.update(value, revision);
+} };
+window.__minecodexSessionStatus = receiver;
+const instanceObserver = new MutationObserver(syncInstances);
+instanceObserver.observe(document.documentElement, {
+  childList:true, subtree:true, attributes:true,
+  attributeFilter:["class", "style", "hidden", "inert", "aria-hidden", "data-composer-placement"],
+});
+syncInstances();
+return () => {
+  instanceObserver.disconnect();
+  for (const instance of instances.values()) instance.dispose();
+  instances.clear();
   style.remove();
   if (window.__minecodexSessionStatus === receiver) window.__minecodexSessionStatus = previous;
 };

package/features/sidebar-focus/DESIGN.md

@@ -0,0 +1,16 @@
+# Sidebar Focus
+
+保留当前任务所在分类与 Project，收起其他分支。再次点击恢复进入聚焦前的展开状态；聚焦期间切换任务跟随路径。用户手动调整分支时退出聚焦并保留手动布局，无撤销浮层。
+
+- 入口：展开侧栏的 Activity 与 Search 之间，随原生侧栏一起隐藏。
+- 图标：Lucide list-chevrons-down-up（聚焦）/ list-chevrons-up-down（还原），16px，24px viewBox 内 2px 描边。
+- 控件：继承原生 Activity 的 Button 类、28px 热区、secondary 颜色，始终使用 ghost。灰色背景仅在 hover 时出现，聚焦状态由图标切换表达，不保留选中底色。
+- 字体、颜色、圆角、动效全部使用原生控件，不新增主题覆盖。
+- 中英文标题：Focus current task / 聚焦当前任务；Exit focus / 退出聚焦。
+- 折叠通过原生回调执行；React 元数据仅用于读取稳定分类、项目和会话身份。
+- 无可识别当前路径时禁用；Activity 列表展示期间暂停整理。
+- 状态仅作用于当前窗口；卸载不额外改变用户布局。
+
+始终显式使用 secondary 色，避免从激活的 Activity 按钮继承 info 蓝色。Activity 开启时按钮原生 disabled，暂停聚焦操作，关闭后恢复可用性。
+
+聚焦与还原图标采用 24×24 viewBox、16px 显示尺寸，描边 1.575 units（实际 1.05px），对齐相邻原生铃铛和搜索的轮廓粗细。

package/features/sidebar-focus/codex-feature.json

@@ -0,0 +1,20 @@
+{
+  "schemaVersion": 1,
+  "id": "sidebar-focus",
+  "version": "0.1.0",
+  "label": {
+    "en": "Sidebar Focus",
+    "zh-CN": "侧栏聚焦"
+  },
+  "description": {
+    "en": "Keep the current task path expanded and collapse other branches.",
+    "zh-CN": "保留当前任务路径，收起其他分支。"
+  },
+  "entry": {
+    "kind": "page-script",
+    "script": "src/sidebar-focus.mjs"
+  },
+  "placement": {
+    "order": 80
+  }
+}

package/features/sidebar-focus/src/sidebar-focus.mjs

@@ -0,0 +1,134 @@
+const COLLAPSE_GLYPH = "<svg aria-hidden=\"true\"\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"16\"\n  height=\"16\"\n  viewBox=\"0 0 24 24\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"1.575\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <path d=\"M3 5h8\" />\n  <path d=\"M3 12h8\" />\n  <path d=\"M3 19h8\" />\n  <path d=\"m15 5 3 3 3-3\" />\n  <path d=\"m15 19 3-3 3 3\" />\n</svg>\n";
+const EXPAND_GLYPH = "<svg aria-hidden=\"true\"\n  xmlns=\"http://www.w3.org/2000/svg\"\n  width=\"16\"\n  height=\"16\"\n  viewBox=\"0 0 24 24\"\n  fill=\"none\"\n  stroke=\"currentColor\"\n  stroke-width=\"1.575\"\n  stroke-linecap=\"round\"\n  stroke-linejoin=\"round\"\n>\n  <path d=\"M3 5h8\" />\n  <path d=\"M3 12h8\" />\n  <path d=\"M3 19h8\" />\n  <path d=\"m15 8 3-3 3 3\" />\n  <path d=\"m15 16 3 3 3-3\" />\n</svg>\n";
+const sectionSelector = "[data-app-action-sidebar-section]";
+const projectSelector = "[data-app-action-sidebar-project-row]";
+const states = new Map();
+const tip = document.createElement("div");
+tip.id = "minecodex-focus-tooltip";
+tip.setAttribute("role", "tooltip");
+tip.hidden = true;
+const style = document.createElement("style");
+style.textContent = `#minecodex-focus-tooltip {position:fixed;z-index:2147483000;pointer-events:none;padding:5px 12px;border:1px solid var(--color-border-tooltip);border-radius:var(--radius-2xl);background:var(--color-background-tooltip);color:var(--color-text-tooltip);box-shadow:var(--shadow-tooltip);font-family:var(--font-sans-default);font-size:var(--text-sm);line-height:18px;font-weight:var(--tooltip-compact-font-weight);letter-spacing:var(--tracking-tooltip);}`;
+document.head.append(style);
+document.body.append(tip);
+function showTip() {
+  if (!button) return;
+  tip.hidden = false;
+  const rect = button.getBoundingClientRect();
+  tip.style.left = Math.max(8, rect.x + rect.width / 2 - tip.offsetWidth / 2) + "px";
+  tip.style.top = rect.bottom + 8 + "px";
+}
+function hideTip() { tip.hidden = true; }
+let active = false, restoring = false, button, timer, disposed = false;
+const text = (en, cn) => (document.documentElement.lang || navigator.language).startsWith("zh") ? cn : en;
+function props(element, predicate) {
+  let fiber = element?.[Object.keys(element).find(key => key.startsWith("__reactFiber"))];
+  for (let i = 0; fiber && i < 30; i++, fiber = fiber.return) {
+    if (predicate(fiber.memoizedProps || {})) return fiber.memoizedProps;
+  }
+  return {};
+}
+function branches() {
+  return [...document.querySelectorAll("#app-shell-sidebar " + sectionSelector)].map(element => {
+    const native = props(element, p => !!p.sectionKey);
+    const data = props(element, p => Array.isArray(p.section?.threadKeys)).section;
+    return { element, key:"section:" + native.sectionKey, data, expanded:element.dataset.appActionSidebarSectionCollapsed === "false",
+      toggle:() => native.onCollapsedChange?.(element.dataset.appActionSidebarSectionCollapsed === "false") };
+  }).concat([...document.querySelectorAll("#app-shell-sidebar " + projectSelector)].map(element => ({
+    element, key:"project:" + element.dataset.appActionSidebarProjectId,
+    data:props(element, p => !!p.group?.projectId).group,
+    expanded:element.getAttribute("aria-expanded") === "true",
+    toggle:() => element.click(),
+  })));
+}
+function remember(items) {
+  for (const item of items) if (!states.has(item.key)) states.set(item.key, item.expanded);
+}
+function target(items) {
+  const selected = document.querySelector('#app-shell-sidebar [data-app-action-sidebar-thread-selected="true"]');
+  const id = document.querySelector("[data-above-composer-conversation-id]")?.dataset.aboveComposerConversationId;
+  const key = selected?.dataset.appActionSidebarThreadId || (id ? "local:" + id : null);
+  const activeProject = items.map(b => props(b.element, p => p.activeProjectId != null).activeProjectId).find(Boolean);
+  const project = items.find(b => b.key.startsWith("project:") && (b.data?.threadKeys?.includes(key) || b.data?.projectId === activeProject));
+  const section = items.find(b => b.key.startsWith("section:") && (b.data?.threadKeys?.includes(key) || (activeProject && b.data?.itemKeys?.includes("codex:project:" + activeProject))))
+    || items.find(b => b.key.startsWith("section:") && (selected && b.element.contains(selected) || project && b.element.contains(project.element)));
+  return section ? { section, project } : null;
+}
+function reconcile() {
+  if (disposed) return;
+  const sidebar = document.querySelector("#app-shell-sidebar");
+  const bell = [...(sidebar?.querySelectorAll("button[aria-pressed]") || [])].find(e => /activity|活动|动态/.test(e.getAttribute("aria-label") || ""));
+  if (!bell) { button?.remove(); button = null; hideTip(); return; }
+  if (!button?.isConnected) {
+    button = bell.cloneNode(false);
+    button.removeAttribute("id");
+    button.setAttribute("data-minecodex-focus", "");
+    // 复用原生内层容器，由其负责图标在热区内居中。
+    const inner = bell.firstElementChild.cloneNode(false);
+    inner.innerHTML = COLLAPSE_GLYPH;
+    button.replaceChildren(inner);
+    button.setAttribute("aria-describedby", tip.id);
+    button.addEventListener("pointerenter", showTip, { signal });
+    button.addEventListener("pointerleave", hideTip, { signal });
+    button.addEventListener("focus", showTip, { signal });
+    button.addEventListener("blur", hideTip, { signal });
+    button.addEventListener("click", () => {
+      hideTip();
+      if (active) { active = false; restoring = true; }
+      else { states.clear(); remember(branches()); active = true; }
+      schedule();
+    }, { signal });
+    // 作为原生按钮组的独立子项，继承组内 gap，不放进铃铛的 Tooltip 包装层。
+    let anchor = bell;
+    while (anchor.parentElement && getComputedStyle(anchor.parentElement).display !== "flex") {
+      anchor = anchor.parentElement;
+    }
+    anchor.after(button);
+  }
+  const label = active ? text("Exit focus", "退出聚焦") : text("Focus current task", "聚焦当前任务");
+  if (button.getAttribute("aria-label") !== label) button.setAttribute("aria-label", label);
+  if (tip.textContent !== label) tip.textContent = label;
+  const pressed = String(active);
+  if (button.getAttribute("aria-pressed") !== pressed) {
+    button.setAttribute("aria-pressed", pressed);
+    button.firstElementChild.innerHTML = active ? EXPAND_GLYPH : COLLAPSE_GLYPH;
+  }
+  button.setAttribute("data-color", "secondary");
+  button.setAttribute("data-variant", "ghost");
+  const items = branches(), path = target(items);
+  const activityActive = bell.getAttribute("aria-pressed") === "true";
+  button.disabled = activityActive || (!active && !restoring && !path);
+  if (activityActive) { hideTip(); return; }
+  if (restoring) {
+    // 先恢复已挂载的子分支，再恢复分类，避免父节点收起后子节点消失。
+    const change = items.filter(b => b.key.startsWith("project:")).concat(items.filter(b => b.key.startsWith("section:")))
+      .find(b => states.has(b.key) && states.get(b.key) !== b.expanded);
+    if (change) { change.toggle(); schedule(); }
+    else { restoring = false; states.clear(); }
+    return;
+  }
+  if (!active || !path) return;
+  remember(items);
+  // 一次只触发一个原生更新；等待 React 挂载新分支后重新计算路径。
+  const change = items.find(b => b === path.section && !b.expanded)
+    || items.find(b => b.key.startsWith("project:") && b.expanded !== (path.section.element.contains(b.element) ? b === path.project : states.get(b.key)))
+    || items.find(b => b.key.startsWith("section:") && b.expanded !== (b === path.section));
+  if (change) { change.toggle(); schedule(); }
+}
+function schedule() {
+  clearTimeout(timer);
+  timer = setTimeout(reconcile, 40);
+}
+document.addEventListener("click", event => {
+  if (!active || !event.isTrusted) return;
+  if (event.target.closest("[data-app-action-sidebar-section-toggle], " + projectSelector)) {
+    active = false; states.clear(); schedule();
+  }
+}, { capture:true, signal });
+const observer = new MutationObserver(schedule);
+observer.observe(document.documentElement, { subtree:true, childList:true, attributes:true, attributeFilter:[
+  "aria-expanded", "aria-pressed", "data-app-action-sidebar-thread-selected",
+  "data-app-action-sidebar-section-collapsed", "data-above-composer-conversation-id", "lang"
+] });
+reconcile();
+return () => { disposed = true; clearTimeout(timer); observer.disconnect(); button?.remove(); tip.remove(); style.remove(); };