@iola_adm/iola-cli 0.2.5 → 0.2.7

package/wiki/Home.md

@@ -12,6 +12,7 @@
 - работа с локальной моделью Ollama;
 - работа с YandexGPT, GigaChat, OpenAI, OpenRouter и Codex CLI;
 - geo-сценарии для жителей через Yandex Geocoder API;
+- личные облачные диски: Яндекс Диск и Облако Mail.ru;
 - подключение публичного MCP-сервера.
 
 Быстрый старт:
@@ -30,6 +31,7 @@ iola ask "найди школу 29"
 - [Мастер настройки](Мастер-настройки)
 - [AI-профили](AI-профили)
 - [Yandex Geocoder API key](Yandex-Geocoder-API-key)
+- [Облачные диски](Облачные-диски)
 - [Скиллы для жителей](Скиллы-для-жителей)
 - [Локальный инструментальный агент](Локальный-инструментальный-агент)
 - [Skills и toolsets](Skills-и-toolsets)

package/wiki/Yandex-Geocoder-API-key.md

@@ -23,7 +23,7 @@
 9. После создания ключ появится в списке ключей API Геокодера.
 10. Скопируйте значение ключа. Это значение будет `YANDEX_GEOCODER_API_KEY`.
 
-Важно: новый ключ может начать работать не сразу. В документации Яндекса указано, что активация ключа может занять до 15 минут. Если CLI пишет `Invalid api key` сразу после создания ключа, подождите и повторите проверку.
+Важно: новый ключ может начать работать не сразу. В документации Яндекса указано, что активация ключа может занять до 15 минут, на практике лучше спокойно подождать 15-30 минут. Если CLI пишет `Invalid api key` сразу после создания ключа, это не обязательно ошибка: подождите и повторите проверку командой `iola geo key doctor`.
 
 ## Сохранение в CLI
 

package/wiki//320/232/320/276/320/274/320/260/320/275/320/264/321/213.md

@@ -33,6 +33,29 @@ iola geo key set yandex
 iola geo key status
 iola geo key doctor
 iola geo geocode "Йошкар-Ола, улица Петрова, 15"
+iola geo nearby "Йошкар-Ола, улица Петрова, 15" --dataset all --limit 5
+iola geo distance --from "Петрова 15" --to "школа 7"
+iola geo map-link "школа 7"
+iola geo resolve "садик золотой петушок"
+iola geo route-context "школа 7"
+iola geo services "Йошкар-Ола, улица Петрова, 15"
+```
+
+Облачные диски:
+
+```bash
+iola cloud setup yandex-disk
+iola cloud setup mailru-cloud
+iola cloud status
+iola cloud doctor
+iola cloud use yandex-disk
+iola cloud ls /IOLA
+iola cloud find "справка" --path /IOLA
+iola cloud upload report.md /IOLA/reports/report.md
+iola cloud download /IOLA/reports/report.md ./report.md
+iola cloud share /IOLA/reports/report.md
+iola cloud save --text "Текст заметки" --path /IOLA/notes/note.txt
+iola cloud backup
 ```
 
 Локальная БД:

package/wiki//320/234/320/260/321/201/321/202/320/265/321/200-/320/275/320/260/321/201/321/202/321/200/320/276/320/271/320/272/320/270.md

@@ -94,6 +94,17 @@ iola index folder ./docs
 
 Инструкция по получению ключа: [Yandex Geocoder API key](Yandex-Geocoder-API-key).
 
+### 15. Облачный диск
+
+Подключает личный облачный диск пользователя:
+
+- Яндекс Диск;
+- Облако Mail.ru.
+
+Секреты сохраняются локально в `~/.iola/secrets.json`. Резервные копии CLI не включают OAuth-токены, пароли и API-ключи.
+
+Инструкция: [Облачные диски](Облачные-диски).
+
 ## Повторный запуск
 
 Если компонент уже настроен, его можно не выбирать. Если нужно переустановить или обновить компонент, выберите его номер вручную.

package/wiki//320/236/320/261/320/273/320/260/321/207/320/275/321/213/320/265-/320/264/320/270/321/201/320/272/320/270.md

@@ -0,0 +1,90 @@
+# Облачные диски
+
+`iola-cli` поддерживает личные облачные диски для бытовых сценариев: сохранить отчет, найти документ, сделать резервную копию, создать ссылку и собрать пакет документов.
+
+Сейчас поддерживаются:
+
+- Яндекс Диск;
+- Облако Mail.ru через WebDAV.
+
+Корпоративные хранилища, S3, Nextcloud и ownCloud в пользовательский контур не входят.
+
+## Команды
+
+```bash
+iola cloud setup yandex-disk
+iola cloud setup mailru-cloud
+iola cloud status
+iola cloud doctor
+iola cloud use yandex-disk
+iola cloud ls /IOLA
+iola cloud find "справка" --path /IOLA
+iola cloud upload report.md /IOLA/reports/report.md
+iola cloud download /IOLA/reports/report.md ./report.md
+iola cloud share /IOLA/reports/report.md
+iola cloud save --text "Текст заметки" --path /IOLA/notes/note.txt
+iola cloud backup
+```
+
+## Яндекс Диск
+
+Яндекс Диск подключается через OAuth-токен пользователя.
+
+Официальная документация:
+
+- REST API Диска: `https://yandex.ru/dev/disk/rest?lang=ru`
+- получение OAuth-токена: `https://yandex.ru/dev/id/doc/ru/access`
+- получение токена вручную для проверки: `https://yandex.ru/dev/id/doc/ru/tokens/debug-token`
+
+Что сделать:
+
+1. Откройте страницу Яндекс OAuth: `https://oauth.yandex.ru/`.
+2. Создайте приложение для личного использования.
+3. В правах приложения выберите доступ к Яндекс Диску.
+4. Получите OAuth-токен.
+5. В CLI выполните:
+
+```bash
+iola cloud setup yandex-disk
+```
+
+6. Вставьте OAuth-токен.
+7. Проверьте подключение:
+
+```bash
+iola cloud doctor
+```
+
+Секрет сохраняется локально в `~/.iola/secrets.json`.
+
+## Облако Mail.ru
+
+Облако Mail.ru подключается через WebDAV.
+
+Официальная инструкция Mail.ru по WebDAV: `https://help.mail.ru/cloud/desktop/webdav/`
+
+Что сделать:
+
+1. Войдите в аккаунт Mail.ru.
+2. Создайте пароль для внешнего приложения. Для WebDAV обычный пароль от почты использовать не нужно.
+3. В CLI выполните:
+
+```bash
+iola cloud setup mailru-cloud
+```
+
+4. Введите email и пароль внешнего приложения/WebDAV.
+5. Проверьте подключение:
+
+```bash
+iola cloud doctor
+```
+
+Публичные ссылки через CLI сейчас поддерживаются только для Яндекс Диска. Для Mail.ru доступен список файлов, загрузка и скачивание через WebDAV.
+
+## Безопасность
+
+- OAuth-токены, пароли и API-ключи не попадают в резервные копии.
+- `iola cloud backup` сохраняет конфигурацию без секретов.
+- Удаление и массовое перемещение файлов в первом контуре не реализованы намеренно.
+- Для локальных файлов продолжает действовать отдельный режим `iola files mode`.

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

