@iola_adm/iola-cli 0.2.36 → 0.2.38

package/wiki/AI-/320/277/321/200/320/276/321/204/320/270/320/273/320/270.md

@@ -29,7 +29,15 @@ iola ask "найди школы на Петрова"
 
 ### YandexGPT
 
-Для CLI нужны две вещи: API key и ID каталога Yandex Cloud.
+Рекомендуемый путь - через `Yandex Cloud Connector`:
+
+```bash
+iola yandex cloud setup
+```
+
+В интерактивном агенте можно выбрать YandexGPT через `/model`. Если Cloud Connector еще не подключен, CLI предложит открыть настройку.
+
+Для CLI нужны две вещи: API key и ID каталога Yandex Cloud. Тот же мастер Cloud Connector может дополнительно сохранить ключ геокодера, чтобы geo-skills и Яндекс Go deeplink работали сразу.
 
 Пошаговая настройка:
 
@@ -73,6 +81,7 @@ CLI попросит ввести:
 После сохранения ключа выберите профиль и модель:
 
 ```bash
+iola yandex cloud enable yandexgpt
 iola ai setup yandexgpt --model yandexgpt-lite/latest
 ```
 
@@ -92,6 +101,8 @@ iola ai setup yandexgpt --model yandexgpt-lite/latest
 
 CLI также понимает env-переменные `YANDEXGPT_API_KEY` или `YANDEX_CLOUD_API_KEY`, а для каталога - `YANDEXGPT_FOLDER_ID` или `YANDEX_CLOUD_FOLDER_ID`.
 
+Подробно про единый путь геокодера и YandexGPT: [Yandex Cloud Connector](Yandex-Cloud-Connector).
+
 ### GigaChat
 
 Для CLI нужен authorization key. Это не одноразовый OAuth access token: CLI сам получает OAuth-токен перед запросом, используя сохраненный authorization key.

package/wiki/Home.md

@@ -13,6 +13,7 @@
 - работа с YandexGPT, GigaChat, OpenAI, OpenRouter и Codex CLI;
 - geo-сценарии для жителей через Yandex Geocoder API;
 - Yandex Connector для пользовательских сервисов Яндекса;
+- Yandex Cloud Connector для геокодера, YandexGPT и deeplink Яндекс Go;
 - личные облачные диски: Яндекс Диск и Облако Mail.ru;
 - подключение публичного MCP-сервера.
 
@@ -32,6 +33,7 @@ iola ask "найди школу 29"
 - [Мастер настройки](Мастер-настройки)
 - [AI-профили](AI-профили)
 - [Yandex Geocoder API key](Yandex-Geocoder-API-key)
+- [Yandex Cloud Connector](Yandex-Cloud-Connector)
 - [Yandex Connector](Yandex-Connector)
 - [Облачные диски](Облачные-диски)
 - [Скиллы для жителей](Скиллы-для-жителей)

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

@@ -9,7 +9,7 @@ Skills не подмешиваются в каждый запрос целико
 - `local-files` - когда пользователь просит работать с локальными файлами, папками, архивами или документами;
 - `browser-agent` - когда запрос связан с сайтом, URL, страницей, скриншотом или браузером;
 - `local-model` - инструкции для локальных компактных моделей и tool-планирования;
-- `yandex-services` - когда запрос связан с Yandex Connector: Яндекс Диск, Почта, Календарь, Контакты, Телемост или Yandex ID;
+- `yandex-services` - когда запрос связан с Yandex Connector или Yandex Cloud Connector: Яндекс Диск, Почта, Календарь, Контакты, Телемост, Yandex ID, геокодер, YandexGPT или Яндекс Go deeplink;
 - `user-skills` - когда пользователь просит создать, включить, выключить или удалить собственный skill.
 
 Обычный диалог вроде `привет` не получает инструкции про слои, отчеты, файлы и браузер.

package/wiki/Yandex-Cloud-Connector.md

