# Codex 用量查询

一个用于 uTools 的 Codex 用量查询插件，支持主界面仪表盘和悬浮窗两种查看方式，用来快速查看账号订阅、余额、当日与本周额度消耗。

## 功能概览

- 支持保存 Codex 查询 Key，本地持久化配置，重启后仍可直接使用
- 支持查询订阅套餐信息，包括套餐类型、开始时间、到期时间、总额度和周额度
- 支持展示账户余额、今日请求次数、今日消耗额度和今日总 Token
- 支持拆分展示输入 Token、缓存 Token、输出 Token、推理 Token
- 支持展示当日与本周已用比例
- 支持手动刷新和自动轮询刷新
- 支持悬浮窗模式，独立显示当日和本周额度占用
- 支持系统通知预警，可分别配置当日和本周阈值
- 支持错误提示，便于定位 Key 无效、接口异常或超时问题
- 适配深浅色外观

## 插件入口

插件提供两个入口：

- `codex-usage`
触发词：`codex用量`、`用量查询`、`codex quota`、`订阅查询`
- `codex-usage-floating`
触发词：`用量浮窗`、`codex浮窗`、`quota float`

其中主入口用于完整查看数据与修改配置，浮窗入口用于快速查看当日和本周用量比例。

## 使用说明

1. 在 uTools 中进入插件主界面。
2. 输入可用的 Codex 查询 Key。
3. 选择刷新频率。
4. 如有需要，开启预警并设置当日、本周阈值。
5. 保存后插件会立即校验 Key，并拉取最新数据。

保存成功后，主界面会展示：

- 账户邮箱
- 套餐订阅信息
- 账户余额
- 今日请求次数
- 今日额度消耗
- 今日总 Token
- 输入、缓存、输出、推理 Token 明细
- 当日与本周使用进度

## 配置项

- `Key`
用于请求 Codex 用量接口，支持直接粘贴原始 Key
- `刷新频率`
可选 `1 分钟`、`3 分钟`、`5 分钟`、`手动刷新`
- `预警阈值`
可分别设置当日和本周阈值，范围为 `50%` 到 `100%`
- `开启预警`
超过阈值后通过 uTools 系统通知提醒

预警通知默认每天只发一次，避免重复打扰。

## 浮窗模式

浮窗可从两种方式打开：

- 使用插件入口 `codex-usage-floating`
- 在主界面点击 `浮窗模式`

浮窗支持以下能力：

- 显示当日和本周已用比例
- 无配置时显示 `配置 Key` 按钮
- 右键菜单支持 `立即更新`、`显示更多`、`关闭`
- 聚焦浮窗时自动同步最新配置并刷新数据

站点地址：https://ylscode.com