minecodex 2.0.4 → 2.0.6

package/features/model-slider/src/frontend/install.mjs

@@ -683,6 +683,7 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
 
   function sizeModelMenuViewport(menu, maxVisibleItems) {
     if (!menu.isConnected) return;
+    if (modelSelectorControllerMenu?.menu === menu && modelSelectorControllerMenu.animations?.length) return;
     const items = modelMenuItems(menu).filter((item) => item.dataset.codexModelSliderRaw);
     if (items.length <= maxVisibleItems) {
       menu.removeAttribute("data-codex-model-slider-overflow");
@@ -959,9 +960,38 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
     }
   }
 
-  function closeControllerModelMenu() {
+  function animateControllerModelMenu(record, opening, onFinish) {
+    const height = record.menu.getBoundingClientRect().height;
+    clearTimeout(record.motionTimer);
+    record.animations?.forEach((animation) => animation.cancel());
+    record.animations = [];
+    if (matchMedia("(prefers-reduced-motion: reduce)").matches) {
+      onFinish();
+      return;
+    }
+    // 原生视图切换：底边保持锚定，高度 320ms，内容 200ms 淡变并位移 10px。
+    record.menu.style.overflowY = "hidden";
+    const size = record.menu.animate([
+      { height: `${opening ? record.sliderHeight : height}px` },
+      { height: `${opening ? record.listHeight : record.sliderHeight}px` },
+    ], { duration: 320, easing: "cubic-bezier(.19,1,.22,1)", fill: "both" });
+    const content = record.content.animate(opening
+      ? [{ opacity: 0, translate: "0 10px" }, { opacity: 1, translate: "0 0" }]
+      : [{ opacity: 1, translate: "0 0" }, { opacity: 0, translate: "0 10px" }],
+    { duration: 200, delay: opening ? 40 : 0, easing: "cubic-bezier(.23,1,.32,1)", fill: "both" });
+    record.animations.push(size, content);
+    if (!opening) {
+      record.animations.push(record.menu.animate([{ opacity: 1 }, { opacity: 0 }],
+        { duration: 200, delay: 40, easing: "cubic-bezier(.23,1,.32,1)", fill: "both" }));
+    }
+    // 后台窗口未必派发动画完成事件，清理按同一时长结束，避免残留菜单。
+    record.motionTimer = setTimeout(onFinish, 320);
+  }
+
+  function closeControllerModelMenu({ immediate = false } = {}) {
     const record = modelSelectorControllerMenu;
     if (!record) return false;
+    if (record.closing && !immediate) return true;
     const placeholder = document.querySelector(
       '[data-codex-intelligence-trigger] [class*="_ModelPickerTriggerPlaceholder_"]',
     );
@@ -969,10 +999,18 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
       placeholder.firstChild.nodeValue = record.placeholderText;
     }
     record.button.setAttribute("aria-expanded", "false");
-    record.parentMenu.style.position = record.position;
-    record.parentMenu.style.overflow = record.overflow;
-    record.menu.remove();
-    modelSelectorControllerMenu = null;
+    record.closing = true;
+    record.menu.inert = true;
+    const finish = () => {
+      clearTimeout(record.motionTimer);
+      record.animations?.forEach((animation) => animation.cancel());
+      record.parentMenu.style.position = record.position;
+      record.parentMenu.style.overflow = record.overflow;
+      record.menu.remove();
+      if (modelSelectorControllerMenu === record) modelSelectorControllerMenu = null;
+    };
+    if (immediate || !record.parentMenu.isConnected) finish();
+    else animateControllerModelMenu(record, false, finish);
     return true;
   }
 
