# Решение проблем (/ru/docs/zm/troubleshooting)

Восстановите работу при зависшем входе, недостающих данных или ошибке архива. Найдите симптом,
исправьте относящуюся к нему причину и повторите указанную проверку. Сохраняйте завершённые файлы
записей и проверяйте неоднозначный результат удалённого изменения перед повтором.

## Вход [#вход]

### Я подтвердил в браузере, но терминал ждёт [#я-подтвердил-в-браузере-но-терминал-ждёт]

Браузер подтвердил приложение, но ответ не дошёл до процесса. Оставьте терминал открытым.
Скопируйте `code=…&state=…` или полный URL на странице WireCat, вставьте в **тот же работающий
терминал `zm login`** и нажмите Enter. Команда должна сообщить `loggedIn: true` и вернуть приглашение.
Если время истекло, начните новый вход и используйте новый ответ. Старый ответ не завершит новую попытку.

Другой компьютер с браузером или удалённый терминал могут препятствовать автоматическому возврату.
[Сеансы](/llms.mdx/docs/ru/zm/sessions/content.md#finish-the-browser-callback) объясняют завершение и пятиминутный срок.

### Zoom сообщает "Invalid redirect" [#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
отличается. Начальный манифест не включает этот режим и разрешения. Пройдите
[полную проверку приложения](/llms.mdx/docs/ru/zm/zoom-app/content.md#create-your-own-app) и подтвердите завершение в терминале.

### Браузер не запускается [#браузер-не-запускается]

Явно выберите установленный браузер:

```sh
zm login --browser firefox
```

В интерактивном терминале откройте сами URL авторизации, напечатанный текущим входом, и при
необходимости вставьте ответ. Не используйте старый URL. Без ввода ошибка запуска браузера
быстро завершает команду. Для входа в канал/JSON нужен `--interactive`; `--no-input` запрещает его.

### Приложение недоступно или требует администратора [#приложение-недоступно-или-требует-администратора]

Проверьте, может ли пользователь Zoom установить приложение. Приложение в разработке не доступно
автоматически вне аккаунта разработчика. Попросите владельца или администратора разрешить доступ;
второе приложение не обходит политику компании. [Повторное использование](/llms.mdx/docs/ru/zm/zoom-app/content.md#use-an-app-you-already-created)
показывает настройки. Разрешённые VTT-файлы можно импортировать без API.

### Ошибка системного хранилища паролей [#ошибка-системного-хранилища-паролей]

Хранилище паролей должно быть установлено, запущено и доступно пользователю. Выполните вход
под тем же пользователем системы, которому доступно хранилище; на сервере без графического сеанса
его может не быть. Токен не сохраняется в открытый файл. После исправления повторите вход и
проверьте `zm session status --json`.

### Не хватает разрешения [#не-хватает-разрешения]

Ошибка указывает точное имя. Владелец добавляет его в **Scopes** и сохраняет приложение, затем
пользователь повторяет `zm login`. Проверьте разрешения через `zm session status --json` и
повторите чтение. Выданные токены не получают новые права автоматически. Архив, детали встреч,
удалённая проверка и изменения имеют [отдельные разрешения](/llms.mdx/docs/ru/zm/zoom-app/content.md#add-archive-or-management-access).

## Настройки [#настройки]

Проверьте клиент, источник и профиль через `zm config show`. Повреждённые настройки не мешают
`--help` и `--version`, но команды настроек сообщают об ошибке. Смена метки не меняет пользователя Zoom.
Если терминал и MCP видят разные данные, сравните `ZM_CONFIG_DIR` и `MESSAGING_STORE`.

## Ответы Zoom [#ответы-zoom]

Ошибка сети и неверный ответ провайдера различаются. Проверьте подключение и не указан ли
`--offline` для запроса Zoom. Диагностика не включает исходный текст ошибок провайдера. В отчёте
сохраните команду, код ошибки и имя разрешения; исключите параметры входа, токены и частный текст встреч.

## Отсутствуют встречи или расшифровки [#отсутствуют-встречи-или-расшифровки]

| Симптом | Проверка и исправление | Признак успеха |
| --- | --- | --- |
| Нет профиля или список пуст | Выберите профиль и импортируйте/загрузите; чтение не регистрирует аккаунты | `zm meetings list --json` показывает встречи профиля |
| Нет недавних встреч организатора | Проверьте пользователя Zoom, API и даты; задайте более ранний `--since` | Сравните даты с ожидаемыми встречами |
| Есть встреча, но нет текста | Проверьте создание/хранение текста и права; несохранённый или удалённый текст загрузка не создаёт | Откройте текст после появления в Zoom и повторной загрузки |
| Нет встречи, где вы были участником | Получите VTT у организатора или скачайте с разрешением и импортируйте | Проверьте дату, название и текст |
| Текст появился позднее | Повторите `zm pull --lookback-days 7` или более ранний `--since` | Откройте новый текст |
| Загрузка прервалась | Исправьте ошибку и повторите; неудачная встреча не продвигает курсор | Проверьте подтверждение и список |
| Неверное имя файла или время | Используйте `YYYY-MM-DD_HHMM_topic.vtt` и его часовой пояс; разрешите конфликты | Импорт с правильной датой и темой |
| Поиск пуст | Проверьте текст, профиль и покрытие индекса | Откройте известный отрывок и проверьте его доступность |

Выполняйте загрузки одного аккаунта последовательно. См. [настройки текста](/llms.mdx/docs/ru/zm/zoom-app/content.md#before-your-first-zm-pull),
[импорт файлов](/llms.mdx/docs/ru/zm/archive/content.md#downloaded-transcripts) и [покрытие поиска](/llms.mdx/docs/ru/zm/search/content.md#search-stored-meetings).

## Архив [#архив]

* **Нет доступных облачных файлов:** проверьте даты, аккаунт организатора, наличие записи и её
  разрешения. Расшифровка и облачная запись — разные источники.
* **Замок остался после сбоя:** изучите `recordings archive locks`, предпросмотрите
  `recordings archive recover`, затем добавьте `--yes` только для распознанного замка завершившегося
  процесса. Активные и чужие замки сохраняются. См. [восстановление](/llms.mdx/docs/ru/zm/archive/content.md#locks-and-recovery).
* **Контрольная сумма не совпала:** сохраните файлы и выберите новую папку. Конфликты не перезаписываются.
  Затем проверьте архив.
* **Загрузка остановилась:** повторите с тем же профилем и папкой для поддерживаемого проверенного
  продолжения. Контрольная точка хранит прогресс, а не целостность; проверяйте завершённые файлы.

## Изменения удалённых встреч [#изменения-удалённых-встреч]

Код выхода 14 означает отправленное изменение с неизвестным результатом. Прочитайте удалённую
встречу или проверьте Zoom до повтора; автоматических повторов нет. После исправления выполните
минимальную подходящую проверку и вернитесь к [своей задаче](/llms.mdx/docs/ru/zm/usage/content.md).