Быстрый старт: единый запрос квот всех ИИ-платформ

Чему вы научитесь

Установить плагин opencode-mystatus за 5 минут
Настроить слэш-команду /mystatus
Проверить успешность установки и выполнить первый запрос квоты ИИ-платформы

Ваша текущая проблема

Вы используете несколько ИИ-платформ для разработки (OpenAI, Zhipu AI, GitHub Copilot, Google Cloud и др.) и каждый день часто проверяете остаток квот на каждой платформе. Каждый раз нужно входить на каждую платформу по отдельности, что отнимает много времени.

Когда использовать этот метод

При первом знакомстве с OpenCode: первый устанавливаемый плагин для новичков
При необходимости управления квотами нескольких платформ: одновременное использование OpenAI, Zhipu AI, GitHub Copilot и других платформ
При командной работе: члены команды используют несколько ИИ-аккаунтов, нужен единый просмотр квот

🎒 Подготовка

Перед началом убедитесь:

Предварительные требования

[ ] Установлен OpenCode
[ ] Настроены данные аутентификации минимум одной ИИ-платформы (OpenAI, Zhipu AI, Z.ai, GitHub Copilot или Google Cloud)

Если вы ещё не настроили ни одной ИИ-платформы, рекомендуется сначала завершить авторизацию хотя бы на одной платформе в OpenCode, затем установить этот плагин.

Основная идея

opencode-mystatus — это плагин OpenCode, его основная ценность:

Автоматическое чтение файлов аутентификации: чтение данных всех настроенных аккаунтов из официального хранилища аутентификации OpenCode
Параллельный запрос всех платформ: одновременный вызов официальных API OpenAI, Zhipu AI, Z.ai, GitHub Copilot и Google Cloud
Визуализация: наглядное отображение остатка квот индикаторами прогресса и обратным отсчётом

Процесс установки прост:

Добавьте плагин и слэш-команду в файл конфигурации OpenCode
Перезапустите OpenCode
Введите /mystatus для запроса квот

Пошаговое выполнение

Шаг 1: Выберите способ установки

opencode-mystatus предлагает три способа установки, выберите один в зависимости от ваших предпочтений:

Позвольте ИИ установить (рекомендуется)Ручная установкаУстановка из локального файла

bash

Вставьте следующее содержимое в любой ИИ-агент (Claude Code, OpenCode, Cursor и др.):

Install opencode-mystatus plugin by following: https://raw.githubusercontent.com/vbgate/opencode-mystatus/main/README.md

bash

Откройте ~/.config/opencode/opencode.json, отредактируйте конфигурацию согласно шагу 2

bash

Скопируйте файлы плагина в каталог ~/.config/opencode/plugin/ (подробнее на шаге 4)

Почему рекомендуется позволить ИИ установить: ИИ-агент автоматически выполнит все этапы настройки, вам нужно только подтвердить, это самый быстрый и простой способ.

Шаг 2: Ручная настройка (обязательно для ручной установки)

Если вы выбрали ручную установку, нужно отредактировать файл конфигурации OpenCode.

2.1 Откройте файл конфигурации

bash

# macOS/Linux
code ~/.config/opencode/opencode.json

# Windows
code %APPDATA%\opencode\opencode.json

2.2 Добавьте плагин и слэш-команду

В файл конфигурации добавьте следующее содержимое (сохраните существующие настройки plugin и command, добавьте новые элементы):

json

{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool to query quota usage. Return the result as-is without modification."
    }
  }
}

Зачем так настраивать:

Параметр	Значение	Назначение
`plugin` массив	`["opencode-mystatus"]`	Сообщает OpenCode загрузить этот плагин
`description`	"Query quota usage for all AI accounts"	Описание в списке слэш-команд
`template`	"Use the mystatus tool..."	Указывает OpenCode, как вызывать mystatus

Вы должны увидеть: файл конфигурации содержит полные поля plugin и command, формат правильный (обратите внимание на запятые и кавычки JSON).

