Mail
Если что-то пошло не так
Исправьте проблемы с профилем, паролем приложения, связкой ключей, лимитами и файлом настроек Mail CLI.
Начните с симптома, выполните проверку, затем повторите команду. Сохраните код ошибки и имя профиля для обращения в поддержку.
| Симптом | Что делать |
|---|---|
| Не уверены, что настроено | Выполните mail doctor. Он не читает связку ключей и не использует сеть. |
mail не найден | Откройте новый терминал и проверьте, что глобальная папка npm есть в PATH. |
| "name a profile" | Поставьте профиль первым, как в mail ya folders list, или задайте MAIL_PROFILE. |
| Файл настроек не читается | doctor перечисляет все проблемы файла в config.issues. Выполните config unset, который он указывает для каждой, или исправьте файл вручную. |
doctor показывает files.problems | Другие пользователи компьютера могут читать config.json или входить в его папку. Выполните каждый chmod, который doctor печатает после "to make it private:". Сам doctor права на файлы никогда не меняет. |
| "no app password for profile" | Выполните mail <profile> session start или задайте MAIL_PASSWORD для одного запуска. |
| "the mail server refused the login" | Пароль приложения неверен, либо IMAP и пароли приложений выключены. Шаги для каждого провайдера описаны в подготовке почтового ящика. Яндексу после создания нового пароля приложения нужно ещё 2–3 часа. Затем снова session start. |
rate_limited | Две причины. Сервер ограничивает аккаунт: команда завершается ошибкой «the mail server is limiting this account»; подождите и выполните её снова. sync израсходовал собственный бюджет запросов: sync не завершается ошибкой. Он отвечает state: partial с stopped: "requests", а в meta.issues есть rate_limited с причиной budget.requests; выполните sync снова, чтобы продолжить, или увеличьте --max-pages. В обоих случаях уже сохранённая почта пропускается. |
| "could not reach the OS keyring" | Хранилище ключей заблокировано или не запущена служба секретов. Пароль сохранён вместо этого в закрытом файле (credential_storage: "file"). Разблокируйте связку ключей и снова выполните session start, чтобы вернуть его туда. |
| Запись отклонена | Её останавливают разрешения профиля или MAIL_READ_ONLY; см. настройки. |
Никогда не вставляйте токен, пароль или личное содержимое в обращение в поддержку.