kingkont 0.20.15 → 0.20.16

package/lib/providers.js

@@ -1207,6 +1207,29 @@ async function deleteProjectText(id, s) {
   return true;
 }
 
+// Batch-операции: один HTTP к chatium вместо N. Используются client'ом
+// при open (download всех .md) и save (upload всех .md).
+async function batchGetProjectTexts(body, s) {
+  const headers = { ...chatiumAuthHeaders(s), 'Content-Type': 'application/json' };
+  const url = `${chatiumBase(s)}${CHATIUM_PATHS.projectTexts}~batch-get`;
+  logCall('POST', 'Chatium', url, `n=${body?.ids?.length || 0}`);
+  const r = await fetch(url, { method: 'POST', headers, body: JSON.stringify(body) });
+  const text = await r.text();
+  let d; try { d = JSON.parse(text); } catch { d = { raw: text }; }
+  if (!r.ok) throw new Error(d?.error || d?.reason || `HTTP ${r.status}`);
+  return d;
+}
+async function batchSaveProjectTexts(body, s) {
+  const headers = { ...chatiumAuthHeaders(s), 'Content-Type': 'application/json' };
+  const url = `${chatiumBase(s)}${CHATIUM_PATHS.projectTexts}~batch-save`;
+  logCall('POST', 'Chatium', url, `n=${body?.items?.length || 0}`);
+  const r = await fetch(url, { method: 'POST', headers, body: JSON.stringify(body) });
+  const text = await r.text();
+  let d; try { d = JSON.parse(text); } catch { d = { raw: text }; }
+  if (!r.ok) throw new Error(d?.error || d?.reason || `HTTP ${r.status}`);
+  return d;
+}
+
 async function listElevenVoices() {
   const key = process.env.ELEVENLABS_API_KEY;
   if (!key) throw new Error('ELEVENLABS_API_KEY не задан');
@@ -1257,6 +1280,8 @@ module.exports = {
   createProjectText,
   getProjectText,
   updateProjectText,
+  batchGetProjectTexts,
+  batchSaveProjectTexts,
   deleteProjectText,
   // Constants (для server.js / тестов)
   KIE_IMAGE_MODELS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.20.15",
+  "version": "0.20.16",
   "description": "KingKont \u00b7 Chatium \u2014 \u043d\u043e\u0434-\u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440 \u0441\u0446\u0435\u043d \u0441 AI-\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 (\u043a\u0430\u0440\u0442\u0438\u043d\u043a\u0438/\u0432\u0438\u0434\u0435\u043e/\u0433\u043e\u043b\u043e\u0441/SFX/\u043c\u0443\u0437\u044b\u043a\u0430/\u0442\u0435\u043a\u0441\u0442)",
   "main": "main.js",
   "bin": {

package/renderer/cloudProjects.js

@@ -472,10 +472,9 @@
     }
   }
 
-  // Параллельная синхронная загрузка всех .md-контентов всех бордов.
-  // Тексты маленькие (1-10KB обычно), качаем сразу — иначе при открытии
-  // доски юзер видит пустые text-ноды до завершения _backgroundDownload
-  // (который не запускается в view-only).
+  // Загрузка всех .md-контентов всех бордов ОДНИМ batch-запросом.
+  // Юзер: «скачивай все текстовые ноды одним api-запросом».
+  // Раньше N параллельных fetch'ей (по 8). Теперь — один POST batch-get.
   async function _downloadAllTexts(projectId, boards) {
     const tasks = [];
     for (const board of boards) {
@@ -485,6 +484,31 @@
       }
     }
     if (!tasks.length) return;
+    try {
+      const r = await fetch('/api/project-texts/batch-get', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ ids: tasks.map(t => t.textId) }),
+      });
+      if (!r.ok) {
+        // Backend без batch-роута — fallback на старый параллельный download.
+        await _downloadAllTextsLegacy(projectId, tasks);
+        return;
+      }
+      const { items = [] } = await r.json();
+      // batch-get гарантирует порядок: items[i] соответствует tasks[i].
+      for (let i = 0; i < tasks.length; i++) {
+        const t = tasks[i];
+        const it = items[i];
+        if (!it || it.error) continue;
+        const buf = new TextEncoder().encode(it.content || '');
+        try { await writeCloudFile(projectId, joinPath(t.boardDir, t.relPath), buf); } catch {}
+      }
+    } catch {
+      await _downloadAllTextsLegacy(projectId, tasks);
+    }
+  }
+  async function _downloadAllTextsLegacy(projectId, tasks) {
     const CONCURRENCY = 8;
     let i = 0;
     async function worker() {
@@ -576,16 +600,20 @@
             if (!fr.ok) continue;
             const buf = new Uint8Array(await fr.arrayBuffer());
             await writeCloudFile(projectId, joinPath(t.boardDir, t.relPath), buf);
+            // content-hash вместо mtime — независимо от write time, тот же
+            // алгоритм при save → dedup hit.
+            const fhash = await _quickFileHash(new Blob([buf]));
             fileHashes[`${t.boardKind}/${t.boardName}/${t.relPath}`] =
-              { url: t.cdnUrl, size: buf.byteLength, mtime: Date.now() };
+              { url: t.cdnUrl, size: buf.byteLength, fhash };
           } 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 || '');
