Документы и файлыYandex Disk

Решение проблем с CLI Яндекс Диска

Исправьте отклоненный токен Яндекса, папку, которая не копируется, или поиск без результатов.

Вход не удался, синхронизация остановилась, поиск ничего не находит: найдите свой случай здесь и исправьте его за минуту-две. Каждая ошибка в своем сообщении говорит, что делать, а код выхода подсказывает скрипту, какой это был сбой.

На этой странице:

  1. Первая проверка
  2. По симптомам
  3. Коды выхода
  4. Если не помогло

Первая проверка

ydisk doctor
ydisk personal doctor --online

doctor не читает связку ключей и не ходит в сеть. Он показывает, что настроено и какие есть проблемы с файлом настроек. doctor --online еще спрашивает Яндекс, работает ли токен профиля.

По симптомам

СимптомЧто делать
ydisk не найденОткройте новый терминал и проверьте, что глобальная папка npm есть в PATH.
"name a profile"Поставьте профиль первым словом, как в ydisk personal status, или задайте YDISK_PROFILE.
"refused the token", код выхода 4Токен неверный, отозван или истек. Получите новый токен и снова выполните ydisk personal session start.
Изменение завершается с кодом выхода 5У токена нет права cloud_api:disk.write, или его запрещают разрешения профиля или YDISK_READ_ONLY. Проверьте настройки. Чтобы получить право, зарегистрируйте приложение заново с ним и получите новый токен.
"the OS keyring did not answer" в LinuxШина сеанса перезапустилась. Выйдите из системы и войдите снова или войдите через session start --credential-storage file.
"no such item, or this token cannot see it", код выхода 6Проверьте путь через files list --folder для его родительской папки. Путь на Диске начинается с /, как в /Documents/plan.pdf.
"asked to slow down", код выхода 8Яндекс получил слишком много запросов с этого аккаунта. Подождите минуту и повторите команду.
Синхронизация останавливается до концаОдна синхронизация читает до 200 файлов. Запускайте sync снова, пока status не покажет, что работы не осталось.
Документы выбранной папки пропалиПапку переименовали или переместили на Диске. Добавьте ее снова по новому пути через folders add.
Поиск не находит файл, который точно естьСм. когда поиск ничего не находит.
PDF находится по имени, но не по текстуЭто скан без текстового слоя или файл больше 50 МБ. status перечисляет такие файлы с причиной.
Загрузка не удалась, потому что Диск заполненОсвободите место на Диске или очистите корзину. Повтор не поможет, пока нет места.
Большую загрузку отклоняютЯндекс ограничивает размер одного файла по тарифу: 1 ГБ без тарифа Яндекс 360 и больше с ним (ограничения Яндекса).
Изменение завершилось с "outcome_unknown", код выхода 14Яндекс дал сбой во время изменения, поэтому оно могло пройти, а могло нет. Проверьте через files show, прежде чем запускать снова.
Агент изменил файл, который вы не хотели менятьПо MCP уровень ask дает команде выполниться. Запретите files.delete и files.share или задайте YDISK_READ_ONLY=1. См. подключение агента. Удаленный файл лежит в корзине Диска: files restore.
Файл настроек не читаетсяdoctor перечисляет каждую проблему файла в config.issues. Выполните config unset, который дан для каждой, или config repair, или поправьте файл вручную.
doctor перечисляет files.problemsДругие пользователи компьютера могут читать config.json или заходить в его папку. Выполните каждый chmod, который doctor печатает после "to make it private:".

Коды выхода

КодЧто значит
2Команда задана неверно: нет профиля, аргумента или параметра.
3Настройки или связка ключей непригодны.
4Яндекс отклонил токен.
5Нельзя: права токена или разрешения профиля.
6Нет такого файла или папки, или токен их не видит.
7Изменение требует вашего подтверждения, а терминала для вопроса не было.
8Яндекс просит снизить темп.
14Изменение могло пройти, а могло нет.

Все коды есть в справочнике команд.

Если не помогло

ydisk runs list показывает последние запуски, а ydisk runs show один из них со всеми шагами. Секреты скрыты. ydisk doctor reports create записывает файл отчета для сообщения об ошибке и говорит, что в нем лежит. Создайте обращение на github.com/WireCatLabs/ydisk-cli/issues с кодом ошибки и командой. Никогда не вставляйте в обращение токен или личное содержимое.