kingkont 0.20.7 → 0.20.9

package/renderer/chat.js

@@ -1342,6 +1342,10 @@
 
   // Главная entry-point: попытаться WS, если не получится — polling.
   function startTransport(key) {
+    // /ws — Electron-only (lib/wsHub.js). В web чат вообще disabled
+    // (web-shim стабит /api/chat/* → 503), но даже без этого WS на
+    // kingkont.ru/ws всегда падает. Не дергаем — просто no-op.
+    if (window.__KINGKONT_WEB__) return;
     if (typeof WebSocket !== 'undefined') ensureWS(key);
     else startPolling(key);
   }

package/renderer/cloudFs.js

@@ -34,10 +34,127 @@
   // Структура: Map<projectId, Map<path, {kind:'file'|'dir', data?: Uint8Array, mtimeMs?: number}>>.
   // Path хранится в normalised форме без leading slash (например 'characters/Anna/scene.json').
   const _mem = new Map();
+  // projectId → Promise<void> для in-flight restore. Используем Promise (а не
+  // Set), чтобы конкурирующие openCloudProject(сразу два — например один на
+  // navigate, второй на hashchange) ОЖИДАЛИ один и тот же restore, иначе
+  // второй стартует readTextFile когда _mem ещё пуст, видит metaPresent=false
+  // и триггерит лишний download.
+  const _idbRestored = new Map();
   function _memProject(id) {
     if (!_mem.has(id)) _mem.set(id, new Map());
     return _mem.get(id);
   }
