---
name: codex-inline-quota-widget
description: 在 Windows Codex Desktop 左侧栏底部配置 OpenAI、GLM、DeepSeek 的只读额度摘要，并验证本机数据边界与原生视觉挂载。用于用户明确要求配置或排查 Codex 内嵌额度栏；不用于充值、消费或账户操作。
---

# Codex 左侧栏内嵌额度栏

这是 Windows Codex Desktop 的实验性本地界面补丁。它在 `.sidebar-navigation` 的页脚区、个人资料栏上方挂载“API 额度”：默认显示 OpenAI、GLM、DeepSeek 的紧凑摘要，点击才展开详情和刷新。摘要使用侧栏的直角分隔、字阶和悬停；详情沿用个人资料菜单的圆角、细边框与表面色，不启动独立黑色浮窗。

## 数据合同

- OpenAI：仅显示本机最近一次 Codex 周额度回执及其时间，不冒充实时 OpenAI API 查询。
- GLM：显示 5 小时和每周窗口的服务端剩余、百分比和重置时间。该监控接口没有公开文档；响应不符合预期就停止显示，绝不依据 token 推算。
- DeepSeek：显示官方余额接口返回的总余额、充值余额、赠送余额和可用状态。

渲染层经已验真的本机 app-server 代理请求 `codex/quota/read`；代理再访问回环地址 `127.0.0.1:18781/api/quotas`。DeepSeek 和 GLM 凭据由 Windows DPAPI 在本机子进程内存中读取，不能进入网页、URL、浏览器存储、日志或报错文本。读取额度不应触发模型调用、充值或消费。

## 配置与验证

1. 完全退出 Codex，检查 Node.js 22+ 和本机回环端口可用。
2. 用 `scripts/start-quota-dashboard.ps1 -NoOpen` 启动本机数据源，再通过“Codex 多模型”入口启动 Codex。启动器核对数据源的 `runtimeBundleVersion`，该入口安装/核对版本化代理与完整官方运行组件；仅有额度服务进程不证明当前 Codex 已加载代理。保留原凭据与已有服务边界，按端口、PID、脚本路径核对后才处理本插件的旧服务。
3. 确认额度栏位于个人资料栏上方，未随项目/对话列表滚动；确认紧凑摘要、点击展开和刷新均有实际读回。
4. 在空闲且无输入草稿时刷新页面，检查额度栏仍挂载且没有重复入口；某个供应商凭据缺失、接口失配或网络异常时，保留其它来源并只将该项显示为不可读取，不估算或静默改写配置。

## 说明与边界

这是参考同类侧栏额度工具后，自行做的三源 API 显示小窗口；不是第一个或唯一的同类产品。它不取代有历史曲线、告警或多终端同步的完整额度监控工具。Codex 更新可改变 DOM 或本机接口，之后必须重新验收。