前言¶

在 DeepSeek Harness 里同时用 Codex 时，额度往往要切到 ChatGPT 网页或别的工具里查 5 小时窗口和每周上限，打断工作流。社区插件 dsh-codex-usage（维护者 sodaa-l，分类：联网工具）把这两类剩余额度直接嵌进 DSH 侧栏与底栏，并显示重置时间；接口不可用时不做估算。下面介绍它的能力、安装方式与使用注意点。

这是什么¶

dsh-codex-usage 是 DSH 用量类插件：在侧栏与底栏展示 ChatGPT Codex 账户的 5 小时与每周额度。卡片背景透明，显示剩余比例和重置时间，字体与主题色与 DSH 一致。源码与说明见 GitHub，目录页见 SkillHub。当前 package 版本为 0.1.1，采用 MIT 许可。

核心功能¶

侧栏与底栏共用一次请求、同一份用量快照与刷新时刻；多个会话或迟挂载的底栏也会同步。

1. 额度展示：显示当前可用的 5 小时和每周额度。套餐没有 5 小时窗口时只显示每周额度；接口失败或没有可识别额度窗口时显示不可用状态，不估算额度。
2. 侧栏：设置页提供侧栏总开关；5 小时与每周为缩进子开关。关闭总开关后子开关禁用，原选择保留。关闭总开关会隐藏卡片。
3. 底栏：在其他底栏控件之后排列 Codex 标志 5h ▰ X%・1 周 ▰ X%，百分比为剩余额度，不显示重置时间；短粗进度条沿用主题色。点击底栏控件可在上方展开与侧栏共用的完整用量卡片；再次点击、点外部、失焦或按 Esc 收起。底栏有独立总开关及子开关，默认开启，不受侧栏开关影响；关闭总开关或两项子开关会隐藏控件，弹出卡片仍展示套餐支持的两种额度。
4. 刷新：自动刷新间隔可选 1、5、15 或 30 分钟，默认 1 分钟。显示选项与刷新间隔保存在当前浏览器，不跨浏览器同步。两个额度窗口到达重置时间后会强制刷新。至少一个侧栏或底栏入口可见时继续共享自动刷新；全部隐藏或卸载后停止自动刷新，设置页仍可手动刷新。

Host 向 https://chatgpt.com/backend-api/wham/usage 请求额度（经 @earendil-works/pi-ai 的 OpenAI Codex OAuth 提供器）。该接口不是公开稳定 API，字段与套餐支持可能变化；部分套餐或组织账户不会返回 5 小时窗口。成功结果默认缓存 60 秒，失败结果最多缓存 10 秒。

Bundle 可选配置：

安装与启用¶

运行要求：DSH >=0.2.0-rc.1，Node.js >=22.19.0。

DSH Web¶

在运行 Web profile 的主机上执行：

dsh plugin --profile web add dsh-codex-usage

DSH Desktop¶

打开 Desktop 工作区，侧栏进入「插件」，选择「添加插件」，输入 dsh-codex-usage 并安装，完成后选择「立即启用」。

插件以当前 DSH 进程权限运行；安装前建议阅读源码与 LICENSE。SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

登录与典型用法¶

启用后，在 DSH 设置中打开「Codex 额度显示」，点击「登录」，用系统浏览器完成 OpenAI 授权。浏览器未自动打开时可点设置页登录链接；本机回调未完成时可粘贴浏览器跳转后的完整地址。等待授权时可取消，也可随时退出账户。

凭据由 DSH 凭据服务保存为 dsh-codex-usage/openai-codex；令牌刷新由凭据服务串行写入，访问令牌留在 Host，不会传给侧栏 Client。使用本插件不需要 Codex CLI。

典型流程：安装并启用 → 设置里登录 → 按需调整侧栏/底栏开关与刷新间隔 → 在侧栏看完整卡片，或在底栏看简要百分比并点击展开详情。

适用场景与注意¶

适合在 DSH Web 或 Desktop 中长期使用 Codex、需要随时对照 5 小时与每周剩余额度的开发者。底栏弹层依赖原生 Popover 与现代浏览器；样式绑定当前 DSH 插槽（侧栏 sidebar.footer.action、底栏 conversation.composer.dock），若 DSH 调整插槽布局，插件可能需要复核。

本地开发验收时，可用 dsh-codex-usage@file:<项目目录> 安装，Loader entry 名称须与 package.json 的 name 一致；克隆或 npm ci 不会自动把插件装入 DSH，安装与登录需分别完成。

结尾¶

dsh-codex-usage 把 Codex 5 小时与每周额度收进 DSH 界面，减少切换查额度的成本。更多信息见 SkillHub 目录页 与 GitHub 仓库。