← Все плагины
ПлагинТерминалDesktopДобавлен 6 ноября 2026

Квота 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.

Все плагины →