+
+  // === IndexedDB persistence (web fallback only). ============================
+  // Зачем: in-memory _mem живёт только пока вкладка не закрылась/не вытеснена
+  // Chrome'ом. Юзер открыл проект, оставил на минуту → memory может быть
+  // освобождена → openCloudProject снова качает все файлы. С IDB кэш
+  // переживает eviction и reload вкладки.
+  // Schema: DB 'kk-cloud-fs', store 'files', keyPath 'key' = 'projectId|relPath'.
+  // Records: { key, projectId, relPath, kind: 'file'|'dir', data?: Uint8Array, mtimeMs? }
+  const IDB_NAME = 'kk-cloud-fs';
+  const IDB_STORE = 'files';
+  let _idbPromise = null;
+  function _idb() {
+    if (!_idbPromise) {
+      _idbPromise = new Promise((resolve, reject) => {
+        if (typeof indexedDB === 'undefined') { resolve(null); return; }
+        const req = indexedDB.open(IDB_NAME, 1);
+        req.onupgradeneeded = () => {
+          const db = req.result;
+          if (!db.objectStoreNames.contains(IDB_STORE)) {
+            const store = db.createObjectStore(IDB_STORE, { keyPath: 'key' });
+            store.createIndex('projectId', 'projectId', { unique: false });
+          }
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => { console.warn('[cloudFs] IDB open failed:', req.error); resolve(null); };
+      }).catch(() => null);
+    }
+    return _idbPromise;
+  }
+  function _idbKey(projectId, relPath) { return projectId + '|' + relPath; }
+  async function _idbPut(projectId, relPath, kind, data, mtimeMs) {
+    const db = await _idb(); if (!db) return;
+    return new Promise(resolve => {
+      try {
+        const tx = db.transaction(IDB_STORE, 'readwrite');
+        tx.objectStore(IDB_STORE).put({
+          key: _idbKey(projectId, relPath), projectId, relPath, kind,
+          data: data || null, mtimeMs: mtimeMs || 0,
+        });
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => { console.warn('[cloudFs] IDB put failed:', tx.error); resolve(); };
+      } catch (e) { console.warn('[cloudFs] IDB put exc:', e); resolve(); }
+    });
+  }
+  async function _idbDelete(projectId, relPath) {
+    const db = await _idb(); if (!db) return;
+    return new Promise(resolve => {
+      try {
+        const tx = db.transaction(IDB_STORE, 'readwrite');
+        tx.objectStore(IDB_STORE).delete(_idbKey(projectId, relPath));
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => resolve();
+      } catch { resolve(); }
+    });
+  }
+  async function _idbDeleteByPrefix(projectId, prefix) {
+    const db = await _idb(); if (!db) return;
+    return new Promise(resolve => {
+      try {
+        const tx = db.transaction(IDB_STORE, 'readwrite');
+        const idx = tx.objectStore(IDB_STORE).index('projectId');
+        const req = idx.openCursor(IDBKeyRange.only(projectId));
+        req.onsuccess = () => {
+          const cur = req.result;
+          if (!cur) return;
+          const r = cur.value;
+          if (r.relPath === prefix || r.relPath.startsWith(prefix + '/')) cur.delete();
+          cur.continue();
+        };
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => resolve();
+      } catch { resolve(); }
+    });
+  }
+  // Загрузить ВСЕ файлы проекта из IDB в _mem за один transaction. Lazy:
+  // делаем максимум один раз на (projectId, page-load). Конкурирующие вызовы
+  // ждут одну и ту же Promise (важно — иначе второй вызов читает _mem пустым
+  // пока первый ещё в IDB-tx и триггерит лишний download).
+  function _idbRestoreProject(projectId) {
+    const existing = _idbRestored.get(projectId);
+    if (existing) return existing;
+    const promise = (async () => {
+      const db = await _idb(); if (!db) return;
+      return new Promise(resolve => {
+        try {
+          const tx = db.transaction(IDB_STORE, 'readonly');
+          const idx = tx.objectStore(IDB_STORE).index('projectId');
+          const req = idx.openCursor(IDBKeyRange.only(projectId));
+          const map = _memProject(projectId);
+          let count = 0;
+          req.onsuccess = () => {
+            const cur = req.result;
+            if (!cur) return;
+            const r = cur.value;
+            if (!map.has(r.relPath)) {
+              map.set(r.relPath, { kind: r.kind, data: r.data || undefined, mtimeMs: r.mtimeMs || 0 });
+              count++;
+            }
+            cur.continue();
+          };
+          tx.oncomplete = () => {
+            if (count) console.log('[cloudFs] restored', count, 'entries from IDB for', projectId);
+            resolve();
+          };
+          tx.onerror = () => resolve();
+        } catch { resolve(); }
+      });
+    })();
+    _idbRestored.set(projectId, promise);
+    return promise;
+  }
   // Нормализация и помощник для родительских папок: 'a/b/c' → ['a', 'a/b', 'a/b/c'].
   function _normalize(p) { return String(p || '').replace(/^\/+|\/+$/g, ''); }
   function _ensureDirs(map, p) {
@@ -129,20 +246,45 @@
       async write(rel, data) {
         const p = _normalize(rel);
         const { dir } = _split(p);
-        if (dir) _ensureDirs(map, dir);
+        if (dir) {
+          _ensureDirs(map, dir);
+          // Persist parent dirs (fire-and-forget) — нужно для list() при restore.
+          const parts = dir.split('/');
+          let acc = '';
+          for (const part of parts) {
+            acc = acc ? acc + '/' + part : part;
+            _idbPut(projectId, acc, 'dir', null, 0).catch(() => {});
+          }
+        }
         const buf = typeof data === 'string'
           ? new TextEncoder().encode(data)
           : (data instanceof Uint8Array ? data : new Uint8Array(data));
-        map.set(p, { kind: 'file', data: buf, mtimeMs: Date.now() });
+        const mtimeMs = Date.now();
+        map.set(p, { kind: 'file', data: buf, mtimeMs });
+        // Persist в IDB (fire-and-forget — UI не ждёт).
+        _idbPut(projectId, p, 'file', buf, mtimeMs).catch(() => {});
+        return true;
+      },
+      async mkdir(rel) {
+        _ensureDirs(map, rel);
+        const p = _normalize(rel);
+        if (p) {
+          const parts = p.split('/');
+          let acc = '';
+          for (const part of parts) {
+            acc = acc ? acc + '/' + part : part;
+            _idbPut(projectId, acc, 'dir', null, 0).catch(() => {});
+          }
+        }
         return true;
       },
-      async mkdir(rel) { _ensureDirs(map, rel); return true; },
       async remove(rel) {
         const p = _normalize(rel);
         // Удаляем запись и все потомки.
         for (const k of Array.from(map.keys())) {
           if (k === p || k.startsWith(p + '/')) map.delete(k);
         }
+        _idbDeleteByPrefix(projectId, p).catch(() => {});
         return true;
       },
     };
@@ -282,10 +424,39 @@
   // Получить projectId / backend из любого вложенного cloud-handle.
   function getCloudProjectId(handle) { return handle?.__cloudProjectId || null; }
 
+  // Полностью очистить проект из IDB и из памяти (для cache invalidation,
+  // когда обнаружили что серверный манифест новее).
+  async function _clearProject(projectId) {
+    _mem.delete(projectId);
+    _idbRestored.delete(projectId);  // Map.delete — same API.
+    const db = await _idb(); if (!db) return;
+    return new Promise(resolve => {
+      try {
+        const tx = db.transaction(IDB_STORE, 'readwrite');
+        const idx = tx.objectStore(IDB_STORE).index('projectId');
+        const req = idx.openCursor(IDBKeyRange.only(projectId));
+        req.onsuccess = () => {
+          const cur = req.result;
+          if (!cur) return;
+          cur.delete();
+          cur.continue();
+        };
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => resolve();
+      } catch { resolve(); }
+    });
+  }
+
   window.cloudFsShim = {
     makeCloudHandle,
     isCloudHandle,
     getCloudProjectId,
+    // Web-only: восстановить проект из IDB перед openCloudProject. Зачем:
+    // Chrome eviction убивает _mem; без этого manifest+файлы каждый раз
+    // качаются заново. Lazy — делает максимум один раз на (projectId, page-load).
+    restoreProject: _idbRestoreProject,
+    // Web-only: полная инвалидация (если серверный mtime новее локального).
+    clearProject: _clearProject,
     // exposed для save-to-server: пройтись по всем файлам in-memory map'а.
     _memProject,
     // Web-only helper: прямой write в backend этого проекта. Используется

package/renderer/cloudProjects.js

@@ -77,6 +77,35 @@
           saveBtn.disabled = false;
         }
       }
