Codex Cache Status

在 VS Code 状态栏显示 Codex 缓存读取结果和默认 30 分钟估算倒计时。只读本地日志，不发送网络请求，不自动保温，不弹通知。

安装

直接只需下载 .vsix 并在 VS Code 中安装，无需下载源码，也无需额外安装 Node.js 或 npm。

在 VS Code 命令面板运行 Extensions: Install from VSIX…，选择 codex-cache-status-0.1.2.vsix。WSL 窗口中应安装在 WSL 侧。安装后如未出现状态栏，运行 Developer: Reload Window。

也可以在下载文件所在目录打开终端，运行：

code --install-extension ./codex-cache-status-0.1.2.vsix

显示与会话选择

首个请求的读取结果保留到下一条消息。支持 user_message 和带 user.* 内容标记的 response_item；缺失消息事件时使用 task_started 识别轮次，忽略注入的环境信息。后续工具调用的命中不会覆盖它。悬停查看首个请求和最近请求的缓存 token 数及输入占比。

发送消息先重置倒计时；新的有效用量事件再次刷新。时间依据是本地事件时间，存在生成和日志写入延迟，不是服务端缓存写入时间。重复用量快照、工具输出和普通文件修改不刷新计时。倒计时归零不代表缓存已删除，未归零也不保证下一次命中。read 0 不代表没有写入缓存。

默认从当前工作区及其子目录的主会话中，选择最近发送消息的会话。排除 Codex 后台子会话。点击状态栏按对话名称选择，可以固定会话或恢复自动选择。名称读取会话目录同级的 session_index.jsonl。插件无法读取 Codex 面板当前选中的聊天。

加载的日志末尾不含用户消息时，自动选择暂按最近用量时间排序，首个请求显示未知；下一条消息到达后恢复正常跟踪。

自动发现最近 7 个 UTC 日期目录，最多考察 96 个最新文件名，筛选后最多跟踪 24 个主会话。已选会话在运行期间继续保留。老会话或候选范围以外的会话可运行 Codex Cache: Track a Session Log… 手动选择。

设置

使用 VS Code 原生状态栏，颜色随主题。无网络、账户、API key、遥测或运行时第三方依赖。

资源限制

• 使用一个串行 setTimeout 循环，不同时执行多轮读取；退出或设置变更时释放资源。
• 每轮最多读取 2 MiB 的会话增量，单文件每轮最多 512 KiB。没有变化的日志只检查文件状态。
• 新会话发现至少间隔 15 秒；最多额外读取 96 个候选文件各 64 KiB 的开头，顺序处理并复用缓冲。
• 首次加载仅读取开头及末尾 512 KiB；不完整历史中的首次请求可能显示未知。
• 每个读块 64 KiB，未完成行上限 256 KiB。超长行跳过并在悬停提示，继续处理下一行。
• 对话名称索引最多读取末尾 1 MiB，只保留已跟踪的至多 24 个名称，每个最多 160 字符；至少间隔 15 秒检查，文件和会话列表未变时不重读。
• 最多 24 个读取器；保存有限的时间、计数和路径，不保留完整对话或请求历史。部分行缓冲理论上限合计 6 MiB，另有 Node/VS Code 运行开销。
• 所有文件句柄在本次读取结束时关闭；没有递归文件监听器、后台进程或 Webview。
• 倒计时按绝对时间计算；电脑睡眠后不会逐秒补跑。