@@ -988,8 +1026,11 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
 
   function openControllerModelMenu(parentMenu, modelButton, selector) {
     if (modelSelectorControllerMenu) {
-      closeControllerModelMenu();
-      return;
+      if (!modelSelectorControllerMenu.closing) {
+        closeControllerModelMenu();
+        return;
+      }
+      closeControllerModelMenu({ immediate: true });
     }
     const controller = nativeComposerModelController();
     if (!Array.isArray(controller?.models) || typeof controller.onSelectModel !== "function") return;
@@ -1002,7 +1043,12 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
     menu.setAttribute("data-state", "open");
     menu.setAttribute("data-codex-model-slider-menu", "");
     menu.setAttribute("data-codex-model-slider-controller-menu", "");
-    featureUI.surface(menu, "dropdown");
+    featureUI.surface(menu, "dropdown", { variant: "opaque" });
+    // 切换同一个 picker 视图，不重复播放整个 Dropdown 的入场缩放。
+    menu.style.animation = "none";
+    const content = document.createElement("div");
+    content.style.flexShrink = "0";
+    menu.append(content);
     models.forEach((model, index) => {
       const item = document.createElement("div");
       item.className = "no-drag outline-hidden rounded-lg px-[var(--padding-row-x)] py-[var(--padding-row-y)] text-sm text-default group hover:bg-primary-ghost-hover focus:bg-primary-ghost-hover cursor-interaction flex flex-col";
@@ -1014,7 +1060,7 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
         scheduleReturn: false,
         owned: true,
       });
-      menu.append(item);
+      content.append(item);
     });
     menu.addEventListener("click", (event) => {
       const star = event.target.closest?.("[data-codex-model-slider-star]");
@@ -1038,6 +1084,7 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
     menu.addEventListener("keydown", (event) => {
       if (event.key === "Escape") {
         event.preventDefault();
+        event.stopPropagation();
         closeControllerModelMenu();
         modelButton.focus();
         return;
@@ -1063,11 +1110,13 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
 
     modelSelectorControllerMenu = {
       menu,
+      content,
       parentMenu,
       button: modelButton,
       placeholderText,
       position: parentMenu.style.position,
       overflow: parentMenu.style.overflow,
+      sliderHeight: parentMenu.getBoundingClientRect().height,
     };
     parentMenu.style.position = "relative";
     parentMenu.style.overflow = "visible";
@@ -1076,6 +1125,15 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
     modelButton.setAttribute("aria-expanded", "true");
     (menu.querySelector('[data-codex-model-slider-selected]')
       ?? menu.querySelector('[role="menuitem"]'))?.focus();
+    const record = modelSelectorControllerMenu;
+    record.listHeight = menu.getBoundingClientRect().height;
+    animateControllerModelMenu(record, true, () => {
+      if (modelSelectorControllerMenu !== record || record.closing) return;
+      record.animations.forEach((animation) => animation.cancel());
+      record.animations = [];
+      menu.style.overflowY = "auto";
+      sizeModelMenuViewport(menu, selector.maxVisibleItems);
+    });
   }
 
   // ========================================================================
@@ -2005,7 +2063,7 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
     enhanceComposerModelTrigger(selector);
     const parentMenu = nativeModelPickerMenu();
     if (modelSelectorControllerMenu && modelSelectorControllerMenu.parentMenu !== parentMenu) {
-      closeControllerModelMenu();
+      closeControllerModelMenu({ immediate: true });
     }
     if (!parentMenu) {
       if (
@@ -2031,7 +2089,7 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
   }
 
   function restoreModelSelectorEnhancements() {
-    closeControllerModelMenu();
+    closeControllerModelMenu({ immediate: true });
     clearTimeout(modelSelectorReturnTimer);
     clearTimeout(modelSelectorEffortTransactionTimer);
     modelSelectorTriggerObserver?.disconnect();
@@ -2091,6 +2149,15 @@ export function installModelSlider(signal, { feature, ui, createIcon, requestRef
     modelSelectorNativeToggleHandlers.clear();
   }
 
+  window.addEventListener("keydown", event => {
+    const record = modelSelectorControllerMenu;
+    if (event.key !== "Escape" || !record) return;
+    // 先退出插件模型视图，避免原生 document 监听同时关闭整个 picker。
+    event.preventDefault();
+    event.stopImmediatePropagation();
+    closeControllerModelMenu();
+    record.button.focus();
+  }, { capture: true, signal });
   document.addEventListener("click", event => {
     if (modelSelectorControllerMenu
       && !modelSelectorControllerMenu.menu.contains(event.target)

package/features/notes/DESIGN.md

@@ -38,7 +38,9 @@ Header 为 Prompts；右侧依次为排序图标、分类调节图标、常驻
 
 点击提示词只插入当前输入框，保留原草稿且不发送。Escape 关闭并回到入口；点击外部关闭；方向键移动列表焦点。原生 Add 或权限面板打开时关闭。切换输入框时关闭，异步结果不得插入另一会话。沿用原生焦点与 hover，无额外进场动画。
 
-入口仅挂载到可见 Codex 输入框；原生可见的 Add 或菜单按钮展开时关闭 Popover。Session Status 的 Context 展开状态不是弹出菜单，不作为冲突条件；隐藏输入框和隐藏控件不参与锚点定位或菜单判断。
+入口通过 Codex Adapter 的 `purpose:"insertion"` 挂载到可见的原生输入框，覆盖 Chat、Work、Codex、Temporary Chat、浮动聊天，以及 side panel 全屏非聊天页面的 chat bar。多输入框并存时优先当前焦点所在输入框；插入操作显式绑定打开面板的输入框，切换后关闭旧面板，不向隐藏输入框插入。此插入契约不扩展会话指标使用的 Codex thread 契约。
+
+原生可见的 Add 或菜单按钮展开时关闭 Popover。Session Status 的 Context 展开状态不是弹出菜单，不作为冲突条件；隐藏输入框和隐藏控件不参与锚点定位或菜单判断。
 
 ## 统计
 成功插入后原子增加 `use_count` 并更新 `called_at`，保存于现有 SQLite。创建、编辑、复制和排序不计数。历史次数未知，从 0 开始，不从旧 `last_used_at` 推断。删除分类、切换页面、重启不清零。
@@ -50,9 +52,9 @@ Header 为 Prompts；右侧依次为排序图标、分类调节图标、常驻
 
 导航栏 book-open 单独采用 20px 容器、27×27 viewBox，实际轮廓约 16.15px，描边折算 1.33px，与原生导航一致。Lucide 两个描边子路径合为一个 path，一次绘制半透明 currentColor，避免书脊交叠变深。选中态使用 Phosphor 官方 book-open-fill 的20px资源；授权见 vendor/phosphor-LICENSE。输入框入口尺寸不变。
 
-拖拽排序使用等高 Drop Placeholder，原生拖影跟随指针；同组条目以 180ms ease-out 让位，落位淡入 140ms。放到范围外或取消恢复原位，不写入排序。遵循 prefers-reduced-motion。
+拖拽排序使用等高 Drop Placeholder，拖影跟随指针并显式按源行圆角裁切，不留下矩形外边界；同组条目以 180ms ease-out 让位，落位淡入 140ms。放到范围外或取消恢复原位，不写入排序。遵循 prefers-reduced-motion。
 
-页面选择通用 Page 外壳，保留原生 Home sidebar 的悬浮与导航行为。
+页面选择通用 Page 的 `sidebar:"none"` 分支，自身不带常驻二级侧栏，保留原生 Home、Space、Scheduled sidebar 的悬浮叠加与导航行为。关闭页面恢复原页面位置，不改变用户的侧栏展开偏好。原生二级入口（如 Space → Images）提交导航后，通过共享 Page 的 `onNavigate` 关闭 Prompts、编辑浮层并释放底层 inert；保留用户刚选择的目标路由。仅悬浮展开侧栏不退出 Prompts。
 
 提示词编辑沿用原生 Project 的复合标题输入：40px 图标段位于标题前，细分隔线，共用圆角边框与 focus-within 状态。图标选择入口不再单独占一行；Title 通过 aria-label 标识。
 
@@ -68,3 +70,5 @@ Category 下拉面板与触发栏等宽、左右对齐，宽度包含内边距
 内置 24 条来自 dsh-prompt 0.1.13 的 MIT 提示词，正文保持原样，按思考、学习、编程、效率分类并配 Emoji。来源与许可保存在 assets/dsh-prompt-LICENSE.txt。首次启动或旧库升级时单次导入；随后允许编辑和删除，重启不还原，也不重建被删除的分类。用户个人内容只保留在本机数据库，不纳入默认资源。
 
 简短悬浮提示调用共享 Tooltip；具体文案由本功能维护。Quick Prompts 通过通用 ComposerMenu 使用原生浮动建议列表材质和输入框主体锚点。排序、分类与图标菜单显式选择 Dropdown。
+
+Categories 管理弹窗的 New category 是有实际功能的次级操作，使用共享 Button 的 `secondary`（outline）分支；分类编辑的 Save 保留主按钮。

package/features/notes/codex-feature.json

@@ -7,8 +7,8 @@
     "zh-CN": "提示词"
   },
   "description": {
-    "en": "Organize prompts, track usage, and insert them from the composer.",
-    "zh-CN": "分类管理提示词、统计调用次数，并从输入框快速调用。"
+    "en": "Organize reusable prompts and insert them with one click.",
+    "zh-CN": "整理常用提示词，一键填入输入框。"
   },
   "surfaceUrl": "http://127.0.0.1:47832/",
   "healthUrl": "http://127.0.0.1:47832/api/health",

package/features/notes/src/frontend/entry.mjs

@@ -9,6 +9,7 @@ let button = null;
 let addButton = null;
 let composerRoot = null;
 let composerThread = null;
+let composerEditable = null;
 let panel = null;
 let items = [];
 let generation = 0;
@@ -169,7 +170,7 @@ function renderList() {
         async () => {
           const current = generation;
           try {
-            window.__codexPersonalRuntime.insertText(item.body);
+            window.__codexPersonalRuntime.insertText(item.body, composerEditable);
             // 插入同步成功后再记一次调用；失败和单纯浏览不计数。
             close();
             await api(`/api/prompts/${encodeURIComponent(item.id)}/use`, {
@@ -224,7 +225,7 @@ function isOpenComposerMenu(node) {
 function sync() {
   if (disposed || signal.aborted) return;
   syncNavigation();
-  const nativeComposer = config.codex.composer(null,{threadOnly:false});
+  const nativeComposer = config.codex.composer(null,{purpose:"insertion"});
   const add = nativeComposer?.add;
   const card = nativeComposer?.root;
   const thread = nativeComposer?.threadId ?? null;
@@ -232,13 +233,14 @@ function sync() {
     close();
     composerThread = thread;
   }
-  if (add !== addButton || card !== composerRoot) {
+  if (add !== addButton || card !== composerRoot || nativeComposer?.editable !== composerEditable) {
     close();
     button?.remove();
     button = null;
     addButton = add;
     composerRoot = card;
   }
+  composerEditable = nativeComposer?.editable ?? null;
   if (!add) return;
   if (
     panel &&
@@ -325,11 +327,12 @@ function syncNavigationSelection() {
 function restoreNavigationSelection() {
   navigationRail?.select(false);
 }
-function closePage(restoreFocus = false) {
+function closePage(restoreFocus = false, restoreNavigation = true) {
   dragState?.cancel();
   pageGeneration++;
   closePagePopup();
   closeEditor(false);
+  if (page) config.ui.releasePage(page, { restoreNavigation });
   page?.remove();
   page = null;
   restoreNavigationSelection();
@@ -362,7 +365,7 @@ function openPage() {
   pageFocus = document.activeElement;
   page = element("section");
   page.setAttribute(MARKER, "page");
-  config.ui.page(page);
+  config.ui.page(page, { sidebar:"none", onNavigate:() => closePage(false, false) });
   page.setAttribute("aria-label", text("Prompts", "提示词"));
   document.body.append(page);
   // 只隔离主内容的焦点，保留导航栏与原生窗口控件。
@@ -726,6 +729,18 @@ function orderControls(item, ordered, isCategory, row) {
     const parent = row.parentElement;
     const siblings = [...parent.children].filter(node => node.dataset.orderGroup === group);
     const originalNext = row.nextSibling;
+    const rect = row.getBoundingClientRect();
+    const radius = getComputedStyle(row).borderRadius;
+    const dragImage = row.cloneNode(true);
+    dragImage.removeAttribute("data-order-group");
+    dragImage.removeAttribute("data-order-id");
+    dragImage.setAttribute("aria-hidden", "true");
+    Object.assign(dragImage.style, { position:"fixed", left:"-10000px", top:"0", width:`${rect.width}px`,
+      height:`${rect.height}px`, margin:"0", boxSizing:"border-box", pointerEvents:"none",
+      background:"var(--mcx-color-surface)", borderRadius:radius, overflow:"hidden", clipPath:`inset(0 round ${radius})` });
+    // 显式裁切拖影，避免浏览器自动截图留下矩形外边界。
+    parent.append(dragImage);
+    event.dataTransfer.setDragImage(dragImage, event.clientX - rect.left, event.clientY - rect.top);
     const placeholder = element("div", "pm-drop-placeholder");
     placeholder.style.height = `${row.getBoundingClientRect().height}px`;
     placeholder.setAttribute("aria-hidden", "true");
@@ -752,6 +767,7 @@ function orderControls(item, ordered, isCategory, row) {
       if (finished) return;
       finished = true;
       lifetime.abort();
+      dragImage.remove();
       dragState = null;
       row.draggable = false;
       if (!started) return;
@@ -768,8 +784,9 @@ function orderControls(item, ordered, isCategory, row) {
     dragState = { cancel: () => finish(false) };
     event.dataTransfer.effectAllowed = "move";
     event.dataTransfer.setData("text/plain", item.id);
-    // 等浏览器截取拖影后再隐藏原行，避免拖影变成空白。
+    // 等浏览器截取拖影后再清理替身、隐藏原行。
     requestAnimationFrame(() => {
+      dragImage.remove();
       if (finished || !row.isConnected) return;
       row.before(placeholder);
       row.classList.add("pm-dragging");
@@ -1075,7 +1092,7 @@ function manageCategories() {
   const target = editorShell(text("Categories", "分类"));
   const footer = config.ui.footer(element("div", "pm-footer"));
   footer.append(
-    pageControl(text("New category", "新建分类"), () => editCategory(), true),
+    pageControl(text("New category", "新建分类"), () => editCategory()),
   );
   for (const category of categories) {
     const row = element("div", "pm-row");
@@ -1291,11 +1308,11 @@ document.addEventListener(
       event.target.closest("[data-app-navigation-rail] button") &&
       !navButton?.contains(event.target)
     )
-      closePage();
+      closePage(false, false);
   },
   { signal, capture: true },
 );
-window.addEventListener("popstate", () => closePage(), { signal });
+window.addEventListener("popstate", () => closePage(false, false), { signal });
 window.addEventListener("resize", positionPage, { signal });
 
 const observer = new MutationObserver(() => {

package/features/session-status/DESIGN.md

@@ -8,6 +8,8 @@
 
 ## Token 与布局
 
+状态栏实例跟随可见正式会话的原生 Composer root，不跟随 contenteditable 编辑节点。发送时编辑区暂时不可交互或重建，同一外壳、同一会话的状态栏继续显示并保留展开选择和统计；不以延时隐藏掩盖变化。真正切换会话时清除旧统计，进入 home、隐藏外壳或迁入浮动输入框时移除实例。宿主读取身份与 Renderer 使用同一个 `composerSurface` 契约。
+
 | 角色 | Codex token | 用途 |
 | --- | --- | --- |
 | 次要文字 | `--color-text-tertiary` | 状态行文字与分隔符 |
@@ -24,7 +26,7 @@
 
 界面文案跟随 Codex 的 `html[lang]`：中文语言使用简体中文，其他语言使用英文；运行中切换语言时同步更新状态行和已打开的明细浮窗。MineCodex Web 使用同样的中英文规则提供本功能开关。
 
-TPS 根据 Codex 会话事件计算有效样本的会话平均约值，以 `N tok/s` 呈现；分母扣除工具执行区间（含迟到事件，重叠区间仅扣一次），不将其视为实时解码速度；缺少有效计时样本时显示 `—`。累计 token 与缓存比例来自 Codex 用量记录。上下文使用原生 Codex 桌面版的口径：最近请求 `last.totalTokens / modelContextWindow`，直接订阅原生会话的 `latestTokenUsageInfo`（`thread/tokenUsage/updated` 更新），压缩后与原生同步刷新，不依赖日志轮询；原生数据不可用时显示占位；状态栏显示百分环和数字，弹层显示用量、窗口容量和压缩次数。二级浮窗的 token 数按十进制换算为 K/M，省略 `tok` 后缀；TPS 仍保留 `tok/s`。日志可见历史只列有数据的指令、消息、工具交互三个短标签，估算值以 `~` 开头。6px 进度条使用 Codex 图标选择器的紫、蓝、绿配色，标签圆点保持同色；当前页面未暴露对应变量时使用 Codex 亮／暗主题原值。剩余的原生占用以浅灰表示；若估算合计超过原生占用，按比例缩放彩色段，让进度条终点始终对应原生总占用。不显示无法取得的工具定义，也不放解释性长文案。
+TPS 根据 Codex 会话事件计算有效样本的会话平均约值，以 `N tok/s` 呈现；分母仅扣除完整落在同一响应计时范围内、且不与已观测模型输出重叠的工具区间（含迟到事件，重叠区间仅扣一次）；跨响应运行或与生成并行的后台工具不扣时，模型输出缺少结束时间时保守保留该样本的观测时长，不将其视为实时解码速度；缺少有效计时样本时显示 `—`。累计 token 与缓存比例来自 Codex 用量记录。上下文使用原生 Codex 桌面版的口径：最近请求 `last.totalTokens / modelContextWindow`，直接订阅原生会话的 `latestTokenUsageInfo`（`thread/tokenUsage/updated` 更新），压缩后与原生同步刷新，不依赖日志轮询；原生数据不可用时显示占位；状态栏显示百分环和数字，弹层显示用量、窗口容量和压缩次数。二级浮窗的 token 数按十进制换算为 K/M，省略 `tok` 后缀；TPS 仍保留 `tok/s`。日志可见历史只列有数据的指令、消息、工具交互三个短标签，估算值以 `~` 开头；工具结果同时接受字符串与内容数组，压缩后的 replacement_history 采用同一文本解析。6px 进度条使用 Codex 图标选择器的紫、蓝、绿配色，标签圆点保持同色；当前页面未暴露对应变量时使用 Codex 亮／暗主题原值。剩余的原生占用以浅灰表示；若估算合计超过原生占用，按比例缩放彩色段，让进度条终点始终对应原生总占用。不显示无法取得的工具定义，也不放解释性长文案。
 
 上下文弹层按视觉归属排列：进度条下紧接三个可见历史分段，不加分段副标题；分隔线之后列原生占用合计、窗口容量和压缩次数。合计取原生最近请求用量，不是三个估算分段的求和。
 
@@ -35,7 +37,7 @@ TPS 标签后放置 12px Lucide info 图标，继承标签颜色，间距 6px。
 ### 折叠入口
 - 首次安装默认展开；用户收起后在模型选择左侧显示 12px context 环，24px 热区；原生 context 环开启时隐藏原生重复入口，卸载时恢复。
 - Tooltip 沿用原生 context 内容：上下文窗口、使用/剩余比例、已用/容量（k tokens）；样式遵循通用 Tooltip。
-- 点击环展开输入框下方详情，右侧 chevron-up 收起；200ms grid 高度与160ms透明度过渡，尊重 reduced-motion。展开状态跨会话、主聊天和 side chat 共享并持久保存。展开时隐藏输入框内的 context 环；收起动效完成后容器 display:none，不保留父级 gap，收起内容不参与键盘焦点。每个输入框订阅自己的会话上下文和统计。
+- 点击环展开输入框下方详情，右侧 chevron-up 收起。原生布局一次切换到目标状态，测量切换前后的位置，仅用 transform 衔接输入框与模型控件；状态行入场配合4px位移与透明度过渡；中途反向按当前位移衔接。展开220ms、收起160ms，曲线 `cubic-bezier(0.23,1,0.32,1)`。反向操作从当前可见位置和透明度继续，取消旧动画；退出内容临时脱离布局，结束后恢复并 display:none，不保留父级 gap。reduced-motion 立即切换，收起内容不参与键盘焦点。展开状态跨会话、主聊天和 side chat 共享并持久保存，展开时隐藏输入框内的 context 环；每个输入框订阅自己的会话上下文和统计。
 - Cache 按原始 cachedInputTokens / inputTokens 计算：大于99%显示一位小数，其余取整数，状态栏和详情共用格式。
 
 输入框实例仅绑定可见的 thread composer。全屏标签页中的隐藏聊天、浮动 Quick Chat（含 right-panel composer overlay）、inert 区域不注入；原生移动输入框或切换可见性时销毁实例并取消订阅，返回聊天后重建。

package/features/session-status/codex-feature.json

@@ -4,8 +4,8 @@
   "version": "0.1.0",
   "label": { "en": "Session Status", "zh-CN": "会话状态" },
   "description": {
-    "en": "Shows conversation steps, observed output speed, token usage and context details below the composer.",
-    "zh-CN": "在输入框下方显示对话步骤、观测输出速度、Token 用量与上下文明细。"
+    "en": "See response speed, token usage and context space.",
+    "zh-CN": "查看输出速度、Token 用量与上下文占用。"
   },
   "entry": { "kind": "page-script", "script": "src/session-status.mjs", "sourceFactory": "src/injection-source.mjs" },
   "icon": {

package/features/session-status/src/adapters/codex/session-log.mjs

@@ -7,6 +7,7 @@ function estimatedTextTokens(value) {
 }
 
 function estimatedContentTokens(content) {
+  if (typeof content === "string") return estimatedTextTokens(content);
   if (!Array.isArray(content)) return 0;
   return content.reduce((total, item) => {
     if (item?.type === "input_image" || item?.type === "output_image") return total + IMAGE_TOKENS_ESTIMATE;
@@ -71,7 +72,7 @@ export function sessionFacts(record) {
     if (p.type === "task_complete" && Number.isFinite(p.time_to_first_token_ms)) emit("first-token-measured", { elapsed:p.time_to_first_token_ms });
     if (p.type === "item_completed") {
       if (p.item?.type === "ContextCompaction") emit("compaction-finished");
-      if (MODEL_OUTPUT_ITEMS.has(p.item?.type) && Number.isFinite(p.started_at_ms)) emit("output-observed", { start:p.started_at_ms });
+      if (MODEL_OUTPUT_ITEMS.has(p.item?.type) && Number.isFinite(p.started_at_ms)) emit("output-observed", { start:p.started_at_ms, end:p.completed_at_ms });
       if (TOOL_ITEMS.has(p.item?.type) && Number.isFinite(p.started_at_ms) && Number.isFinite(p.completed_at_ms)) emit("tool-measured", { start:p.started_at_ms, end:p.completed_at_ms });
     }
     if (p.type === "token_count") emit("usage-observed", { total:usage(p.info?.total_token_usage), last:usage(p.info?.last_token_usage), contextWindow:p.info?.model_context_window });

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

@@ -14,6 +14,7 @@ export function createSessionState() {
     last: null,
     contextWindow: null,
     firstOutputAt: null,
+    pendingOutputIntervals: [],
     pendingToolIntervals: [],
     speedMeasurements: [],
     ttftTotalMs: 0,
@@ -30,14 +31,17 @@ export function createSessionState() {
   };
 }
 
-function overlappingToolMs(intervals, start, end) {
-  const clipped = intervals
-    .map(([toolStart, toolEnd]) => [Math.max(start, toolStart), Math.min(end, toolEnd)])
+function boundedToolWaitMs(intervals, start, end, outputs) {
+  // 仅扣同一响应内、与已观测生成不重叠的工具区间；后台进程存活时间不是等待时间。
+  if (outputs.some(([, outputEnd]) => !Number.isFinite(outputEnd))) return 0;
+  const waits = intervals
+    .filter(([toolStart, toolEnd]) => toolStart >= start && toolEnd <= end
+      && !outputs.some(([outputStart, outputEnd]) => toolStart < outputEnd && toolEnd > outputStart))
     .filter(([left, right]) => right > left)
     .sort((left, right) => left[0] - right[0]);
   let elapsed = 0;
   let rightEdge = start;
-  for (const [left, right] of clipped) {
+  for (const [left, right] of waits) {
     elapsed += Math.max(0, right - Math.max(left, rightEdge));
     rightEdge = Math.max(rightEdge, right);
   }
@@ -45,7 +49,7 @@ function overlappingToolMs(intervals, start, end) {
 }
 
 export function applySessionStatusEvent(state, event) {
-  const reset = () => { state.firstOutputAt=null; state.pendingToolIntervals=[]; };
+  const reset = () => { state.firstOutputAt=null; state.pendingOutputIntervals=[]; state.pendingToolIntervals=[]; };
   switch (event.kind) {
     case "history-replaced":
       state.compactionRecords++; state.last=null; reset();
@@ -63,11 +67,14 @@ export function applySessionStatusEvent(state, event) {
     case "turn-ended": reset(); if (event.id) state.runningTurns.delete(event.id); else state.runningTurns.clear(); break;
     case "first-token-measured": state.ttftTotalMs+=event.elapsed; state.ttftSamples++; break;
     case "compaction-finished": state.compactionCompleted++; break;
-    case "output-observed": state.firstOutputAt=Math.min(state.firstOutputAt ?? event.start,event.start); break;
+    case "output-observed":
+      state.firstOutputAt=Math.min(state.firstOutputAt ?? event.start,event.start);
+      state.pendingOutputIntervals.push([event.start,event.end]);
+      break;
     case "tool-measured":
       state.toolMs+=Math.max(0,event.end-event.start);
       state.pendingToolIntervals.push([event.start,event.end]);
-      // 工具记录可能晚到，补扣与既有响应样本重叠的时间。
+      // 工具记录可能晚到；是否属于可扣除等待区间，由样本的生成边界判断。
       for (const sample of state.speedMeasurements) if (event.start < sample.end && event.end > sample.start) sample.tools.push([event.start,event.end]);
       break;
     case "usage-observed":
@@ -81,7 +88,8 @@ export function applySessionStatusEvent(state, event) {
         state.responses.add(event.id);
         const output=event.last?.output;
         if (Number.isFinite(output) && output > 0 && state.firstOutputAt != null && Number.isFinite(event.end) && event.end > state.firstOutputAt)
-          state.speedMeasurements.push({ start:state.firstOutputAt,end:event.end,output,tools:state.pendingToolIntervals.slice() });
+          state.speedMeasurements.push({ start:state.firstOutputAt,end:event.end,output,
+            outputs:state.pendingOutputIntervals.slice(),tools:state.pendingToolIntervals.slice() });
       }
       reset();
       if (event.total) { state.total=event.total; state.hasResponseUsage=true; }
@@ -96,7 +104,7 @@ export function sessionStatusSnapshot(state, threadId) {
   let decodeMs = 0;
   let speedSamples = 0;
   for (const sample of state.speedMeasurements) {
-    const elapsed = sample.end - sample.start - overlappingToolMs(sample.tools, sample.start, sample.end);
+    const elapsed = sample.end - sample.start - boundedToolWaitMs(sample.tools, sample.start, sample.end, sample.outputs);
     if (elapsed <= 0 || elapsed >= 600_000) continue;
     decodeTokens += sample.output;
     decodeMs += elapsed;

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

@@ -35,9 +35,7 @@ style.id = STYLE_ID;
 style.textContent = `
   [${MARKER}] { box-sizing:border-box; display:flex; flex-wrap:wrap; justify-content:center; align-items:center; gap:0 4px; margin:0 auto; padding-top:2px; max-width:100%; min-height:24px; min-width:0; font-family:var(--mcx-font-sans-default,inherit); font-size:var(--mcx-text-xs,12px); line-height:16px; font-variant-numeric:tabular-nums; color:var(--mcx-color-text-tertiary); }
   [${MARKER}][hidden] { display: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] { display:grid; grid-template-rows:1fr; }
   [data-minecodex-session-reveal][data-expanded]:not([hidden]) { margin-top:-4px; }
   [data-minecodex-session-reveal] > div { min-height:0; overflow:hidden; }
   [data-minecodex-session-reveal]:not([data-expanded]) { pointer-events:none; }
@@ -102,7 +100,7 @@ window.addEventListener("storage", (event) => {
 }, { signal });
 // Codex 会把离屏输入框搬到 Quick Chat 浮层；节点仍连接不代表当前页面是聊天。
 function isActiveComposer(composer) {
-  return Boolean(config.codex.composer(composer));
+  return Boolean(config.codex.composerSurface(composer));
 }
 function createInstance(composerElement) {
 let copy = selectedCopy();
@@ -156,15 +154,30 @@ document.body.append(tooltip);
 let expanded = globalExpanded;
 let collapseTimer = null;
 let collapsing = false;
+const motion = new Set();
+function clearMotion() {
+  for (const animation of motion) animation.cancel();
+  motion.clear();
+  for (const key of ["position", "left", "top", "width"]) reveal.style.removeProperty(key);
+}
 const nativeIndicators = new Set();
 function setExpanded(value) {
+  const card = reveal.previousElementSibling;
+  const model = card?.querySelector('[data-composer-navigation-target="reasoning"]');
+  const controls = model?.parentElement;
+  const before = card?.getBoundingClientRect();
+  const controlsBefore = controls?.getBoundingClientRect();
+  const revealBefore = reveal.getBoundingClientRect();
+  const opacity = reveal.hidden ? 0 : Number(getComputedStyle(reveal).opacity);
+  const animate = value !== expanded && !root.hidden && !matchMedia("(prefers-reduced-motion: reduce)").matches;
   clearTimeout(collapseTimer);
-  collapsing = expanded && !value && !matchMedia("(prefers-reduced-motion: reduce)").matches;
+  clearMotion();
+  collapsing = animate && !value;
   expanded = value;
-  if (collapsing) collapseTimer = setTimeout(() => {
-    collapsing = false;
-    syncVisibility(findComposer());
-  }, 200);
+  // 退出内容暂时脱离布局，原生输入框一次到达目标位置，再以位移衔接。
+  if (collapsing) Object.assign(reveal.style, {
+    position:"fixed", left:`${revealBefore.left}px`, top:`${revealBefore.top}px`, width:`${revealBefore.width}px`,
+  });
   reveal.toggleAttribute("data-expanded", expanded);
   clip.inert = !expanded;
   trigger.setAttribute("aria-expanded", String(expanded));
@@ -172,6 +185,25 @@ function setExpanded(value) {
   if (expanded) reveal.hidden = false;
   syncVisibility(findComposer());
   if (!expanded) closePanel();
+  if (!animate) return;
+  const duration = expanded ? 220 : 160;
+  const options = { duration, easing:"cubic-bezier(0.23,1,0.32,1)", fill:"both" };
+  const play = (node, frames) => { if (node) motion.add(node.animate(frames, options)); };
+  const after = card.getBoundingClientRect();
+  play(card, [{transform:`translateY(${before.top-after.top}px)`},{transform:"translateY(0)"}]);
+  if (controlsBefore) {
+    const after = controls.getBoundingClientRect();
+    play(controls, [{transform:`translateX(${controlsBefore.left-after.left}px)`},{transform:"translateX(0)"}]);
+  }
+  const offset = expanded && revealBefore.height ? revealBefore.top-reveal.getBoundingClientRect().top : -4;
+  play(reveal, [{opacity,transform:`translateY(${expanded ? offset : 0}px)`},
+    {opacity:expanded ? 1 : 0,transform:`translateY(${expanded ? 0 : -4}px)`}]);
+  if (!expanded) play(trigger, [{opacity:0},{opacity:1}]);
+  collapseTimer = setTimeout(() => {
+    collapsing = false;
+    clearMotion();
+    syncVisibility(findComposer());
+  }, duration);
 }
 trigger.addEventListener("click", () => setGlobalExpanded(!expanded), { signal });
 function hideTooltip() { tooltip.hidden = true; trigger.removeAttribute("aria-describedby"); }
@@ -401,7 +433,7 @@ function findComposer() {
   return isActiveComposer(composerElement) ? composerElement : null;
 }
 function currentThreadId(composer) {
-  return config.codex.currentThreadId(composer);
+  return composer ? config.codex.composerSurface(composer)?.threadId ?? null : null;
 }
 // 与原生 Context 指示器订阅同一会话状态；不以日志百分比覆盖它。
 const emptyNativeContext = () => ({ contextUsedTokens:null,contextWindow:null,contextPercent:null });
@@ -445,6 +477,9 @@ function ensurePosition() {
   const composer = findComposer();
   const threadId = currentThreadId(composer);
   if (threadId !== activeThreadId) {
+    clearTimeout(collapseTimer);
+    clearMotion();
+    collapsing = false;
     activeThreadId = threadId;
     nativeContext = emptyNativeContext();
     // 会话建立后先展示占位，不让日志落盘速度决定状态栏是否出现。
@@ -547,6 +582,7 @@ return { update: receiver.update, setExpanded, dispose() {
   nativeUsage.dispose();
   clearTimeout(refreshTimer);
   clearTimeout(collapseTimer);
+  clearMotion();
   observer.disconnect();
   localeObserver.disconnect();
   closePanel();
@@ -560,7 +596,7 @@ 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"]')) {
+  for (const composer of document.querySelectorAll('[data-codex-composer-root]')) {
     if (isActiveComposer(composer) && !instances.has(composer)) instances.set(composer, createInstance(composer));
   }
 }

package/features/sidebar-focus/DESIGN.md

@@ -5,13 +5,13 @@
 保留当前任务所在分类与 Project，收起其他分支。再次点击恢复进入聚焦前的展开状态；聚焦期间切换任务跟随路径。用户手动调整分支时退出聚焦并保留手动布局，无撤销浮层。
 
 - 入口：展开侧栏的 Activity 与 Search 之间，随原生侧栏一起隐藏。
-- 图标：固定使用 Lucide list-chevrons-down-up，开启和退出聚焦不切换图标。16px，24px viewBox，描边 1.575 units（实际 1.05px）。
-- 控件：继承原生 Activity 的 Button 类与 28px 热区。未激活为 secondary / ghost，激活为 info / soft，与原生 View activity 一致；aria-pressed 表达聚焦开关状态。
-- 中英文标题：Focus current task / 聚焦当前任务；Exit focus / 退出聚焦。
+- 图标：整理操作使用 Lucide list-chevrons-down-up；可恢复布局时切换为 list-chevrons-up-down。16px，24px viewBox，描边 1.575 units（实际 1.05px）。
+- 控件：继承原生 Activity 的 Button 类与 28px 热区。两种状态均使用 secondary / ghost，以图标表达下一步动作，不显示蓝色模式选中态；aria-pressed 保留可恢复状态的可访问语义。
+- 中英文标题：Focus current task / 聚焦当前任务；Restore layout / 恢复布局。
 - 折叠通过原生回调执行；React 元数据仅用于读取稳定分类、项目和会话身份。
 - 无可识别当前路径时禁用；Activity 列表展示期间暂停整理。
 - 状态仅作用于当前窗口；卸载不额外改变用户布局。
 
-根据聚焦状态显式设置 data-color 与 data-variant，直接复用原生语义 token 适配明暗模式，不写死蓝色或背景色。Activity 开启时按钮原生 disabled，暂停聚焦操作，关闭后恢复可用性。
+显式使用中性 data-color 与 data-variant，直接复用原生语义 token 适配明暗模式，不写死颜色或背景色。Activity 开启时按钮原生 disabled，暂停聚焦操作，关闭后恢复可用性。
 
 Tooltip 由共享组件库通过 `data-minecodex-tooltip` 管理；插件只提供随聚焦状态变化的文案，不维护独立材质、定位或显示事件。克隆入口时移除原控件的 `title` 与 `aria-describedby`。

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

@@ -7,14 +7,15 @@
     "zh-CN": "侧栏聚焦"
   },
   "description": {
-    "en": "Keep the current task path expanded and collapse other branches.",
-    "zh-CN": "保留当前任务路径，收起其他分支。"
+    "en": "Fold unrelated branches to keep the current task in view.",
+    "zh-CN": "收起无关分支，专注当前任务路径。"
   },
   "entry": {
     "kind": "page-script",
     "script": "src/sidebar-focus.mjs",
     "sourceFactory": "src/injection-source.mjs"
   },
+  "icon": {"viewBox": "0 0 24 24", "markup": "<rect width=\"18\" height=\"18\" x=\"3\" y=\"3\" rx=\"2\" />\n  <path d=\"M9 3v18\" />"},
   "placement": {
     "order": 80
   }