yacli-attachment-to-disk

name	yacli-attachment-to-disk
description	Сохранить вложение из письма на локальный диск: найти письмо, выбрать нужное вложение и экспортировать его в файл. Используй когда пользователь просит скачать invoice, договор, архив или другой attachment из Яндекс Почты.
metadata	{"author":"NextStat"}

Сохранить вложение из письма на диск

Кросс-сервисный сценарий: письмо -> вложение -> локальный файл.

Шаги

1. Найди письмо по теме, отправителю или ключевой фразе:

yacli mail search "invoice" --limit 10

2. Если нужно уточнить вложения, прочитай письмо:

yacli mail read UID

3. Сохрани нужное вложение по индексу или точному имени:

yacli mail attachment export UID --index 1 --output ./invoice.pdf

или

yacli mail attachment export UID --name invoice.pdf --output ./invoice.pdf

Заметки

• Если имя вложения известно точно, предпочитай --name, чтобы не зависеть от порядка attachments.
• Если файл уже существует, добавь --force только после явного подтверждения перезаписи.
• Если у письма несколько похожих вложений, сначала покажи список attachments и объясни выбор.
• Если пользователь просит сохранить файл в конкретную папку, явно используй этот путь в --output.