minecodex 1.1.1 → 1.2.0

package/README.md

@@ -14,6 +14,7 @@ MineCodex 给 Codex Desktop 增加一组轻量、本地优先的扩展功能。
 | **Notes** | 跨会话管理待办事项、常用提示词与文件，可随时从 Codex 工具栏快速复用 |
 | **Images** | 集中浏览生成的图片、Prompt 和来源任务，轻松保存原图或快速返回原会话 |
 | **Hide Upsell Banner** | 隐藏输入框上方的用量提示横幅，仅优化界面展示，不影响正常的用量统计 |
+| **Session Status** | 在输入框下方查看当前任务的步骤、观测速度、Token 用量与上下文明细 |
 
 ## 安装
 
@@ -53,7 +54,7 @@ mcx open
 
 ## 工作原理
 
-MineCodex 统一管理 Codex 内的菜单入口、主题风格与界面适配。每个插件（Model Slider、Notes、Images）独立管理各自的数据与操作页面；Hide Upsell Banner 专注于界面展示的优化，不影响实际的用量计算。所有功能按需开启，关闭后即停止运行。
+MineCodex 统一管理 Codex 内的菜单入口、主题风格与界面适配。Model Slider、Notes、Images 各自管理数据与操作页面；Session Status 只读汇总本机 Codex 会话事件，Hide Upsell Banner 优化界面展示。所有功能按需开启，关闭后即停止运行。
 
 ## 开发
 
@@ -67,4 +68,4 @@ npm run pack:audit
 
 ## 许可
 
-MineCodex 是非官方独立扩展项目，与 OpenAI 无关联。项目自有代码以 MIT License 授权；第三方图标、品牌和兼容资产遵循各自的权利说明，见 [`features/model-slider/THIRD_PARTY_NOTICES.md`](features/model-slider/THIRD_PARTY_NOTICES.md)。
+MineCodex 是非官方独立扩展项目，与 OpenAI 无关联。项目自有代码以 MIT License 授权；第三方图标、品牌和兼容资产遵循各自的权利说明，见 [`features/model-slider/THIRD_PARTY_NOTICES.md`](features/model-slider/THIRD_PARTY_NOTICES.md) 与 [`features/session-status/vendor/lucide-LICENSE`](features/session-status/vendor/lucide-LICENSE)。

package/features/session-status/DESIGN.md

@@ -0,0 +1,31 @@
+# Session Status 设计约定
+
+## 意图
+
+状态行紧随 Codex 原生输入框，帮助用户在长任务中快速判断回合、模型步骤、输出速度和 token 用量。视觉上作为输入框的附属信息，不争夺发送按钮与模型选择器的层级。
+
+## Token 与布局
+
+| 角色 | Codex token | 用途 |
+| --- | --- | --- |
+| 次要文字 | `--color-text-tertiary` | 状态行文字与分隔符 |
+| 主要文字 | `--color-text-primary` | 弹层标题和数值 |
+| 弹层表面 | `--color-token-dropdown-background` | 点击后的明细 |
+| 边框 | `--color-border-subtle` | 弹层与分割线 |
+| 悬停 | `--color-token-list-hover-background` | 状态按钮反馈 |
+| 焦点描边 | `--input-outline-border-color-focus` | 键盘焦点反馈 |
+| 分类进度 | Codex `--app-block-accent-purple`、`--app-block-accent-blue`、`--app-block-accent-green`，以及 `--color-token-border-default` | 各弹层的分类比例与未分类段 |
+| 字体 | `--font-sans-default`、`--text-xs` | 与原生辅助信息一致 |
+| 圆角与阴影 | `--radius-xl`、`--shadow-lg` | 明细弹层 |
+
+状态行和输入框共用内容宽度，单行高度为 24px，顶部留 2px 内边距；每个状态按钮高 22px，内边距为上下 3px、左右 7px。宽度不足时自然换行，不覆盖输入框或悬浮控件。统计图标采用 Lucide Gauge，用量图标采用 Phosphor Database 单路径版本，两者以 14px 绘制；上下文使用与 Codex 原生相同参数的 12px 百分环。弹层由按钮锚定，键盘可聚焦，Escape 和点击外部关闭。遵守系统减少动态效果设置，不添加持续动画。
+
+## 数据呈现
+
+界面文案跟随 Codex 的 `html[lang]`：中文语言使用简体中文，其他语言使用英文；运行中切换语言时同步更新状态行和已打开的明细浮窗。MineCodex Web 使用同样的中英文规则提供本功能开关。
+
+TPS 根据 Codex 会话事件计算，分母扣除工具执行区间；缺少有效计时样本时显示 `—`。累计 token 与缓存比例来自 Codex 用量记录。上下文使用原生 Codex 桌面版的口径：最近请求 `last.totalTokens / modelContextWindow`，状态栏显示百分环和数字，弹层显示用量、窗口容量和压缩次数。二级浮窗的 token 数按十进制换算为 K/M，省略 `tok` 后缀；TPS 仍保留 `tok/s`。日志可见历史只列有数据的指令、消息、工具交互三个短标签，估算值以 `~` 开头。6px 进度条使用 Codex 图标选择器的紫、蓝、绿配色，标签圆点保持同色；当前页面未暴露对应变量时使用 Codex 亮／暗主题原值。剩余的原生占用以浅灰表示；若估算合计超过原生占用，按比例缩放彩色段，让进度条终点始终对应原生总占用。不显示无法取得的工具定义，也不放解释性长文案。
+
+上下文弹层按视觉归属排列：进度条下紧接三个可见历史分段，不加分段副标题；分隔线之后列原生占用合计、窗口容量和压缩次数。合计取原生最近请求用量，不是三个估算分段的求和。
+
+会话统计浮窗只显示回合、步骤、首字延迟和 TPS。Token 用量浮窗以 Total 为主项，紧接比例条和输出（紫）、其他输入（蓝）、缓存输入（绿）三项，顺序与上下文弹层一致；分隔线后才显示缓存命中率。其他输入为总输入减缓存输入，包含缓存写入。三项使用同一分母。