@@ -0,0 +1,127 @@
+# Yandex Cloud Connector
+
+`Yandex Cloud Connector` подключает к `iola-cli` сервисы Yandex Cloud, которые нужны жителю:
+
+- Яндекс Геокодер - адреса, координаты, расстояния, ссылки на карту и deeplink Яндекс Go;
+- YandexGPT - российская AI-модель в меню `/model`.
+
+Это отдельный коннектор. Он не заменяет обычный `Yandex Connector` для Диска, Почты, Календаря и Контактов.
+
+## Как подключить
+
+Самый простой путь:
+
+```bash
+iola master
+```
+
+В мастере выберите:
+
+```text
+14. Yandex Cloud Connector - геокодинг и YandexGPT
+```
+
+CLI откроет консоль Yandex Cloud и попросит сохранить:
+
+- ключ `YANDEX_GEOCODER_API_KEY`;
+- при необходимости YandexGPT API key;
+- при необходимости `YANDEXGPT_FOLDER_ID`.
+
+Геокодер включается по умолчанию. YandexGPT можно включить сразу или позже через `/model`.
+
+Прямые команды:
+
+```bash
+iola yandex cloud setup
+iola yandex cloud status
+iola yandex cloud doctor
+iola yandex cloud enable geocoder yandexgpt
+iola yandex cloud disable yandexgpt
+iola yandex cloud delete
+```
+
+Ключи сохраняются только локально в:
+
+```text
+~/.iola/secrets.json
+```
+
+## YandexGPT в /model
+
+Откройте меню моделей:
+
+```text
+/model
+```
+
+Выберите:
+
+```text
+2. Российские AI (YandexGPT/GigaChat)
+```
+
+Если Yandex Cloud Connector еще не подключен, CLI объяснит, что нужен коннектор, и предложит включить его. Если отказаться, CLI вернется в меню выбора моделей.
+
+## Геокодер
+
+После подключения доступны geo-команды:
+
+```bash
+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 route-context "школа 7"
+```
+
+Геокодер также нужен для Яндекс Go deeplink:
+
+```bash
+iola yandex go link --from "Медведево, Школьная 15" --to "Медведево, Советская 20"
+iola yandex go open --from "Медведево, Школьная 15" --to "Медведево, Советская 20" --tariff econom
+```
+
+Если ключ геокодера не найден, CLI пишет понятную ошибку и предлагает:
+
+```bash
+iola master
+```
+
+или:
+
+```bash
+iola yandex cloud setup
+```
+
+## Яндекс Go
+
+Сейчас `iola-cli` поддерживает только безопасный сценарий:
+
+- уточнить адрес отправления и назначения;
+- получить координаты через геокодер;
+- сформировать deeplink маршрута Яндекс Go;
+- при команде `open` открыть ссылку в браузере или приложении.
+
+CLI не нажимает кнопку заказа, не подтверждает поездку, не списывает деньги и не обещает цену. Цена, повышенный спрос, детское кресло, назначение машины и отмена поездки требуют партнерского `clid/apikey` от Яндекса.
+
+Примеры:
+
+```bash
+iola yandex go link --from "Йошкар-Ола, Ленинский 24" --to "Йошкар-Ола, Кремлевская 26"
+iola ask "сделай ссылку Яндекс Go от Медведево, Школьная 15 до Медведево, Советская 20"
+```
+
+## Ручная инструкция по ключу геокодера
+
+Если нужен только геокодер без YandexGPT, можно использовать отдельную инструкцию:
+
+[Yandex Geocoder API key](Yandex-Geocoder-API-key)
+
+Бесплатный лимит API Геокодера для обычного ключа у Яндекса указан как до 1000 запросов в сутки. Новый ключ может активироваться с задержкой 15-30 минут.
+
+## Важно
+
+Yandex Cloud тарифицирует YandexGPT по правилам Yandex Cloud. Перед активным использованием модели проверьте лимиты и оплату в консоли.
+
+Не публикуйте API-ключи и folder ID в GitHub, README, issue, wiki или чатах поддержки.

package/wiki/Yandex-Connector.md

@@ -42,14 +42,17 @@ iola yandex token delete
 - `docs` - Яндекс Документы / 360 через Диск;
 - `telemost` - Яндекс Телемост через календарное событие.
 
-Отдельные ключи, не обычный OAuth бытового Яндекса:
+Отдельный коннектор, не обычный OAuth бытового Яндекса:
 
-- `cloud` - Yandex Cloud, YandexGPT, SpeechKit, Vision, IAM и folder ID;
-- `maps` - Yandex Geocoder API и карты.
+- `cloud` - Yandex Cloud Connector: ключ геокодера, YandexGPT API key и folder ID;
+- `maps` - Яндекс Геокодер: адреса, координаты, расстояния, ссылки на карту и deeplink маршрута.
+
+Готово без оформления заказа:
+
+- `taxi` - Яндекс Go / Такси: подготовить маршрут, геокодировать адреса, сформировать deeplink и открыть приложение. Заказ, цена и назначение машины ждут партнерский `clid/apikey` от Яндекса;
 
 Backlog после первого контура:
 
-- `taxi` - Яндекс Go / Такси: только подготовить маршрут и открыть приложение, без заказа и оплаты;
 - `market` - Яндекс Маркет: поиск и список покупок, без корзины и оплаты;
 - `delivery` - Яндекс Доставка: подготовка заявки/ссылки, без оформления и оплаты.
 
