Monitor Token 是一个轻量、常驻桌面的 Codex Token 用量悬浮窗，支持 Windows 和 macOS。它解决的问题是：Codex 的会话记录和周额度信息分散在不同位置，Monitor Token 把它们整理成一个不打断工作的悬浮窗。
主要能力
- 今日、本周、本月 Token 统计
- Codex 主周额度已用百分比和重置时间
- 三种显示样式：仪表卡、极简状态条、轻量卡片
- 四种数值格式：普通、千分位、智能缩写、固定 M
- 交互方式：拖动移动、双击刷新、右键完成所有配置
使用方式 运行前请先安装并登录 Codex CLI。程序会自动读取本机 ~/.codex/sessions，并尝试通过本机 Codex 服务获取主周额度。服务端额度暂时不可用时，可以右键设置手动周 Token 额度。右键窗口可切换样式、统计周期、数值格式，或设置手动周额度。
要求：Windows 10/11 或 macOS 12+、Python 3.9+、已登录的 Codex CLI。macOS 激活虚拟环境时使用相应命令（资料中未提供具体命令内容）。
技术实现
- 增量扫描 ~/.codex/sessions 中新增的 Token 事件，避免每次全量读取。
- 按本地时区汇总今日、本周和本月用量。
- 后台调用本机 Codex app-server 获取主周额度，失败时回退到最近的本地会话快照。
- PySide6 只负责渲染悬浮窗，扫描和额度请求不会阻塞界面。
适用场景 适合需要随时了解 Codex Token 消耗与周额度剩余情况的开发者，在不打断工作的情况下通过桌面悬浮窗查看用量。
限制与注意事项
- 当前安装包尚未进行商业代码签名。Windows 可能显示 SmartScreen 提示；macOS 首次启动时可在 Finder 中右键应用并选择“打开”。只从本仓库 Releases 下载应用。
- 本地 Token 数来自当前设备保留的会话文件；周额度百分比来自 Codex 服务，两者口径不同，因此统计和网页上看到的不完全相同。
- 当前 Release 仅提供 Windows 和 macOS，Linux 支持在路线图中。
- 更完善的无障碍和高 DPI 适配、Windows/macOS 代码签名仍在计划中。
项目欢迎提交 Issue 或 Pull Request，开发说明见 CONTRIBUTING.md，版本记录见 CHANGELOG.md。
