Hermes Usage Monitor

把 OpenCode Go 额度和 DeepSeek API 余额、趋势、预测与诊断带进 Hermes Desktop。

一眼看到 5 小时、每周和每月使用率；无需反复打开 Console，也不需要常驻另一个应用。

OC Go  5h 12% · 周 28% · 月 19%   |   DS ¥86.42

_{Hermes Usage Monitor 2.0 实际界面}

English

它做什么

• 每 60 秒自动刷新，点击状态栏可立即刷新。
• 同时显示 5 小时、每周和每月额度。
• 悬停查看各周期的重置倒计时。
• 额度达到 80% / 95% 时变色提醒。
• 网络异常时保留最近一次结果，并明确标记为缓存。
• 提供 Hermes 命令面板操作：OpenCode Go：刷新额度。
• 使用 DeepSeek 官方余额 API，显示总余额、充值余额和赠送余额。
• DeepSeek 每 5 分钟刷新；没有配置 API Key 时自动隐藏。
• OpenCode 可切换“已使用”与“剩余额度”显示。
• 跨越额度阈值时主动提醒；恢复正常后会自动解除预警状态。
• 自动跟随 Hermes 的中英文界面语言。
• 内置配置与连接诊断，不会输出 Cookie 或 API Key。
• 提供 Hermes 原生详情页，集中查看额度、余额、趋势、设置与诊断。
• 在本机记录 DeepSeek 余额快照，识别充值并排除其对消耗计算的干扰。
• 累积至少 24 小时数据后，估算日均消耗和余额可用天数。

命令面板

在 Hermes 命令面板中搜索“用量监控”，可以：

• 切换 OpenCode 已用 / 剩余显示。
• 开启或关闭额度预警。
• 显示或隐藏 DeepSeek 状态栏。
• 检查 OpenCode Cookie、页面解析、DeepSeek API Key 和网络连接。
• 打开完整的 Usage Monitor 页面。

这些偏好保存在 Hermes 的插件本地存储中，重启后仍然有效。

也可以从 Hermes 侧边栏直接进入 Usage Monitor。

2.0 数据原则

• DeepSeek 趋势来自本机定时保存的余额快照，不是官方账单。
• 余额上升会被识别为充值或赠送，不计入消耗。
• 观察不足 24 小时时不生成预测，避免用短时间波动误导用户。
• 历史文件只包含时间、币种和余额，不包含 API Key、Cookie 或请求内容。
• 插件 ID 继续使用 opencode-go-quota，因此从 1.x 升级不会丢失已有设置。

历史默认保存在：

<HERMES_HOME>/plugin-data/opencode-go-quota/deepseek-history.json

有什么不同

OpenCode Go 的额度工具已经存在，但多数运行在终端、VS Code 或 macOS 菜单栏。本项目专门面向 Hermes Desktop：

• 原生嵌入：直接进入 Hermes 状态栏和命令面板，不增加窗口。
• 前后端隔离：auth Cookie 只由本机 Hermes 后端读取，不会返回桌面渲染层。
• 足够轻：不引入新的 Node 或 Python 第三方依赖。
• 故障可见：区分待配置、认证失效、读取失败和缓存数据。
• 容易审计：功能单一，代码短，没有遥测。

目前仅在 Windows 上验证。代码没有使用 Windows 专属接口，macOS 与 Linux 理论上可用，但尚未实测。

安装

1. 复制文件

将：

desktop/plugin.js

复制到：

%LOCALAPPDATA%\hermes\desktop-plugins\opencode-go-quota\plugin.js

将：

backend/dashboard/

复制到：

%LOCALAPPDATA%\hermes\plugins\opencode-go-quota\dashboard\

macOS / Linux 请将 %LOCALAPPDATA%\hermes 换成自己的 Hermes Home 目录。

2. 启用插件

编辑 Hermes Home 下的 config.yaml：

plugins:
  enabled:
    - opencode-go-quota

如果已经有 plugins.enabled，只添加列表项，不要覆盖原有插件。

3. 配置 OpenCode

编辑 Hermes Home 下的 .env：

OPENCODE_GO_WORKSPACE_ID=wrk_xxxxxxxxxxxxxxxxxxxxxxxxxx
OPENCODE_GO_AUTH_COOKIE=Fe26.2**xxxxxxxxxxxxxxxxxxxx

Workspace ID 位于 Go Console 地址：

https://opencode.ai/workspace/<workspace-id>/go

auth Cookie 的获取方法：

1. 登录 opencode.ai 并打开 Go Console。
2. 按 F12，进入 **Application → Cookies → https://opencode.ai**。
3. 复制名为 auth 的 Cookie 值。

重启 Hermes。底部出现 OC Go 即安装完成。

可选：DeepSeek 余额

如果 Hermes 已经配置 DeepSeek，无需额外操作。插件会复用 .env 中的：

DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

配置后，状态栏会增加 DS ¥余额。插件只请求 DeepSeek 官方的 GET /user/balance，API Key 不会返回桌面渲染层。

卸载

从 config.yaml 的 plugins.enabled 中移除 opencode-go-quota，再删除上述两个插件目录并重启 Hermes。

安全与限制

• auth Cookie 等同于登录凭据。不要提交到 Git、截图分享或发送给他人。
• Cookie 以明文保存在本机 .env 中。插件不会记录、上传或返回它。
• OpenCode 暂无稳定、公开的 Go 套餐额度 API。本插件读取已认证的 Console 页面，因此页面结构变化后可能需要更新。
• Cookie 过期后，需要重新登录 OpenCode 并替换 .env 中的值。
• DeepSeek 官方接口提供账户余额，不提供 5 小时、每周或每月使用百分比；插件不会把本地推算伪装成官方数据。
• DeepSeek 的预计可用天数属于本地估算，会受充值、赠送和用量变化影响。

工作方式

Hermes 后端访问：

https://opencode.ai/workspace/<workspace-id>/go

后端解析三个额度周期，只向桌面插件返回使用率、重置时间和缓存状态。桌面插件负责显示，不接触认证信息。

DeepSeek 使用官方余额接口：

GET https://api.deepseek.com/user/balance

开发与验证

解析器测试不访问网络，也不需要真实 Cookie：

python -m unittest discover -s tests -v

License

MIT