@iola_adm/iola-cli 0.2.33 → 0.2.34

package/wiki/Skills-/320/270-toolsets.md

@@ -9,15 +9,18 @@ Skills не подмешиваются в каждый запрос целико
 - `local-files` - когда пользователь просит работать с локальными файлами, папками, архивами или документами;
 - `browser-agent` - когда запрос связан с сайтом, URL, страницей, скриншотом или браузером;
 - `local-model` - инструкции для локальных компактных моделей и tool-планирования;
-- `yandex-services` - когда запрос связан с Yandex Connector: Яндекс Диск, Почта, Календарь, Контакты, Телемост или Yandex ID.
+- `yandex-services` - когда запрос связан с Yandex Connector: Яндекс Диск, Почта, Календарь, Контакты, Телемост или Yandex ID;
+- `user-skills` - когда пользователь просит создать, включить, выключить или удалить собственный skill.
 
 Обычный диалог вроде `привет` не получает инструкции про слои, отчеты, файлы и браузер.
 
 ```bash
 iola skills list
 iola skills show open-data
+iola skills create mail-digest --description "Сводка почты" --instructions "Когда пользователь просит сводку почты, найди непрочитанные письма и кратко сгруппируй их по отправителям." --allowed-tools yandex_mail_list,yandex_mail_read --enable
 iola skills enable reports
 iola skills disable local-model
+iola skills delete mail-digest --yes
 iola skills paths
 ```
 
@@ -40,6 +43,24 @@ iola tools profile full
 Режим `safe` подходит для чтения и анализа без записи файлов и без запуска sync.
 Режим `full` предназначен для доверенного локального пользователя.
 
+## Пользовательские skills
+
+Пользователь может создавать собственные skills без редактирования npm-пакета. Такие skills сохраняются локально в `~/.iola/skills/<name>/SKILL.md` и не пропадают при обновлении CLI.
+
+Skill - это инструкция для агента, а не произвольный исполняемый код. Он может описывать любые сценарии, но должен опираться на встроенные tools `iola-cli`: открытые данные, Яндекс Почту/Диск/Календарь/Контакты, локальные файлы, browser runtime, cron, MCP, отчеты и память.
+
+Доступные tools управления:
+
+- `user_skill_list` - список пользовательских skills;
+- `user_skill_create` - создать skill;
+- `user_skill_enable` - включить skill;
+- `user_skill_disable` - выключить skill;
+- `user_skill_delete` - удалить пользовательский skill.
+
+При создании через AI пользователь может написать обычным языком: `создай скилл, который при просьбе "сводка почты" берет непрочитанные письма и группирует по отправителям`. CLI создаст локальный `SKILL.md` и включит его.
+
+Для опасных действий внутри пользовательского skill нужно явное подтверждение пользователя: отправка писем, удаление данных, публикация ссылок, запись файлов и изменение внешних сервисов.
+
 ## Yandex toolset
 
 Toolset `yandex` включает локальные tools для пользовательских сервисов Яндекса:
@@ -48,7 +69,7 @@ Toolset `yandex` включает локальные tools для пользов
 - Яндекс Диск: список, создание папок, поиск, сохранение текста, загрузка, скачивание, публичные ссылки;
 - Яндекс Почта: статус, список писем, поиск, чтение, отправка;
 - Яндекс Календарь: статус, список событий, создание события;
-- Яндекс Контакты: статус, список, поиск;
+- Яндекс Контакты: статус, список, поиск, карточка, создание, обновление, удаление, импорт/экспорт, дубликаты, неполные карточки, backup на Диск, дни рождения в календарь, письмо/ссылка/встреча по контакту;
 - Телемост: подготовка встречи через календарное событие.
 
 Опасные действия ограничены: отправка письма, удаление файлов, публикация ссылок и создание событий требуют явного подтверждения в tool-вызове. Токены хранятся локально в `~/.iola/secrets.json`.

package/wiki/Yandex-Connector.md

@@ -116,12 +116,27 @@ OAuth-права дают CLI разрешение обращаться к се
 - `yandex_disk_ls` - список файлов и папок;
 - `yandex_disk_mkdir` - создать папку;
 - `yandex_disk_find` - найти файл или папку;
+- `yandex_disk_stat` - метаданные файла или папки;
+- `yandex_disk_exists` - проверка существования;
+- `yandex_disk_read_text` - чтение небольшого текстового файла;
 - `yandex_disk_save_text` - сохранить текстовый результат на Диск;
 - `yandex_disk_upload` - загрузить локальный файл на Диск;
 - `yandex_disk_download` - скачать файл с Диска;
