dsh-gpt-quota-widget

GPT 娘 · Codex 用量挂件

为 DeepSeek Harness（DSH）Web 添加一个可拖动的桌面伙伴：查看 Codex 每周与 5 小时额度，跟随主会话切换八种角色状态。无需前端打包，无第三方 Node.js 运行时依赖。

第三方 DSH 插件，非 OpenAI 或 DSH 官方产品。代码与角色图片的使用及分发条件见 许可说明 和 素材说明。

实际挂件预览

上图由无头 Chromium 加载现有 http://127.0.0.1:3080 提供的真实挂件前端脚本、角色图片、用量与活动接口后截图，不是设计稿，未使用模拟额度。因 DSH 主页面在全新浏览器中要求认证，截图使用同源空白文档独立挂载真实脚本；不是已登录主页面整页截图。会话正文、账户标识和凭据均未包含。数字是截图时的实际快照，不代表当前额度。见 截图方法与复现。

八种状态

待机 idle	思考 thinking	推理 reasoning	回答 responding

工具 tool	等待 waiting	成功 success	失败 failure

八张透明 PNG 与 原始八状态源图 均保存在仓库及包内，不依赖外链图床。图片展示不构成许可授予。

功能

• 账户用量：每 60 秒刷新，也可手动刷新；展示本周已用、剩余比例、重置倒计时与 5 小时已用比例。宿主有 30 秒缓存，手动刷新不保证绕过它。
• 状态联动：每秒读取主会话活动；忽略委派子代理，支持用户创建的会话分支及并行主会话。工具使用面向用户的概括标签，不显示内部工具名。
• 按模型显示：当前标签页选择 GPT／Codex 模型时显示额度；其他模型仅保留 GPT 娘动画和拖动，暂停用量刷新。切换模型无需发送消息，切回后恢复原来的展开状态。模型尚未加载或选择失败时也只显示角色。
• 交互：显示额度时点击角色展开／收起，拖动移动；位置与展开状态存入当前浏览器的 localStorage。
• 视觉提示：周用量达到 75% 为橙色、90% 为红色；八种图片搭配独立动画，遵循系统减少动态效果偏好。

前置条件

• Node.js 20 或更新版本，以及已安装且可从 PATH 调用的 pnpm；一个正常运行的 DSH Web profile。
• DSH 需提供 webServer、credentials 及 session/event API。安装命令已在 DSH 0.1.2-rc.1 验证；DSH 仍在演进，不承诺所有历史／未来版本兼容。
• 在 DSH 模型设置的 OpenAI Codex，或 dsh-codex-subscription 中完成 ChatGPT OAuth 登录。无需将 token 写进本插件。
• 宿主能访问 OpenAI 的用量服务。未登录时挂件显示提示，不会自行登录。

安装

推荐从 GitHub 安装。示例中的 web 是运行 DSH Web 的 profile 名；使用其他 profile 时请替换。

从 npm 安装

npm 包发布后可使用以下命令；

dsh plugin --profile web add dsh-gpt-quota-widget

如需固定版本，在包名后添加 @版本号。

从 GitHub 安装

dsh plugin --profile web add github:AceAttorney/dsh-gpt-quota-widget

源码仓库：AceAttorney/dsh-gpt-quota-widget。默认安装仓库默认分支；如需固定发行版本，在仓库名后添加 #标签名，使用仓库中实际存在的 release tag。

启用挂件

安装会将依赖加入指定 profile，并通过 package.json 的 dsh.bundle.patch 加载 cordis.patch.yml。包内包含运行源码、八张角色图与文档，无需额外编译。

安装完成后，重启对应 DSH Web 进程，再刷新浏览器。挂件将显示在页面右下角；点击角色展开额度详情，拖动角色可调整位置。

卸载

dsh plugin --profile web remove dsh-gpt-quota-widget

随后自行重启对应宿主并刷新页面。卸载不清除浏览器中的 gpt-quota-widget-open、gpt-quota-widget-pos；需要时可在浏览器站点存储中删除这两个键。

支持的 Codex 接入方式

目前支持通过以下 OAuth 登录查看 Codex 账户额度：

• DSH 内置 OpenAI Codex OAuth：在 DSH 模型设置中登录，读取内置 llm-pi-ai/openai-codex 凭据。
• dsh-codex-subscription：读取凭据引用 OPENAI_CODEX_SUBSCRIPTION_OAUTH。

同时存在时，优先读取订阅插件引用，再回退到 DSH 内置凭据。无需将 token 写入本插件；这不是普通 OpenAI API key 的计费或余额查询。

目前尚未适配 V1ki/dsh-plugin-subscriptions 的独立多账号登录存储；它与上述 dsh-codex-subscription 不是同一个插件。

隐私提醒：额度与活动状态属于私密信息，请勿将 DSH 或 /gpt-quota/* 直接暴露到公网。

常见问题

没有挂件／脚本 404？ 确认插件已安装到运行 DSH Web 的 profile，并重启对应宿主后刷新页面。不要启动另一个前端开发服务器来替代 DSH Web。

“请先登录”或“暂不可用”？ 先检查 DSH 的 Codex 登录；401／403 通常需要重新授权，5xx 或超时可能是上游／网络问题。不要将完整凭据、网络响应或 profile 文件贴进公开 issue。

如何升级？ 使用上面的 npm 安装命令重新安装，或指定目标版本；GitHub 安装可指定新的 release tag。完成后重启对应 DSH Web 进程并刷新页面。

状态与当前标签页不同？ 活动来自宿主的主会话事件，不绑定当前浏览器标签页；并行主会话和短暂的完成／失败状态会影响当前展示。

许可与贡献

形象来源声明：GPT 娘形象来源于 B 站 UP 主 ZipZipPipe。相关权利归原权利人所有，如有侵权请联系删除（侵删）。 此署名不代表已获得素材使用或再分发授权，详见 素材说明。

当前没有对代码或素材作公开授权，也没有声称任何作者身份。提交公开贡献、分发仓库或 npm 包前，请先完成 发布清单。代码与角色素材必须分别核验，不能以代码许可替代图片授权。项目是第三方集成，不代表 OpenAI 或 DSH 官方。