@@ -107,6 +110,19 @@ iola cloud doctor
 
 Если включен `disk`, токен автоматически подключается и к старому облачному провайдеру `yandex-disk`, поэтому команды `iola cloud ...` продолжают работать.
 
+Yandex Cloud Connector подключается отдельно:
+
+```bash
+iola yandex cloud setup
+iola yandex cloud status
+iola yandex cloud enable geocoder yandexgpt
+iola yandex cloud disable yandexgpt
+```
+
+В `/yandex` для него есть отдельный пункт `Yandex Cloud Connector - геокодинг и YandexGPT`. Геокодер включается по умолчанию, потому что он нужен для geo-skills и deeplink Яндекс Go. YandexGPT можно включить там же или выбрать через `/model`.
+
+Если пользователь выбирает YandexGPT в `/model`, а Cloud Connector еще не подключен, CLI объясняет, что нужен Yandex Cloud Connector, и предлагает открыть настройку.
+
 ## Что значит включить сервис
 
 OAuth-права дают CLI разрешение обращаться к сервису Яндекса. Практическая работа идет через локальные tools:
@@ -186,6 +202,8 @@ QR-код:
 - `yandex_mail_meeting_pack` - собрать пакет по письму: сохранить письмо на Диск, создать ссылку/QR, поставить встречу в календарь и опционально отправить ссылку отправителю;
 - `yandex_telemost_status` - проверить режим Телемоста;
 - `yandex_telemost_create_event` - создать встречу: прямой Telemost API используется только если он доступен аккаунту; иначе создается календарное событие без выдуманной ссылки.
+- `yandex_cloud_status` - проверить Yandex Cloud Connector;
+- `yandex_go_deeplink` - построить deeplink маршрута Яндекс Go по адресам или координатам.
 
 Комбинированные сценарии:
 
@@ -193,6 +211,7 @@ QR-код:
 iola ask "по последнему письму создай встречу завтра в 14:00, сохрани письмо на диск и пришли отправителю ссылку"
 iola ask "собери полный пакет по контакту Петров: папка на диске, заметка, встреча завтра в 12 и ссылка с QR"
 iola ask "создай папку для школы 2 на яндекс диске и отправь ссылку контакту Иванов"
+iola ask "сделай ссылку Яндекс Go от Медведево, Школьная 15 до Медведево, Советская 20"
 ```
 
 CLI использует уже подключенные сервисы: Почту, Диск, Контакты и Календарь. Если не хватает email, найдено несколько контактов или неясна дата встречи, CLI должен уточнить, а не выбирать случайно.
@@ -257,10 +276,10 @@ docs/assets/iola-oauth-icon.png
 
 Yandex Connector не является универсальным ключом ко всему Яндексу.
 
-Обычные пользовательские сервисы работают через OAuth и scope. Yandex Cloud, YandexGPT и Geocoder требуют отдельные ключи, folder ID или настройки в Yandex Cloud.
+Обычные пользовательские сервисы работают через OAuth и scope. Yandex Cloud, YandexGPT и Geocoder подключаются через отдельный Yandex Cloud Connector.
 
 Для браузерного подключения в сборке CLI уже указан public OAuth `client_id` приложения IOLA. Это не секретный ключ. Пользователь не должен создавать OAuth-приложение вручную.
 
 Яндекс ограничивает количество разных групп сервисов в одном OAuth-приложении. Поэтому один токен не может покрыть Диск, Почту, Календарь и Контакты сразу. CLI использует две встроенные группы: `IOLA CLI A` и `IOLA CLI B`.
 
-CLI не должен автоматически оформлять покупки, вызывать такси, подтверждать доставку или выполнять платежи. Для таких сценариев допустима только подготовка ссылки, маршрута или списка, а финальное действие делает пользователь в приложении Яндекса.
+CLI не должен автоматически оформлять покупки, вызывать такси, подтверждать доставку или выполнять платежи. Для Яндекс Go сейчас допустимы только геокодирование адресов, подготовка deeplink маршрута и открытие приложения. Финальное действие делает пользователь в приложении Яндекса.

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

@@ -1,6 +1,12 @@
 # Yandex Geocoder API key
 
-Эта инструкция нужна для подключения геокодера Яндекса к `iola-cli`.
+Эта инструкция нужна для ручного подключения геокодера Яндекса к `iola-cli`.
+
+Рекомендуемый путь для обычного пользователя - через [Yandex Cloud Connector](Yandex-Cloud-Connector):
+
+```bash
+iola yandex cloud setup
+```
 
 Геокодер нужен жителям для вопросов вида:
 

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

@@ -29,6 +29,8 @@ iola data schools --format csv --output schools.csv
 Геокодер:
 
 ```bash