+- `yandex_disk_move` - переместить файл или папку;
+- `yandex_disk_copy` - скопировать файл или папку;
+- `yandex_disk_rename` - переименовать файл или папку;
 - `yandex_disk_share` - создать публичную ссылку;
+- `yandex_disk_share_qr` - создать публичную ссылку и QR-код, сохранить QR PNG на Диск;
+- `yandex_disk_share_email` - создать ссылку, QR-код и отправить их по Яндекс Почте;
 - `yandex_disk_unshare` - снять публичную ссылку;
 - `yandex_disk_delete` - удалить файл или папку;
+- `yandex_disk_trash_list` - показать корзину;
+- `yandex_disk_restore` - восстановить из корзины;
+- `yandex_disk_empty_trash` - очистить корзину;
+
+QR-код:
+
+В веб-интерфейсе Яндекс Диска QR-код доступен при работе с публичной ссылкой. В REST API отдельное поле готового QR-кода не документировано. Поэтому `iola-cli` берет публичную ссылку через API, локально создает PNG QR-кода, загружает этот PNG на Яндекс Диск рядом с исходным объектом и при необходимости публикует отдельную ссылку на QR.
 - `yandex_mail_status` - проверить доступ к Почте;
 - `yandex_mail_list` - показать последние письма;
 - `yandex_mail_search` - найти письма;
@@ -132,9 +147,39 @@ OAuth-права дают CLI разрешение обращаться к се
 - `yandex_calendar_create_event` - создать событие;
 - `yandex_contacts_status` - проверить доступ к Контактам;
 - `yandex_contacts_list` - показать контакты;
-- `yandex_contacts_search` - найти контакт;
+- `yandex_contacts_search` - найти контакт по имени, email, телефону, организации, адресу или заметке;
+- `yandex_contacts_get` - открыть карточку контакта;
+- `yandex_contacts_create` - создать контакт;
+- `yandex_contacts_update` - обновить поля контакта;
+- `yandex_contacts_delete` - удалить контакт;
+- `yandex_contacts_add_email`, `yandex_contacts_add_phone`, `yandex_contacts_add_address`, `yandex_contacts_add_note`, `yandex_contacts_add_birthday`, `yandex_contacts_add_org` - добавить отдельные поля;
+- `yandex_contacts_remove_email`, `yandex_contacts_remove_phone` - удалить отдельные поля;
+- `yandex_contacts_export_vcard`, `yandex_contacts_export_csv` - экспортировать контакты;
+- `yandex_contacts_import_vcard`, `yandex_contacts_import_csv` - импортировать контакты;
+- `yandex_contacts_find_incomplete` - найти неполные карточки;
+- `yandex_contacts_find_duplicates` - найти дубликаты;
+- `yandex_contacts_backup_to_disk` - сохранить backup контактов на Яндекс Диск;
+- `yandex_contacts_birthdays_to_calendar` - создать события дней рождения в календаре;
+- `yandex_contact_send_mail` - отправить письмо контакту;
+- `yandex_contact_send_disk_link_qr` - отправить контакту ссылку и QR-код на объект Диска;
+- `yandex_contact_create_disk_folder` - создать папку контакта на Диске с vCard и README;
+- `yandex_contact_create_calendar_event` - создать встречу с контактом;
+- `yandex_contact_create_telemost_event` - создать событие для Телемоста с контактом;
+- `yandex_contact_from_public_entity` - создать контакт из открытого городского слоя;
 - `yandex_telemost_create_event` - создать календарное событие для встречи.
 
+Регулярная проверка контактов:
+
+```bash
+iola yandex contacts-maintenance on --days 7
+iola yandex contacts-maintenance on --days 7 --backup
+iola yandex contacts-maintenance status
+iola yandex contacts-maintenance tick
+iola yandex contacts-maintenance off
+```
+
+Проверка ищет дубликаты и неполные карточки. Если включен `--backup`, при tick сохраняется CSV-копия контактов на Яндекс Диск.
+
 Включение сервиса в `/yandex` разрешает CLI использовать соответствующую категорию. Отправка письма, удаление файлов, публикация ссылок и создание событий требуют явного намерения пользователя и подтверждения в tool-вызове.
 
 ## Иконка приложения

package/wiki//320/241/320/272/320/270/320/273/320/273/321/213-/320/264/320/273/321/217-/320/266/320/270/321/202/320/265/320/273/320/265/320/271.md

@@ -162,9 +162,37 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 - показать файлы и папки в `/IOLA`;
 - создать папку;
 - найти файл или папку;
