前言¶
在 DeepSeek Harness（DSH）里跑智能体时，Codex 订阅、Gemini 账号池和平台钱包往往是三套独立入口：额度分散在别的插件设置页里，钱包又要另开界面查。长时间会话里，你很难在不动鼠标的情况下判断「这周还剩多少」「五小时窗口何时重置」「平台余额够不够」。dsh-quota-bar 是 GuoruiC 维护的客户端插件，把这三类只读指标收成窗口底部一条状态栏；每个来源可单独关闭，关掉后不再发起任何请求，适合只想盯其中一两格的人。
这是什么¶
插件全名 dsh-quota-bar（仓库 GuoruiC/dsh-quota-bar），当前版本 0.3.0，许可证 MIT。分类为 DSH 社区目录里的客户端插件；GitHub 星标数为 2（以仓库页面为准）。
它不查上游、不持有账号，只是已有数据来源的「仪表」：
| 格子 | 数据真正来自 | 你需要先做的 |
|---|---|---|
| Codex | dsh-codex-subscription 里已登录的 ChatGPT / Codex 账号 |
在该插件里完成 Codex 订阅登录 |
| Gemini | dsh-gemini-pool 账号池里已登录的 Google 账号 |
在该插件里登录 Google 账号 |
| DeepSeek | DSH 平台账号充值钱包（充值 + 赠金） | 在 DSH 里登录平台账号 |
未安装、未登录或 token 过期时，对应格子显示「未登录 / 不可用」，属于如实反映而非本插件故障。
核心功能¶
底部状态条大致形态如下（示意，具体数值随账号变化）：
● Codex 周 54% · 5h 97% · 4 小时 33 分后重置 │ ● Gemini 周 100% · 5h 100% · 4 小时 35 分后重置 │ ● DeepSeek ¥106.04 更新于 18:49 ⟳ ⚙
额度与颜色
- Codex / Gemini：各显示「周」与「5 小时」两个窗口的剩余百分比；重置倒计时取该来源最近的一个窗口。
- 颜色取两窗口里最低百分比：≥50% 绿、20–50% 琥珀、<20% 红。
- DeepSeek：平台钱包合计；有赠金时会标出「赠金 ¥x」。余额颜色：≤0 红、<¥20 琥珀、其余绿。
交互
- 悬停可看完整明细（各窗口剩余与重置时刻；钱包拆分充值 + 赠金）。
- 右侧
⟳强制刷新已开启的来源；平时 Codex / Gemini 每 60 秒、DeepSeek 每 10 分钟自动刷新。
可选来源
- 状态条
⚙或 设置 → 额度条 可开关各来源；关闭后既不显示也不请求（Codex 不调 RPC、Gemini 不fetch、DeepSeek 不调账号服务）。 - 开关保存在浏览器
localStorage（键名dsh.quota-bar.sources.v1）。 - 首次运行会探测一次，对返回「未登录」的来源自动关掉，避免每 60 秒打失败接口；之后不再自动改动。
- 三个全关时保留一行「额度来源已全部关闭」和
⚙。
隐私与权限（README 原文）
- 只读：不写数据、不改配置、不代替其他插件操作。
- 仅请求本机 DSH 的
/api/codex-subscription/usage、/antigravity/api/status，以及经宿主访问的remote.account.getBalance；无第三方上报与遥测。 - 实现位于明文
lib/client.js，无混淆。
安装与启用¶
命令行安装（须与 README 一致）：
dsh plugin add github:GuoruiC/dsh-quota-bar
装完后重启 DSH（bundle 在宿主启动时装配），界面底部应出现状态条。
也可在 DSH 内 插件 → 发现 搜索 quota 或 dsh-quota-bar 从市场安装。
环境要求：需要带 shell.bottom 槽位与客户端插件能力的 DSH；作者在 2026-11 的 DSH Desktop 构建上开发与验证。被观测的 Codex / Gemini 插件均为可选依赖。
典型用法¶
- 按上节安装并重启 DSH。
- 在
dsh-codex-subscription、dsh-gemini-pool与 DSH 平台账号中完成你实际要用的登录；不需要的来源可在额度条⚙里直接关掉。 - 日常盯盘看底部条即可；需要即时数据时点
⟳。Codex 的 usage 有内部缓存，手动刷新才会强制拉取。 - 换机器或清空浏览器缓存后，来源开关回到默认（三源全开 + 重新探测），需按需再关。
适用场景与注意¶
适合谁
- 经常在 DSH 里切换模型、又不想反复打开订阅/池子设置页查额度与余额的开发者。
- 只用 DeepSeek 钱包、不用 Codex/Gemini 的人：关掉对应格即可零多余请求。
安装前建议
- 插件在 DSH 客户端进程内以 Web 侧脚本运行，会按已开启来源访问本机 DSH API 与账号服务；安装前可阅读仓库
lib/client.js与 MIT 许可证。 shell.bottom为 root 级单占位槽位；若其他插件也占用底部槽位可能冲突。- 社区目录 skillhub.cn 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；星标、版本以仓库为准。
结尾¶
dsh-quota-bar 把 Codex、Gemini 额度与 DeepSeek 钱包收成一条只读底栏，来源可选、关闭即停请求，适合作为 DSH「一切皆插件」生态里的轻量观测组件。进一步了解可看 目录页 与 GitHub 仓库。