+iola yandex cloud setup
+iola yandex cloud status
 iola geo key set yandex
 iola geo key status
 iola geo key doctor
@@ -41,6 +43,14 @@ iola geo route-context "школа 7"
 iola geo services "Йошкар-Ола, улица Петрова, 15"
 ```
 
+Яндекс Go deeplink:
+
+```bash
+iola yandex go status
+iola yandex go link --from "Медведево, Школьная 15" --to "Медведево, Советская 20"
+iola yandex go open --from "Медведево, Школьная 15" --to "Медведево, Советская 20" --tariff econom
+```
+
 Облачные диски:
 
 ```bash
@@ -69,6 +79,10 @@ iola yandex status
 iola yandex doctor
 iola yandex enable disk mail calendar
 iola yandex disable mail
+iola yandex cloud setup
+iola yandex cloud enable geocoder yandexgpt
+iola yandex cloud delete
+iola yandex go link --from "Адрес" --to "Адрес"
 iola yandex oauth-url disk --client-id CLIENT_ID
 iola yandex token set
 iola yandex token delete

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

@@ -30,45 +30,39 @@ iola master
 
 После настройки локальную модель можно менять в интерактивном агенте через `/model`. Помимо штатной IOLA-модели можно выбрать установленную или рекомендуемую Ollama-модель, либо вручную ввести имя любой модели из библиотеки Ollama.
 
-### 4. YandexGPT API
-
-Настраивает профиль YandexGPT и сохраняет API key плюс folder ID локально у пользователя.
-
-Российский провайдер вызывается напрямую, без gateway/proxy.
-
-### 5. GigaChat API
+### 4. GigaChat API
 
 Настраивает профиль GigaChat и сохраняет authorization key локально у пользователя.
 
 Российский провайдер вызывается напрямую, без gateway/proxy.
 
-### 6. OpenAI API
+### 5. OpenAI API
 
 Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.
 
 После сохранения ключа мастер предлагает выбрать модель из доступного списка.
 
-### 7. OpenRouter API
+### 6. OpenRouter API
 
 Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.
 
 После сохранения ключа мастер предлагает выбрать разработчика моделей OpenRouter, а затем одну из свежих моделей для текстовой работы. В списке моделей `0` возвращает к выбору разработчика.
 
-### 8. Codex CLI
+### 7. Codex CLI
 
 Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.
 
-### 9. MCP для Codex
+### 8. MCP для Codex
 
 Добавляет MCP-сервер открытых данных Йошкар-Олы в Codex. Этот пункт можно запускать повторно для обновления подключения.
 
-### 10. 7-Zip / архивы
+### 9. 7-Zip / архивы
 
 Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.
 
 Нужен для чтения, распаковки, сборки и индексирования архивов.
 
-### 11. Индекс локальных документов
+### 10. Индекс локальных документов
 
 Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:
 