Шаг 3: Установка из локального файла (обязательно для локальной установки)

Если вы выбрали установку из локального файла, нужно вручную скопировать файлы плагина.

3.1 Скопируйте файлы плагина

bash

# Предположим, вы клонировали исходный код opencode-mystatus в ~/opencode-mystatus/

# Скопируйте основной плагин и файлы библиотеки
cp -r ~/opencode-mystatus/plugin/mystatus.ts ~/.config/opencode/plugin/
cp -r ~/opencode-mystatus/plugin/lib/ ~/.config/opencode/plugin/

# Скопируйте конфигурацию слэш-команды
cp ~/opencode-mystatus/command/mystatus.md ~/.config/opencode/command/

Зачем копировать эти файлы:

mystatus.ts: основной файл плагина, содержит определение инструмента mystatus
lib/: каталог, содержит логику запроса для OpenAI, Zhipu AI, Z.ai, GitHub Copilot и Google Cloud
mystatus.md: описание конфигурации слэш-команды

Вы должны увидеть: в каталоге ~/.config/opencode/plugin/ есть mystatus.ts и подкаталог lib/, в каталоге ~/.config/opencode/command/ есть mystatus.md.

Шаг 4: Перезапуск OpenCode

Независимо от выбранного способа установки, последний шаг — перезапуск OpenCode.

Почему обязательна перезагрузка: OpenCode читает файл конфигурации только при запуске, после изменения конфигурации нужна перезагрузка для вступления в силу.

Вы должны увидеть: после перезапуска OpenCode работает нормально.

Шаг 5: Проверка установки

Теперь проверим успешность установки.

5.1 Тестирование слэш-команды

В OpenCode введите:

bash

/mystatus

Вы должны увидеть:

Если настроены данные аутентификации минимум одной ИИ-платформы, вы увидите вывод, похожий на этот (пример OpenAI):

Вывод на китайскомВывод на английском

markdown

## OpenAI 账号额度

Account:        user@example.com (team)

3小时限额
████████████████████████ 剩余 85%
重置: 2h 30m后

markdown

## OpenAI Account Quota

Account:        user@example.com (team)

3-hour limit
████████████████████████ 85% remaining
Resets in: 2h 30m

Примечание о языке вывода

Плагин автоматически определяет язык системы (китайская система показывает китайский, английская — английский), оба варианта вывода правильны.

Если вы ещё не настроили ни одного аккаунта, вы увидите:

Вывод на китайскомВывод на английском

markdown

未找到任何已配置的账号。

支持的账号类型:
- OpenAI (Plus/Team/Pro 订阅用户)
- 智谱 AI (Coding Plan)
- Z.ai (Coding Plan)
- Google Cloud (Antigravity)

markdown

No configured accounts found.

Supported account types:
- OpenAI (Plus/Team/Pro subscribers)
- Zhipu AI (Coding Plan)
- Z.ai (Coding Plan)
- Google Cloud (Antigravity)

5.2 Понимание вывода

Элемент (китайская версия)	Элемент (английская версия)	Значение
`## OpenAI 账号额度`	`## OpenAI Account Quota`	Заголовок платформы
`user@example.com (team)`	`user@example.com (team)`	Информация об аккаунте (email/команда)
`3小时限额`	`3-hour limit`	Тип лимита (3-часовой лимит)
`剩余 85%`	`85% remaining`	Остаток в процентах
`重置: 2h 30m后`	`Resets in: 2h 30m`	Обратный отсчёт до сброса

Почему API Key не отображается полностью: для защиты вашей конфиденциальности плагин автоматически маскирует отображение (например, 9c89****AQVM).

Контрольная точка ✅

Убедитесь, что вы выполнили следующие шаги:

Шаг	Метод проверки	Ожидаемый результат
Установка плагина	Проверьте `~/.config/opencode/opencode.json`	Массив `plugin` содержит `"opencode-mystatus"`
Настройка команды	Проверьте тот же файл	Объект `command` содержит конфигурацию `mystatus`
Перезапуск OpenCode	Проверьте процесс OpenCode	Перезапущен
Тест команды	Введите `/mystatus`	Отображается информация о квотах или "未找到任何已配置的账号"