+      // 🤝 Расшарить — sidebar button. Показываем когда открыт мой
+      // cloud-проект (state.cloudMine === true). JS-injected, не в HTML.
+      // openShareModal живёт в board.js (window.openShareModal). В Electron
+      // share-API'ы (/api/proj/setPublic|share|unshare|shares) проксируются
+      // через server.js → kingkont.ru/proj_*; в web — через web-shim.
+      {
+        let shareBtn = $('shareProjectBtn');
+        const wantShow = logged && state.cloudProjectId && state.cloudMine !== false;
+        if (wantShow && !shareBtn && saveBtn?.parentNode) {
+          shareBtn = document.createElement('button');
+          shareBtn.id = 'shareProjectBtn';
+          shareBtn.className = 'kk-edit-only';
+          shareBtn.textContent = '🤝 Расшарить';
+          shareBtn.title = 'Расшарить проект другому юзеру или сделать публичным';
+          shareBtn.style.cssText = 'margin-top:6px; font-size:12px;';
+          shareBtn.addEventListener('click', () => {
+            if (typeof window.openShareModal === 'function') {
+              window.openShareModal({
+                id: state.cloudProjectId,
+                name: state.filmHandle?.name || '',
+                isPublic: !!state.cloudIsPublic,
+                mine: state.cloudMine !== false,
+              });
+            }
+          });
+          saveBtn.parentNode.insertBefore(shareBtn, saveBtn.nextSibling);
+        }
+        if (shareBtn) shareBtn.style.display = wantShow ? '' : 'none';
+      }
     }).catch(() => {});
   }
 
@@ -196,8 +225,15 @@
       });
       writeCache(cached);
       notifyListChange(cached);
+      // Свежесозданный проект — мы сами owner.
+      state.cloudPermission = 'owner';
+      state.cloudMine = true;
+      state.cloudCanModify = true;
+      state.cloudIsPublic = false;
       await openFilm(handle);
       setCloudButtonsVisibility();
+      if (typeof window.renderTemplateOverlay === 'function') window.renderTemplateOverlay();
+      if (window.__KINGKONT_WEB__) location.hash = '#project=' + created.id;
     } catch (e) {
       alert('Не удалось создать облачный проект: ' + (e?.message || e));
     }
@@ -260,10 +296,14 @@
     // 1. Проверяем синхронизирован ли уже локально.
     //    Electron: userData/cloud-projects/<id>/ через window.cloudFs (диск).
     //    Web: in-memory map в cloudFsShim — живёт пока страница не перезагружена.
