在 Codex 输入框上方的独立横条显示当前聊天的“累计折算输入 Token + 累计输出 Token”、最近一次提问/运行的缓存命中率和平均生成速度,以及本次运行的折算输入和输出。替代原来的“Work locally”,点击展开跨会话日期统计。浮窗主指标为保留两位小数的预估总开销(USD),包含普通输入、缓存读取、缓存写入与输出费用;各范围都有模型费用饼图,点击图例中的模型即可筛选统计,再次点击选中项或点击筛选状态条的 × 恢复。
- 浮层第一个选项为“当前会话”,显示当前聊天完整历史的费用及 token 统计,开销上方显示整个会话的对话轮次(不随模型/来源筛选变化,不将合并后的柱数当作轮数);后续为近一天(滚动 24 小时)、近一周、近一个月(滚动日历月)、自定义日期,默认按北京时间统计。
- “当前会话”和“近一天”不显示每日明细;较长范围的明细按需展开。模型使用两层列表:默认合并同名模型(忽略大小写),点击模型筛选其全部来源;模型左侧箭头仅展开/收起来源,不改变筛选、不发请求,点击来源子行才筛选该模型和来源。收起后仍保留来源筛选,顶部状态条始终显示所选模型/来源,点击 × 清除;再次点击选中项也清除。无筛选时显示“全部模型”。来源目录随统计一起缓存、预计算。模型使用差异更大的调色板,来源子行只显示名称与占比,不添加图形标记;切换筛选和时间范围时保留模型已分配的颜色。饼图和所有百分比始终以所选时间范围全部模型的费用为基准,筛选不改变占比分母。
- 输入统计采用“原始 Token/折算 Token”对照表,逐行显示总输入、普通输入、缓存读取、缓存写入;输出 Token 与命中率单独显示。原始与折算数值都能点击筛选柱状图,与开销共用单选状态,并支持模型与来源组合筛选;再次点击已选项恢复开销图。原始总 Token 收入“更多统计”,不再显示将折算输入与原始输出混加的“折算总 Token”。饼图始终按费用占比绘制,命中率图固定为 0–100%。
- 日期选项汇总当前 Codex 主机上的所有本地会话,与正在打开的聊天无关。范围选择在聊天与窗口之间共享。
- 紧凑浮窗:费用标签与金额同行、输入原始与折算列对齐;缩短行距和列距,输入与输出/命中率合成一个连续统计卡片,总输入以细分隔线和字重突出、小型饼图与趋势图;保留完整模型名(长名称换行)、筛选、每日明细和折算说明。极窄布局下指标自动上下排布,明细表可横向滚动。
- 轻量动效:浮窗打开、范围/模型/指标切换、来源展开与详情展开使用约 160–180 毫秒的透明度和微位移过渡,不在后台轮询时反复播放,不逐帧测量布局;按钮状态轻微渐变。跟随系统“减少动态效果”设置停用持续与过渡动效。
- 浅色、深色、跟随系统;默认跟随操作系统,浮层右上角点击太阳/月亮图标循环切换,图标表示当前实际明暗,小点表示自动模式。只改变统计组件的主题。
- 用量横条占据输入框上方的独立一行,替代“Work locally”;原生上下文、模型和发送控件保持原布局。原位置若还有其他操作按钮则保留。Codex 重建输入区域后自动恢复挂载,找不到工具栏时退回输入框上方。
- 窄侧栏按真实内容宽度尽量完整显示,优先压缩间距,再隐藏最近运行的输入/输出,随后隐藏首项的“+ 累计输出”等指标;只按横条自身宽度、数值及字体变化重新测量,不参与原生底栏的宽度竞争。命中使用箭中靶图标、速度使用表盘图标,输入/输出使用统一线条箭头;运行时仅图标做小幅呼吸、位移与指针摆动,数值保持稳定。悬停不显示提示,点击才展开浮层。支持键盘与 Escape 关闭。
- 无运行时依赖、无监听端口;仅从公开模型定价源下载价格,不上传会话记录;增量读取日志,不读取或保存聊天正文到额外文件。
安装
在 VS Code 扩展页面选择 Install from VSIX…,安装 dist/codex-usage-widget-0.5.32.vsix。安装或更新完成后重新加载窗口。
本地 VS Code:将本插件安装在本地,Codex 也安装在本地。
Remote SSH / WSL / Dev Container:将本插件和 Codex 安装在相同远程扩展宿主。统计代码直接在 Codex 的扩展宿主内运行,前端通过 Webview 消息通道取数,不依赖浏览器 localhost。可将同一个 VSIX 下载到本地安装;本项目不自动访问或修改 SSH 客户端上的文件。
本地窗口统计本地 ~/.codex,远程窗口统计远程 ~/.codex。不自动合并多台机器的统计。可设置 codexUsage.dataPath 指定 Codex 数据目录,优先于环境变量 CODEX_HOME。
命令面板:
Codex Usage: Install / Repair Widget:安装或检查补丁。
Codex Usage: Remove Widget Patch:恢复原文件并关闭自动补丁,之后重新加载。卸载本插件前先运行此命令,否则已经写入的独立补丁仍会保留。
Codex Usage: Show Diagnostics:显示扩展宿主、Codex 路径和补丁版本。
统计口径
- 输入原始拆分:总输入 = 普通输入 + 缓存读取 + 缓存写入;原始总 Token = 总输入 + 输出,包含重复发送的上下文。折算以普通输入单价为基准:普通输入 × 1、缓存读 × 读价/输入价、缓存写 × 写价/输入价,分别累加得到折算总输入。每个请求先按实际模型、来源及价格档计算各分项,再汇总,不能对聚合量套用平均折算率。折算衡量费用,不代表实际处理 Token 减少;跨模型比较费用请看金额。底栏仍以“累计折算输入 + 原始输出”分开展示。
- 缓存读取保留原始命中 Token,同时单独显示其折算量。只统计日志和价格表中明确提供且能计算的分项;缺失写入量、缺失定价或无法计算的分项不补猜、不计入对应合计。每条请求的可计算价格分项与折算分项分别累加,不因另一分项缺失而丢弃已知部分。未提供独立写入项时不补造写入量,普通输入使用日志输入扣除已提供缓存读写后的余量。图表、运行详情及每日明细采用相同规则;费用占比分母不完整时仍保留未知状态。底部“统计口径与计算说明”按钮默认收起,点击才显示计算公式和统计范围,不使用悬停提示。
- 速度右侧的“↑ / ↓”只统计最近一次提问/运行;运行中增量更新,新提问时清零。窄栏优先隐藏这两项。
- 底栏 Hit = 最近一次提问/运行所有请求的缓存输入 / 原始输入,按输入 token 加权。浮窗“当前会话”的缓存命中率数值始终取整个聊天,不受模型筛选影响;日期选项取所选范围与模型的加权缓存命中率。命中率图表按所选模型/来源分组计算。
- 底栏
… t/s = 本轮输出 Token / 本轮从开始到结束的总秒数,包含思考、工具执行、网络与等待时间;运行中使用已过去的时间,结束或中止后固定。不再依赖单条消息的生成计时,也不按消息耗时过滤输出 Token。缺少有效轮次耗时或尚无输出时显示 —。
- 缓存属于输入的子集;推理 token 按记录的子项展示逻辑处理,不再次加入总量。
- “当前会话”柱状图按每次提问/运行汇总费用,同轮内多次 API 请求合并;点击柱子查看模型、总输入/输出 Token、缓存及开销,再次点击收起,悬浮不显示提示。支持键盘 Enter,最多展示 60 根柱,超出时合并相邻轮次并保留统计总量;模型和来源筛选后保留原轮次编号。
- “近一天”精确按当前时刻往前 24 小时过滤,柱状图显示这段时间内的 24 个小时区间,以开销计;无新增日志时也会更新滚动边界。近一周、近一个月与自定义仍按日历日期统计。
- 日期统计使用每个请求的记录时间。跨午夜的请求记在用量记录落盘的日期。
- 优先读取
token_usage_record,按响应 ID 去重,兼容旧版 token_count 累计增量。不会将两种记录重复相加。
- 扫描
sessions 和 archived_sessions。切换聊天按组件的真实聊天 ID 绑定,不猜测最后修改的日志。
- 历史未记录、已删除或其他设备上的请求无法计入。初次扫描在后台进行,后续每约 2.5 秒增量更新;不存在每个 token 都精确实时计数的保证。
- 主题设置存于 VS Code 设置,日期选择存于 Codex 数据目录的
usage-widget/preferences.json。不修改会话 JSONL。
响应与缓存
独立横条按自身宽度、统计文字与字体缓存测量结果。原生发送/停止按钮的图标重建、透明度或 transform 变化均不会触发统计条重挂载、主题写入或宽度读取;仅监听挂载结构、会话与主题的实际变化。避免每帧清空统计条宽度和轮流探测各尺寸;数值、横条宽度或字体加载变化时重新测量。统计数据更新合并到动画帧,避免同步响应期间阻塞交互。
新增或修改指标时升级统计缓存版本,丢弃旧版本的全部统计缓存(含索引、计价与汇总),重新读取本机日志并计算;本次 0.5.32 已执行该迁移。定价表和偏好设置保留。重建完成后正常缓存新结果,日常切换指标只改变图表展示,不重复扫描日志。
价格目录按模型 ID 建立索引,避免每条历史请求都遍历整张价格表。逐请求计价与日期转换结果复用;新增记录只计价新增部分。
宿主缓存会话汇总、日期范围和模型筛选结果,最多保留 128 个查询结果和 64 个会话汇总;日志用量变化、删除/截断、价格表更新时自动失效。聊天正文流式输出不触发统计重算;按时区跨午夜后更新日期范围。
首次前台查询返回后,依次在后台预计算当前会话、近一天、近一周、近一个月,并推送给界面。每个范围之间让出事件循环,不预计算自定义日期。浮窗关闭且会话运行时,后台轮询只更新当前会话,将日期范围预计算推迟到运行结束或浮窗打开,减少扩展宿主的额外计算压力。
界面最多缓存 64 组统计。再次打开或切换已缓存范围时,先立即显示已有结果,再后台更新;新版本到达时保留其他范围的旧结果,直到对应预计算更新;防止晚到的旧版本覆盖新统计。宿主将统计与日志读取位置持久化,重新加载窗口后先恢复上次结果,再后台校验并推送更新;未变化的历史日志无需重新解析。
磁盘缓存位于 Codex 数据目录的 usage-widget/statistics-v1.json.gz,保存用量索引、计时、已计价记录和已计算的统计,使用压缩和原子替换,文件权限为仅当前用户读写。只保留统计元数据,不保存聊天正文或未完成的 JSON 尾部;修改最多合并约 15 秒后写盘,正文流式更新不会触发写盘。
新增日志从上次完整记录的位置继续读取;删除、截断、替换与归档会重新校验。价格表指纹变化时复用用量索引并重新计价;跨午夜和时区变化时重新匹配日期范围。缓存损坏、版本不兼容或磁盘无法写入时回退到正常日志扫描/内存缓存。首次使用或删除磁盘缓存后仍需完整读取一次。
Webview 请求按顺序处理,避免收到回复后立即切换栏目时被误报为“统计正在更新”。
统计未变化时复用现有界面,保留模型按钮焦点;每日明细只在展开时生成。忽略聊天正文的 DOM 更新,减少生成过程中的无效宽度测量。
模型定价
优先获取 https://models.dev/api.json,不可用时回退到 LiteLLM 的 model_prices_and_context_window.json。价格保存在 Codex 数据目录的 usage-widget/prices-v2.json。启动与空闲查询只加载本地缓存,不发网络请求;运行期间先检查上次成功获取价格表的时间:缓存未超过 24 小时则复用,超过 24 小时、时间戳无效或没有可用缓存才在后台下载并重新缓存;跨运行、跨重启同样复用有效期内的磁盘价格表。多个视图和并发检查合并为一次刷新,下载期间继续使用旧表;失败保留旧表与原成功时间,至少间隔一分钟后重试。没有缓存则等待后台获取结果。兼容读取 v1 缓存的输入比例,金额需新表补齐输出和缓存写入价格。两种数据源统一归一化为美元/token。
模型 ID 和提供商忽略大小写及首尾空格,按完整 ID 和可用的上下文/服务价格档匹配,不模糊套用相似模型。优先使用提供商自己的价格;custom 或价格目录中不存在的自定义网关名(如 aimoo、aiearth)按完全相同模型 ID 的唯一官方提供商价格折算,不能反映网关自行调整的收费。如果多个官方区域提供商存在不同报价,保留未匹配状态。按当前公开定价估算,不重建历史账单;缓存比例不是写死的。
定价尚未下载或未匹配时,受影响的金额、费用占比或折算输入显示 —,保留真实输出、输入缓存和 Hit;无缓存的输入无需价格即可确定。浮窗会列出定价缺失的具体模型名;不会将已知部分金额当作完整占比。模型费用按每个请求实际记录的模型和提供商分别累加,支持同一会话切换模型;筛选只影响浮窗,不改变底栏最近运行的 Hit、速度或 token 计数。缓存写入使用日志的 cache_write_input_tokens 与价格表的默认写入单价;无法匹配所需单价时不估造费用。默认常规定价;日志携带可识别的服务档位时选用对应价格。
Codex UI 补丁
原版 Codex 没有第三方 UI 插槽,本插件需要修改其前端和扩展入口。首次修改前备份到 Codex 扩展目录的 .codex-usage-backup,记录原始和补丁 SHA-256。
已适配 openai.chatgpt 26.51111.21308。后续版本会先识别全部挂载点;识别失败则不修改文件。启动时检查补丁,支持新扩展目录自动适配;不覆盖补丁安装后出现的其他文件修改。Codex 更新到新版本可能需要重新适配。
修改范围:Webview HTML 加载组件;前端传递现有消息 API、标记底栏和真实会话 ID;扩展宿主加载独立统计桥。保留 Codex 原有内容安全策略,不放宽脚本或网络权限。
开发与验证
npm install
npm test
npx playwright install chromium
npm run test:ui
npm run package
运行时使用 VS Code 自带 Node.js,开发测试需要 Node.js 18+ 与 Python 3。UI 测试使用模拟宿主验证显示与交互;实际 VS Code Webview 仍需重新加载后进行集成验收。
运行时横条数字按位滚动,低位先变化,进位与借位依次带动高位;切换会话或新轮次不播放数值变化动效。速度指针摆动,用量三根柱错峰轻微涨落;系统启用减少动态效果时全部停用。首次模型筛选等待期间保留原内容,避免浮窗先收缩后展开。
浮窗筛选时柱高从原值平滑过渡;范围切换时尺寸以 240ms 过渡,未缓存范围等待期间保留完整内容。连续切换接续当前尺寸,减少动态效果时立即更新。
统计引擎运行于同一扩展宿主主机上的独立 worker:日志解析、计价、汇总、缓存序列化均不占 Codex 扩展宿主线程。Worker 异常退出后下次请求自动重建。
横条数字使用固定宽度槽位;用量变化不重新测量整条布局。暂缺本轮指标保留透明槽位,窄栏仍按优先级隐藏整项。原生 utility rail 内部图标和文字更新不触发全局扫描。
未选会话时已读取磁盘统计并预计算日期范围及最近 32 个会话摘要;前端日期缓存跨会话共享,选择预读会话先显示摘要再校对,自定义日期仍按需计算。
数字滚轮逐位显示中间数字,大幅变化至多多滚一圈以限制动画时长;单位和小数点静止。位数减少时高位最后退去。浮窗尺寸动画期间隐藏溢出,动画结束后恢复必要的滚动,避免瞬时滚动条。
柱图悬浮或键盘聚焦显示横轴区间和带单位的指标精确值;上方最大值参考线与下方轴说明随筛选变化。浮窗关闭淡出,主题颜色渐变,内部组件展开收起统一使用尺寸动画。横条恢复内容宽度,以位置过渡衔接数值变化。
内部展开在原生点击处理结束后记录目标布局;除外框外,展开区域自身的高度及下方内容位置也使用 240ms 过渡,浮窗达到视口高度上限时仍可见。
横条响应通过空闲回调与动画帧合并;输入区按钮点击后短暂让出渲染,不在原生发送处理期间插入统计测量。相同 thread 属性重写不触发组件扫描。新轮次尚无命中率/速度时暂留上一轮数值(辅助说明注明),切换会话清空。借位后移除空高位格,加号独立居中等距排布。
模型饼图忽略金额无法完整计算的模型,按其余已定价模型的费用重新归一化为 100%;缺失模型仍可筛选原始用量。来源占比使用相同分母,缺失模型及其来源不分配虚构占比。
运行时统一排除无法完整计价的用量记录:它们不进入 Token、折算、金额、命中率及图表汇总,也不提供模型筛选,只显示 ⓘ 缺失定价提醒。原始日志不修改,价格补齐后重新纳入。此口径由后台统计引擎显式启用。