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

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

• Установить плагин 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, его основная ценность:

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

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

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

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

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

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

Позвольте ИИ установить (рекомендуется)

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

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

Ручная установка

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

Установка из локального файла

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

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

---

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

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

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

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

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

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

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

{
  "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 Скопируйте файлы плагина

# Предположим, вы клонировали исходный код 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 введите:

/mystatus

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

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

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

## OpenAI 账号额度

Account:        [email protected] (team)

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

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

## OpenAI Account Quota

Account:        [email protected] (team)

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

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

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

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

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

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

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

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

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	Заголовок платформы
[email protected] (team)	[email protected] (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 для проверки формата, например:

// ❌ Ошибка: лишняя запятая в последнем элементе
{
  "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 не перезагрузил файл конфигурации

Решение:

1. Полностью закройте OpenCode (не сворачивайте)
2. Перезапустите OpenCode
3. Снова введите /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:

1. Три способа установки: позвольте ИИ установить (рекомендуется), ручная установка, установка из локального файла
2. Расположение файла конфигурации: ~/.config/opencode/opencode.json
3. Ключевые параметры конфигурации:
   • массив plugin: добавьте "opencode-mystatus"
   • объект command: настройте слэш-команду mystatus
4. Метод проверки: после перезапуска OpenCode введите /mystatus
5. Автоматическое чтение аутентификации: плагин автоматически читает данные настроенных аккаунтов из ~/.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.