前言¶
在 DeepSeek Harness（DSH）里用 Codex 订阅能力时，配额是否够用、各时间窗口何时重置，往往要打开 Codex 插件自己的界面或回想上次读数。若你已经在用社区插件 dsh-codex-subscription 完成 ChatGPT 账号登录与用量缓存，仍希望在 Web UI 左侧栏底部随时看到与 Command Code 面板风格一致的配额摘要，并一键展开完整仪表盘，dsh-codex-usage-panel（维护者 brianmoney，分类：客户端）正是为此设计的纯展示层：不直连 ChatGPT，只消费 Codex 插件经认证桥接上报的数据。
这是什么¶
dsh-codex-usage-panel 在 DSH Web UI 左侧栏底部固定一块 Codex 配额卡片，样式对齐旁的 Command Code 面板；点击卡片可打开主区域的配额仪表盘。OAuth、 /wham/usage 缓存与配额推算均由 dsh-codex-subscription 负责，本插件通过与其相同的已认证桥接读取报告，避免第二套凭据或与 Codex 面板读数不一致。
当前包版本为 0.1.0，许可证 MIT，Node 引擎要求 >=22。
核心功能¶
侧栏卡片（sidebar.footer.action，顺序在 Cordis 与 Command Code 之下）¶
展示配额环、「Codex」标题、状态徽标，以及每个配额窗口（如 5 小时、周度）的一行：重置时间、剩余百分比与全宽进度条。侧栏收起时，同一入口以 wide: false 提供约 36px 的图标按钮（仍带环）。
配额仪表盘（main，键 codex-usage-panel）¶
展示 Codex 插件报告的全部限速窗口，以及 credits / spend-limit / reset-credit 等磁贴、数据新鲜度说明；提供 Refresh 与 Close。Close 后回到对话界面。
数据来源与接口形态¶
本插件不直接访问 ChatGPT API，而是调用：
POST /api/codex-subscription/status -> { authenticated, provider, expiresAt? }
POST /api/codex-subscription/usage -> { rateLimits: [...], chatPass?, credits?, ... }
行为上与 Codex composer 读数一致：先查 status，避免未登录被误判为用量错误、或缺失路由被误判为已登出。窗口的 resetsAt 为 epoch 秒；credits.expiresAt 与 resetCredits.nextExpiresAt 为 毫秒。
轮询与展示语义¶
- 窗口可见时：启动时拉取一次，此后每 60 秒轮询；回到前台立即拉取；桥接不可用时每 5 秒最多重试 6 次。隐藏窗口不发请求。
- Codex 主机侧用量缓存约 60 秒，常规轮询成本低；仪表盘上的 Refresh 会带
force: true强制刷新。 - 传输错误时保留上次读数并标记过期；仅当从未成功读过时才显示不可用。
- 环与进度条表示剩余配额（与 Codex 插件词汇一致），剩余 ≤20% 时使用错误态主题色。
样式与语言¶
仅使用 --dsw-alias-* 主题令牌，随宿主亮/暗主题变化；不导入 Harness 客户端包，降低跨版本风险。文案在 codex-usage-panel 命名空间注册，支持英文与简体中文，随 UI 语言切换。
未安装或未就绪的 Codex 插件时，卡片不渲染内容，侧栏底部保持干净（属依赖缺失，而非「配额为零」）。
安装与启用¶
环境要求：
- 已启用 DSH Web UI（
dsh web或 Desktop 应用）。 - 已安装并登录
dsh-codex-subscription（peerDependencies要求>=2.5.0）。
在指定 profile 下添加插件：
dsh plugin --profile <your-profile> add github:brianmoney/dsh-codex-usage-panel
然后重启该 host profile（Desktop 用户可重启应用）。也可通过应用内插件管理器从包目录安装。
典型用法¶
- 确认
dsh-codex-subscription已完成 ChatGPT 登录且 composer 能正常显示配额。 - 安装本插件并重启 DSH / Desktop。
- 在左侧栏底部查看 Codex 卡片：5h、Weekly 等窗口的剩余百分比与重置时间。
- 点击卡片进入仪表盘，查看全部限速窗口与 credits 相关磁贴；需要即时数据时点 Refresh。
- 用 Close 回到对话主界面。
侧栏收起时，通过底部图标按钮仍可看到配额环并打开同一仪表盘。
适用场景与注意¶
适合： 已在 DSH 中使用 Codex 订阅插件、希望在侧栏固定位置快速扫一眼剩余配额、并偶尔展开完整仪表盘的用户。
依赖关系： 无 dsh-codex-subscription 则无展示；安装前请一并规划 Codex 插件的版本（≥2.5.0）。
安全与权限： 插件以当前 DSH 进程权限运行，安装前建议阅读 GitHub 仓库 源码与 MIT 许可证；勿在未审阅的情况下盲目添加第三方插件。
DSH 生态遵循「一切皆插件」；SkillHub 目录页 为社区收录站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-codex-usage-panel 把 Codex 订阅配额做成侧栏底部的常驻卡片与可展开的仪表盘，数据完全来自 dsh-codex-subscription，适合需要「看一眼剩余、必要时深挖」的日常开发流程。
- 目录页：https://www.skillhub.cn/plugins/brianmoney/dsh-codex-usage-panel
- 源码与说明：https://github.com/brianmoney/dsh-codex-usage-panel