Предупреждения о типичных ошибках

Частая ошибка 1: Ошибка формата JSON

Проявление: сбой запуска OpenCode, ошибка формата JSON

Причина: в файле конфигурации лишние или недостающие запятые, кавычки

Решение:

Используйте онлайн-инструменты проверки JSON для проверки формата, например:

json

// ❌ Ошибка: лишняя запятая в последнем элементе
{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool..."
    }
  }  // ← здесь не должно быть запятой
}

// ✅ Правильно
{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool..."
    }
  }
}

Частая ошибка 2: Забыли перезапустить OpenCode

Проявление: после ввода /mystatus отображается "未找到命令"

Причина: OpenCode не перезагрузил файл конфигурации

Решение:

Полностью закройте OpenCode (не сворачивайте)
Перезапустите OpenCode
Снова введите /mystatus

Частая ошибка 3: Отображение "未找到任何已配置的账号"

Проявление: после выполнения /mystatus отображается "未找到任何已配置的账号"

Причина: вы ещё не авторизовались ни на одной ИИ-платформе

Решение:

Авторизуйтесь минимум на одной ИИ-платформе (OpenAI, Zhipu AI, Z.ai, GitHub Copilot или Google Cloud)
Подробности см. в описании настройки в руководстве Быстрый старт

Частая ошибка 4: Сбой запроса квоты Google Cloud

Проявление: другие платформы запрашиваются нормально, но Google Cloud показывает ошибку

Причина: Google Cloud требует дополнительный плагин аутентификации

Решение:

Сначала установите плагин opencode-antigravity-auth для завершения аутентификации Google аккаунта.

Итог урока

В этом уроке мы завершили установку и базовую проверку opencode-mystatus:

Три способа установки: позвольте ИИ установить (рекомендуется), ручная установка, установка из локального файла
Расположение файла конфигурации: ~/.config/opencode/opencode.json
Ключевые параметры конфигурации:
- массив plugin: добавьте "opencode-mystatus"
- объект command: настройте слэш-команду mystatus
Метод проверки: после перезапуска OpenCode введите /mystatus
Автоматическое чтение аутентификации: плагин автоматически читает данные настроенных аккаунтов из ~/.local/share/opencode/auth.json

После установки вы можете использовать команду /mystatus или естественный язык в OpenCode для запроса квот всех ИИ-платформ.

Следующий урок

В следующем уроке мы изучим Использование mystatus: слэш-команды и естественный язык.
Вы научитесь:
Подробное использование команды /mystatus
Как вызвать инструмент mystatus на естественном языке
Различия между двумя способами вызова и сценарии применения
Принципы настройки слэш-команд

Приложение: ссылка на исходный код

Нажмите, чтобы раскрыть расположение исходного кода

Обновлено: 2026-01-23

Функция	Путь к файлу	Строка
Точка входа плагина	`plugin/mystatus.ts`	26-94
Определение инструмента mystatus	`plugin/mystatus.ts`	29-33
Чтение файла аутентификации	`plugin/mystatus.ts`	35-46
Параллельный запрос всех платформ	`plugin/mystatus.ts`	49-56
Сбор и объединение результатов	`plugin/mystatus.ts`	58-89
---	---	---

Ключевые константы:

Путь к файлу аутентификации: ~/.local/share/opencode/auth.json (plugin/mystatus.ts:35)

Ключевые функции:

mystatus(): основная функция инструмента mystatus, читает файл аутентификации и параллельно запрашивает все платформы (plugin/mystatus.ts:29-33)
collectResult(): собирает результаты запроса в массивы results и errors (plugin/mystatus.ts:100-116)
queryOpenAIUsage(): запрос квоты OpenAI (plugin/lib/openai.ts)
queryZhipuUsage(): запрос квоты Zhipu AI (plugin/lib/zhipu.ts)
queryZaiUsage(): запрос квоты Z.ai (plugin/lib/zhipu.ts)
queryGoogleUsage(): запрос квоты Google Cloud (plugin/lib/google.ts)
queryCopilotUsage(): запрос квоты GitHub Copilot (plugin/lib/copilot.ts)