+            const content = td.content || '';
+            const buf = new TextEncoder().encode(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() };
+              { textId: t.textId, content };
           } else if (t.kind === 'cover') {
             const fr = await fetch('/api/proxy?url=' + encodeURIComponent(t.cdnUrl));
             if (!fr.ok) continue;
@@ -593,7 +621,8 @@
             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 };
+            const fhash = await _quickFileHash(new Blob([buf]));
+            coverHash = { size: buf.byteLength, fhash, url: t.cdnUrl };
           }
         } catch {}
       }
@@ -616,6 +645,27 @@
   }
   function joinPath(a, b) { return a ? (a + '/' + b).replace(/\/+/g, '/') : b; }
 
+  // Быстрый content-hash для dedup'а файлов при save.
+  // Раньше дедупили по size+mtime — но mtime файла, записанного в cloudFs/
+  // FSAH, не совпадает с тем что мы запомнили (Date.now() в JS != OS-stamped
+  // mtime). Поэтому при save после download'а ВСЕ файлы перезаливались.
+  // Quick-hash: SHA-1 по первым 64KB + последним 64KB + size (для маленьких
+  // файлов <128KB — полное содержимое). Достаточно чтобы отличить изменения
+  // (header или footer обычно затрагиваются при edit'е любого media).
+  async function _quickFileHash(file) {
+    const u8 = new Uint8Array(await file.arrayBuffer());
+    let chunk;
+    if (u8.byteLength <= 131072) {
+      chunk = u8;
+    } else {
+      chunk = new Uint8Array(131072);
+      chunk.set(u8.subarray(0, 65536), 0);
+      chunk.set(u8.subarray(u8.byteLength - 65536), 65536);
+    }
+    const hash = await crypto.subtle.digest('SHA-1', chunk);
+    return Array.from(new Uint8Array(hash)).map(b => b.toString(16).padStart(2, '0')).join('');
+  }
+
   async function writeCloudFile(projectId, relPath, data) {
     if (window.cloudFs) return window.cloudFs.write(projectId, relPath, data);
     // Web fallback: пишем в shared in-memory backend, тот же что
@@ -632,11 +682,18 @@
     if (!isLoggedIn(s)) { alert('Войдите в KingKont'); return; }
     if (!state.filmHandle) return;
 
-    // Если это папочный (не cloud) проект — спросим имя и создадим новый
-    // cloud-проект. Это ответ на «Любой проект (в том числе тот что создан
-    // в папке) нужно уметь сохранить на сервер».
-    const isCloud = !!state.cloudProjectId;
-    let projectId = state.cloudProjectId;
+    // Сначала читаем meta — там может быть привязка cloudProjectId от
+    // прошлого save'а. Без этого после reload приложения юзер открывал
+    // папочный проект и save создавал НОВЫЙ cloud-проект (вместо обновления
+    // ранее привязанного). Юзер: «когда я сохраняю проект на сервер — не
+    // должно создаваться нового проекта; проект на диске должен получать
+    // связку с доской в облаке».
+    const meta = (typeof readProjectMeta === 'function')
+      ? (await readProjectMeta(state.filmHandle)) || {}
+      : {};
+    const linkedCloudId = state.cloudProjectId || meta.cloudProjectId || null;
+    const isCloud = !!linkedCloudId;
+    let projectId = linkedCloudId;
     let projectName = state.filmHandle.name;
     if (!isCloud) {
       // window.prompt() в Electron подавлен — askName из board.js.
@@ -657,16 +714,12 @@
       const created = await r.json();
       projectId = created.id;
       state.cloudProjectId = projectId;
+    } else {
+      state.cloudProjectId = projectId;
     }
 
     PROGRESS.show('Сбор данных проекта…');
     try {
-      // Читаем .kingkont-meta.json — там лежат хеши (size+mtime) → cdnUrl
-      // для всех ранее загруженных файлов. Используем для dedup'а — не
-      // перезаливаем неизменённые файлы.
-      const meta = (typeof readProjectMeta === 'function')
-        ? (await readProjectMeta(state.filmHandle)) || {}
-        : {};
       const oldHashes = meta.fileHashes || {};
       const oldTextHashes = meta.textHashes || {};
       const newHashes = {};
@@ -681,6 +734,53 @@
       let uploaded = 0;
       let reused = 0;
 
+      // Pre-pass: один batch-запрос на ВСЕ изменённые text-ноды.
+      // Юзер: «сохраняй все текстовые ноды одним api-запросом».
+      // Раньше — N fetch'ей (один per .md). Cached-hits не отправляем.
+      const batchTextItems = [];
+      for (const board of allBoards) {
+        for (const f of board.mediaFiles) {
+          if (!f.fileHandle) continue;
+          if (!/\.md$/i.test(f.relPath)) continue;
+          const metaKey = `${board.kind}/${board.name}/${f.relPath}`;
+          try {
+            const file = await f.fileHandle.getFile();
+            const content = await file.text();
+            const cached = oldTextHashes[metaKey];
+            if (cached && cached.content === content && cached.textId) continue;
+            batchTextItems.push({
+              metaKey, relPath: f.relPath, content,
+              oldTextId: cached?.textId || null,
+            });
+          } catch {}
+        }
+      }
+      const textResultsByMetaKey = new Map();
+      if (batchTextItems.length) {
+        try {
+          const r = await fetch('/api/project-texts/batch-save', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+              items: batchTextItems.map(it => ({
+                id: it.oldTextId || undefined,
+                projectId, relPath: it.relPath, content: it.content,
+              })),
+            }),
+          });
+          if (r.ok) {
+            const { items: results = [] } = await r.json();
+            for (let i = 0; i < batchTextItems.length; i++) {
+              textResultsByMetaKey.set(batchTextItems[i].metaKey, results[i] || { error: 'no_result' });
+            }
+          } else {
+            console.warn(`[cloudProjects] batch-save ${r.status} → fallback на per-item`);
+          }
+        } catch (e) {
+          console.warn(`[cloudProjects] batch-save error:`, e?.message || e);
+        }
+      }
+
       for (const board of allBoards) {
         const sceneFile = await board.handle.getFileHandle('scene.json').catch(() => null);
         let scene = {};
@@ -707,8 +807,9 @@
           // автоматически, без обновления клиента.
           if (isMd) {
             const cachedText = oldTextHashes[metaKey];
-            // Dedup: size+mtime совпадают → переиспользуем textId, нет API-вызова.
-            if (cachedText && cachedText.size === file.size && cachedText.mtime === file.lastModified && cachedText.textId) {
+            const content = await file.text();
+            // Dedup hit (content не менялся) → переиспользуем textId.
+            if (cachedText && cachedText.content === content && cachedText.textId) {
               boardTexts[f.relPath] = cachedText.textId;
               newTextHashes[metaKey] = cachedText;
               reused++;
@@ -717,9 +818,19 @@
                 `[${board.kind}/${board.name}] ${f.relPath} (cached, ${uploaded}/${total})`);
               continue;
             }
+            // Batch-save уже отработал — используем готовый результат.
+            const bres = textResultsByMetaKey.get(metaKey);
+            if (bres && bres.id) {
+              boardTexts[f.relPath] = bres.id;
+              newTextHashes[metaKey] = { textId: bres.id, content };
+              uploaded++;
+              PROGRESS.update(uploaded, total,
+                `[${board.kind}/${board.name}] ${f.relPath} (batch, ${uploaded}/${total})`);
+              continue;
+            }
+            // Batch не сработал для этого item'а → per-item fallback (старый путь).
             PROGRESS.update(uploaded, total,
               `[${board.kind}/${board.name}] ${f.relPath} (text, ${uploaded + 1}/${total})`);
-            const content = await file.text();
             let textId = cachedText?.textId || null;
             let dbPathFailed = false;
             if (textId) {
@@ -757,7 +868,7 @@
             }
             if (textId) {
               boardTexts[f.relPath] = textId;
-              newTextHashes[metaKey] = { textId, size: file.size, mtime: file.lastModified };
+              newTextHashes[metaKey] = { textId, content };
               uploaded++;
               continue;
             }
@@ -766,18 +877,22 @@
 
           // ---- Бинарь → CDN через /api/upload. ----
           const cached = oldHashes[metaKey];
-          // Dedup: size + mtime совпадают → переиспользуем CDN-URL.
-          // (Это identifier «файл не менялся с момента последней синхронизации»;
-          //  неважно загружали мы его сами или скачали при openCloudProject.)
-          if (cached && cached.size === file.size && cached.mtime === file.lastModified) {
-            boardFiles[f.relPath] = cached.url;
-            allFilesIndex[metaKey] = cached.url;
-            newHashes[metaKey] = cached;
-            reused++;
-            uploaded++;
-            PROGRESS.update(uploaded, total,
-              `[${board.kind}/${board.name}] ${f.relPath} (cached, ${uploaded}/${total})`);
-            continue;
+          // Dedup: сначала быстрая проверка по size, потом content-hash.
+          // Mtime НЕ используем — Date.now() в JS не совпадает с OS-stamped
+          // mtime, после download/write валидные файлы выглядели как «новые».
+          let fhash = null;
+          if (cached && cached.size === file.size) {
+            fhash = await _quickFileHash(file);
+            if (cached.fhash === fhash) {
+              boardFiles[f.relPath] = cached.url;
+              allFilesIndex[metaKey] = cached.url;
+              newHashes[metaKey] = cached;
+              reused++;
+              uploaded++;
+              PROGRESS.update(uploaded, total,
+                `[${board.kind}/${board.name}] ${f.relPath} (cached, ${uploaded}/${total})`);
+              continue;
+            }
           }
           PROGRESS.update(uploaded, total,
             `[${board.kind}/${board.name}] ${f.relPath} (${uploaded + 1}/${total})`);
@@ -791,9 +906,10 @@
           });
           if (!r.ok) throw new Error(`upload ${f.relPath} failed: ${r.status}`);
           const j = await r.json();
+          if (!fhash) fhash = await _quickFileHash(file);
           boardFiles[f.relPath] = j.url;
           allFilesIndex[metaKey] = j.url;
-          newHashes[metaKey] = { url: j.url, size: file.size, mtime: file.lastModified };
+          newHashes[metaKey] = { url: j.url, size: file.size, fhash };
           uploaded++;
         }
         const boardEntry = { kind: board.kind, name: board.name, scene, files: boardFiles };