package/features/session-status/README.md

@@ -0,0 +1,29 @@
+# Session Status / 会话状态
+
+在 Codex 输入框下方显示当前任务的回合、模型响应步骤、观测 TPS、累计 token 和缓存命中。点击状态行可查看统计、用量及上下文详情。
+
+数据由 Runtime Host 只读解析本机 `~/.codex/sessions` 中的 Codex 会话事件，再通过已有 CDP 连接向注入脚本发送数值快照；功能不发送对话内容，也不修改 Codex 会话日志。远程任务或缺少本机日志时隐藏状态行。
+
+## 口径
+
+- 回合：唯一 `task_started` / `turn_context` 的 `turn_id`。
+- 步骤：有 `token_usage_record` 的唯一 `response_id`，即已记录的模型响应次数。
+- Token：优先采用逐响应记录的 `thread_token_usage`，旧日志缺少该记录时回退到 `token_count.total_token_usage`；缓存命中为 `cached_input_tokens / input_tokens`。未缓存输入为总输入减缓存读与缓存写。
+- TPS：仅对可配对模型输出条目起点与逐次用量记录终点的响应，计算 `Σ output_tokens / Σ（观测时长 − 其中工具执行时长）`；重叠工具区间只扣一次。缺少有效计时样本时显示 `—`。
+- Token 构成：Total 下的比例条按输出（紫）、其他输入（蓝）、缓存输入（绿）显示三项在会话总用量中的占比；缓存命中率独立放在末尾，仍以总输入为分母。其他输入为总输入减缓存输入，包含缓存写入。
+- 上下文：与当前 Codex 桌面版原生百分环相同，采用最近请求的 `last.total_tokens / model_context_window`，裁切至 0–100%。即使关闭原生百分环，本功能仍从会话事件独立读取。二级浮窗在进度条下显示日志可见历史的指令、消息、工具交互本地估算，随后显示原生占用合计、窗口容量和压缩次数；`~` 表示估算，合计并非估算分段之和。进度条采用 Codex 原生配色，以紫、蓝、绿分别表示三类，未分类的占用为浅灰；彩色段按需缩放，整条终点对应原生总占用。工具定义因未写入日志而不显示。
+- 压缩次数：读取会话日志中的 `compacted` 记录及其 `window_number`，兼容旧版 `context_compacted` 和 `ContextCompaction` 完成事件；同一次压缩的多种记录只计一次。若 `compacted` 含 `replacement_history`，分段估算以它替换压缩前历史，再累计后续记录。
+
+统计图标使用 Lucide Static v1.31.0 的 Gauge；用量图标使用 Phosphor Icons 的 Database，单路径填充避免半透明色在路径交叠处加深。许可见 [`vendor/lucide-LICENSE`](vendor/lucide-LICENSE) 和 [`vendor/phosphor-LICENSE`](vendor/phosphor-LICENSE)。
+
+## 上下文分类的可行性
+
+当前桌面版原生百分环只需要 `last.totalTokens` 和 `modelContextWindow`。Codex 的会话用量事件还提供输入、缓存、输出和推理输出，但没有系统提示词、工具定义、对话消息各自的 token 数。日志中的 `session_meta.base_instructions`、`response_item` 角色与类型、`compacted.replacement_history` 可以形成有边界的活跃历史分段：基础与开发者指令、消息（包含压缩摘要）、工具调用与结果。参考 Codex 自身的粗估口径，将 UTF-8 可见文本按约 4 字节/token 计，图片按固定大小估算；全程本地运算，不调用模型。加密摘要参考 Codex 对编码长度的换算。
+
+这些分段与准确的最近请求用量是两套口径：日志缺少完整工具定义和实际请求封装，且最新追加的条目可能尚未进入下一次请求，因此分段值不强求与总占用相加相等。旧日志没有 `replacement_history` 时只估算压缩后的可见后缀，不把压缩前历史继续累加。弹层保持简短，通过分组标题和 `~` 标记区分估算。二级浮窗所有 token 数按十进制（1K = 1,000，1M = 1,000,000）显示数量级，不附加 `tok`；速度继续使用 `tok/s`。
+
+若将来 Codex 的事件或 App Server 增加分类用量，可用原生数据替换本地估算。
+
+相关实现调研：[`picoSols/codex-usage-statusline`](https://github.com/picoSols/codex-usage-statusline) 也用 Codex `token_count` 计算总占用；[`auditt98/context-viewer`](https://github.com/auditt98/context-viewer) 用 `tiktoken` 给可见日志文本估算分类，但其 Codex 解析不能还原每次实际请求中的完整提示词和工具定义。[`HarnessDesk` 的 DSH 接入](https://github.com/HarnessDesk/HarnessDesk/blob/main/docs/context-usage.md) 从 DSH 自己的 token meter 接收分类投影，其 Codex 接入没有这项投影。[Codex App Server 用量协议](https://github.com/openai/codex/blob/main/codex-rs/app-server-protocol/schema/json/v2/ThreadTokenUsageUpdatedNotification.json) 只提供输入、缓存、输出、推理等用量种类和上下文窗口，没有按提示词、工具和消息拆分的字段。
+
+会话 JSONL 和 Codex DOM 均属版本相关接口，升级 Codex 后需用隔离窗口重新验证。关闭本功能会移除注入节点和观察器。

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

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "id": "session-status",
+  "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 用量与上下文明细。"
+  },
+  "entry": { "kind": "page-script", "script": "src/session-status.mjs" },
+  "icon": {
+    "viewBox": "0 0 24 24",
+    "markup": "<path d=\"m12 14 4-4\"></path><path d=\"M3.34 19a10 10 0 1 1 17.32 0\"></path>"
+  },
+  "placement": { "order": 50 }
+}

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