Формат файла конфигурации: Настройки плагина и слэш-команд в файле конфигурации OpenCode ~/.config/opencode/opencode.json см. в README.zh-CN.md строки 33-82.

Старт

Платформы

Доп. функции

FAQ

Приложение

Версии

Быстрый старт: единый запрос квот всех ИИ-платформ

Чему вы научитесь

Ваша текущая проблема

Когда использовать этот метод

🎒 Подготовка

Основная идея

Пошаговое выполнение

Шаг 1: Выберите способ установки

Шаг 2: Ручная настройка (обязательно для ручной установки)

2.1 Откройте файл конфигурации

2.2 Добавьте плагин и слэш-команду

Шаг 3: Установка из локального файла (обязательно для локальной установки)

3.1 Скопируйте файлы плагина

Шаг 4: Перезапуск OpenCode

Шаг 5: Проверка установки

5.1 Тестирование слэш-команды

5.2 Понимание вывода

Контрольная точка ✅

Предупреждения о типичных ошибках

Частая ошибка 1: Ошибка формата JSON

Частая ошибка 2: Забыли перезапустить OpenCode

Частая ошибка 3: Отображение "未找到任何已配置的账号"

Частая ошибка 4: Сбой запроса квоты Google Cloud

Итог урока

Следующий урок

Приложение: ссылка на исходный код

Быстрый старт: единый запрос квот всех ИИ-платформ ​

Чему вы научитесь ​

Ваша текущая проблема ​

Когда использовать этот метод ​

🎒 Подготовка ​

Основная идея ​

Пошаговое выполнение ​

Шаг 1: Выберите способ установки ​

Шаг 2: Ручная настройка (обязательно для ручной установки) ​

2.1 Откройте файл конфигурации ​

2.2 Добавьте плагин и слэш-команду ​

Шаг 3: Установка из локального файла (обязательно для локальной установки) ​

3.1 Скопируйте файлы плагина ​

Шаг 4: Перезапуск OpenCode ​

Шаг 5: Проверка установки ​

5.1 Тестирование слэш-команды ​

5.2 Понимание вывода ​

Контрольная точка ✅ ​

Предупреждения о типичных ошибках ​

Частая ошибка 1: Ошибка формата JSON ​

Частая ошибка 2: Забыли перезапустить OpenCode ​

Частая ошибка 3: Отображение "未找到任何已配置的账号" ​

Частая ошибка 4: Сбой запроса квоты Google Cloud ​

Итог урока ​

Следующий урок ​

Приложение: ссылка на исходный код ​

Быстрый старт: единый запрос квот всех ИИ-платформ

Чему вы научитесь

Ваша текущая проблема

Когда использовать этот метод

🎒 Подготовка

Основная идея

Пошаговое выполнение

Шаг 1: Выберите способ установки

Шаг 2: Ручная настройка (обязательно для ручной установки)

2.1 Откройте файл конфигурации

2.2 Добавьте плагин и слэш-команду

Шаг 3: Установка из локального файла (обязательно для локальной установки)

3.1 Скопируйте файлы плагина

Шаг 4: Перезапуск OpenCode

Шаг 5: Проверка установки

5.1 Тестирование слэш-команды

5.2 Понимание вывода

Контрольная точка ✅

Предупреждения о типичных ошибках

Частая ошибка 1: Ошибка формата JSON

Частая ошибка 2: Забыли перезапустить OpenCode

Частая ошибка 3: Отображение "未找到任何已配置的账号"

Частая ошибка 4: Сбой запроса квоты Google Cloud

Итог урока

Следующий урок

Приложение: ссылка на исходный код