+- проверить, есть ли файл или папка;
+- показать карточку файла: размер, тип, даты изменения, публичная ссылка;
+- прочитать небольшой текстовый файл;
 - сохранить текстовый результат;
 - создать или снять публичную ссылку;
-- загрузить или скачать файл.
+- создать QR-код для публичной ссылки и сохранить его на Диск;
+- отправить публичную ссылку и QR-код по Яндекс Почте email-адресу или контакту;
+- загрузить или скачать файл;
+- переместить, скопировать или переименовать файл/папку;
+- удалить файл/папку в корзину;
+- показать корзину, восстановить объект из корзины или очистить корзину.
+
+Примеры:
+
+- `сколько места на Яндекс Диске`;
+- `покажи файлы на Яндекс Диске`;
+- `найди на Диске договор`;
+- `прочитай файл /IOLA/notes/todo.txt`;
+- `создай папку фото на Яндекс Диске`;
+- `сделай публичную ссылку на /IOLA/report.pdf`;
+- `сделай публичную ссылку и QR-код на /IOLA/report.pdf`;
+- `отправь ссылку и QR-код на /IOLA/report.pdf по почте user@example.com`;
+- `отправь Петрову ссылку и QR-код на папку /IOLA/reports`;
+- `создай папку /IOLA/share, перенеси файлы из папки /IOLA/inbox, сделай ссылку и QR-код и отправь по почте user@example.com`;
+- `сними публичную ссылку с /IOLA/report.pdf`;
+- `переименуй /IOLA/a.txt в b.txt`;
+- `перемести /IOLA/a.txt в /IOLA/archive/a.txt`;
+- `скопируй /IOLA/a.txt в /IOLA/copy/a.txt`;
+- `удали /IOLA/tmp.txt`;
+- `покажи корзину Яндекс Диска`;
+- `восстанови /IOLA/tmp.txt из корзины`.
 
 ### yandex-mail
 
@@ -213,7 +241,56 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 
 - проверить доступ к адресной книге;
 - показать контакты;
-- найти контакт по имени, email или телефону.
+- найти контакт по имени, email, телефону, организации, адресу или заметке;
+- открыть карточку контакта;
+- создать контакт с email или телефоном;
+- добавить или обновить email, телефон, адрес, заметку, день рождения, организацию и должность;
+- удалить email или телефон из карточки;
+- удалить контакт по явной просьбе пользователя;
+- найти неполные контакты: без email, телефона или адреса;
+- найти дубликаты контактов;
+- экспортировать контакты в vCard или CSV;
+- импортировать контакты из vCard или CSV;
+- сохранить резервную копию контактов на Яндекс Диск;
+- создать события дней рождения в Яндекс Календаре;
+- включить регулярную проверку контактов: дубликаты, неполные карточки и опциональный backup на Диск.
+
+Примеры:
+
+- `найди контакт Петров`;
+- `создай контакт Иван Петров email ivan@example.com`;
+- `добавь телефон +7 999 123 45 67 к контакту Иван Петров`;
+- `добавь заметку к контакту Иван Петров заметка: родительский комитет`;
+- `покажи контакты без email`;
+- `покажи дубликаты контактов`;
+- `экспортируй контакты в csv`;
+- `сохрани резервную копию контактов на Яндекс Диск`;
+- `импортируй контакты из contacts.csv`;
+- `создай события дней рождения из контактов в календаре`.
+- `включи регулярную проверку контактов каждые 7 дней`;
+- `запусти проверку контактов сейчас`;
+- `включи проверку контактов с backup на Диск`.
+
+### yandex-contacts-combined
+
+Комбинированные сценарии с контактами:
+
+- отправить письмо контакту по имени;
+- если найдено несколько контактов, попросить уточнить;
+- если у контакта нет email, сказать прямо и не отправлять письмо;
+- отправить контакту публичную ссылку и QR-код на файл или папку Яндекс Диска;
+- создать папку контакта на Яндекс Диске и сохранить туда `contact.vcf` и `README.txt`;
+- создать встречу с контактом в Яндекс Календаре;
+- создать календарное событие для Телемоста с контактом;
+- создать контакт из открытого городского слоя, если у школы или детского сада есть публичный email или телефон.
+
+Примеры:
+
+- `отправь Петрову письмо текст: встреча завтра в 14:00`;
+- `отправь Иванову ссылку и QR-код на /IOLA/report.pdf`;
+- `создай папку на Яндекс Диске для контакта Иван Петров`;
+- `создай встречу с Иваном Петровым завтра в 15:00`;
+- `создай контакт из школы № 7`.
 
 ### yandex-telemost