@iola_adm/iola-cli 0.2.7 → 0.2.8

package/package.json

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

package/src/cli.js

@@ -3159,19 +3159,31 @@ async function yandexDiskList(remotePath, options = {}) {
 }
 
 async function yandexDiskFind(query, options = {}) {
-  const payload = await yandexDiskRequest("GET", "/resources/files", { query: { limit: Math.max(100, Number(options.limit || 50) * 5), fields: "items.name,items.path,items.size,items.type" } });
   const needle = normalizeGeoText(query);
-  return (payload.items || [])
-    .map((item) => ({
-      type: item.type === "dir" ? "dir" : "file",
-      name: item.name || path.basename(item.path || ""),
-      path: denormalizeYandexDiskPath(item.path || ""),
-      size: item.size || "-",
-    }))
+  const rows = await yandexDiskListRecursive(options.path || CLOUD_DEFAULT_REMOTE_DIR, { depth: Number(options.depth || 4), limit: Math.max(100, Number(options.limit || 50) * 5) });
+  return rows
     .filter((item) => normalizeGeoText(`${item.name} ${item.path}`).includes(needle))
     .slice(0, Number(options.limit || 50));
 }
 
+async function yandexDiskListRecursive(remotePath, options = {}) {
+  const depth = Number(options.depth || 4);
+  const limit = Number(options.limit || 200);
+  const rows = [];
+  await yandexDiskWalk(remotePath, rows, depth, limit);
+  return rows;
+}
+
+async function yandexDiskWalk(remotePath, rows, depth, limit) {
+  if (rows.length >= limit || depth < 0) return;
+  const items = await yandexDiskList(remotePath).catch(() => []);
+  for (const item of items) {
+    if (rows.length >= limit) break;
+    rows.push(item);
+    if (item.type === "dir") await yandexDiskWalk(item.path, rows, depth - 1, limit);
+  }
+}
+
 async function yandexDiskUpload(localPath, remotePath, options = {}) {
   const resolved = path.resolve(localPath);
   const info = await stat(resolved);

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

@@ -36,20 +36,60 @@ iola cloud backup
 - получение OAuth-токена: `https://yandex.ru/dev/id/doc/ru/access`
 - получение токена вручную для проверки: `https://yandex.ru/dev/id/doc/ru/tokens/debug-token`
 
-Что сделать:
+### Получение OAuth-токена Яндекс Диска
 
 1. Откройте страницу Яндекс OAuth: `https://oauth.yandex.ru/`.
-2. Создайте приложение для личного использования.
-3. В правах приложения выберите доступ к Яндекс Диску.
-4. Получите OAuth-токен.
-5. В CLI выполните:
+2. Если Яндекс просит пройти верификацию через Госуслуги, пройдите ее. Без этого создание OAuth-приложения может быть недоступно.
+3. Нажмите `Создать`.
+4. В окне `Какое приложение хотите создать?` выберите `Для авторизации пользователей`.
+5. Нажмите `Перейти к созданию`.
+6. На шаге `Создание приложения` заполните:
+   - `Название вашего сервиса`: например `iola-cli`;
+   - `Иконка сервиса`: загрузите любую простую PNG-иконку до 1 МБ;
+   - `Почта для связи`: оставьте свою почту или укажите актуальную.
+7. Нажмите `Продолжить`.
+8. На шаге `Платформы приложений` выберите `Веб-сервисы`.
+9. В поле `Redirect URI` укажите:
+
+```text
+https://oauth.yandex.ru/verification_code
+```
+
+10. Нажмите кнопку добавления рядом с `Redirect URI`, если интерфейс показывает такую кнопку.
+11. В поле `Suggest Hostname`, если оно обязательно, укажите сайт проекта или любой понятный URL сервиса, например:
+
+```text
+https://github.com
+```
+
+12. Нажмите `Продолжить`.
+13. На шаге `Права доступа к данным пользователей` не выбирайте лишние основные права: телефон, почта, дата рождения, профиль не нужны.
+14. В блоке `Дополнительные` через поле `Название доступа` добавьте три права:
+   - `Чтение всего Диска` / `cloud_api:disk.read`;
+   - `Запись в любом месте на Диске` / `cloud_api:disk.write`;
+   - `Доступ к информации о Диске` / `cloud_api:disk.info`.
+15. Нажмите `Продолжить`.
+16. На финальном экране проверьте, что приложение запрашивает только три права Диска.
+17. Нажмите `Всё верно, создать приложение`.
+18. На странице созданного приложения скопируйте `ClientID`.
+19. Откройте ссылку, заменив `CLIENT_ID` на ваш `ClientID`:
+
+```text
+https://oauth.yandex.ru/authorize?response_type=token&client_id=CLIENT_ID
+```
+
+20. На экране авторизации нажмите `Войти как ...`.
+21. Если Яндекс показывает предупреждение `Сервис ещё не верифицирован`, это нормально для личного приложения. Продолжайте только если приложение создавали вы сами и доверяете ему.
+22. Яндекс перенаправит на страницу `verification_code`, где будет показан OAuth-токен. В адресной строке он также находится после `access_token=`.
+23. Скопируйте OAuth-токен.
+24. В CLI выполните:
 
 ```bash
 iola cloud setup yandex-disk
 ```
 
-6. Вставьте OAuth-токен.
-7. Проверьте подключение:
+25. Вставьте OAuth-токен.
+26. Проверьте подключение:
 
 ```bash
 iola cloud doctor
@@ -57,6 +97,10 @@ iola cloud doctor
 
 Секрет сохраняется локально в `~/.iola/secrets.json`.
 
+После успешной проверки CLI создаст или использует папку `/IOLA` на Яндекс Диске.
+
+Обычно такой токен выдается на длительный срок. Если доступ перестал работать, получите новый токен через ту же ссылку авторизации и повторите `iola cloud setup yandex-disk`.
+
 ## Облако Mail.ru
 
 Облако Mail.ru подключается через WebDAV.