前言¶
在 DeepSeek Harness 里切换多个 AI 提供商时，额度往往分散在各家控制台、CLI 或本地凭据里，很难在写 Harness 的同一屏里一眼看完还剩多少。手动打开网页查配额，或分别跑 mmx quota show 之类命令，会打断开发节奏。dsh-quota-hub（额度中心）把多家提供商的 5 小时窗口、每周额度、余额等汇总到 DSH 侧边栏，用半圆形彩虹拱做总览，并可选配套 macOS 菜单栏应用 QuotaBar。下面介绍它是什么、能读哪些数据、如何安装与日常使用。
这是什么¶
dsh-quota-hub 是 Wldeinsamkeit 维护的 DeepSeek Harness 可视化插件：在侧边栏实时展示 AI 提供商额度，核心 UI 是「每道弧代表一家 AI、按剩余额度填充」的半圆彩虹；全满即表示各家额度都较充足。社区目录 skillhub.cn 将其归类为趣味换装类插件；源码与说明见 GitHub 仓库，许可证为 MIT。插件以 DSH 的 Web 客户端形式注入侧边栏布局（package.json 中声明依赖 dsh 引擎 >=0.1.7）。
核心功能¶
侧边栏总览与交互¶
半圆彩虹拱上，每条弧对应一个已配置的提供商，填充比例反映当前所选维度下的剩余额度。点击可在 5 小时额度 与 每周额度 之间切换，切换与打开时带有加满动画。鼠标悬浮任意弧，可查看该家的详细信息：双窗口剩余、用量、重置时间等。
展开详情后，每个提供商一张卡片；每条额度类型（5 小时、每周、余额、日请求等）单独一条分档色进度条：剩余 90% 以上为绿，70–90 为黄，30–70 为蓝，低于 30 为红。
刷新与配置¶
数据默认每 10 秒自动刷新，也支持手动触发立即采集。README 说明为零配置：密钥从本机 DeepSeek Harness 凭据库（~/.dsh/.credentials.yaml）、~/.codex/auth.json（Codex/ChatGPT）以及已登录的 mmx（MiniMax）读取，文档明确写「任何密钥都不上传」。
数据来源（README 表格）¶
| 提供商 | 指标 | 方式 |
|---|---|---|
| Z.ai / 智谱 Coding Plan | 5 小时 + 每周 credits | 官方配额端点（Coding Plan Key） |
| MiniMax | 5 小时 + 每周（百分比） | mmx quota show / 官方接口 |
| Codex · ChatGPT | 5 小时窗口 + 每周窗口 | 官方用量端点（OAuth） |
| DeepSeek | 预付余额 | 官方 balance 接口 |
| Gemini · AI Pro | CLI 日请求 | 手工记录（官方无额度 API） |
配套 macOS QuotaBar¶
仓库内 companion-quota-bar/ 提供同一套数据的 macOS 菜单栏版（小彩虹图标 + 半圆彩虹弹窗），与侧边栏插件共用同一份 state.json，细节见仓库内 companion-quota-bar/README.md。
安装与启用¶
DeepSeek Harness 生态里插件可通过市场或命令行安装；本插件收录进 Plugin Market 后，可在 Plugins → Plugin Market 搜索 quota 一键安装。当前 README 给出的命令行方式为：
dsh plugin --profile <profile> add https://github.com/Wldeinsamkeit/dsh-quota-hub
将 <profile> 换成你实际使用的 DSH profile 名。README 还提到手动方式：在 Harness 插件管理里用 install_bundle 指向插件目录（需自行取得仓库内容，本文不展开 clone 步骤）。
安装完成后，插件按 package.json 配置在 Web 客户端立即注入侧边栏相关模块，无需在插件内再填一份密钥列表。
典型用法¶
- 在 DSH 中装好插件并保证本机已有对应提供商凭据（Harness 凭据库、Codex OAuth、
mmx登录等）。 - 打开 Harness 侧边栏中的额度中心视图，默认看到半圆彩虹总览；需要看周额度时点击切换 5 小时 / 每周。
- 悬浮某条弧核对重置时间与用量；需要分项进度条时展开详情卡片。
- 若 10 秒刷新不够及时，使用界面上的手动立即采集（具体入口以插件 UI 为准）。
- 若在 macOS 上使用 QuotaBar，按
companion-quota-bar/README.md配置，使菜单栏与 DSH 侧栏读取同一份state.json。
适用场景与注意¶
适合经常在 DSH 里混用智谱 Coding Plan、MiniMax、Codex/ChatGPT、DeepSeek 等、又希望在本机一眼看清额度窗口的开发者。Gemini · AI Pro 的日请求为手工记录，不能指望与其它家一样的自动 API 配额。
插件随当前 DSH 进程运行，读取本机凭据与调用官方端点；安装前应自行浏览 GitHub 源码 与 MIT 许可证，确认行为符合你的安全策略。社区目录站点与 DeepSeek / 幻方无官方从属关系，不等同于官方应用商店。
结尾¶
dsh-quota-hub 把多提供商额度收进 DSH 侧边栏的半圆彩虹与分档进度条，并支持 5 小时 / 每周切换与本地零配置凭据读取；需要菜单栏常驻时可选用同仓库的 QuotaBar。进一步了解可访问 目录页 与 GitHub：Wldeinsamkeit/dsh-quota-hub。
