【2026】Hermes Quota 插件完全指南：一眼看清 AI 提供商的剩余配额

「我还能调用多少 AI？每次都要打开 API 后台，太麻烦了……」

「我同时用多个 AI 提供商，却掌握不了剩余配额。」「我想在下一次请求失败前，就知道使用上限。」

这正是Hermes Quota 插件要解决的问题。

结论：Hermes Quota 是一款在 Hermes Desktop 界面内、实时显示每个 AI 提供商剩余配额（使用上限）的插件。通过状态栏的小标签和侧边栏的专用面板，一眼就能看清每个提供商还剩多少。

本文用图解方式，清楚讲解安装、用法、CLI 命令和故障排查。

本文内容

Hermes Quota 是什么
工作原理（数据流图解）
安装方法（3 步）
界面怎么看（状态栏 / 面板 / 设置）
CLI / 聊天命令一览
支持的提供商与 Grok 手动开启
故障排查
读者想了解的内容

Hermes Quota 是什么？

Hermes Quota是由 rarf/hermes-quota-plugin 发布的 Hermes Agent 独立插件。

它做的事很简单：让你在下一次请求失败前，就能看到 AI 提供商的剩余配额。

主要功能

状态栏（右下角）：始终显示剩余最少提供商的紧凑标签。悬停可展开全部提供商、全部时间窗口（Session / Spark 5h / Spark Weekly 等）的详情（剩余 %、重置倒计时）
配额面板（侧边栏）：每个提供商一张卡片，含官方品牌图标、进度条、套餐徽章和详情（积分、重置计划）
CLI / 聊天命令：hermes quota 或 /quota，在终端或聊天里也能查看

支持的提供商

anthropic、openai-codex、nous、openrouter、gemini、kimi，以及手动开启的 grok。

工作原理（数据流图解）

设计理念是「UI 自身不做网络 I/O」。后端刷新本地缓存，UI 只读取缓存。这样，查看配额就不会给正常的智能体响应增加额外网络调用。

Hermes Quota 的工作原理（数据流）

图解要点

后端从各提供商（anthropic、openai-codex、openrouter、gemini、kimi）获取配额
数据汇总到quota_cache.json（本地缓存）
Desktop 组件和 CLI/聊天都只是读取这份缓存

重点是：刷新只在「请求时」或「计划时」发生，而非每次模型响应时。不增加额外通信成本，就能看到最新配额。

安装方法（3 步）

git clone https://github.com/rarf/hermes-quota-plugin.git
cd hermes-quota-plugin
./install.sh

补充说明

Windows：在 Git Bash 中运行
macOS / Linux：在普通 shell 中运行
安装脚本会复制后端和 Desktop 组件，并启用插件
重新运行即可更新；./uninstall.sh 可对称卸载

多 profile 注意事项

Hermes 按 profile 解析插件。在命名 profile（如 affiliate）中，只在全局根目录（~/.hermes/）安装可能会显示「backend unavailable」。./install.sh 会自动处理这个问题。

界面怎么看

1. 状态栏（右下角）

始终显示剩余最少的提供商的紧凑标签。

标签显示最低剩余量
悬停可展开全部提供商、全部时间窗口的详情（剩余 %、重置倒计时）
可在设置中切换「仅最低」⇔「全部提供商」

2. 配额面板（侧边栏）

每个提供商一张卡片，包含：

官方品牌图标
带色调的进度条
套餐徽章
详情行（积分、已入账的重置）

没有数据的提供商折叠到「No data」区域，默认只显示有实时数据的提供商。

3. 配额设置（Quota Settings）

可逐个开关要显示的提供商。选择保存在本地并持久化。

CLI / 聊天命令一览

终端（CLI）

hermes quota              # 显示所有提供商
hermes quota refresh      # 重新获取最新数据
hermes quota status       # 显示状态（--json 输出 JSON）
hermes quota provider     # 按提供商显示

聊天内（斜杠命令）

/quota            # 显示配额
/quota refresh    # 强制重新获取
/quota grok       # 显示 Grok 配额

输出示例

📊 quota (fetched 1m ago)
• openai-codex · Session 45% (reset tomorrow 06:43)
• grok · Weekly 72% (reset tomorrow 18:00)
• gemini: unavailable (consumer-tier-deprecated)

_Run `/quota refresh` to force a re-fetch._

「unavailable」是提供商缺少凭证、或没有可用配额端点时的如实状态显示。

Grok 需手动开启

Grok 是唯一从浏览器（Firefox 的 grok.com Cookie）读取的提供商，因此默认关闭。

开启方法

hermes config set plugins.entries.quota.settings.grokEnabled true
hermes quota refresh

关闭时，Grok 只显示「opt-in-disabled」，不会读取任何 Cookie
开启后，先关闭 Firefox 再执行 hermes quota refresh
失败时会如实报告 auth-failed 或 cloudflare-blocked，绝不会伪装成「0%」

故障排查

Desktop 显示「Quota backend unavailable」

后端在 Desktop 启动时挂载，仅重载 JavaScript 是不够的。

关闭所有 Hermes Desktop 窗口
重新打开 Desktop
执行：

hermes plugins doctor quota
hermes quota refresh

Grok 显示「no-session-cookies」

插件会自动搜索标准 Firefox 配置。请确认已登录 Firefox。

Grok 显示「auth-failed」或「cloudflare-blocked」

浏览器会话已过期，或 Grok 拒绝了请求。请重新登录后再执行 hermes quota refresh。切勿把 Cookie 粘贴到 Issue 或聊天中。

隐私与安全

不包含任何遥测或分析
不打印 Cookie 或令牌
Grok Cookie 仅用于 Grok 的计费请求
缺少凭证时明确显示「unavailable」
不覆盖内置 Hermes 工具权限

读者想了解的内容

Q. Hermes Quota 免费吗？是的，MIT 许可，免费使用。

Q. 适用于任何 Hermes 吗？它是 Hermes Desktop 插件，独立结构，更新后仍可运行。

Q. 会增加网络调用吗？正常模型响应时不会。它只读缓存，查看配额不会拖慢响应。

Q. 能添加提供商吗？可以。在 quota_providers/ 注册一个返回 QuotaResult 的抓取器即可，缓存和组件无需修改。

Q. 支持多个 Hermes profile 吗？支持，./install.sh 已处理命名 profile。

Q. 为什么配额显示「unavailable」？缺少凭证，或该提供商没有可用的配额端点。这是正常现象。

总结：告别配额焦虑

Hermes Quota 能在 Hermes Desktop 界面内，实时显示 AI 提供商的剩余配额。

状态栏始终显示最低剩余量
侧边栏面板展示各提供商详情
CLI / 聊天用 /quota 即时查看
基于缓存，无额外通信开销

想在下一次请求失败前掌握剩余配额的人，这款插件值得安装，3 步即可完成。

参考链接

rarf/hermes-quota-plugin（GitHub）

信息截至 2026 年 8 月。插件规格与支持的提供商可能随更新而变，请以 GitHub 仓库为准。