-    //    Без web-ветки браузер качал файлы при каждом open, хотя в памяти
-    //    они уже лежали с прошлого визита в этой же сессии.
+    //    Кроме _mem поднимаем сохранённые ранее файлы из IndexedDB —
+    //    Chrome аггрессивно вытесняет JS-память, и без IDB через минуту
+    //    после открытия мы снова качали весь проект с сервера.
     if (!opts.forceRefresh) {
       try {
+        if (!window.cloudFs && window.cloudFsShim?.restoreProject) {
+          await window.cloudFsShim.restoreProject(projectId);
+        }
         let metaText = null;
         if (window.cloudFs) {
           metaText = await window.cloudFs.readText(projectId, '.kingkont-meta.json');
@@ -276,17 +316,57 @@
             const handle = await window.cloudFsShim.makeCloudHandle(projectId, suggestedName || projectId);
             state.cloudProjectId = projectId;
             state.cloudDirty = false;
+            // Сбрасываем permissions-state в "ещё не знаем" (null), иначе
+            // прошлые значения (или initial false из state.js) триггерили
+            // view-only-mode у renderTemplateOverlay'я ДО ответа сервера.
+            // Юзер видел readonly-полку, потом она менялась на edit-mode.
+            // Сравнение `state.cloudCanModify === false` теперь false для
+            // null — eager toggle оставляет edit-mode (по URL #project=).
+            state.cloudCanModify = null;
+            state.cloudPermission = null;
+            state.cloudMine = null;
+            state.cloudIsPublic = null;
+            // Restore CDN-карту из meta — иначе после reload в web view-only
+            // картинки не находились (FS-fallback видит только scene.json,
+            // сами файлы лежат на CDN, локально не качались).
+            if (meta.cdnByBoard) state.cloudCdnByBoard = meta.cdnByBoard;
             touchCloudOpened(projectId);
             await openFilm(handle);
             setCloudButtonsVisibility();
-            if (window.__KINGKONT_WEB__) location.hash = '#project=' + projectId;
+            // Eager mode-toggle на основе URL — НЕ ждём сервер. Иначе при
+            // hash navigation (#project= → #template= без reload) edit-mode
+            // оставался активным ~500ms пока fetch /api/projects не отдаст
+            // canModify. Юзер видит лишние edit-кнопки на view-only-link.
+            if (typeof window.renderTemplateOverlay === 'function') window.renderTemplateOverlay();
+            if (window.__KINGKONT_WEB__ && !/^#template=/.test(location.hash)) location.hash = '#project=' + projectId;
+            // Background — узнаём актуальный canModify. Если расширились
+            // shared-edit права или наоборот отозвали — обновится здесь.
+            fetch('/api/projects/' + encodeURIComponent(projectId)).then(r => r.ok ? r.json() : null).then(p => {
+              if (!p) return;
+              state.cloudPermission = p.permission || (p.mine ? 'owner' : null);
+              state.cloudMine = !!p.mine;
+              state.cloudCanModify = !!p.canModify;
+              state.cloudIsPublic = !!p.isPublic;
+              setCloudButtonsVisibility();
+              if (typeof window.renderTemplateOverlay === 'function') window.renderTemplateOverlay();
+            }).catch(() => {});
             return;
           }
         }
       } catch {}
     }