@@ -1,6 +1,6 @@
 # Скиллы для жителей
 
-Эта страница фиксирует пользовательские skills, которые стоит развивать в `iola-cli`.
+Эта страница фиксирует пользовательские skills, которые реализованы и развиваются в `iola-cli`.
 
 Цель этих skills - помогать жителю города в бытовых вопросах: где находится объект, что рядом, какой объект ближе, как открыть место на карте. Это не административный аудит данных.
 
@@ -8,6 +8,19 @@
 
 Для geo skills нужен ключ `Yandex Geocoder API`.
 
+Первый рабочий контур подключен к слоям `schools` и `kindergartens`.
+
+Команды:
+
+```bash
+iola geo nearby "Йошкар-Ола, улица Петрова, 15" --dataset all --limit 5
+iola geo distance --from "Петрова 15" --to "школа 7"
+iola geo map-link "школа 7"
+iola geo resolve "садик золотой петушок"
+iola geo route-context "школа 7"
+iola geo services "Йошкар-Ола, улица Петрова, 15"
+```
+
 ### nearby
 
 Находит городские объекты рядом с адресом пользователя.
@@ -18,7 +31,7 @@
 - `какие школы ближе к улице Машиностроителей`;
 - `что из городских учреждений рядом с домом`.
 
-На первом этапе работает по слоям `schools` и `kindergartens`. Позже можно подключить МФЦ, поликлиники, остановки, спортобъекты и учреждения культуры.
+Сейчас работает по слоям `schools` и `kindergartens`. Позже можно подключить МФЦ, поликлиники, остановки, спортобъекты и учреждения культуры.
 
 ### route-context
 
@@ -81,17 +94,46 @@
 
 Это важно, чтобы не путать объекты с одинаковыми номерами или похожими названиями.
 
-## Приоритет реализации
+## Ограничения
+
+- Расстояние считается по прямой между координатами. Это не автомобильный и не пешеходный маршрут.
+- CLI не должен подставлять похожий объект из другого населенного пункта. Если слой не содержит нужный объект, ответ должен прямо говорить, что данных недостаточно.
+- При первом поиске рядом CLI геокодирует объекты слоя. Повторные запросы в той же сессии работают быстрее за счет памяти процесса.
+
+## Personal docs skills
+
+Эти skills работают с личными документами пользователя в подключенном облаке. Они включаются только при явном облачном намерении: `Яндекс Диск`, `Облако Mail.ru`, `облако`, `сохрани на диск`, `загрузи`, `дай ссылку`, `поделиться`.
+
+Если пользователь говорит только `файл`, `папка` или `документ`, CLI использует `local-files`, а не облако.
+
+### cloud-find-document
+
+Найти документ в подключенном облаке: справку, квитанцию, школьный документ, файл обращения.
+
+### cloud-save-result
+
+Сохранить ответ CLI, отчет, карточку учреждения или список ближайших объектов в `/IOLA`.
+
+### cloud-share-link
+
+Создать публичную ссылку на файл. В первом контуре поддерживается для Яндекс Диска.
+
+### cloud-document-pack
+
+Собрать папку с материалами для обращения: текст, найденные данные, ссылки, вложенные документы и скриншоты.
+
+### cloud-inbox
+
+Проверить `/IOLA/inbox`, найти новые документы и предложить их разобрать или проиндексировать.
+
+### cloud-backup-cli
+
+Сохранить резервную копию настроек CLI без секретов, OAuth-токенов и API-ключей.
 
-Первый этап:
+### cloud-restore-cli
 
-1. `nearby`
-2. `place-resolver`
-3. `map-link`
+Восстановить CLI из резервной копии, когда пользователь переустановил программу или перешел на другой компьютер.
 
-Второй этап:
+### cloud-organize
 
-1. `distance`
-2. `area-filter`
-3. `route-context`
-4. `address-to-services`
+Помочь разобрать личные документы: найти старые отчеты, крупные файлы, дубликаты и предложить структуру папок.