@@ -809,11 +925,16 @@
         const coverBlob = await readProjectCover(state.filmHandle);
         if (coverBlob) {
           const ch = meta.coverHash;
-          if (ch && ch.size === coverBlob.size && ch.mtime === coverBlob.lastModified && ch.url) {
-            // Cover не менялся — переиспользуем CDN-URL.
-            coverUrl = ch.url;
-            PROGRESS.update(uploaded, total, 'Обложка не менялась (cached)');
-          } else {
+          let coverFhash = null;
+          if (ch && ch.size === coverBlob.size && ch.url) {
+            coverFhash = await _quickFileHash(coverBlob);
+            if (ch.fhash === coverFhash) {
+              coverUrl = ch.url;
+              PROGRESS.update(uploaded, total, 'Обложка не менялась (cached)');
+              newCoverHash = ch;
+            }
+          }
+          if (!newCoverHash || newCoverHash !== ch) {
             PROGRESS.update(uploaded, total, 'Загрузка обложки…');
             const r = await fetch('/api/upload', {
               method: 'POST',
@@ -826,7 +947,8 @@
             if (r.ok) {
               const { url } = await r.json();
               coverUrl = url;
-              newCoverHash = { size: coverBlob.size, mtime: coverBlob.lastModified, url };
+              if (!coverFhash) coverFhash = await _quickFileHash(coverBlob);
+              newCoverHash = { size: coverBlob.size, fhash: coverFhash, url };
             }
           }
         }

package/renderer/settings.js

@@ -552,6 +552,23 @@ async function renderNodeBody(node, body) {
       playRow.appendChild(playBtn);
       body.appendChild(playRow);
     }
+    // Описание (опц.) — для image/video нод. Юзер: «под каждой нодой
+    // картинки или видео должно быть возможно добавить описание».
+    // Хранится в node.description (scene.json). Показываем всегда (даже
+    // пустым) — клик в textarea = начать писать.
+    if (node.type === 'image' || node.type === 'video') {
+      const desc = document.createElement('textarea');
+      desc.className = 'node-description';
+      desc.placeholder = 'Описание (опц.)';
+      desc.value = node.description || '';
+      desc.rows = 1;
+      desc.addEventListener('mousedown', e => e.stopPropagation());
+      desc.addEventListener('input', () => {
+        node.description = desc.value;
+        scheduleSave();
+      });
+      body.appendChild(desc);
+    }
   } else if (node.type === 'image' && !node.file && (node.generated?.rawPrompt || node.generated?.prompt)) {
     // Image-нода с промптом, но без файла (ещё не генерилась).
     // Кнопка ▶ Запустить — сверху (без декоративной 🖼-иконки и

package/renderer/styles.css

@@ -110,6 +110,19 @@
     width: 36px; height: 36px; flex-shrink: 0; object-fit: contain;
     background: #1a1a1a; border-radius: 8px; padding: 4px;
   }
+  /* Описание под image/video нодой. Auto-grow по содержимому. */
+  .node .node-description {
+    width: 100%; min-height: 28px; max-height: 120px;
+    margin-top: 6px; padding: 4px 6px;
+    background: #1e1e1e; color: #ccc;
+    border: 1px solid #333; border-radius: 3px;
+    font-family: inherit; font-size: 12px; line-height: 1.4;
+    resize: vertical; box-sizing: border-box;
+    outline: none;
+  }
+  .node .node-description:focus { border-color: #4a6a9a; }
+  .node .node-description::placeholder { color: #555; }
+
   /* Link-badge: значок 🔗 на ноде когда у неё есть linkedBoard. Лежит в
      правом-верхнем углу, кликабельный (= dblclick: открыть target-сцену).
      По умолчанию скрыт (display:none); refreshNodeLinkBadge показывает. */

package/server.js

@@ -518,6 +518,20 @@ async function handleProjectTextDelete(res, id) {
   } catch (e) { sendError(res, e, 502); }
 }
 
+// Batch endpoints — проксируют один запрос в chatium /project_texts~batch-*.
+async function handleProjectTextBatchGet(req, res) {
+  try {
+    const body = await readJson(req);                           // { ids: string[] }
+    send(res, 200, await providers.batchGetProjectTexts(body, getSettings()));
+  } catch (e) { sendError(res, e, 502); }
+}
+async function handleProjectTextBatchSave(req, res) {
+  try {
+    const body = await readJson(req);                           // { items: [...] }
+    send(res, 200, await providers.batchSaveProjectTexts(body, getSettings()));
+  } catch (e) { sendError(res, e, 502); }
+}
+
 // =============================================================================
 // Chat sessions: server-side LLM-loop с tool-pump pattern.
 // Клиент:  POST /api/chat/send {key, text, system}  → starts loop
@@ -753,6 +767,9 @@ async function _requestHandler(req, res) {
     // Project texts (.md контент). Отдельная таблица на сервере; клиент
     // ссылается на записи по id из manifest'а board.texts[relPath] = textId.
     if (req.method === 'POST' && url.pathname === '/api/project-texts') return handleProjectTextCreate(req, res);
+    // Batch-операции (отдельные роуты с одним fetch для N items).
+    if (req.method === 'POST' && url.pathname === '/api/project-texts/batch-get')  return handleProjectTextBatchGet(req, res);
+    if (req.method === 'POST' && url.pathname === '/api/project-texts/batch-save') return handleProjectTextBatchSave(req, res);
     {
       const m = url.pathname.match(/^\/api\/project-texts\/([^/]+)$/);
       if (m) {