-    // 2. Не синхронизирован → скачиваем с сервера.
-    PROGRESS.show('Загрузка проекта…');
+    // 2. Не синхронизирован → новая стратегия (web view-only OR медленный
+    // первый load расшаренной ссылки):
+    //   a) GET /api/projects/<id> — манифест
+    //   b) Пишем только scene.json'ы (маленькие) — нужны для openFilm
+    //   c) openFilm() СРАЗУ — доска видна
+    //   d) Pre-populate state.currentBoard.urls с CDN-proxy URL'ами →
+    //      картинки грузятся напрямую из chatium-storage параллельно через
+    //      браузер. Никакого «скачали → сохранили локально → URL.createObjectURL».
+    //   e) Если canModify=true (юзер может сохранять) — в фоне качаем файлы
+    //      и сохраняем локально (для dedup при save). Если canModify=false —
+    //      ничего не качаем, всё работает через CDN.
+    PROGRESS.show('Загрузка манифеста…');
     try {
       const r = await fetch('/api/projects/' + encodeURIComponent(projectId));
       if (!r.ok) {
@@ -295,118 +375,163 @@
       }
       const proj = await r.json();
       const handle = await window.cloudFsShim.makeCloudHandle(projectId, proj.name || suggestedName || 'Project');
-      // Скачиваем все board'ы манифеста (если они уже не лежат локально с тем же hash).
       const boards = Array.isArray(proj.manifest?.boards) ? proj.manifest.boards : [];
-      // Сначала собираем общий список файлов для прогресса (CDN-файлы + DB-тексты).
-      const totalFiles = boards.reduce(
-        (s, b) => s + Object.keys(b?.files || {}).length + Object.keys(b?.texts || {}).length, 0);
-      let done = 0;
-      // fileHashes / textHashes индексируем тем же ключом что использует save:
-      // `${kind}/${name}/${relPath}`. Иначе при следующем save dedup не найдёт
-      // ничего и перезальёт всё заново.
-      const fileHashes = {};
-      const textHashes = {};
+      const canModify = !!proj.canModify;
+
+      // a) Пишем scene.json'ы синхронно (для каждого board нужен, чтобы
+      //    openFilm / switchBoard смогли отрендерить ноды).
       for (const board of boards) {
         const boardDir = boardKindToDir(board.kind, board.name);
-        // 1) scene.json
         if (board.scene) {
           await writeCloudFile(projectId, joinPath(boardDir, 'scene.json'),
             new TextEncoder().encode(JSON.stringify(board.scene, null, 2)));
         }
-        // 2) media-файлы — из CDN.
+      }
+      // CDN-карта — будет и в state, и в meta (чтобы пережила reload).
+      // Конвертируем /get/<hash> → /thumbnail/<hash>/1024x для лучшего
+      // кеширования на CDN (юзер: «/get плохо кешируется, /thumbnail
+      // кешируется»). 1024px достаточно и для card-thumbnail и для
+      // полноэкранного просмотра. Маленькие thumbs (320x) — отдельной
+      // картой не требуются, scene-card сам ресайзит через CSS.
+      const cdnByBoard = {};
+      for (const board of boards) {
+        const map = {};
         for (const [relPath, cdnUrl] of Object.entries(board.files || {})) {
-          done++;
-          PROGRESS.update(done, totalFiles, `Загрузка ${relPath} (${done}/${totalFiles})`);
-          const fr = await fetch('/api/proxy?url=' + encodeURIComponent(cdnUrl));
-          if (!fr.ok) throw new Error(`Не удалось скачать ${relPath}: ${fr.status}`);
-          const buf = new Uint8Array(await fr.arrayBuffer());
-          const localPath = joinPath(boardDir, relPath);
-          await writeCloudFile(projectId, localPath, buf);
-          // Получаем mtimeMs от FS — без него dedup на save не сработает
-          // (cached.mtime === file.lastModified должно совпадать).
-          let mtime = Date.now();
-          if (window.cloudFs?.stat) {
-            try {
-              const st = await window.cloudFs.stat(projectId, localPath);
-              if (st?.mtimeMs) mtime = st.mtimeMs;
-            } catch {}
-          }
-          fileHashes[`${board.kind}/${board.name}/${relPath}`] = {
-            url: cdnUrl, size: buf.byteLength, mtime,
-          };
-        }
-        // 3) text-файлы (.md) — из таблицы project_texts по textId.
-        for (const [relPath, textId] of Object.entries(board.texts || {})) {
-          done++;
-          PROGRESS.update(done, totalFiles, `Загрузка ${relPath} (${done}/${totalFiles})`);
-          const tr = await fetch('/api/project-texts/' + encodeURIComponent(textId));
-          if (!tr.ok) throw new Error(`Не удалось получить текст ${relPath}: ${tr.status}`);
-          const td = await tr.json();
-          const buf = new TextEncoder().encode(td.content || '');
-          const localPath = joinPath(boardDir, relPath);
-          await writeCloudFile(projectId, localPath, buf);
-          let mtime = Date.now();
-          if (window.cloudFs?.stat) {
-            try {
-              const st = await window.cloudFs.stat(projectId, localPath);
-              if (st?.mtimeMs) mtime = st.mtimeMs;
-            } catch {}
-          }
-          textHashes[`${board.kind}/${board.name}/${relPath}`] = {
-            textId, size: buf.byteLength, mtime,
-          };
+          const thumbUrl = cdnUrl.includes('fs.chatium.ru/get/')
+            ? cdnUrl.replace('/get/', '/thumbnail/') + '/1024x'
+            : cdnUrl;
+          map[relPath] = '/api/proxy?url=' + encodeURIComponent(thumbUrl);
         }
+        cdnByBoard[board.name] = map;
       }
-      // 3) cover (опционально). Запоминаем size+mtime → coverHash для
-      // dedup'а при следующем save'е (иначе первый же save перезальёт
-      // обложку, хотя она не менялась).
-      let openedCoverHash = null;
-      if (proj.coverUrl) {
-        try {
-          const fr = await fetch('/api/proxy?url=' + encodeURIComponent(proj.coverUrl));
-          if (fr.ok) {
-            const buf = new Uint8Array(await fr.arrayBuffer());
-            const ct = fr.headers.get('content-type') || 'image/jpeg';
-            const ext = ct.includes('png') ? 'png' : (ct.includes('webp') ? 'webp' : 'jpg');
-            const coverPath = '.cover.' + ext;
-            await writeCloudFile(projectId, coverPath, buf);
-            let coverMtime = Date.now();
-            if (window.cloudFs?.stat) {
-              try {
-                const st = await window.cloudFs.stat(projectId, coverPath);
-                if (st?.mtimeMs) coverMtime = st.mtimeMs;
-              } catch {}
-            }
-            openedCoverHash = { size: buf.byteLength, mtime: coverMtime, url: proj.coverUrl };
-          }
-        } catch {}
-      }
-      // 4) meta — cloudProjectId + fileHashes (собран в loop'е выше) + coverHash.
-      // Ключи в формате `${kind}/${name}/${relPath}` совпадают с тем что
-      // использует saveCloudProject — dedup сработает на следующем save'е.
+      // Skeleton meta + cdnByBoard (для fast cache-hit на reload).
       await writeCloudFile(projectId, '.kingkont-meta.json',
         new TextEncoder().encode(JSON.stringify({
           cloudProjectId: projectId,
-          fileHashes,
-          textHashes,
+          fileHashes: {},
+          textHashes: {},
           coverUrl: proj.coverUrl || null,
-          coverHash: openedCoverHash,
+          coverHash: null,
           syncedAt: Date.now(),
+          incomplete: !canModify,    // флажок для будущего save (если расширим)
+          cdnByBoard,                // {boardName: {relPath: '/api/proxy?url=...'}}
         }, null, 2)));
-      // 5) Открываем.
+
+      // b) Стейт + open
       state.cloudProjectId = projectId;
       state.cloudDirty = false;
+      state.cloudPermission = proj.permission || (proj.mine ? 'owner' : null);
+      state.cloudMine = !!proj.mine;
+      state.cloudCanModify = canModify;
+      state.cloudIsPublic = !!proj.isPublic;
+      // CDN-карта используется при switchBoard — наполняет урлы новой доски
+      // (см. _hookBoardSwitchForCdn ниже).
+      state.cloudCdnByBoard = cdnByBoard;
       touchCloudOpened(projectId);
       await openFilm(handle);
+      // Pre-populate URLs ТЕКУЩЕЙ доски — чтобы при renderCanvas картинки
+      // сразу же сослались на CDN, без round-trip через FS.
+      _applyCdnUrlsToCurrentBoard();
       setCloudButtonsVisibility();
-      if (window.__KINGKONT_WEB__) location.hash = '#project=' + projectId;
-      PROGRESS.hide();
+      if (typeof window.renderTemplateOverlay === 'function') window.renderTemplateOverlay();
+      if (window.__KINGKONT_WEB__ && !/^#template=/.test(location.hash)) location.hash = '#project=' + projectId;
+      PROGRESS.hide();   // доска уже видна юзеру
+
+      // c) Background download — только если canModify (нужны локальные
+      //    файлы для save+dedup). Параллельно, без блокировки UI.
+      if (canModify) {
+        _backgroundDownload(projectId, boards, proj.coverUrl).catch(e =>
+          console.warn('[cloudProjects] background download failed:', e?.message || e));
+      }
     } catch (e) {
       PROGRESS.hide();
       alert('Не удалось открыть облачный проект: ' + (e?.message || e));
     }
   }
 
