dsh-codex-usage ·「Codex 用量」

Codex 订阅配额 + DeepSeek 余额聚合，一键并入 DeepSeek Harness 的用量面板。

一个 DeepSeek Harness (DSH) host 插件：只读、回环、带缓存的聚合接口 GET /api/dsh-usage/overview，把 Codex (ChatGPT 订阅) 的滚动配额窗口 和 DeepSeek 账户余额 收进同一个 JSON 里，供 UI 插件渲染。

Codex Usage — a DeepSeek Harness host plugin that aggregates your Codex (ChatGPT) subscription quota windows and DeepSeek account balance into one loopback-only API endpoint.

---

这个插件是干什么的？

如果你在用 DeepSeek Harness + Codex 子代理（把日常工作委派给 Codex）， 最怕的就是订阅额度不知不觉刷爆——Plus 账号是按 5 小时 / 7 天 / 每月 滚动窗口限流的。这个插件：

• 📊 查 Codex 订阅配额：通过锁定版 @openai/codex@0.147.0 的 app-server 协议读取 account/read + account/rateLimits/read， 得到 5h / 7d / month 三个滚动窗口的 已用百分比 + 重置倒计时；
• 💰 查 DeepSeek 余额：官方 api.deepseek.com/user/balance （总余额 / 赠金 / 充值分列，自动按有余额的 USD 优先选币种）；
• 🔗 给 UI 一个聚合端点：一个 JSON、5 分钟缓存、?refresh=1 强制穿透， 前端只管渲染，不用碰任何密钥。

💡 有 ChatGPT Plus 账号？把它物尽其用。 配合 DSH 的 Codex 子代理（dsh-subagent-codex），日常写码、查资料、 跑测试都能交给 Codex 分担 DeepSeek 的 token 压力；本插件 + 配套的 DeepSeek 用量面板 就是你的"仪表盘"—— 一边干活，一边盯着配额不超限。

安装（需要 DSH ≥ 0.1.1-rc.x、Node ≥ 22）

## 可选配置

`cordis.patch.yml` 的 insert 条目加 `config`：

```yaml
- insert:
    - id: codex-usage
      name: dsh-codex-usage
      config:
        apiKeyRef: DEEPSEEK_API_KEY        # 余额接口 API Key ref（默认）
        codexUsageUrl: https://codex.app/account/usage     # 官方用量页链接（默认）
        deepseekUsageUrl: https://platform.deepseek.com/usage
        refreshMs: 300000                  # 缓存 TTL（默认 5 分钟）
        timeoutMs: 30000                   # Codex app-server / 上游超时（默认 30s）