@@ -76,36 +70,17 @@ iola master
 iola index folder ./docs
 ```
 
-### 12. Browser runtime
+### 11. Browser runtime
 
 Проверяет Playwright/Chromium runtime. Нужен для браузерного агента.
 
-### 13. Ollama
+### 12. Ollama
 
 Опциональный локальный runtime для выбора сторонних моделей из библиотеки Ollama.
 
 Если runtime уже установлен, пункт показывается как `готово`.
 
-### 14. Yandex Geocoder API
-
-Сохраняет ключ Yandex Geocoder API локально у пользователя и проверяет его тестовым запросом.
-
-Нужен для будущих geo-skills: поиск объектов рядом с адресом, ссылки на карту, определение расстояний и уточнение населенного пункта.
-
-Инструкция по получению ключа: [Yandex Geocoder API key](Yandex-Geocoder-API-key).
-
-### 15. Облачный диск
-
-Подключает личный облачный диск пользователя:
-
-- Яндекс Диск;
-- Облако Mail.ru.
-
-Секреты сохраняются локально в `~/.iola/secrets.json`. Резервные копии CLI не включают OAuth-токены, пароли и API-ключи.
-
-Инструкция: [Облачные диски](Облачные-диски).
-
-### 16. Yandex Connector
+### 13. Yandex Connector
 
 Настраивает единый коннектор пользовательских сервисов Яндекса.
 
@@ -116,10 +91,20 @@ iola index folder ./docs
 
 Мастер не спрашивает список сервисов. Он подключает коннектор с максимальным набором OAuth-прав, а активные функции CLI выбираются позже командой `/yandex` в интерактивном CLI или `iola yandex menu` в терминале.
 
-В коннектор также заложены категории для проверки: Почта, Календарь, Контакты, Wiki, Tracker, Forms, Документы/360. Такси, Маркет и Доставка записаны в backlog только как подготовка ссылки, маршрута или списка без заказа и оплаты.
+В коннектор также заложены категории для проверки: Почта, Календарь, Контакты, Документы/360 и Телемост. Яндекс Go deeplink работает через Yandex Cloud Connector и геокодер; заказ такси, Маркет и Доставка остаются без оформления заказа и оплаты.
 
 Инструкция: [Yandex Connector](Yandex-Connector).
 
+### 14. Yandex Cloud Connector
+
+Настраивает Yandex Cloud Connector: геокодер и, при необходимости, YandexGPT.
+
+Геокодер включается по умолчанию. Он нужен для geo-skills и deeplink Яндекс Go. YandexGPT можно включить сразу или выбрать позже через `/model`.
+
+Ключи сохраняются локально у пользователя. Российский AI-провайдер вызывается напрямую, без gateway/proxy.
+
+Инструкция: [Yandex Cloud Connector](Yandex-Cloud-Connector).
+
 ## Повторный запуск
 
 Если компонент уже настроен, его можно не выбирать. Если нужно переустановить или обновить компонент, выберите его номер вручную.

package/wiki//320/240/320/265/321/210/320/265/320/275/320/270/320/265-/320/277/321/200/320/276/320/261/320/273/320/265/320/274.md

@@ -28,7 +28,7 @@ iola ai doctor
 
 ```bash
 iola ai key status
-iola ai key set yandexgpt
+iola yandex cloud setup
 iola ai key set gigachat
 iola ai key set openai
 iola ai key set openrouter
@@ -41,7 +41,7 @@ iola ai key set openrouter
 - OpenAI Platform: `https://platform.openai.com/api-keys`
 - OpenRouter: `https://openrouter.ai/settings/keys`
 
-Для YandexGPT нужен не только API key, но и folder ID каталога Yandex Cloud. Для GigaChat нужен authorization key; CLI сам получает OAuth-токен перед запросом.
+Для YandexGPT нужен не только API key, но и folder ID каталога Yandex Cloud. Рекомендуемый путь - `iola yandex cloud setup`, там же подключается ключ геокодера для geo-skills и Яндекс Go deeplink. Для GigaChat нужен authorization key; CLI сам получает OAuth-токен перед запросом.
 
 Важно: оплата российскими банковскими картами для OpenAI Platform и OpenRouter может быть невозможна. Если API-запросы не проходят после сохранения ключа, проверьте не только ключ, но и billing/баланс в личном кабинете сервиса.
 

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

@@ -378,20 +378,35 @@ CLI не должен сам нажимать финальные кнопки в
 - `iola yandex contacts-maintenance on --days 7 --backup`;
 - `iola yandex disk-maintenance on --days 7`.
 
-## Yandex Connector backlog
+## Yandex Go deeplink
 
-Эти сценарии зафиксированы для следующего этапа. Они не должны оформлять заказ, списывать деньги или нажимать финальную кнопку вместо пользователя.
+Эти сценарии не оформляют заказ, не списывают деньги и не нажимают финальную кнопку вместо пользователя.
 
 ### taxi-prepare-ride
 
 Подготовить поездку в Яндекс Go:
 
 - уточнить точку отправления и назначения;
-- геокодировать адреса;
+- геокодировать адреса через Yandex Cloud Connector;
 - сформировать ссылку/deep link в Яндекс Go;
 - открыть приложение или страницу;
 - пользователь сам проверяет цену и нажимает заказ.
 
+Команды:
+
+```bash
+iola yandex go link --from "Медведево, Школьная 15" --to "Медведево, Советская 20"
+iola yandex go open --from "Медведево, Школьная 15" --to "Медведево, Советская 20" --tariff econom
+```
+
+Если ключ геокодера не подключен, CLI должен объяснить, что нужно открыть `/master` и выбрать `Yandex Cloud Connector (геокодинг и YandexGPT)`, либо запустить `iola yandex cloud setup`.
+
+Цена, повышенный спрос, детское кресло, назначение машины и отмена поездки через API ждут партнерский `clid/apikey` от Яндекса.
+
+## Yandex Connector backlog
+
+Эти сценарии зафиксированы для следующего этапа. Они не должны оформлять заказ, списывать деньги или нажимать финальную кнопку вместо пользователя.
+
 ### market-prepare-cart
 
 Подготовить список покупок для Яндекс Маркета: