English · Русский
Плавающий виджет для Hermes WebUI, показывающий баланс счёта Polza.ai. Нажмите на баланс — увидите дневные расходы с разбивкой по моделям и токенам.
| Иконка | Описание |
|---|---|
| 💰 | Текущий баланс — автообновление (настраивается, по умолчанию 60 с) |
| 📊 | Клик → ежедневная статистика: расход, количество генераций, токены (вход/выход) |
| 🏆 | Топ-5 моделей по стоимости за сегодня |
| 🔄 | Пагинация с дедупликацией — все генерации за день, без дублей |
| ⛁ | Разбивка по провайдерам (DeepSeek, GMICloud, SiliconFlow и др.) |
| 🔑 | Смена API-ключа через правый клик / долгое нажатие на балансе |
| 🌗 | Автоопределение тёмной / светлой темы WebUI |
├── README.md ← этот файл (русский)
├── README.en.md ← английская версия
├── extensions/
│ └── polza-balance/
│ ├── manifest.json ← манифест расширения WebUI
│ └── polza-balance.js ← виджет: логика, вёрстка, тема (один файл)
Один JS-файл — без внешнего CSS, npm или сборки. Стили встроены в JS, чтобы не делать лишний HTTP-запрос.
Откройте Settings → Extensions в Hermes WebUI, найдите Polza.ai Balance, нажмите Install. Обновите страницу (Ctrl+Shift+R).
Скопируйте папку расширения в директорию расширений WebUI:
cp -r extensions/polza-balance/ ~/.hermes/webui/extensions/polza-balance/Убедитесь, что в .env WebUI прописана директория расширений:
HERMES_WEBUI_EXTENSION_DIR=/path/to/your/extensions
HERMES_WEBUI_CSP_CONNECT_EXTRA=https://polza.aiЕсли файл ~/STATE_DIR/extensions/manifest.json существует, WebUI загрузит расширение автоматически — никаких SCRIPT_URLS не нужно. При отсутствии манифеста создайте:
{
"extensions": [
{
"id": "polza-balance",
"scripts": ["polza-balance/polza-balance.js"]
}
]
}Перезапустите WebUI и сделайте жёсткую перезагрузку браузера (Ctrl+Shift+R).
| Действие | Результат |
|---|---|
| Клик по балансу | Открыть/закрыть попап с расходами |
| Правый клик / долгое нажатие | Сменить API-ключ и интервал обновления |
| 🔑 Polza (при первом запуске) | Ввести API-ключ |
API-ключ хранится в localStorage браузера — сохраняется между сессиями.
Сегодня — 63,75 ₽
383 генерации · 8,2K вход / 4,3K выход
🗄 31% кешировано · 🧠 1.2K thinking
───────────────────────────────────────
DeepSeek V4 Flash 63,75 ₽
8,2K/4,3K
───────────────────────────────────────
⛁ Providers
● DeepSeek (319) 48.78 ₽ avg 0.15
● GMICloud (64) 33.29 ₽ avg 0.52
sequenceDiagram
participant B as Browser
participant W as Hermes WebUI
participant P as Polza.ai API
B->>W: load polza-balance.js
activate W
W-->>B: served
deactivate W
B->>P: GET /api/v1/balance
activate P
P-->>B: {credits, usage}
deactivate P
B->>B: render widget
Расширение общается напрямую с Polza.ai API — WebUI только отдаёт JS-файл и добавляет исключение в CSP.
CSP: HERMES_WEBUI_CSP_CONNECT_EXTRA=https://polza.ai разрешает браузеру делать fetch() к Polza API. Без него браузер заблокирует запрос.
В Hermes WebUI есть галерея расширений: Settings → Extensions. Реестр читается с https://hermes-webui.github.io/hermes-webui-extensions/registry.json, публикуется из github.com/hermes-webui/hermes-webui-extensions.
Чтобы добавить расширение:
- Форкните
hermes-webui/hermes-webui-extensions - Создайте директорию расширения:
extensions/polza-balance/
├── manifest.json ← метаданные расширения (скрипты, права)
├── polza-balance.js ← код виджета
└── README.md ← документация
- Обновите
extensions.toml(или конфиг реестра) для регистрации расширения - Откройте PR — GitHub Action сгенерирует
registry.jsonи опубликует его автоматически после слияния
manifest.json для этого расширения:
{
"id": "polza-balance",
"name": "Polza.ai Balance",
"version": "1.2.0",
"author": "akrhin",
"description": "Floating widget showing Polza.ai account balance and daily spending breakdown by model with input/output token counts.",
"scripts": ["polza-balance.js"],
"csp_connect_extra": "https://polza.ai"
}Поле csp_connect_extra указывает галерее, что для установки расширения нужно добавить https://polza.ai в HERMES_WEBUI_CSP_CONNECT_EXTRA — WebUI запросит подтверждение у пользователя.
Это расширение — готовый шаблон для любого провайдера с REST API для проверки баланса.
- Форкните репозиторий или скопируйте
polza-balance.js - Замените URL API и названия полей ответа
- Поменяйте
HERMES_WEBUI_CSP_CONNECT_EXTRAна домен вашего провайдера - Разверните и перезапустите
| Переменная | Где в polza-balance.js |
Что менять |
|---|---|---|
BALANCE_URL |
строка ~11 | Эндпоинт баланса провайдера |
HISTORY_URL |
строка ~12 | Эндпоинт истории провайдера |
| Поле ответа | fetchBalance() |
d.amount → поле баланса у вашего провайдера |
| Поле стоимости | fetchTodayCost() |
item.cost → поле стоимости у вашего провайдера |
| Поля токенов | fetchTodayCost() |
item.usage.prompt_tokens → поля токенов у вашего провайдера |
| CSP origin | .env |
https://polza.ai → домен API вашего провайдера |
DeepSeek
// GET https://api.deepseek.com/user/balance
// { "balance": "9.28", "is_available": true }
balance = parseFloat(d.balance);
// CSP: https://api.deepseek.comOpenAI
// GET https://api.openai.com/v1/dashboard/billing/credit_grants
// { "total_remaining": 12.58, ... }
balance = d.total_remaining;
// CSP: https://api.openai.comAnthropic
// GET https://api.anthropic.com/v1/organizations/{org_id}/billing
// { "credits_remaining": 25.00 }
balance = d.credits_remaining;
// CSP: https://api.anthropic.comПочему API-ключ в localStorage?
Ключ никогда не покидает браузер. Никакого хранения на сервере, никаких cookie, которые утекают в WebUI. Просто и достаточно безопасно для self-hosted.
Почему в попапе 0 генераций?
API-ключ в браузере не совпадает с тем, который используется для генерации. Нажмите правой кнопкой на баланс и введите правильный ключ.
Как изменить интервал обновления?
Правый клик по балансу → второй запрос спрашивает секунды (по умолчанию 60, максимум 3600). Значение сохраняется в localStorage.
Как удалить расширение?
Удалите через галерею (Settings → Extensions) или удалите файлы из HERMES_WEBUI_EXTENSION_DIR и уберите CSP-переменную из .env. Перезапустите WebUI.
MIT. Репозиторий: github.com/akrhin/polza-webui-extensions