Решение проблем
Разберитесь с отсутствующими расшифровками, входом, моделями и конфликтами архива.
Восстановите работу при зависшем входе, недостающих данных или ошибке архива. Найдите симптом, исправьте относящуюся к нему причину и повторите указанную проверку. Сохраняйте завершённые файлы записей и проверяйте неоднозначный результат удалённого изменения перед повтором.
Вход
Я подтвердил в браузере, но терминал ждёт
Браузер подтвердил приложение, но ответ не дошёл до процесса. Оставьте терминал открытым.
Скопируйте code=…&state=… или полный URL на странице WireCat, вставьте в тот же работающий
терминал zm login и нажмите Enter. Команда должна сообщить loggedIn: true и вернуть приглашение.
Если время истекло, начните новый вход и используйте новый ответ. Старый ответ не завершит новую попытку.
Другой компьютер с браузером или удалённый терминал могут препятствовать автоматическому возврату. Сеансы объясняют завершение и пятиминутный срок.
Zoom сообщает "Invalid redirect"
Откройте выбранную среду Development или Production приложения. В OAuth Redirect URL и
OAuth Allow Lists должен быть https://wirecat.dev/zoom-callback; включите Use Public
Client OAuth. Скопируйте Public Client ID, настройте его и повторите вход. Обычный Client ID
отличается. Начальный манифест не включает этот режим и разрешения. Пройдите
полную проверку приложения и подтвердите завершение в терминале.
Браузер не запускается
Явно выберите установленный браузер:
zm login --browser firefoxВ интерактивном терминале откройте сами URL авторизации, напечатанный текущим входом, и при
необходимости вставьте ответ. Не используйте старый URL. Без ввода ошибка запуска браузера
быстро завершает команду. Для входа в канал/JSON нужен --interactive; --no-input запрещает его.
Приложение недоступно или требует администратора
Проверьте, может ли пользователь Zoom установить приложение. Приложение в разработке не доступно автоматически вне аккаунта разработчика. Попросите владельца или администратора разрешить доступ; второе приложение не обходит политику компании. Повторное использование показывает настройки. Разрешённые VTT-файлы можно импортировать без API.
Ошибка системного хранилища паролей
Хранилище паролей должно быть установлено, запущено и доступно пользователю. Выполните вход
под тем же пользователем системы, которому доступно хранилище; на сервере без графического сеанса
его может не быть. Токен не сохраняется в открытый файл. После исправления повторите вход и
проверьте zm session status --json.
Не хватает разрешения
Ошибка указывает точное имя. Владелец добавляет его в Scopes и сохраняет приложение, затем
пользователь повторяет zm login. Проверьте разрешения через zm session status --json и
повторите чтение. Выданные токены не получают новые права автоматически. Архив, детали встреч,
удалённая проверка и изменения имеют отдельные разрешения.
Настройки
Проверьте клиент, источник и профиль через zm config show. Повреждённые настройки не мешают
--help и --version, но команды настроек сообщают об ошибке. Смена метки не меняет пользователя Zoom.
Если терминал и MCP видят разные данные, сравните ZM_CONFIG_DIR и MESSAGING_STORE.
Ответы Zoom
Ошибка сети и неверный ответ провайдера различаются. Проверьте подключение и не указан ли
--offline для запроса Zoom. Диагностика не включает исходный текст ошибок провайдера. В отчёте
сохраните команду, код ошибки и имя разрешения; исключите параметры входа, токены и частный текст встреч.
Отсутствуют встречи или расшифровки
| Симптом | Проверка и исправление | Признак успеха |
|---|---|---|
| Нет профиля или список пуст | Выберите профиль и импортируйте/загрузите; чтение не регистрирует аккаунты | zm meetings list --json показывает встречи профиля |
| Нет недавних встреч организатора | Проверьте пользователя Zoom, API и даты; задайте более ранний --since | Сравните даты с ожидаемыми встречами |
| Есть встреча, но нет текста | Проверьте создание/хранение текста и права; несохранённый или удалённый текст загрузка не создаёт | Откройте текст после появления в Zoom и повторной загрузки |
| Нет встречи, где вы были участником | Получите VTT у организатора или скачайте с разрешением и импортируйте | Проверьте дату, название и текст |
| Текст появился позднее | Повторите zm pull --lookback-days 7 или более ранний --since | Откройте новый текст |
| Загрузка прервалась | Исправьте ошибку и повторите; неудачная встреча не продвигает курсор | Проверьте подтверждение и список |
| Неверное имя файла или время | Используйте YYYY-MM-DD_HHMM_topic.vtt и его часовой пояс; разрешите конфликты | Импорт с правильной датой и темой |
| Поиск пуст | Проверьте текст, профиль и покрытие индекса | Откройте известный отрывок и проверьте его доступность |
Выполняйте загрузки одного аккаунта последовательно. См. настройки текста, импорт файлов и покрытие поиска.
Архив
- Нет доступных облачных файлов: проверьте даты, аккаунт организатора, наличие записи и её разрешения. Расшифровка и облачная запись — разные источники.
- Замок остался после сбоя: изучите
recordings archive locks, предпросмотритеrecordings archive recover, затем добавьте--yesтолько для распознанного замка завершившегося процесса. Активные и чужие замки сохраняются. См. восстановление. - Контрольная сумма не совпала: сохраните файлы и выберите новую папку. Конфликты не перезаписываются. Затем проверьте архив.
- Загрузка остановилась: повторите с тем же профилем и папкой для поддерживаемого проверенного продолжения. Контрольная точка хранит прогресс, а не целостность; проверяйте завершённые файлы.
Изменения удалённых встреч
Код выхода 14 означает отправленное изменение с неизвестным результатом. Прочитайте удалённую встречу или проверьте Zoom до повтора; автоматических повторов нет. После исправления выполните минимальную подходящую проверку и вернитесь к своей задаче.