Квота ZubriQ
Квота тарифа и расход токенов по сессиям — в окне /quota, боковой панели и Desktop.
@zubriq/quota@0.2.0
Откроется ZuBrIQ Desktop и поставит плагин; после установки перезапустите приложение. Нет приложения — скачать или поставьте в терминале:
ZubrCode в терминале
Команда для ZubrCode:
zubrcode plugin add @zubriq/quota@0.2.0Документация
Плагин квоты и расхода аккаунта ZubriQ для ZubrCode (CLI, терминал, Desktop). Квота — одним
запросом GET https://zubriq.ai/api/v1/usage; расход — локальный учёт шагов по событиям
ZubrCode с оценкой стоимости в BYN по публичным ценам.
Идея и UX — по образцу opencode-quota (MIT).
Установка
zubrcode plugin add @zubriq/quota
Или в ZubrCode Desktop: Настройки → Расширения → Плагины → «Каталог ZubriQ» → «Добавить», затем перезапустите приложение.
Пакеты @zubriq/* лежат в реестре ZubriQ, а не на npmjs. ZubrCode 2.2.5-3 и новее знает его
сам; в более старых добавьте одну строку в ~/.npmrc:
@zubriq:registry=https://packages.artcloud.by/repository/npm-zubriq/
Войдите в ZubriQ, если ещё не вошли — плагин читает ключ ZubriQ из подключений ZubrCode:
zubrcode auth login zubriq
Два режима квоты
- subscription (тариф с окнами): строки по каждому пулу и окну — «Токены · 5 ч», «Токены · неделя», — процент остатка и время сброса; краткая строка показывает тариф и самое критичное окно.
- api (без тарифа с окнами): баланс BYN, расход ключа сегодня и за месяц, бюджет ключа (остаток из суммы).
В обоих режимах видны тариф, включена ли доплата с баланса и ссылка на биллинг.
Где видно квоту
Терминал (TUI):
- панель «ZuBrIQ» в боковой панели сессии — тариф, строки по окнам с остатком и временем сброса (в api-режиме — баланс, ключ и бюджет) или одна строка «Войдите…», если входа нет;
- краткая строка квоты под полем ввода;
- команда
/quota(и через палитру: «ZuBrIQ: квота») — открывает окно с вкладками «Расход / Лимиты / Настройки» и сразу форс-обновляет квоту. Клавиши:tab/shift+tabи1/2/3— вкладки,←/→— диапазон,r— обновить,e— экспорт,space— переключить доплату с баланса,esc— закрыть (подсказки — в подвале окна); /quota_usage [диапазон]— тост со сводкой расхода и квоты (как тост/quotaраньше);/quota_status— тост со статусом плагина: вход в ZuBrIQ, записи расхода, возраст цен, путь к файлу настроек и его предупреждения, версия;/quota_export [диапазон]— записать статистику расхода в JSON по пути из настройкиexportPathи тостом показать путь.
Диапазоны: today (по умолчанию — настройка defaultRange), 24h, 7d, 30d, all,
session (текущая сессия с сабагентами), between YYYY-MM-DD YYYY-MM-DD. Команды принимают
диапазон аргументом после имени (/quota_usage 7d); без аргумента берётся defaultRange,
а внутри окна /quota диапазон меняется клавишами.
Расход
Плагин подписывается на события шагов ZubrCode и пишет токены и стоимость каждого шага в
своё хранилище (usage/<день>/<eventID>, дубликаты исключаются, сабагенты учитываются).
Стоимость в BYN — оценка ≈ по публичным ценам zubriq.ai/api/public/pricing (кеш — сутки);
факт по ключу — из ответа /api/v1/usage. На полосках окон — отметка равномерного расхода
«┃» (доля окна по length_seconds); записи старше retentionDays сервер удаляет сам.
Desktop (GUI):
- вкладка «Квота» справа, в боковой панели сессии: переключатель «Расход | Лимиты». «Лимиты» — тариф, полоски остатка по окнам с отметкой «┃» и подписью «осталось N% · сброс …» (в api-режиме — строки баланса и бюджета), кнопки «Пополнить» и «Сменить тариф», переключатель «Доплачивать с баланса»; «Расход» — диапазоны, итоговые токены и стоимость, список моделей с полосками, факт по ключу и экспорт в JSON через системный диалог;
- страница «Квота» в настройках приложения — те же настройки, что во вкладке TUI;
- команда
/quota— форс-обновление и сводка тостом.
Уведомления — на пороге израсходования из настройки toastThreshold (по умолчанию 80 %,
«квота на исходе») и при исчерпании; показываются один раз на окно сброса (или месяц бюджета),
не повторяются после перезапуска.
Настройки
Файл ~/.config/zubrcode/quota/settings.jsonc (каталог — XDG_CONFIG_HOME или ~/.config,
как у ZubrCode). Правится вручную и из интерфейса (вкладка «Настройки» окна /quota, страница
в настройках Desktop); комментарии, порядок ключей и неизвестные ключи сохраняются. Ручные
правки подхватываются без перезапуска, изменения из интерфейса применяются сразу во всех
открытых окнах (событие settingsChanged).
| Ключ | По умолчанию | Что делает |
|---|---|---|
showSidebar |
true |
Панель «ZuBrIQ» в боковой панели TUI и вкладка «Квота» в Desktop. |
showStatusLine |
true |
Строка квоты под полем ввода. |
showToasts |
true |
Уведомления на пороге и исчерпании. |
toastThreshold |
80 |
Порог уведомления «на исходе», % израсходования (50–99). |
evenUseMark |
true |
Отметка равномерного расхода «┃» на полосках окон. |
defaultRange |
"today" |
Диапазон вкладки «Расход» и команд без аргумента: today | 24h | 7d | 30d | all. |
retentionDays |
90 |
Сколько дней хранить записи расхода; старые сервер удаляет сам. |
exportPath |
"~/zubrcode-quota-{date}.json" |
Путь /quota_export; {date} → YYYY-MM-DD, {range} → диапазон, ~ → домашний каталог. |
consoleUrl |
"" |
Адрес консоли. Порядок: этот ключ → опция consoleUrl в opencode.json → ZUBRIQ_CONSOLE_URL → https://zubriq.ai. |
Пример:
{
// Порог уведомлений — 70 % израсходования
"toastThreshold": 70,
// Диапазон по умолчанию — неделя
"defaultRange": "7d",
// Экспорт на рабочий стол
"exportPath": "~/Desktop/quota-{range}-{date}.json"
}
Битый файл — умолчания и предупреждение в /quota_status; файл не перезаписывается, пока его
не поправят. Адрес консоли можно задать и без файла настроек:
Ответ кешируется на 60 секунд; смена ключа ZubriQ сбрасывает кеш сразу.
Разработка
npm install # в корне репозитория (npm workspaces)
npm test # vitest
npm run typecheck
npm run build # dist: index.js, rpc.js, tui.js, gui-experimental.cjs
Лицензия
MIT.