@@ -0,0 +1,326 @@
+// page-script：数据由 Runtime Host 单向传入，页面只负责展示。
+const MARKER = "data-minecodex-session-status";
+const STYLE_ID = "minecodex-session-status-style";
+const copyByLocale = { "zh-CN": {
+  turns: "回合", steps: "步", speed: "TPS", cache: "缓存", cacheDetail: "缓存命中",
+  statistics: "会话统计", usage: "Token 用量", context: "上下文详情", total: "总量",
+  firstToken: "平均首字延迟", input: "输入", cached: "缓存输入", output: "输出",
+  sum: "合计", capacity: "窗口容量", contextShare: "上下文占用", compactions: "压缩次数",
+  instructions: "指令", messages: "消息", toolHistory: "工具交互", other: "未分类",
+}, en: {
+  turns: "turns", steps: "steps", speed: "TPS", cache: "Cache", cacheDetail: "Cache hit",
+  statistics: "Session stats", usage: "Token usage", context: "Context", total: "Total",
+  firstToken: "Avg first token", input: "Input", cached: "Cached input", output: "Output",
+  sum: "Sum", capacity: "Window size", contextShare: "Context used", compactions: "Compactions",
+  instructions: "Instructions", messages: "Messages", toolHistory: "Tool activity", other: "Unclassified",
+} };
+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 = {
+  statistics: '<svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"><path d="m12 14 4-4"/><path d="M3.34 19a10 10 0 1 1 17.32 0"/></svg>',
+  usage: '<svg aria-hidden="true" viewBox="0 0 256 256" fill="currentColor"><path d="M128,24C74.17,24,32,48.6,32,80v96c0,31.4,42.17,56,96,56s96-24.6,96-56V80C224,48.6,181.83,24,128,24Zm80,104c0,9.62-7.88,19.43-21.61,26.92C170.93,163.35,150.19,168,128,168s-42.93-4.65-58.39-13.08C55.88,147.43,48,137.62,48,128V111.36c17.06,15,46.23,24.64,80,24.64s62.94-9.68,80-24.64ZM69.61,53.08C85.07,44.65,105.81,40,128,40s42.93,4.65,58.39,13.08C200.12,60.57,208,70.38,208,80s-7.88,19.43-21.61,26.92C170.93,115.35,150.19,120,128,120s-42.93-4.65-58.39-13.08C55.88,99.43,48,89.62,48,80S55.88,60.57,69.61,53.08ZM186.39,202.92C170.93,211.35,150.19,216,128,216s-42.93-4.65-58.39-13.08C55.88,195.43,48,185.62,48,176V159.36c17.06,15,46.23,24.64,80,24.64s62.94-9.68,80-24.64V176C208,185.62,200.12,195.43,186.39,202.92Z"/></svg>',
+};
+
+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}][hidden] { display: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; }
+  [${MARKER}] button:hover, [${MARKER}] button[aria-expanded="true"] { background:var(--color-token-list-hover-background); }
+  [${MARKER}] button:focus-visible { outline:2px solid var(--input-outline-border-color-focus); outline-offset:1px; }
+  [data-minecodex-session-status-panel] { --mcx-purple:var(--app-block-accent-purple,light-dark(#8952ee,#7849d1)); --mcx-blue:var(--app-block-accent-blue,light-dark(#3a83f7,#2c67c5)); --mcx-green:var(--app-block-accent-green,light-dark(#53b559,#48a04c)); box-sizing:border-box; position:fixed; z-index:2147483000; min-width:260px; max-width:min(360px,calc(100vw - 24px)); padding:16px; border:1px solid var(--color-border-subtle); border-radius:var(--radius-xl,14px); background:var(--color-token-dropdown-background); color:var(--color-text-primary); font-family:var(--font-sans-default,inherit); font-size:13px; box-shadow:var(--shadow-lg,0 8px 28px rgba(0,0,0,.12)); }
+  [data-minecodex-session-status-panel] h3 { display:flex; align-items:center; gap:8px; margin:0 0 12px; padding:0 0 10px; border-bottom:1px solid var(--color-border-subtle); font-size:14px; font-weight:600; }
+  [data-minecodex-session-status-panel] dl { display:grid; grid-template-columns:minmax(0,1fr) auto; gap:8px 20px; margin:0; }
+  [data-minecodex-session-status-panel] dt { color:var(--color-text-tertiary); }
+  [data-minecodex-session-status-panel] dd { margin:0; text-align:right; font-variant-numeric:tabular-nums; white-space:nowrap; }
+  [data-minecodex-session-status-panel] .context-head { display:flex; justify-content:space-between; gap:12px; margin-bottom:8px; }
+  [data-minecodex-session-status-panel] .context-head span:first-child { color:var(--color-text-tertiary); }
+  [data-minecodex-session-status-panel] .context-bar, [data-minecodex-session-status-panel] .mix-bar { display:flex; height:6px; overflow:hidden; border-radius:var(--radius-xl); background:var(--color-token-border-default); }
+  [data-minecodex-session-status-panel] .context-bar { margin-bottom:14px; }
+  [data-minecodex-session-status-panel] .mix-bar { grid-column:1 / -1; margin:0 0 3px; }
+  [data-minecodex-session-status-panel] .context-bar span, [data-minecodex-session-status-panel] .mix-bar span { display:block; flex:none; height:100%; }
+  [data-minecodex-session-status-panel] .context-bar [data-segment="instructions"] { background:var(--mcx-purple); }
+  [data-minecodex-session-status-panel] .context-bar [data-segment="messages"], [data-minecodex-session-status-panel] .context-bar [data-segment="overall"] { background:var(--mcx-blue); }
+  [data-minecodex-session-status-panel] .context-bar [data-segment="tools"] { background:var(--mcx-green); }
+  [data-minecodex-session-status-panel] .context-bar [data-segment="other"] { background:var(--color-text-tertiary); opacity:.4; }
+  [data-minecodex-session-status-panel] .mix-bar [data-tone="purple"], [data-minecodex-session-status-panel] dt[data-tone="purple"]::before { background:var(--mcx-purple); }
+  [data-minecodex-session-status-panel] .mix-bar [data-tone="blue"], [data-minecodex-session-status-panel] dt[data-tone="blue"]::before { background:var(--mcx-blue); }
+  [data-minecodex-session-status-panel] .mix-bar [data-tone="green"], [data-minecodex-session-status-panel] dt[data-tone="green"]::before { background:var(--mcx-green); }
+  [data-minecodex-session-status-panel] .detail-divider { grid-column:1 / -1; margin-top:4px; border-top:1px solid var(--color-border-subtle); }
+  [data-minecodex-session-status-panel] dt[data-tone] { display:flex; align-items:center; gap:7px; }
+  [data-minecodex-session-status-panel] dt[data-tone]::before { content:""; flex:none; width:7px; height:7px; border-radius:2px; }
+`;
+document.head.append(style);
+
+const root = document.createElement("div");
+root.setAttribute(MARKER, "");
+root.hidden = true;
+function createContextRing() {
+  const namespace = "http://www.w3.org/2000/svg";
+  const svg = document.createElementNS(namespace, "svg");
+  svg.setAttribute("viewBox", "0 0 12 12");
+  svg.setAttribute("aria-hidden", "true");
+  svg.classList.add("context-ring");
+  for (const opacity of ["0.16", "1"]) {
+    const circle = document.createElementNS(namespace, "circle");
+    for (const [name, value] of Object.entries({ cx: "6", cy: "6", r: "5", fill: "none", stroke: "currentColor", "stroke-width": "2", opacity })) {
+      circle.setAttribute(name, value);
+    }
+    if (opacity === "1") {
+      circle.setAttribute("pathLength", "100");
+      circle.setAttribute("stroke-dasharray", "100");
+      circle.setAttribute("stroke-dashoffset", "100");
+      circle.setAttribute("stroke-linecap", "round");
+      circle.setAttribute("transform", "rotate(-90 6 6)");
+      circle.dataset.contextProgress = "";
+    }
+    svg.append(circle);
+  }
+  return svg;
+}
+const buttons = ["statistics", "usage", "context"].map((kind) => {
+  const button = document.createElement("button");
+  button.type = "button";
+  button.dataset.kind = kind;
+  button.setAttribute("aria-haspopup", "dialog");
+  button.setAttribute("aria-expanded", "false");
+  if (kind === "context") button.append(createContextRing());
+  else button.insertAdjacentHTML("beforeend", icons[kind]);
+  const label = document.createElement("span");
+  label.className = "status-label";
+  button.append(label);
+  root.append(button);
+  return button;
+});
+let snapshot = null;
+let panel = null;
+let openKind = null;
+let rescanQueued = false;
+
+function number(value) { return value == null ? "—" : new Intl.NumberFormat().format(value); }
+function compact(value) {
+  if (value == null) return "—";
+  if (value < 1000) return number(value);
+  const millions = value >= 999_950;
+  return `${new Intl.NumberFormat(undefined, { maximumFractionDigits: 1 }).format(value / (millions ? 1e6 : 1e3))}${millions ? "M" : "K"}`;
+}
+function tokenValue(value) { return value == null ? "—" : compact(value); }
+function sectionValue(value) { return `~${compact(value)}`; }
+function contextBarSegments(value) {
+  const windowSize = value.contextWindow;
+  const used = Math.min(windowSize, Math.max(0, value.contextUsedTokens ?? 0));
+  if (!(windowSize > 0) || used === 0) return [];
+  if (!value.contextSections) return [["overall", used]];
+  const known = [
+    ["instructions", Math.max(0, value.contextSections.instructions ?? 0)],
+    ["messages", Math.max(0, value.contextSections.messages ?? 0)],
+    ["tools", Math.max(0, value.contextSections.toolHistory ?? 0)],
+  ];
+  const estimatedTotal = known.reduce((sum, [, amount]) => sum + amount, 0);
+  const scale = estimatedTotal > used ? used / estimatedTotal : 1;
+  const segments = known.map(([kind, amount]) => [kind, amount * scale]);
+  if (estimatedTotal < used) segments.push(["other", used - estimatedTotal]);
+  return segments.filter(([, amount]) => amount > 0);
+}
+function duration(ms) {
+  if (ms == null) return "—";
+  if (ms < 1000) return `${Math.round(ms)}ms`;
+  const seconds = Math.round(ms / 1000);
+  return seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m${seconds % 60}s`;
+}
+function row(dl, label, value) {
+  const dt = document.createElement("dt");
+  dt.textContent = label;
+  const dd = document.createElement("dd");
+  dd.textContent = value;
+  dl.append(dt, dd);
+  return dt;
+}
+function divider(dl) {
+  const line = document.createElement("div");
+  line.className = "detail-divider";
+  dl.append(line);
+}
+function appendMixBar(dl, title, parts) {
+  const visible = parts.filter(([, , amount]) => Number.isFinite(amount) && amount > 0);
+  const total = visible.reduce((sum, [, , amount]) => sum + amount, 0);
+  if (total === 0) return;
+  const bar = document.createElement("div");
+  bar.className = "mix-bar";
+  bar.setAttribute("role", "img");
+  const percent = (amount) => new Intl.NumberFormat(undefined, { maximumFractionDigits: 1 }).format(amount / total * 100);
+  bar.setAttribute("aria-label", `${title}: ${visible.map(([, name, amount]) => `${name} ${percent(amount)}%`).join(", ")}`);
+  for (const [tone, name, amount] of visible) {
+    const segment = document.createElement("span");
+    segment.dataset.tone = tone;
+    segment.style.width = `${amount / total * 100}%`;
+    segment.title = `${name} ${percent(amount)}%`;
+    bar.append(segment);
+  }
+  dl.append(bar);
+}
+function closePanel() {
+  panel?.remove();
+  panel = null;
+  openKind = null;
+  for (const button of buttons) button.setAttribute("aria-expanded", "false");
+}
+function showPanel(kind) {
+  closePanel();
+  if (!snapshot) return;
+  const anchor = buttons.find((button) => button.dataset.kind === kind);
+  if (!anchor) return;
+  openKind = kind;
+  anchor.setAttribute("aria-expanded", "true");
+  panel = document.createElement("div");
+  panel.dataset.minecodexSessionStatusPanel = kind;
+  panel.setAttribute("role", "dialog");
+  panel.setAttribute("aria-label", copy[kind]);
+  const heading = document.createElement("h3");
+  heading.textContent = copy[kind];
+  heading.prepend(anchor.querySelector("svg").cloneNode(true));
+  const dl = document.createElement("dl");
+  panel.append(heading, dl);
+  if (kind === "statistics") {
+    row(dl, copy.turns, number(snapshot.turns));
+    row(dl, copy.steps, number(snapshot.steps));
+    row(dl, copy.firstToken, duration(snapshot.averageFirstTokenMs));
+    row(dl, copy.speed, snapshot.observedTps == null ? "—" : `${number(snapshot.observedTps)} tok/s`);
+  } else if (kind === "usage") {
+    row(dl, copy.total, tokenValue(snapshot.totalTokens));
+    const otherInput = snapshot.inputTokens == null || snapshot.cachedInputTokens == null
+      ? null : Math.max(0, snapshot.inputTokens - snapshot.cachedInputTokens);
+    appendMixBar(dl, copy.total, [
+      ["purple", copy.output, snapshot.outputTokens],
+      ["blue", copy.input, otherInput],
+      ["green", copy.cached, snapshot.cachedInputTokens],
+    ]);
+    row(dl, copy.output, tokenValue(snapshot.outputTokens)).dataset.tone = "purple";
+    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}%`);
+  } else {
+    if (snapshot.contextPercent != null) {
+      const head = document.createElement("div");
+      head.className = "context-head";
+      const label = document.createElement("span");
+      label.textContent = copy.contextShare;
+      const value = document.createElement("span");
+      value.textContent = `${snapshot.contextPercent}%`;
+      head.append(label, value);
+      const bar = document.createElement("div");
+      bar.className = "context-bar";
+      bar.setAttribute("role", "img");
+      bar.setAttribute("aria-label", `${copy.contextShare} ${snapshot.contextPercent}%`);
+      for (const [kind, amount] of contextBarSegments(snapshot)) {
+        const segment = document.createElement("span");
+        segment.dataset.segment = kind;
+        segment.style.width = `${amount / snapshot.contextWindow * 100}%`;
+        segment.title = copy[kind === "tools" ? "toolHistory" : kind];
+        bar.append(segment);
+      }
+      panel.insertBefore(head, dl);
+      panel.insertBefore(bar, dl);
+    }
+    if (snapshot.contextSections) {
+      const sections = [
+        ["instructions", copy.instructions, snapshot.contextSections.instructions],
+        ["messages", copy.messages, snapshot.contextSections.messages],
+        ["tools", copy.toolHistory, snapshot.contextSections.toolHistory],
+      ].filter(([, , value]) => value > 0);
+      if (sections.length) {
+        for (const [section, label, value] of sections) {
+          row(dl, label, sectionValue(value)).dataset.tone = section === "instructions" ? "purple" : section === "tools" ? "green" : "blue";
+        }
+        divider(dl);
+      }
+    }
+    row(dl, copy.sum, tokenValue(snapshot.contextUsedTokens));
+    row(dl, copy.capacity, tokenValue(snapshot.contextWindow));
+    row(dl, copy.compactions, number(snapshot.compactions));
+  }
+  document.body.append(panel);
+  const anchorRect = anchor.getBoundingClientRect();
+  const width = panel.getBoundingClientRect().width;
+  const height = panel.getBoundingClientRect().height;
+  panel.style.left = `${Math.max(12, Math.min(innerWidth - width - 12, anchorRect.left + anchorRect.width / 2 - width / 2))}px`;
+  panel.style.top = `${Math.max(12, anchorRect.top - height - 8)}px`;
+}
+
+function findComposer() {
+  return document.querySelector('[data-codex-composer="true"][contenteditable="true"]')
+    ?? document.querySelector('[contenteditable="true"][role="textbox"]');
+}
+function ensurePosition() {
+  const composer = findComposer();
+  if (!composer) { root.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);
+    closePanel();
+  }
+}
+function render() {
+  root.hidden = !snapshot || (snapshot.turns === 0 && snapshot.totalTokens == null);
+  if (root.hidden) { closePanel(); return; }
+  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[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}%`}`);
+  if (openKind) showPanel(openKind);
+}
+for (const button of buttons) button.addEventListener("click", () => {
+  const kind = button.dataset.kind;
+  if (openKind === kind) closePanel();
+  else showPanel(kind);
+}, { signal });
+document.addEventListener("pointerdown", (event) => {
+  if (panel && !panel.contains(event.target) && !root.contains(event.target)) closePanel();
+}, { signal });
+document.addEventListener("keydown", (event) => {
+  if (event.key === "Escape") closePanel();
+}, { signal });
+const observer = new MutationObserver(() => {
+  if (rescanQueued) return;
+  rescanQueued = true;
+  queueMicrotask(() => { rescanQueued = false; ensurePosition(); });
+});
+observer.observe(document.documentElement, { childList: true, subtree: true });
+const localeObserver = new MutationObserver(() => {
+  const nextCopy = selectedCopy();
+  if (nextCopy === copy) return;
+  copy = nextCopy;
+  render();
+});
+localeObserver.observe(document.documentElement, { attributes: true, attributeFilter: ["lang"] });
+ensurePosition();
+const previous = window.__minecodexSessionStatus;
+const receiver = {
+  update(value) {
+    snapshot = value;
+    ensurePosition();
+    render();
+  },
+};
+window.__minecodexSessionStatus = receiver;
+return () => {
+  observer.disconnect();
+  localeObserver.disconnect();
+  closePanel();
+  root.remove();
+  style.remove();
+  if (window.__minecodexSessionStatus === receiver) window.__minecodexSessionStatus = previous;
+};

package/features/session-status/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/session-status/vendor/phosphor-LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Phosphor Icons
+
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -31,6 +31,12 @@
     "features/images/codex-feature.json",
     "features/hide-upsell-banner/src",
     "features/hide-upsell-banner/codex-feature.json",
+    "features/session-status/src",
+    "features/session-status/codex-feature.json",
+    "features/session-status/DESIGN.md",
+    "features/session-status/README.md",
+    "features/session-status/vendor/lucide-LICENSE",
+    "features/session-status/vendor/phosphor-LICENSE",
     "apps/dashboard/app.js",
     "apps/dashboard/favicon.svg",
     "apps/dashboard/index.html",
@@ -42,7 +48,7 @@
   },
   "scripts": {
     "start": "node packages/cli/bin/mcx.mjs serve",
-    "test": "node --test packages/cli/test/*.test.mjs packages/runtime-host/test/*.test.mjs features/model-slider/test/*.test.mjs features/notes/test/*.test.mjs features/images/test/*.test.mjs features/hide-upsell-banner/test/*.test.mjs apps/dashboard/test/*.test.mjs",
+    "test": "node --test packages/cli/test/*.test.mjs packages/runtime-host/test/*.test.mjs features/model-slider/test/*.test.mjs features/notes/test/*.test.mjs features/images/test/*.test.mjs features/hide-upsell-banner/test/*.test.mjs features/session-status/test/*.test.mjs apps/dashboard/test/*.test.mjs",
     "test:cli": "node --test packages/cli/test/*.test.mjs",
     "test:runtime": "node --test packages/runtime-host/test/*.test.mjs",
     "check": "node --check packages/cli/bin/mcx.mjs && node --check packages/cli/src/*.mjs && node --check packages/runtime-host/src/*.mjs",

package/packages/cli/src/config.mjs

@@ -2,7 +2,7 @@ import { randomBytes } from "node:crypto";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import path from "node:path";
 
-export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images", "hide-upsell-banner"]);
+export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images", "hide-upsell-banner", "session-status"]);
 export const DEFAULT_CONFIG = Object.freeze({
   schemaVersion: 1,
   features: Object.freeze({
@@ -10,6 +10,7 @@ export const DEFAULT_CONFIG = Object.freeze({
     notes: true,
     images: true,
     "hide-upsell-banner": true,
+    "session-status": true,
   }),
 });
 

package/packages/cli/src/control-server.mjs

@@ -197,14 +197,7 @@ async function iconResponse(id, paths, response) {
     iconPath = path.join(paths.featuresRoot, id, "assets", "ui", "sparkles.svg");
   } else if (id === "notes") {
     iconPath = path.join(paths.featuresRoot, id, "assets", "icons", "sticky-note.svg");
-  } else if (id === "images") {
-    const manifest = JSON.parse(await readFile(path.join(paths.featuresRoot, id, "codex-feature.json"), "utf8"));
-    const viewBox = manifest.icon?.viewBox ?? "0 0 24 24";
-    const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${viewBox}" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">${manifest.icon.markup}</svg>`;
-    response.writeHead(200, { "Content-Type": "image/svg+xml", "Cache-Control": "public, max-age=3600" });
-    response.end(svg);
-    return;
-  } else if (id === "hide-upsell-banner") {
+  } else if (["images", "hide-upsell-banner", "session-status"].includes(id)) {
     const manifest = JSON.parse(await readFile(path.join(paths.featuresRoot, id, "codex-feature.json"), "utf8"));
     const viewBox = manifest.icon?.viewBox ?? "0 0 24 24";
     const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${viewBox}" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">${manifest.icon.markup}</svg>`;

package/packages/runtime-host/src/codex-runtime.mjs

@@ -31,6 +31,7 @@ import {
   attachFilesToComposer,
   createImageEditThread,
 } from "./host-actions.mjs";
+import { SessionStatusReader, threadIdFromLocation } from "./session-status-reader.mjs";
 
 
 // 保持公共入口兼容：历史 import 从本文件继续可用。
@@ -103,6 +104,8 @@ export class CodexRuntime {
     this.pidChangeQueue = null;
     this.rendererDiscovered = false;
     this.lastRendererStatus = null;
+    this.sessionStatusReader = features.some((feature) => feature.id === "session-status")
+      ? new SessionStatusReader() : null;
   }
 
   async start({ launchCodex = false } = {}) {
@@ -673,9 +676,34 @@ export class CodexRuntime {
         this.notifyStatusChange();
       }
     }
+    if (this.sessionStatusReader) await this.publishSessionStatus();
     this.notifyStatusChange();
   }
 
+  async publishSessionStatus() {
+    for (const [targetId, client] of this.clients) {
+      if (!this.injectedTargets.has(targetId)) continue;
+      try {
+        const response = await client.send("Runtime.evaluate", {
+          expression: `(() => {
+            const selected = document.querySelector('[data-app-action-sidebar-thread-selected="true"]');
+            return selected?.getAttribute('data-app-action-sidebar-thread-id')
+              ?? location.pathname + location.search;
+          })()`,
+          returnByValue: true,
+        });
+        const threadId = threadIdFromLocation(response.result?.value);
+        const snapshot = threadId ? await this.sessionStatusReader.read(threadId) : null;
+        await client.send("Runtime.evaluate", {
+          expression: `window.__minecodexSessionStatus?.update(${JSON.stringify(snapshot)})`,
+          returnByValue: true,
+        });
+      } catch (error) {
+        this.logger.warn?.("Session Status update failed", error.message);
+      }
+    }
+  }
+
   async stop() {
     if (this.stopPromise) return this.stopPromise;
     this.stopPromise = (async () => {
@@ -712,4 +740,3 @@ export class CodexRuntime {
     return this.stopPromise;
   }
 }
-

package/packages/runtime-host/src/session-status-reader.mjs

@@ -0,0 +1,299 @@
+import { createReadStream } from "node:fs";
+import { readdir, stat } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+const THREAD_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const MODEL_OUTPUT_ITEMS = new Set(["Reasoning", "AgentMessage"]);
+const TOOL_ITEMS = new Set(["CommandExecution", "McpToolCall", "DynamicToolCall"]);
+const IMAGE_TOKENS_ESTIMATE = 1844;
+
+function estimatedTextTokens(value) {
+  return typeof value === "string" ? Math.ceil(Buffer.byteLength(value, "utf8") / 4) : 0;
+}
+
+function estimatedContentTokens(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;
+    return total + estimatedTextTokens(item?.text);
+  }, 0);
+}
+
+function estimatedEncryptedTokens(value) {
+  if (typeof value !== "string") return 0;
+  // 参考 Codex 的历史粗估：先去掉加密封装，再按约 4 字节/token 换算。
+  return Math.ceil(Math.max(0, Math.floor(value.length * 3 / 4) - 650) / 4);
+}
+
+function estimatedSections(item) {
+  const type = item?.type;
+  if (type === "message") {
+    const tokens = estimatedContentTokens(item.content);
+    return item.role === "developer" || item.role === "system"
+      ? { instructions: tokens, messages: 0, tools: 0 }
+      : { instructions: 0, messages: tokens, tools: 0 };
+  }
+  if (type === "function_call" || type === "custom_tool_call") {
+    return { instructions: 0, messages: 0, tools: estimatedTextTokens(item.arguments ?? item.input) };
+  }
+  if (type === "function_call_output" || type === "custom_tool_call_output") {
+    return { instructions: 0, messages: 0, tools: estimatedContentTokens(item.output) };
+  }
+  if (type === "reasoning" || type === "compaction") {
+    return { instructions: 0, messages: estimatedContentTokens(item.summary)
+      + estimatedEncryptedTokens(item.encrypted_content), tools: 0 };
+  }
+  return null;
+}
+
+function addSections(target, sections) {
+  if (!sections) return;
+  for (const key of ["instructions", "messages", "tools"]) target[key] += sections[key];
+}
+
+export function threadIdFromLocation(value) {
+  return String(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;
+}
+
+function emptyState(filePath) {
+  return {
+    filePath,
+    offset: 0,
+    pending: "",
+    turns: new Set(),
+    responses: new Set(),
+    hasResponseUsage: false,
+    total: null,
+    last: null,
+    contextWindow: null,
+    firstOutputAt: null,
+    pendingToolIntervals: [],
+    decodeTokens: 0,
+    decodeMs: 0,
+    speedSamples: 0,
+    ttftTotalMs: 0,
+    ttftSamples: 0,
+    toolMs: 0,
+    compactionRecords: 0,
+    compactionCompleted: 0,
+    compactionEvents: 0,
+    compactionWindow: 0,
+    baseInstructionTokens: 0,
+    visibleSections: { instructions: 0, messages: 0, tools: 0 },
+    hasVisibleHistory: false,
+    updatedAt: null,
+  };
+}
+
+function validUsage(value) {
+  return value && ["input_tokens", "cached_input_tokens", "output_tokens", "total_tokens"]
+    .every((key) => Number.isFinite(value[key]) && value[key] >= 0);
+}
+
+function overlappingToolMs(intervals, start, end) {
+  const clipped = intervals
+    .map(([toolStart, toolEnd]) => [Math.max(start, toolStart), Math.min(end, toolEnd)])
+    .filter(([left, right]) => right > left)
+    .sort((left, right) => left[0] - right[0]);
+  let elapsed = 0;
+  let rightEdge = start;
+  for (const [left, right] of clipped) {
+    elapsed += Math.max(0, right - Math.max(left, rightEdge));
+    rightEdge = Math.max(rightEdge, right);
+  }
+  return elapsed;
+}
+
+export function applySessionStatusEvent(state, event) {
+  const payload = event?.payload ?? {};
+  if (event?.type === "compacted") {
+    state.compactionRecords += 1;
+    if (Number.isSafeInteger(payload.window_number) && payload.window_number >= 0) {
+      state.compactionWindow = Math.max(state.compactionWindow, payload.window_number);
+    }
+    // 压缩会替换活跃历史；不能继续累计压缩前的消息与工具记录。
+    state.visibleSections = { instructions: 0, messages: 0, tools: 0 };
+    state.hasVisibleHistory = false;
+    if (Array.isArray(payload.replacement_history)) {
+      for (const item of payload.replacement_history) addSections(state.visibleSections, estimatedSections(item));
+      state.hasVisibleHistory = true;
+    }
+  }
+  if (event?.type === "response_item") {
+    const sections = estimatedSections(payload);
+    if (sections) {
+      addSections(state.visibleSections, sections);
+      state.hasVisibleHistory = true;
+    }
+  }
+  if (event?.type === "turn_context" && payload.turn_id) state.turns.add(payload.turn_id);
+  if (event?.type === "session_meta") {
+    if (Number.isFinite(payload.context_window)) state.contextWindow = payload.context_window;
+    state.baseInstructionTokens = estimatedTextTokens(payload.base_instructions?.text);
+  }
+  if (event?.type === "event_msg") {
+    if (payload.type === "context_compacted") state.compactionEvents += 1;
+    if (payload.type === "task_started" && payload.turn_id) state.turns.add(payload.turn_id);
+    if (payload.type === "task_complete" && Number.isFinite(payload.time_to_first_token_ms)) {
+      state.ttftTotalMs += payload.time_to_first_token_ms;
+      state.ttftSamples += 1;
+    }
+    if (payload.type === "item_completed") {
+      const itemType = payload.item?.type;
+      if (itemType === "ContextCompaction") state.compactionCompleted += 1;
+      const start = payload.started_at_ms;
+      const end = payload.completed_at_ms;
+      if (MODEL_OUTPUT_ITEMS.has(itemType) && Number.isFinite(start)) {
+        state.firstOutputAt = Math.min(state.firstOutputAt ?? start, start);
+      }
+      if (TOOL_ITEMS.has(itemType) && Number.isFinite(start) && Number.isFinite(end)) {
+        state.toolMs += Math.max(0, end - start);
+        state.pendingToolIntervals.push([start, end]);
+      }
+    }
+    if (payload.type === "token_count") {
+      if (!state.hasResponseUsage && validUsage(payload.info?.total_token_usage)) {
+        state.total = payload.info.total_token_usage;
+      }
+      if (!state.hasResponseUsage && validUsage(payload.info?.last_token_usage)) {
+        state.last = payload.info.last_token_usage;
+      }
+      if (Number.isFinite(payload.info?.model_context_window)) {
+        state.contextWindow = payload.info.model_context_window;
+      }
+    }
+  }
+  if (event?.type === "token_usage_record") {
+    const responseId = payload.response_id;
+    if (responseId && !state.responses.has(responseId)) {
+      state.responses.add(responseId);
+      const responseEnd = Date.parse(event.timestamp);
+      const elapsed = state.firstOutputAt == null ? null : responseEnd - state.firstOutputAt
+        - overlappingToolMs(state.pendingToolIntervals, state.firstOutputAt, responseEnd);
+      const output = payload.usage?.output_tokens;
+      // 会话事件只给出首个可见条目的时间，故 TPS 是观测估算。
+      if (Number.isFinite(output) && output > 0 && state.firstOutputAt != null
+        && Number.isFinite(elapsed) && elapsed > 0 && elapsed < 600_000) {
+        state.decodeTokens += output;
+        state.decodeMs += elapsed;
+        state.speedSamples += 1;
+      }
+    }
+    state.firstOutputAt = null;
+    state.pendingToolIntervals = [];
+    if (validUsage(payload.thread_token_usage)) {
+      state.total = payload.thread_token_usage;
+      state.hasResponseUsage = true;
+    }
+    if (validUsage(payload.usage)) state.last = payload.usage;
+  }
+  if (state.total || state.turns.size) state.updatedAt = event.timestamp ?? state.updatedAt;
+}
+
+export function sessionStatusSnapshot(state, threadId) {
+  const total = state.total;
+  const input = total?.input_tokens ?? 0;
+  const cached = total?.cached_input_tokens ?? 0;
+  const cacheWrite = total?.cache_write_input_tokens ?? 0;
+  const contextUsed = state.last?.total_tokens ?? null;
+  const contextWindow = state.contextWindow > 0 ? state.contextWindow : null;
+  return {
+    threadId,
+    turns: state.turns.size,
+    steps: state.responses.size,
+    totalTokens: total?.total_tokens ?? null,
+    inputTokens: total?.input_tokens ?? null,
+    cachedInputTokens: total?.cached_input_tokens ?? null,
+    cacheWriteInputTokens: total?.cache_write_input_tokens ?? null,
+    uncachedInputTokens: total ? Math.max(0, input - cached - cacheWrite) : null,
+    outputTokens: total?.output_tokens ?? null,
+    cacheHitPercent: input > 0 ? Math.round(cached / input * 100) : null,
+    observedTps: state.decodeMs > 0 ? Math.round(state.decodeTokens / (state.decodeMs / 1000)) : null,
+    speedSamples: state.speedSamples,
+    observedModelMs: state.decodeMs,
+    toolMs: state.toolMs,
+    averageFirstTokenMs: state.ttftSamples > 0 ? Math.round(state.ttftTotalMs / state.ttftSamples) : null,
+    contextUsedTokens: contextUsed,
+    contextWindow,
+    contextPercent: contextUsed != null && contextWindow != null
+      ? Math.min(100, Math.round(contextUsed / contextWindow * 100)) : null,
+    compactions: Math.max(state.compactionWindow, state.compactionRecords,
+      state.compactionCompleted, state.compactionEvents),
+    contextSections: state.hasVisibleHistory ? {
+      instructions: state.baseInstructionTokens + state.visibleSections.instructions,
+      messages: state.visibleSections.messages,
+      toolHistory: state.visibleSections.tools,
+    } : null,
+    updatedAt: state.updatedAt,
+  };
+}
+
+async function findLog(directory, threadId) {
+  let entries;
+  try { entries = await readdir(directory, { withFileTypes: true }); }
+  catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+  for (const entry of entries) {
+    const filePath = path.join(directory, entry.name);
+    if (entry.isFile() && entry.name.endsWith(`-${threadId}.jsonl`)) return filePath;
+    if (entry.isDirectory()) {
+      const found = await findLog(filePath, threadId);
+      if (found) return found;
+    }
+  }
+  return null;
+}
+
+export class SessionStatusReader {
+  constructor({ sessionsDir = path.join(process.env.CODEX_HOME ?? path.join(os.homedir(), ".codex"), "sessions") } = {}) {
+    this.sessionsDir = sessionsDir;
+    this.states = new Map();
+    this.missingCheckedAt = new Map();
+  }
+
+  async read(threadId) {
+    if (!THREAD_ID.test(threadId ?? "")) return null;
+    let state = this.states.get(threadId);
+    if (!state) {
+      const lastCheck = this.missingCheckedAt.get(threadId) ?? 0;
+      if (Date.now() - lastCheck < 10_000) return null;
+      this.missingCheckedAt.set(threadId, Date.now());
+      const filePath = await findLog(this.sessionsDir, threadId);
+      if (!filePath) return null;
+      state = emptyState(filePath);
+      this.states.set(threadId, state);
+      this.missingCheckedAt.delete(threadId);
+    }
+    let info;
+    try { info = await stat(state.filePath); }
+    catch (error) {
+      if (error.code !== "ENOENT") throw error;
+      this.states.delete(threadId);
+      return null;
+    }
+    if (info.size < state.offset) state = emptyState(state.filePath);
+    if (info.size > state.offset) {
+      const stream = createReadStream(state.filePath, {
+        start: state.offset,
+        end: info.size - 1,
+        encoding: "utf8",
+      });
+      for await (const chunk of stream) {
+        const lines = `${state.pending}${chunk}`.split("\n");
+        state.pending = lines.pop() ?? "";
+        for (const line of lines) {
+          if (!line.includes('"token_usage_record"') && !line.includes('"event_msg"')
+            && !line.includes('"turn_context"') && !line.includes('"session_meta"')
+            && !line.includes('"response_item"') && !line.includes('"compacted"')) continue;
+          try { applySessionStatusEvent(state, JSON.parse(line)); } catch { /* 忽略损坏的单行 */ }
+        }
+      }
+      state.offset = info.size;
+      this.states.set(threadId, state);
+    }
+    return sessionStatusSnapshot(state, threadId);
+  }
+}