+  // Подложить CDN-URL'ы под state.currentBoard.urls — рендеру медиа-нод
+  // в settings.js достаточно непустого `urls[node.file]`, чтобы не лезть
+  // в FS (см. settings.js:405).
+  function _applyCdnUrlsToCurrentBoard() {
+    const board = state.currentBoard;
+    if (!board) return;
+    const map = state.cloudCdnByBoard?.[board.name];
+    if (!map) return;
+    board.urls = board.urls || {};
+    for (const [relPath, url] of Object.entries(map)) {
+      if (!board.urls[relPath]) board.urls[relPath] = url;
+    }
+  }
+  // openFilm и selectBoard могут вызываться без нашего ведома (юзер кликает
+  // на другую сцену в сайдбаре). Перехватываем смену через event — после
+  // каждой смены доски подкладываем URL'ы. board.js шлёт project-changed
+  // и board-changed; ловим оба.
+  window.addEventListener('board-changed', _applyCdnUrlsToCurrentBoard);
+  window.addEventListener('project-changed', _applyCdnUrlsToCurrentBoard);
+
+  // Background-загрузка всех файлов в локальный FS (для edit-mode).
+  // Параллельно по 4 за раз — не валим chatium.
+  async function _backgroundDownload(projectId, boards, coverUrl) {
+    const tasks = [];
+    for (const board of boards) {
+      const boardDir = boardKindToDir(board.kind, board.name);
+      for (const [relPath, cdnUrl] of Object.entries(board.files || {})) {
+        tasks.push({ kind: 'file', boardKind: board.kind, boardName: board.name,
+          boardDir, relPath, cdnUrl });
+      }
+      for (const [relPath, textId] of Object.entries(board.texts || {})) {
+        tasks.push({ kind: 'text', boardKind: board.kind, boardName: board.name,
+          boardDir, relPath, textId });
+      }
+    }
+    if (coverUrl) tasks.push({ kind: 'cover', cdnUrl: coverUrl });
+    const fileHashes = {};
+    const textHashes = {};
+    let coverHash = null;
+    const CONCURRENCY = 4;
+    let i = 0;
+    async function worker() {
+      while (i < tasks.length) {
+        const t = tasks[i++];
+        try {
+          if (t.kind === 'file') {
+            const fr = await fetch('/api/proxy?url=' + encodeURIComponent(t.cdnUrl));
+            if (!fr.ok) continue;
+            const buf = new Uint8Array(await fr.arrayBuffer());
+            await writeCloudFile(projectId, joinPath(t.boardDir, t.relPath), buf);
+            fileHashes[`${t.boardKind}/${t.boardName}/${t.relPath}`] =
+              { url: t.cdnUrl, size: buf.byteLength, mtime: Date.now() };
+          } else if (t.kind === 'text') {
+            const tr = await fetch('/api/project-texts/' + encodeURIComponent(t.textId));
+            if (!tr.ok) continue;
+            const td = await tr.json();
+            const buf = new TextEncoder().encode(td.content || '');
+            await writeCloudFile(projectId, joinPath(t.boardDir, t.relPath), buf);
+            textHashes[`${t.boardKind}/${t.boardName}/${t.relPath}`] =
+              { textId: t.textId, size: buf.byteLength, mtime: Date.now() };
+          } else if (t.kind === 'cover') {
+            const fr = await fetch('/api/proxy?url=' + encodeURIComponent(t.cdnUrl));
+            if (!fr.ok) continue;
+            const buf = new Uint8Array(await fr.arrayBuffer());
+            const ct = fr.headers.get('content-type') || 'image/jpeg';
+            const ext = ct.includes('png') ? 'png' : (ct.includes('webp') ? 'webp' : 'jpg');
+            await writeCloudFile(projectId, '.cover.' + ext, buf);
+            coverHash = { size: buf.byteLength, mtime: Date.now(), url: t.cdnUrl };
+          }
+        } catch {}
+      }
+    }
+    await Promise.all(Array.from({ length: CONCURRENCY }, worker));
+    // Обновляем meta — теперь с реальными хэшами для dedup'а при save.
+    try {
+      await writeCloudFile(projectId, '.kingkont-meta.json',
+        new TextEncoder().encode(JSON.stringify({
+          cloudProjectId: projectId, fileHashes, textHashes,
+          coverUrl: coverUrl || null, coverHash, syncedAt: Date.now(),
+        }, null, 2)));
+    } catch {}
+  }
+
   function boardKindToDir(kind, name) {
     if (kind === 'character') return '_characters/' + name;
     if (kind === 'location')  return '_locations/' + name;