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

Настройки CLI Яндекс Диска

Настройки CLI для Яндекс Диска: профили, папки, переменные и порядок, в котором они действуют.

Меняйте поведение ydisk для одного профиля или для всех сразу: что агент может менять на вашем Диске, как долго хранятся записи запусков и как поиск упорядочивает результаты. Настройки лежат в одном файле, config.json, в папке, которую показывает ydisk doctor. У каждого профиля своя часть, а defaults действуют для всех профилей.

ydisk personal config show
ydisk personal config set limit 50
ydisk personal config unset limit

config show перечисляет каждую настройку и откуда она взялась: из файла, из переменной или из значения по умолчанию.

Разрешения

permissions решает, что команда может делать для этого профиля. У каждой команды свой ключ с ее именем, например files.move или files.upload, и у каждого ключа один из четырех уровней:

УровеньЧто происходит
allowКоманда выполняется.
askВ терминале инструмент сначала спрашивает. Через MCP спросить некого, поэтому команда выполняется.
readonlyЧтение выполняется. Изменение отклоняется.
denyКоманда отклоняется с кодом выхода 5.

Два ключа охраняют изменения, которые трудно отменить. Пока вы их не измените, у них уровень ask. Остальные ключи files стоят на allow:

КлючЧто охраняет
files.deletefiles delete, а также загрузку, копирование и перенос с --replace, которые перезаписывают файл. В группе api: удаление, очистку корзины и любую перезапись.
files.sharefiles publish и files unpublish: ссылку, которую откроет любой, у кого она есть. В группе api: операции с публичными ссылками.
ydisk personal config set permissions.files.delete deny
ydisk personal config set permissions.files.share deny
ydisk personal config set permissions.files.upload deny

Команда api, которая делает то же, что команда files, проверяет и ключ той команды: files.move со значением deny останавливает и api resources-move. --dry-run у любого изменения показывает каждый проверяемый ключ и его уровень, но само изменение не делает.

YDISK_READ_ONLY=1 отклоняет любое изменение, что бы ни говорили разрешения. Для одного MCP-сервера --permission files.delete=deny делает ключ строже, но не мягче. См. подключение агента.

Записи запусков

Команда, которая завершилась ошибкой, сохраняется как запуск, его показывают ydisk runs list и runs show. Команда, которая обращается к Яндекс Диску, например files list, sync или session status --check, сохраняется и при успехе, если только record не false (тогда сохраняются одни ошибки) или она не запущена с --no-record. record_input решает, хранит ли запуск слова, которые вы набрали. По умолчанию true, пока вы не поставите false. Секреты скрываются в любом случае. См. безопасность.

НастройкаПо умолчаниюЧто делает
recordtrueСохранять каждый запуск. false сохраняет только неудачные.
record_inputtrueХранить слова, набранные в командной строке: true, false или failed.
keep_runs_for_days30Сколько дней хранится запуск.
keep_successful_runs_for_days7Сколько дней хранится успешный запуск.
runs_size_limit_mb200Сколько мегабайт могут занимать все запуски вместе.

Другие настройки

НастройкаПо умолчаниюЧто делает
limit20Сколько элементов список показывает за раз.
search_rerankermmarcoМодель, которая упорядочивает первые результаты поиска, или off.
embedding_providerlocallocal или openai: чем текст превращается в векторы для поиска по смыслу. openai отправляет текст в OpenAI.
update_checktrueРаз в день проверять, нет ли новой версии.
skill_hinttrueРаз в день сообщать агенту, что skill install даст ему навык этого инструмента.

Переменные окружения

ПеременнаяЧто делает
YDISK_PROFILEПрофиль для команд, в которых он не назван.
YDISK_READ_ONLY1 отклоняет любое изменение.