@iola_adm/iola-cli 0.2.6 → 0.2.8

package/README.md

@@ -173,6 +173,20 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 Инструкция по получению ключа: [Yandex Geocoder API key](https://github.com/adm-iola/iola-cli/wiki/Yandex-Geocoder-API-key).
 Список сценариев: [Скиллы для жителей](https://github.com/adm-iola/iola-cli/wiki/Скиллы-для-жителей).
 
+Облачные диски для личных документов:
+
+```bash
+iola cloud setup yandex-disk
+iola cloud setup mailru-cloud
+iola cloud status
+iola cloud find "справка" --path /IOLA
+iola cloud upload report.md /IOLA/reports/report.md
+iola cloud share /IOLA/reports/report.md
+iola cloud backup
+```
+
+Инструкция: [Облачные диски](https://github.com/adm-iola/iola-cli/wiki/Облачные-диски).
+
 Зарубежные API-ключи:
 
 - OpenAI Platform: регистрация `https://platform.openai.com/`, ключи `https://platform.openai.com/api-keys`;
@@ -200,6 +214,7 @@ iola version --check
 - [Мастер настройки](https://github.com/adm-iola/iola-cli/wiki/Мастер-настройки)
 - [AI-профили](https://github.com/adm-iola/iola-cli/wiki/AI-профили)
 - [Yandex Geocoder API key](https://github.com/adm-iola/iola-cli/wiki/Yandex-Geocoder-API-key)
+- [Облачные диски](https://github.com/adm-iola/iola-cli/wiki/Облачные-диски)
 - [Скиллы для жителей](https://github.com/adm-iola/iola-cli/wiki/Скиллы-для-жителей)
 - [Локальный инструментальный агент](https://github.com/adm-iola/iola-cli/wiki/Локальный-инструментальный-агент)
 - [Skills и toolsets](https://github.com/adm-iola/iola-cli/wiki/Skills-и-toolsets)
@@ -222,6 +237,7 @@ iola version --check
 - AI-профили для IOLA local, Ollama, YandexGPT, GigaChat, OpenAI, OpenRouter и Codex CLI;
 - локальный tool-agent для модели IOLA с tools `search_data`, `search_entities`, `resolve_entity_field`, `get_card`, `export_report`, `file_read`, `browser_open`;
 - ленивые skills, toolsets, permissions, memory, hooks и готовые agents;
+- личные облачные диски: Яндекс Диск и Облако Mail.ru для сохранения отчетов, backup и документов;
 - subagents, skill bundles, layered settings, usage/budget accounting и trajectory export;
 - локальный MCP-сервер по stdio/http для подключения iola-cli к другим AI-клиентам;
 - ответы по открытым данным берутся из публичного MCP `https://apiiola.yasg.ru/mcp`;

package/package.json

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

package/skills/personal-docs/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: personal-docs
+description: Личные документы пользователя в облаке: поиск, сохранение, ссылки, пакеты документов и резервные копии.
+---
+
+Используй этот skill, когда пользователь явно говорит про облако, Яндекс Диск, Облако Mail.ru, ссылку на файл, сохранить в облако, загрузить на диск, поделиться документом или личный архив документов.
+
+Не включай cloud-сценарий только по словам "файл", "папка" или "документ". Для обычной работы с файлами на ПК используй `local-files`.
+
+Если непонятно, где искать документ, спроси: "Где искать: на компьютере или в облаке?"
+
+Основные сценарии:
+
+- `cloud-find-document` - найти документ в подключенном облаке.
+- `cloud-save-result` - сохранить ответ, отчет, карточку или список в облако.
+- `cloud-share-link` - создать публичную ссылку на файл в Яндекс Диске.
+- `cloud-document-pack` - собрать папку с материалами для обращения.
+- `cloud-inbox` - проверить входящую папку `/IOLA/inbox`.
+- `cloud-backup-cli` - сохранить резервную копию CLI без секретов.
+- `cloud-restore-cli` - восстановить данные CLI из резервной копии.
+- `cloud-organize` - помочь разобрать личные документы и дубликаты.
+
+Безопасность:
+
+- Не выгружай API-ключи, OAuth-токены и пароли в облако.
+- Перед удалением, перемещением или публикацией файла требуй подтверждение.
+- Если провайдер не поддерживает публичные ссылки через CLI, честно скажи об ограничении.

package/src/cli.js

@@ -39,6 +39,7 @@ const PROJECT_CONFIG_FILE = path.join(PROJECT_IOLA_DIR, "config.json");
 const LOCAL_CONFIG_FILE = path.join(PROJECT_IOLA_DIR, "local.json");
 const BROWSER_RUNTIME_DIR = path.join(CONFIG_DIR, "browser-runtime");
 const BROWSER_RUNTIME_PACKAGE = path.join(BROWSER_RUNTIME_DIR, "node_modules", "playwright", "package.json");
+const CLOUD_DEFAULT_REMOTE_DIR = "/IOLA";
 const INDEXABLE_EXTENSIONS = /\.(md|txt|csv|json|html|docx|xlsx|pptx|pdf)$/i;
 const LOCAL_TOOLS = ["search_data", "search_entities", "resolve_entity_field", "get_card", "export_report", "file_read", "browser_open", "get_current_date"];
 const LEGACY_LOCAL_TOOLS = ["search_local", "export_data", "run_report", "save_view"];
@@ -228,7 +229,14 @@ const DEFAULT_AI_CONFIG = {
     suggestions: true,
   },
   skills: {
-    enabled: ["education", "open-data", "geo", "reports", "local-model", "local-files", "browser-agent"],
+    enabled: ["education", "open-data", "geo", "personal-docs", "reports", "local-model", "local-files", "browser-agent"],
+  },
+  cloud: {
+    activeProvider: "",
+    providers: {
+      "yandex-disk": { root: CLOUD_DEFAULT_REMOTE_DIR },
+      "mailru-cloud": { root: CLOUD_DEFAULT_REMOTE_DIR },
+    },
   },
   daemon: {
     host: "127.0.0.1",
@@ -314,6 +322,7 @@ const SLASH_COMMANDS = [
   { command: "/permissions", description: "разрешения" },
   { command: "/tools", description: "tools и toolsets" },
   { command: "/files status", description: "локальные файловые операции" },
+  { command: "/cloud status", description: "облачные диски" },
   { command: "/archive doctor", description: "архиватор" },
   { command: "/changes list", description: "подготовленные изменения" },
   { command: "/index status", description: "индекс документов" },
@@ -389,6 +398,7 @@ const COMMANDS = new Map([
   ["skills", handleSkills],
   ["tools", handleTools],
   ["files", handleFiles],
+  ["cloud", handleCloud],
   ["archive", handleArchive],
   ["changes", handleChanges],
   ["import", handleImport],
@@ -537,6 +547,7 @@ async function showHelp() {
   iola agent                   интерактивный режим
   iola ai setup                настройка AI-профиля
   iola browser status          браузерный runtime
+  iola cloud status            облачные диски
   iola mcp status              MCP-подключение
   iola doctor                  диагностика
   iola wiki                    документация
@@ -576,6 +587,7 @@ Usage:
   iola skills list|show|paths|enable|disable|bundles|bundle|doctor
   iola tools list|toolsets|enable|disable|profile
   iola files status|mode|approvals|tree|read|search|write|patch
+  iola cloud setup|status|ls|find|upload|download|share|save|backup
   iola archive doctor|list|test|extract|create|index
   iola changes list|show|apply|discard
   iola import file|folder
@@ -2879,6 +2891,479 @@ async function handleFiles(args) {
   throw new Error("Команды files: status, mode MODE, approvals POLICY, tree [PATH], read FILE, search TEXT, write FILE --text TEXT, patch FILE --search OLD --replace NEW.");
 }
 
+async function handleCloud(args) {
+  const [action = "status", target, maybeRemote, ...rest] = args;
+  const options = parseOptions(rest);
+
+  if (action === "setup") {
+    await setupCloudProvider(target, options);
+    return;
+  }
+
+  if (action === "use") {
+    const provider = normalizeCloudProvider(target);
+    await requireCloudCredentials(provider);
+    const config = await loadConfig();
+    await saveConfig({ cloud: { ...(config.cloud || {}), activeProvider: provider } });
+    console.log(`Активный облачный диск: ${provider}`);
+    return;
+  }
+
+  if (action === "status") {
+    await printCloudStatus({ check: Boolean(options.check) });
+    return;
+  }
+
+  if (action === "doctor") {
+    await printCloudStatus({ check: true });
+    return;
+  }
+
+  if (action === "delete") {
+    const provider = normalizeCloudProvider(target);
+    const secrets = await loadSecrets();
+    delete secrets.cloud?.[provider];
+    if (secrets.cloud && Object.keys(secrets.cloud).length === 0) delete secrets.cloud;
+    await saveSecrets(secrets);
+    const config = await loadConfig();
+    if (config.cloud?.activeProvider === provider) {
+      await saveConfig({ cloud: { ...(config.cloud || {}), activeProvider: "" } });
+    }
+    console.log(`Локальные секреты облака удалены: ${provider}`);
+    return;
+  }
+
+  if (action === "ls" || action === "list") {
+    const provider = await getCloudProvider(options.provider);
+    const rows = await cloudList(provider, target || cloudRootForProvider(provider));
+    printTable(rows, [["type", "Тип"], ["name", "Имя"], ["path", "Путь"], ["size", "Размер"]]);
+    return;
+  }
+
+  if (action === "find" || action === "search") {
+    if (!target) throw new Error('Пример: iola cloud find "справка" --path /IOLA');
+    const provider = await getCloudProvider(options.provider);
+    const rows = await cloudFind(provider, target, { path: options.path || cloudRootForProvider(provider), limit: Number(options.limit || 50) });
+    printTable(rows, [["type", "Тип"], ["name", "Имя"], ["path", "Путь"], ["size", "Размер"]]);
+    return;
+  }
+
+  if (action === "upload") {
+    if (!target) throw new Error('Пример: iola cloud upload report.md /IOLA/reports/report.md');
+    const provider = await getCloudProvider(options.provider);
+    const remotePath = maybeRemote || `${cloudRootForProvider(provider)}/${path.basename(target)}`;
+    const result = await cloudUpload(provider, target, remotePath, { overwrite: options.overwrite !== false });
+    printKeyValue(result);
+    return;
+  }
+
+  if (action === "download") {
+    if (!target) throw new Error('Пример: iola cloud download /IOLA/report.md ./report.md');
+    const provider = await getCloudProvider(options.provider);
+    const outputPath = maybeRemote || path.basename(target);
+    const result = await cloudDownload(provider, target, outputPath);
+    printKeyValue(result);
+    return;
+  }
+
+  if (action === "share") {
+    if (!target) throw new Error('Пример: iola cloud share /IOLA/report.md');
+    const provider = await getCloudProvider(options.provider);
+    const result = await cloudShare(provider, target);
+    printKeyValue(result);
+    return;
+  }
+
+  if (action === "save") {
+    const provider = await getCloudProvider(options.provider);
+    const text = options.text ?? [target, maybeRemote, ...rest].filter(Boolean).join(" ");
+    if (!text) throw new Error('Пример: iola cloud save --text "Текст" --path /IOLA/notes/note.txt');
+    const remotePath = options.path || `${cloudRootForProvider(provider)}/notes/iola-${timestampForFile()}.txt`;
+    const tempPath = path.join(CONFIG_DIR, `cloud-save-${Date.now()}.txt`);
+    await mkdir(CONFIG_DIR, { recursive: true });
+    await writeFile(tempPath, text, "utf8");
+    try {
+      const result = await cloudUpload(provider, tempPath, remotePath, { overwrite: true });
+      printKeyValue(result);
+    } finally {
+      await rm(tempPath, { force: true }).catch(() => {});
+    }
+    return;
+  }
+
+  if (action === "backup") {
+    const provider = await getCloudProvider(options.provider);
+    const result = await cloudBackup(provider);
+    printKeyValue(result);
+    return;
+  }
+
+  throw new Error(`Команды cloud:
+  iola cloud setup yandex-disk
+  iola cloud setup mailru-cloud
+  iola cloud status|doctor
+  iola cloud use yandex-disk
+  iola cloud ls /IOLA
+  iola cloud find "справка" --path /IOLA
+  iola cloud upload local.txt /IOLA/local.txt
+  iola cloud download /IOLA/local.txt ./local.txt
+  iola cloud share /IOLA/local.txt
+  iola cloud save --text "Текст" --path /IOLA/notes/note.txt
+  iola cloud backup`);
+}
+
+async function setupCloudProvider(providerValue, options = {}) {
+  const provider = normalizeCloudProvider(providerValue);
+  if (!process.stdin.isTTY) throw new Error("Для настройки облака запустите команду в интерактивном терминале.");
+  const secrets = await loadSecrets();
+  secrets.cloud = secrets.cloud || {};
+
+  if (provider === "yandex-disk") {
+    console.log("Яндекс Диск использует OAuth-токен пользователя с доступом к Диску.");
+    console.log("Инструкция: https://github.com/adm-iola/iola-cli/wiki/Облачные-диски");
+    const token = (await askText("Введите OAuth-токен Яндекс Диска: ")).trim();
+    if (!token) throw new Error("Токен пустой, сохранение отменено.");
+    secrets.cloud[provider] = { token };
+  } else if (provider === "mailru-cloud") {
+    console.log("Облако Mail.ru подключается через WebDAV и пароль внешнего приложения.");
+    console.log("Инструкция: https://github.com/adm-iola/iola-cli/wiki/Облачные-диски");
+    const username = (await askText("Введите email Mail.ru: ")).trim();
+    const password = (await askText("Введите пароль внешнего приложения/WebDAV: ")).trim();
+    if (!username || !password) throw new Error("Email или пароль пустой, сохранение отменено.");
+    secrets.cloud[provider] = { username, password, baseUrl: options.baseUrl || "https://webdav.cloud.mail.ru" };
+  }
+
+  await saveSecrets(secrets);
+  const config = await loadConfig();
+  await saveConfig({ cloud: { ...(config.cloud || {}), activeProvider: provider } });
+  console.log(`Облачный диск сохранен и выбран: ${provider}`);
+  await printCloudStatus({ check: true });
+}
+
+async function printCloudStatus(options = {}) {
+  const config = await loadConfig();
+  const secrets = await loadSecrets();
+  const rows = ["yandex-disk", "mailru-cloud"].map((provider) => ({
+    provider,
+    active: config.cloud?.activeProvider === provider ? "yes" : "no",
+    configured: secrets.cloud?.[provider] ? "yes" : "no",
+    root: cloudRootForProvider(provider, config),
+  }));
+  printTable(rows, [["provider", "Провайдер"], ["active", "Активен"], ["configured", "Настроен"], ["root", "Папка"]]);
+  if (options.check) {
+    for (const row of rows.filter((item) => item.configured === "yes")) {
+      try {
+        const listed = await cloudList(row.provider, cloudRootForProvider(row.provider), { allowMissingRoot: true });
+        console.log(`${row.provider}: ok (${listed.length} объектов в корневой папке IOLA или папка доступна)`);
+      } catch (error) {
+        console.log(`${row.provider}: error - ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }
+  }
+}
+
+function normalizeCloudProvider(value) {
+  const text = String(value || "").toLocaleLowerCase("ru-RU").trim();
+  if (!text || text === "yandex" || text === "yandex-disk" || text === "яндекс" || text === "яндекс-диск") return "yandex-disk";
+  if (text === "mailru" || text === "mailru-cloud" || text === "mail" || text === "mail.ru" || text === "облако-mail") return "mailru-cloud";
+  throw new Error("Поддерживаются облака: yandex-disk, mailru-cloud.");
+}
+
+async function getCloudProvider(value) {
+  if (value) return normalizeCloudProvider(value);
+  const config = await loadConfig();
+  const provider = normalizeCloudProvider(config.cloud?.activeProvider || "yandex-disk");
+  await requireCloudCredentials(provider);
+  return provider;
+}
+
+async function requireCloudCredentials(provider) {
+  const secrets = await loadSecrets();
+  const credentials = secrets.cloud?.[provider];
+  if (!credentials) throw new Error(`Облачный диск не настроен: ${provider}. Запустите: iola cloud setup ${provider}`);
+  return credentials;
+}
+
+function cloudRootForProvider(provider, config = null) {
+  const loaded = config || readConfigLayerSync(CONFIG_FILE) || {};
+  return loaded.cloud?.providers?.[provider]?.root || DEFAULT_AI_CONFIG.cloud.providers[provider]?.root || CLOUD_DEFAULT_REMOTE_DIR;
+}
+
+async function cloudList(provider, remotePath, options = {}) {
+  if (provider === "yandex-disk") return yandexDiskList(remotePath, options);
+  if (provider === "mailru-cloud") return mailruCloudList(remotePath, options);
+  throw new Error(`Провайдер не поддерживается: ${provider}`);
+}
+
+async function cloudUpload(provider, localPath, remotePath, options = {}) {
+  if (provider === "yandex-disk") return yandexDiskUpload(localPath, remotePath, options);
+  if (provider === "mailru-cloud") return mailruCloudUpload(localPath, remotePath, options);
+  throw new Error(`Провайдер не поддерживается: ${provider}`);
+}
+
+async function cloudDownload(provider, remotePath, outputPath) {
+  if (provider === "yandex-disk") return yandexDiskDownload(remotePath, outputPath);
+  if (provider === "mailru-cloud") return mailruCloudDownload(remotePath, outputPath);
+  throw new Error(`Провайдер не поддерживается: ${provider}`);
+}
+
+async function cloudFind(provider, query, options = {}) {
+  if (provider === "yandex-disk") return yandexDiskFind(query, options);
+  if (provider === "mailru-cloud") {
+    const rows = await mailruCloudList(options.path || CLOUD_DEFAULT_REMOTE_DIR);
+    return rows.filter((row) => normalizeGeoText(`${row.name} ${row.path}`).includes(normalizeGeoText(query))).slice(0, Number(options.limit || 50));
+  }
+  throw new Error(`Провайдер не поддерживается: ${provider}`);
+}
+
+async function cloudShare(provider, remotePath) {
+  if (provider === "yandex-disk") return yandexDiskShare(remotePath);
+  throw new Error("Публичные ссылки через CLI сейчас поддерживаются только для Яндекс Диска.");
+}
+
+async function yandexDiskRequest(method, apiPath, options = {}) {
+  const credentials = await requireCloudCredentials("yandex-disk");
+  const url = new URL(`https://cloud-api.yandex.net/v1/disk${apiPath}`);
+  for (const [key, value] of Object.entries(options.query || {})) {
+    if (value !== undefined && value !== "") url.searchParams.set(key, String(value));
+  }
+  const response = await fetch(url, {
+    method,
+    headers: {
+      Authorization: `OAuth ${credentials.token}`,
+      ...(options.headers || {}),
+    },
+    body: options.body,
+    signal: AbortSignal.timeout(Number(options.timeout || 30000)),
+  });
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`Yandex Disk request failed: ${response.status} ${response.statusText}\n${sanitizeSecretFromText(text, credentials.token)}`);
+  }
+  if (response.status === 204) return {};
+  const text = await response.text();
+  if (!text.trim()) return {};
+  return JSON.parse(text);
+}
+
+async function yandexDiskList(remotePath, options = {}) {
+  await ensureYandexDiskDir(remotePath, { allowExisting: true, allowMissingRoot: Boolean(options.allowMissingRoot) });
+  const payload = await yandexDiskRequest("GET", "/resources", { query: { path: normalizeYandexDiskPath(remotePath), limit: 100 } });
+  const items = payload._embedded?.items || [];
+  return items.map((item) => ({
+    type: item.type === "dir" ? "dir" : "file",
+    name: item.name || path.basename(item.path || ""),
+    path: denormalizeYandexDiskPath(item.path || ""),
+    size: item.size || "-",
+  }));
+}
+
+async function yandexDiskFind(query, options = {}) {
+  const needle = normalizeGeoText(query);
+  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);
+  if (!info.isFile()) throw new Error(`Это не файл: ${localPath}`);
+  await ensureYandexDiskDir(path.dirname(remotePath), { allowExisting: true });
+  const upload = await yandexDiskRequest("GET", "/resources/upload", { query: { path: normalizeYandexDiskPath(remotePath), overwrite: options.overwrite !== false } });
+  const bytes = await readFile(resolved);
+  const response = await fetch(upload.href, { method: upload.method || "PUT", body: bytes, signal: AbortSignal.timeout(120000) });
+  if (!response.ok) throw new Error(`Yandex Disk upload failed: ${response.status} ${response.statusText}`);
+  return { provider: "yandex-disk", local: resolved, remote: remotePath, size: info.size };
+}
+
+async function yandexDiskDownload(remotePath, outputPath) {
+  const download = await yandexDiskRequest("GET", "/resources/download", { query: { path: normalizeYandexDiskPath(remotePath) } });
+  const response = await fetch(download.href, { signal: AbortSignal.timeout(120000) });
+  if (!response.ok) throw new Error(`Yandex Disk download failed: ${response.status} ${response.statusText}`);
+  const buffer = Buffer.from(await response.arrayBuffer());
+  const resolved = path.resolve(outputPath);
+  await mkdir(path.dirname(resolved), { recursive: true });
+  await writeFile(resolved, buffer);
+  return { provider: "yandex-disk", remote: remotePath, local: resolved, size: buffer.length };
+}
+
+async function yandexDiskShare(remotePath) {
+  await yandexDiskRequest("PUT", "/resources/publish", { query: { path: normalizeYandexDiskPath(remotePath) } });
+  const payload = await yandexDiskRequest("GET", "/resources", { query: { path: normalizeYandexDiskPath(remotePath), fields: "name,path,public_url" } });
+  return { provider: "yandex-disk", remote: remotePath, publicUrl: payload.public_url || "-" };
+}
+
+async function ensureYandexDiskDir(remotePath, options = {}) {
+  const normalized = normalizeYandexDiskPath(remotePath || CLOUD_DEFAULT_REMOTE_DIR);
+  const plain = denormalizeYandexDiskPath(normalized);
+  const parts = plain.split("/").filter(Boolean);
+  let current = "";
+  for (const part of parts) {
+    current += `/${part}`;
+    try {
+      await yandexDiskRequest("PUT", "/resources", { query: { path: current } });
+    } catch (error) {
+      const message = String(error?.message || "");
+      if (/409|DiskPathPointsToExistentDirectoryError|уже существует/iu.test(message)) continue;
+      if (options.allowMissingRoot && /404/iu.test(message)) continue;
+      throw error;
+    }
+  }
+}
+
+function normalizeYandexDiskPath(remotePath) {
+  const text = String(remotePath || CLOUD_DEFAULT_REMOTE_DIR).trim().replace(/\\/g, "/");
+  if (text.startsWith("disk:") || text.startsWith("app:")) return text;
+  return text.startsWith("/") ? text : `/${text}`;
+}
+
+function denormalizeYandexDiskPath(remotePath) {
+  return String(remotePath || "").replace(/^disk:/u, "").replace(/^app:/u, "") || "/";
+}
+
+async function mailruCloudRequest(method, remotePath, options = {}) {
+  const credentials = await requireCloudCredentials("mailru-cloud");
+  const baseUrl = String(credentials.baseUrl || "https://webdav.cloud.mail.ru").replace(/\/+$/u, "");
+  const url = `${baseUrl}${encodeWebDavPath(remotePath)}`;
+  const response = await fetch(url, {
+    method,
+    headers: {
+      Authorization: `Basic ${Buffer.from(`${credentials.username}:${credentials.password}`).toString("base64")}`,
+      ...(options.headers || {}),
+    },
+    body: options.body,
+    signal: AbortSignal.timeout(Number(options.timeout || 30000)),
+  });
+  if (!response.ok && !(method === "MKCOL" && response.status === 405)) {
+    const text = await response.text().catch(() => "");
+    throw new Error(`Mail.ru Cloud WebDAV request failed: ${response.status} ${response.statusText}\n${sanitizeSecretFromText(text, credentials.password)}`);
+  }
+  return response;
+}
+
+async function mailruCloudList(remotePath, options = {}) {
+  await ensureMailruCloudDir(remotePath, { allowMissingRoot: Boolean(options.allowMissingRoot) });
+  const response = await mailruCloudRequest("PROPFIND", remotePath, { headers: { Depth: "1" } });
+  const text = await response.text();
+  return parseWebDavList(text, remotePath);
+}
+
+async function mailruCloudUpload(localPath, remotePath) {
+  const resolved = path.resolve(localPath);
+  const info = await stat(resolved);
+  if (!info.isFile()) throw new Error(`Это не файл: ${localPath}`);
+  await ensureMailruCloudDir(path.dirname(remotePath));
+  const bytes = await readFile(resolved);
+  await mailruCloudRequest("PUT", remotePath, { body: bytes, timeout: 120000 });
+  return { provider: "mailru-cloud", local: resolved, remote: remotePath, size: info.size };
+}
+
+async function mailruCloudDownload(remotePath, outputPath) {
+  const response = await mailruCloudRequest("GET", remotePath, { timeout: 120000 });
+  const buffer = Buffer.from(await response.arrayBuffer());
+  const resolved = path.resolve(outputPath);
+  await mkdir(path.dirname(resolved), { recursive: true });
+  await writeFile(resolved, buffer);
+  return { provider: "mailru-cloud", remote: remotePath, local: resolved, size: buffer.length };
+}
+
+async function ensureMailruCloudDir(remotePath, options = {}) {
+  const parts = String(remotePath || CLOUD_DEFAULT_REMOTE_DIR).replace(/\\/g, "/").split("/").filter(Boolean);
+  let current = "";
+  for (const part of parts) {
+    current += `/${part}`;
+    try {
+      await mailruCloudRequest("MKCOL", current);
+    } catch (error) {
+      const message = String(error?.message || "");
+      if (/405|409/iu.test(message)) continue;
+      if (options.allowMissingRoot && /404/iu.test(message)) continue;
+      throw error;
+    }
+  }
+}
+
+function encodeWebDavPath(remotePath) {
+  const normalized = String(remotePath || "/").replace(/\\/g, "/");
+  const segments = normalized.split("/").filter(Boolean).map(encodeURIComponent);
+  return `/${segments.join("/")}${normalized.endsWith("/") ? "/" : ""}`;
+}
+
+function parseWebDavList(xml, basePath) {
+  const responses = String(xml || "").split(/<[^:>]*:?response[^>]*>/iu).slice(1);
+  const rows = [];
+  for (const response of responses) {
+    const href = decodeXml(stripXmlTags(response.match(/<[^:>]*:?href[^>]*>([\s\S]*?)<\/[^:>]*:?href>/iu)?.[1] || ""));
+    const name = decodeXml(stripXmlTags(response.match(/<[^:>]*:?displayname[^>]*>([\s\S]*?)<\/[^:>]*:?displayname>/iu)?.[1] || "")) || path.basename(href);
+    const size = decodeXml(stripXmlTags(response.match(/<[^:>]*:?getcontentlength[^>]*>([\s\S]*?)<\/[^:>]*:?getcontentlength>/iu)?.[1] || ""));
+    const isDir = /<[^:>]*:?collection\s*\/?>/iu.test(response);
+    const normalizedPath = decodeURIComponent(href || "");
+    if (normalizeGeoText(normalizedPath).replace(/\s+/g, "") === normalizeGeoText(basePath).replace(/\s+/g, "")) continue;
+    rows.push({ type: isDir ? "dir" : "file", name, path: normalizedPath, size: size || "-" });
+  }
+  return rows;
+}
+
+function stripXmlTags(value) {
+  return String(value || "").replace(/<[^>]+>/g, "").trim();
+}
+
+function decodeXml(value) {
+  return String(value || "")
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, "\"")
+    .replace(/&#39;/g, "'");
+}
+
+async function cloudBackup(provider) {
+  const config = await loadConfig();
+  const payload = {
+    createdAt: new Date().toISOString(),
+    version: getPackageVersion(),
+    note: "Секреты, API-ключи и токены не включены в резервную копию.",
+    config: {
+      api: config.api,
+      ai: { activeProfile: config.ai?.activeProfile, provider: config.ai?.provider, model: config.ai?.model, profiles: config.ai?.profiles },
+      files: config.files,
+      skills: config.skills,
+      cloud: config.cloud,
+    },
+  };
+  const tempPath = path.join(CONFIG_DIR, `iola-backup-${timestampForFile()}.json`);
+  await writeFile(tempPath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+  try {
+    return cloudUpload(provider, tempPath, `${cloudRootForProvider(provider)}/backup/${path.basename(tempPath)}`, { overwrite: true });
+  } finally {
+    await rm(tempPath, { force: true }).catch(() => {});
+  }
+}
+
+function timestampForFile() {
+  return new Date().toISOString().replace(/[:.]/g, "-");
+}
+
 async function handleArchive(args) {
   const [action = "doctor", target, ...rest] = args;
   const options = parseOptions(rest);
@@ -9928,6 +10413,14 @@ async function onboard(args = []) {
       await setYandexGeocoderKey();
     }
   }
+  if (components.includes("cloud")) {
+    if (process.stdin.isTTY) {
+      const providerAnswer = (await askText("Облачный диск: 1 - Яндекс Диск, 2 - Облако Mail.ru, 0 - пропустить: ")).trim();
+      if (providerAnswer === "1") await setupCloudProvider("yandex-disk");
+      else if (providerAnswer === "2") await setupCloudProvider("mailru-cloud");
+      else console.log("Настройка облачного диска пропущена.");
+    }
+  }
   if (components.includes("codex")) {
     await installCodexIfMissing();
     await aiSetup(["codex"]);
@@ -9977,6 +10470,7 @@ async function chooseOnboardComponents(status = null) {
       12: "browser",
       13: "ollama",
       14: "yandex-geocoder",
+      15: "cloud",
     };
     return [...selected].map((item) => map[item] || item).filter(Boolean);
   } finally {
@@ -9989,7 +10483,7 @@ function isOnboardExitAnswer(answer) {
 }
 
 async function getOnboardComponentStatus() {
-  const [config, readiness, browser, archive, codexVersion, ollamaVersion, yandexGeocoderKey] = await Promise.all([
+  const [config, readiness, browser, archive, codexVersion, ollamaVersion, yandexGeocoderKey, cloudSecrets] = await Promise.all([
     loadConfig(),
     getAiReadiness(),
     getBrowserStatus(),
@@ -9997,6 +10491,7 @@ async function getOnboardComponentStatus() {
     getCommandVersion("codex", ["--version"]),
     getOllamaVersion(),
     getYandexGeocoderKey(),
+    loadSecrets().then((secrets) => secrets.cloud || {}),
   ]);
   const workspaceReady = existsSync(PROJECT_CONTEXT_FILE) || existsSync(PROJECT_CONTEXT_DIR_FILE) || existsSync(PROJECT_IOLA_DIR);
   const policyReady = (config.toolsets?.enabled || []).includes("analyst");
@@ -10015,6 +10510,7 @@ async function getOnboardComponentStatus() {
     index: false,
     browser: browser.installed === "yes",
     "yandex-geocoder": Boolean(yandexGeocoderKey),
+    cloud: Object.keys(cloudSecrets).length > 0,
   };
 }
 
@@ -10034,6 +10530,7 @@ function onboardComponentRows(status) {
     ["12", "browser", "Browser runtime", "Playwright/Chromium установлен"],
     ["13", "ollama", "Ollama", "опциональный локальный runtime"],
     ["14", "yandex-geocoder", "Yandex Geocoder API", "ключ геокодера сохранен или есть в env"],
+    ["15", "cloud", "Облачный диск", "Яндекс Диск или Облако Mail.ru"],
   ];
   return rows.map(([number, key, title, hint]) => ({ number, key, title, hint, status: status[key] ? "готово" : "не настроено" }));
 }
@@ -10048,7 +10545,7 @@ function defaultOnboardSelection(status) {
 }
 
 function defaultOnboardComponents(status) {
-  const map = { 1: "workspace", 2: "policy", 3: "iola", 4: "yandexgpt", 5: "gigachat", 6: "openai", 7: "openrouter", 8: "codex", 9: "codex-mcp", 10: "archive", 11: "index", 12: "browser", 13: "ollama", 14: "yandex-geocoder" };
+  const map = { 1: "workspace", 2: "policy", 3: "iola", 4: "yandexgpt", 5: "gigachat", 6: "openai", 7: "openrouter", 8: "codex", 9: "codex-mcp", 10: "archive", 11: "index", 12: "browser", 13: "ollama", 14: "yandex-geocoder", 15: "cloud" };
   return defaultOnboardSelection(status).map((item) => map[item]).filter(Boolean);
 }
 
@@ -11947,6 +12444,14 @@ function mergeConfig(base, override) {
       ...base.files,
       ...(override.files || {}),
     },
+    cloud: {
+      ...base.cloud,
+      ...(override.cloud || {}),
+      providers: {
+        ...(base.cloud?.providers || {}),
+        ...(override.cloud?.providers || {}),
+      },
+    },
     memory: {
       ...base.memory,
       ...(override.memory || {}),
@@ -12006,6 +12511,9 @@ function sanitizeConfig(config) {
   if (Array.isArray(next.skills?.enabled) && next.skills.enabled.includes("open-data") && !next.skills.enabled.includes("education")) {
     next.skills.enabled = ["education", ...next.skills.enabled];
   }
+  if (Array.isArray(next.skills?.enabled) && next.skills.enabled.includes("local-files") && !next.skills.enabled.includes("personal-docs")) {
+    next.skills.enabled = [...next.skills.enabled, "personal-docs"];
+  }
   const localProfile = next.ai?.profiles?.local;
   if (localProfile?.provider === "iola") {
     if (!localProfile.runtime || localProfile.model === "iola-router-1b") {
@@ -12050,6 +12558,9 @@ function validateConfig(config) {
   for (const toolset of config.toolsets?.enabled || []) {
     if (!TOOLSETS[toolset]) errors.push(`toolsets.enabled содержит неизвестный toolset: ${toolset}`);
   }
+  if (config.cloud?.activeProvider && !["yandex-disk", "mailru-cloud"].includes(config.cloud.activeProvider)) {
+    errors.push(`cloud.activeProvider неизвестен: ${config.cloud.activeProvider}`);
+  }
   return errors;
 }
 
@@ -12063,6 +12574,7 @@ function configSchema() {
       permissions: { localTools: ALL_LOCAL_TOOLS, runtime: ["readFiles", "writeFiles", "editFiles", "deleteFiles", "sync", "externalApi", "externalAi", "codex"] },
       toolsets: { available: Object.keys(TOOLSETS) },
       files: { modes: ["locked", "read-only", "workspace-write", "full-access"], approvals: ["never", "on-write", "on-danger", "always"] },
+      cloud: { providers: ["yandex-disk", "mailru-cloud"], root: CLOUD_DEFAULT_REMOTE_DIR },
       skills: { enabled: "array of skill names" },
       daemon: { host: "127.0.0.1", port: DAEMON_PORT },
     },

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//320/232/320/276/320/274/320/260/320/275/320/264/321/213.md

@@ -41,6 +41,23 @@ 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
+```
+
 Локальная БД:
 
 ```bash

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,134 @@
+# Облачные диски
+
+`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`
+
+### Получение OAuth-токена Яндекс Диска
+
+1. Откройте страницу Яндекс OAuth: `https://oauth.yandex.ru/`.
+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
+```
+
+25. Вставьте OAuth-токен.
+26. Проверьте подключение:
+
+```bash
+iola cloud doctor
+```
+
+Секрет сохраняется локально в `~/.iola/secrets.json`.
+
+После успешной проверки CLI создаст или использует папку `/IOLA` на Яндекс Диске.
+
+Обычно такой токен выдается на длительный срок. Если доступ перестал работать, получите новый токен через ту же ссылку авторизации и повторите `iola cloud setup yandex-disk`.
+
+## Облако 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

@@ -99,3 +99,41 @@ iola geo services "Йошкар-Ола, улица Петрова, 15"
 - Расстояние считается по прямой между координатами. Это не автомобильный и не пешеходный маршрут.
 - 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
+
+Восстановить CLI из резервной копии, когда пользователь переустановил программу или перешел на другой компьютер.
+
+### cloud-organize
+
+Помочь разобрать личные документы: найти старые отчеты, крупные файлы, дубликаты и предложить структуру папок.