在 Codex 聊天输入框上方,查看用量、额度与使用足迹。
Codex Pulse 是面向 Codex VS Code 扩展的本机补丁,在聊天输入框上方添加用量卡片。
| 功能 | 说明 |
|---|---|
| 会话用量 | 显示会话 token、当前账号与官方订阅套餐(Free / Plus / Pro 等) |
| 周剩余额度 | 百分比、进度条与重置时间 |
| 使用历史 | 每日 token 用量热力图 |
| 主题适配 | 沿用 VS Code 配色的紧凑卡片 |
本项目非 OpenAI 官方产品,也不是独立 VSIX 扩展。用量数据来自官方 Codex 接口,界面嵌入依赖扩展内部结构。补丁不会关闭 Codex 自动更新,升级后可能需要重新应用或适配。
- Node.js 22+ 和 Git。
- 已安装并登录的 Codex VS Code 扩展。
- 对目标扩展目录有写入权限。
应用补丁无需运行 npm install。
git clone https://github.com/haochen12/codex-pulse.git
cd codex-pulse
node scripts/patch-codex.cjs status
node scripts/patch-codex.cjs apply确认 status 显示“未安装补丁;结构匹配”后再应用。完成后,在 VS Code 命令面板运行 Developer: Reload Window / 开发人员:重新加载窗口。
Windows、macOS 和 Linux 使用相同命令;目前已实机验证 Windows / Codex 26.1111.21308。自定义目录及 Insiders 参数可通过 node scripts/patch-codex.cjs --help 查看。远程环境请在 Codex 实际运行的扩展宿主中执行。
在源码目录运行以下命令,然后重新加载窗口:
node scripts/patch-codex.cjs restore将仓库中的 skills/codex-pulse-update 文件夹复制到 ~/.codex/skills/;设置了 CODEX_HOME 时,复制到其 skills/ 目录。重新加载技能后,在 Codex 对话中输入:
$codex-pulse-update 更新补丁
技能会检查当前版本、更新源码,并重新应用兼容的补丁。仅检查时输入 $codex-pulse-update 检查补丁状态。技能仅在调用时执行,不会在后台自动维护。
更新 Codex Pulse 源码:如果当前版本已打补丁,先用旧源码恢复,再拉取更新:
node scripts/patch-codex.cjs restore
git pull --ff-only
node scripts/patch-codex.cjs status
node scripts/patch-codex.cjs apply当前版本未安装补丁时,跳过 restore。仅在 status 显示未安装且结构匹配时执行 apply;成功后重新加载 VS Code 窗口。
Codex 升级后卡片消失:在源码目录运行 status,显示“未安装补丁;结构匹配”时再运行 apply,然后重新加载窗口。显示已安装且校验通过时,无需重复应用。
遇到结构不匹配或文件校验失败,请保留备份并通过 Issues 提供版本和错误信息,等待适配。不要将旧版本备份恢复到新版本目录。
欢迎提交 Issue 或 Pull Request。报告问题时请提供操作系统、VS Code 与 Codex 版本、复现步骤及错误信息,并移除账户等个人信息。
提交代码前运行 npm test。修改界面时,先执行 npm ci 和 npx playwright install chromium,再运行 npm run test:ui。
本项目采用 MIT License。
