@iola_adm/iola-cli 0.2.38 → 0.2.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.2.38",
+  "version": "0.2.39",
   "description": "CLI и AI-агент городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",

package/src/cli.js

@@ -3575,6 +3575,7 @@ async function handleYandexCloudConnector(args = []) {
   }
 
   if (action === "open") {
+    printYandexCloudSetupGuide({ includeYandexGpt: true });
     await openUrl("https://console.yandex.cloud/");
     return;
   }
@@ -3585,9 +3586,13 @@ async function handleYandexCloudConnector(args = []) {
 async function setupYandexCloudConnector(options = {}) {
   console.log("Yandex Cloud Connector: геокодинг и YandexGPT.");
   console.log("Геокодер будет включен по умолчанию. YandexGPT можно выбрать в /model после сохранения ключей.");
+  printYandexCloudSetupGuide({ includeYandexGpt: true });
   if (process.stdin.isTTY) {
     const openConsole = await askYesNo("Открыть Yandex Cloud Console для получения ключей? [Y/n] ", true);
-    if (openConsole) await openUrl("https://console.yandex.cloud/");
+    if (openConsole) {
+      console.log("Открыл Yandex Cloud Console. Вернитесь сюда после создания ключей и вставьте их в CLI.");
+      await openUrl("https://console.yandex.cloud/");
+    }
   }
 
   const secrets = await loadSecrets();
@@ -3601,6 +3606,8 @@ async function setupYandexCloudConnector(options = {}) {
     return;
   }
 
+  console.log("");
+  console.log("Вставьте ключ API Геокодера. Если ключ еще создается, оставьте мастер открытым, получите ключ в браузере и вернитесь сюда.");
   const geocoderKey = (await askText(`YANDEX_GEOCODER_API_KEY${currentGeocoder ? " [уже сохранен, Enter - оставить]" : ""}: `)).trim() || currentGeocoder;
   if (!geocoderKey) throw new Error("Для Cloud Connector нужен хотя бы Geocoder API key.");
 
@@ -3619,6 +3626,22 @@ async function setupYandexCloudConnector(options = {}) {
   await printYandexCloudConnectorStatus({ check: true });
 }
 
+function printYandexCloudSetupGuide(options = {}) {
+  console.log("");
+  console.log("Что делать в открывшейся консоли Яндекса:");
+  console.log("1. Войдите в свой Яндекс-аккаунт.");
+  console.log("2. Если Яндекс попросит создать облако или каталог, создайте их. Названия можно оставить простыми: iola-cli и default.");
+  console.log("3. Для геокодера откройте Кабинет разработчика: https://developer.tech.yandex.ru/services/2");
+  console.log("4. Выберите API Геокодера, создайте API key и скопируйте значение ключа.");
+  console.log("5. Вернитесь в это окно CLI и вставьте ключ в поле YANDEX_GEOCODER_API_KEY.");
+  if (options.includeYandexGpt) {
+    console.log("6. Если нужен YandexGPT: в Yandex Cloud откройте каталог, скопируйте ID каталога, затем создайте сервисный аккаунт и API-ключ с правом yc.ai.foundationModels.execute.");
+    console.log("7. После ключа геокодера CLI отдельно спросит, настраивать ли YandexGPT. Можно ответить n и подключить модель позже через /model.");
+  }
+  console.log("Подробная инструкция: https://github.com/adm-iola/iola-cli/wiki/Yandex-Cloud-Connector");
+  console.log("");
+}
+
 async function saveYandexCloudConnectorSecrets({ geocoderApiKey, yandexgptApiKey, folderId }) {
   const secrets = await loadSecrets();
   secrets.yandexCloud = {

package/wiki/Yandex-Cloud-Connector.md

@@ -21,7 +21,19 @@ iola master
 14. Yandex Cloud Connector - геокодинг и YandexGPT
 ```
 
-CLI откроет консоль Yandex Cloud и попросит сохранить:
+CLI не просто открывает консоль. Он печатает короткую инструкцию, что делать дальше, и только потом просит вставить ключи.
+
+Что делает пользователь:
+
+1. Входит в свой Яндекс-аккаунт.
+2. Если Яндекс просит создать облако или каталог, создает их. Названия можно оставить простыми: `iola-cli` и `default`.
+3. Для геокодера открывает Кабинет разработчика: `https://developer.tech.yandex.ru/services/2`.
+4. Выбирает `API Геокодера`, создает API key и копирует значение ключа.
+5. Возвращается в окно CLI и вставляет ключ в поле `YANDEX_GEOCODER_API_KEY`.
+6. Если нужен YandexGPT, в Yandex Cloud копирует ID каталога, создает сервисный аккаунт и API-ключ с правом `yc.ai.foundationModels.execute`.
+7. Если YandexGPT пока не нужен, на вопрос CLI можно ответить `n` и подключить модель позже через `/model`.
+
+CLI попросит сохранить:
 
 - ключ `YANDEX_GEOCODER_API_KEY`;
 - при необходимости YandexGPT API key;

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

@@ -101,6 +101,8 @@ iola index folder ./docs
 
 Геокодер включается по умолчанию. Он нужен для geo-skills и deeplink Яндекс Go. YandexGPT можно включить сразу или выбрать позже через `/model`.
 
+При запуске CLI печатает пошаговую инструкцию: войти в Яндекс, создать облако/каталог при необходимости, открыть Кабинет разработчика геокодера, создать API key, вернуться в CLI и вставить ключ. Пользователь не остается один на пустой странице консоли.
+
 Ключи сохраняются локально у пользователя. Российский AI-провайдер вызывается напрямую, без gateway/proxy.
 
 Инструкция: [Yandex Cloud Connector](Yandex-Cloud-Connector).