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

История изменений CLI Яндекс Диска

История изменений CLI для Яндекс Диска: новые возможности, изменения и исправления.

Заметные изменения в @wirecat/yandex-disk-cli. По одному разделу на версию, новые сверху.

0.2.0 — 18.11.2026

Добавлено

  • ydisk store info показывает файл общего хранилища, его размер, формат и число строк, так что WireCat Desktop может сказать, читает ли его Яндекс Диск.
  • ydisk <profile> account remove --keep-data|--delete-data выводит профиль из системы и забывает его на этом компьютере. Выбранные папки и синхронизированные файлы остаются или удаляются, как вы выберете.
  • folders browse дает каждой папке kind и has_children. Яндекс не сообщает число вложенных элементов, поэтому инструмент заглядывает в каждую папку отдельным запросом, если на уровне не больше 20 папок. Если их больше, has_children равен null.

Исправлено

  • Опубликован из GitHub Actions с подписью npm (provenance), поэтому WireCat Desktop его устанавливает: Desktop отказывается ставить выпуск встроенного инструмента, который собрал не workflow его репозитория, а 0.1.0 был опубликован с компьютера.
  • Руководства рассказывают шаг за шагом, что делает инструмент. Новые страницы: найдите документ (слова, формы слов, смысл, имена файлов), подключение агента (навык, mcp add, mcp config, приложения в браузере и что агент может менять), сценарии и сравнение с другими инструментами. Установка и вход проводит через получение токена Яндекса с названиями из самого Яндекса, решение проблем устроено по симптомам и с кодами выхода, а безопасность говорит, что остается на вашем компьютере и как это удалить. В шагах с токеном теперь назван тип приложения «Для доступа к API или отладки», как на страницах Яндекса.
  • Справка и ошибка --cursor в folders browse и files list называют page.next_cursor, ключ, который есть в ответе, а не page.next.

0.1.0 — 17.11.2026

Добавлено

  • За основу взят @wirecat/cli-template 0.25.0.
  • Вход с токеном OAuth Яндекса, который вставляется один раз: session start читает его скрыто или из stdin, проверяет через GET /v1/disk и хранит в связке ключей системы. session status --check и doctor --online говорят, чей это токен.
  • Выбранные папки Диска как текст для поиска: folders add <path>, sync, status, documents list|show|export, search, catalog, теги, заметки и записи памяти, общие команды документов из cli-core. Каждая синхронизация заново обходит выбранные папки (в API Диска нет ленты изменений) и читает только файлы, у которых изменился MD5. Перемещенный файл сохраняет id, теги и заметки. Текст берется из PDF, docx, xlsx, CSV, TSV, текста и Markdown. Время хранится и отдается в UTC.
  • Файлы вживую: files list|show|download|upload|copy|move|create|delete|restore|publish|unpublish по путям на Диске. files delete отправляет в корзину. --replace и files delete спрашивают так же, как files.delete, files publish так же, как files.share, а --dry-run показывает каждый ключ, который проверяет запись. files publish отвечает публичной ссылкой или опускает public_url, если не может ее прочитать. Скачивание и загрузка идут по адресу, который дает Яндекс, без токена.
  • api: по одной команде на каждую операцию описания Swagger 1.2 от Яндекса, всего 20. Три, которые отвечают ссылкой на скачивание или загрузку, пропущены, а ссылки file, preview и sizes ресурса убираются из каждого ответа. --all листает страницы там, где их листает API. Окончательное удаление, overwrite=true и публичная ссылка спрашивают по files.delete и files.share. Операция, которая делает то же, что команда files, проверяет и ключ этой команды: files.move: deny останавливает и api resources-move, в запуске и в --dry-run.