kingkont 0.8.6 → 0.8.8

package/index.html

@@ -41,7 +41,7 @@
       <span>Сцены</span>
       <span style="display:flex; gap:4px;">
         <button id="newEpisode" disabled title="Создать сцену">+</button>
-        <button id="openTemplates" title="Открыть библиотеку шаблонов" style="font-size:12px;">📚</button>
+        <button id="openTemplates" title="Открыть библиотеку шаблонов" style="font-size:12px;">🎨</button>
       </span>
     </h3>
     <div class="sidebar-list" id="episodeList"></div>
@@ -238,8 +238,6 @@
   <button data-act="audio">🎙 Сгенерировать голос</button>
   <button data-act="image">🖼 Сгенерировать картинку</button>
   <button data-act="video">🎬 Сгенерировать видео</button>
-  <hr style="margin:4px 0; border:0; border-top:1px solid #333;">
-  <button data-act="save-template" title="Загрузить эту сцену как шаблон на сервер">💾 Сохранить сцену как шаблон</button>
 </div>
 
 <!-- ===== Settings modal (двойной клик на сгенерированную ноду) ===== -->

package/lib/providers.js

@@ -739,6 +739,21 @@ async function createTemplate(body, s) {
   return d;
 }
 
+async function updateTemplate(id, body, s) {
+  const headers = { ...chatiumAuthHeaders(s), 'Content-Type': 'application/json' };
+  // POST /templates~update?id=...
+  const url = `${chatiumBase(s)}${CHATIUM_PATHS.templates}~update?id=${encodeURIComponent(id)}`;
+  logCall('POST', 'Chatium', url,
+    `name=${body?.name} files=${Object.keys(body?.files || {}).length}`);
+  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 deleteTemplate(id, s) {
   const headers = chatiumAuthHeaders(s);
   // POST /templates~delete?id=... (Chatium-роутер не уважает HTTP DELETE
@@ -791,6 +806,7 @@ module.exports = {
   listTemplates,
   getTemplate,
   createTemplate,
+  updateTemplate,
   deleteTemplate,
   // Constants (для server.js / тестов)
   KIE_IMAGE_MODELS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "description": "KingKont · Chatium — нод-редактор сцен с AI-генерацией (картинки/видео/голос/SFX/музыка/текст)",
   "main": "main.js",
   "bin": {

package/renderer/board.js

@@ -100,6 +100,14 @@ window.addEventListener('DOMContentLoaded', async () => {
   };
   document.getElementById('brandLogo')?.addEventListener('dblclick', openSettingsFromLogo);
   document.getElementById('welcomeLogo')?.addEventListener('dblclick', openSettingsFromLogo);
+  // ПКМ на brand-area (sidebar header) — действия проектного уровня
+  // (сохранить как шаблон / обновить шаблон).
+  document.querySelector('.brand')?.addEventListener('contextmenu', e => {
+    if (!state.filmHandle) return;
+    e.preventDefault();
+    e.stopPropagation();
+    showProjectContextMenu(e.clientX, e.clientY);
+  });
 
   // Версия приложения на welcome-экране и в шапке проекта (после слова
   // "KingKont"). appInfo.version() — IPC к main → app.getVersion().
@@ -374,6 +382,35 @@ async function renderWelcomeRecents() {
   openCard.addEventListener('click', () => $('pickRoot').click());
   grid.appendChild(openCard);
 
+  // Сразу за «Открыть проект» — карточка «Шаблоны» (открывает библиотеку
+  // шаблонов с серверa). Стиль такой же как у open-card — иконка + meta.
+  const tplCard = document.createElement('div');
+  tplCard.className = 'welcome-card open-card';
+  const tplThumb = document.createElement('div');
+  tplThumb.className = 'welcome-card-thumb';
+  // Своя картинка-обложка для карточки «Шаблоны» (assets/templates.jpg).
+  // Если не загрузится — fallback на 🎨.
+  const tplThumbImg = document.createElement('img');
+  tplThumbImg.src = 'assets/templates.jpg';
+  tplThumbImg.alt = '';
+  tplThumbImg.draggable = false;
+  tplThumbImg.onerror = () => { tplThumb.textContent = '🎨'; tplThumbImg.remove(); };
+  tplThumb.appendChild(tplThumbImg);
+  const tplMeta = document.createElement('div');
+  tplMeta.className = 'welcome-card-meta';
+  const tplName = document.createElement('div');
+  tplName.className = 'welcome-card-name';
+  tplName.textContent = 'Шаблоны';
+  const tplSub = document.createElement('div');
+  tplSub.className = 'welcome-card-ts';
+  tplSub.textContent = 'библиотека на сервере';
+  tplMeta.append(tplName, tplSub);
+  tplCard.append(tplThumb, tplMeta);
+  tplCard.addEventListener('click', () => {
+    if (typeof openTemplatesWindow === 'function') openTemplatesWindow();
+  });
+  grid.appendChild(tplCard);
+
   // Title меняем в зависимости от наличия recents.
   if (titleEl) titleEl.textContent = list.length ? 'Открыть проект · недавние' : 'Открыть проект';
 
@@ -757,6 +794,21 @@ function showBoardContextMenu(kind, item, clientX, clientY) {
       selectBoard({ kind, ...item }).then(() => openCharacterSettings()).catch(() => {});
     });
   }
+  // Сохранение этого board'а как шаблон. saveCurrentBoardAsTemplate
+  // работает с state.currentBoard, поэтому сначала открываем нужный
+  // board (если он не текущий), а затем запускаем сохранение.
+  add('💾 Сохранить как шаблон', async () => {
+    try {
+      if (!state.currentBoard || state.currentBoard.kind !== kind || state.currentBoard.name !== item.name) {
+        await selectBoard({ kind, ...item });
+      }
+      if (typeof saveCurrentBoardAsTemplate === 'function') {
+        await saveCurrentBoardAsTemplate();
+      }
+    } catch (e) {
+      alert('Не удалось сохранить как шаблон: ' + (e?.message || e));
+    }
+  });
   add('🗑 Удалить', async () => {
     if (!confirm(`Удалить «${item.name}»? Папка переедет в _deleted, Cmd+Z восстановит.`)) return;
     try { await deleteBoard(kind, item.name); }
@@ -1992,6 +2044,29 @@ function showNodeContextMenu(node, clientX, clientY) {
   setTimeout(() => document.addEventListener('mousedown', closeNodeMenu, { once: true }), 0);
 }
 
+// ПКМ на brand-area sidebar — действия с проектом (сохранить как шаблон).
+// Показывает «Создать новый шаблон» всегда, и «Обновить «X»» если проект
+// был открыт из шаблона юзера (см. saveCurrentProjectAsTemplate — он сам
+// определит mode по .kingkont-meta.json).
+function showProjectContextMenu(clientX, clientY) {
+  const menu = $('nodeMenu');
+  menu.innerHTML = '';
+  const add = (label, fn) => {
+    const b = document.createElement('button');
+    b.textContent = label;
+    b.addEventListener('click', () => {
+      menu.classList.add('hidden');
+      fn();
+    });
+    menu.appendChild(b);
+  };
+  add('💾 Сохранить как шаблон…', () => {
+    if (typeof saveCurrentProjectAsTemplate === 'function') saveCurrentProjectAsTemplate();
+  });
+  positionFloatingMenu(menu, clientX, clientY);
+  setTimeout(() => document.addEventListener('mousedown', closeNodeMenu, { once: true }), 0);
+}
+
 // ПКМ на 📚 Templates-кнопке — действия проектного уровня.
 function showTemplatesButtonContextMenu(clientX, clientY) {
   const menu = $('nodeMenu');

package/renderer/generate.js

@@ -158,18 +158,11 @@ document.querySelectorAll('#addMenu button').forEach(btn => {
       state.addMenuPos = null;
       return;
     }
-    if (act === 'save-template') {
-      // Сохранение всей сцены как шаблона на Chatium-сервер.
-      // saveCurrentBoardAsTemplate сам откроет templates-модалку (для
-      // прогресс-бара) и обновит список после успешного upload'а.
-      state.addMenuPos = null;
-      if (typeof saveCurrentBoardAsTemplate === 'function') {
-        await saveCurrentBoardAsTemplate();
-      }
-      return;
-    }
-    // save-project-template вынесен на ПКМ 📚 Templates-кнопки
-    // (см. board.js: showTemplatesButtonContextMenu).
+    // save-template actions перенесены:
+    //   • «Сохранить сцену как шаблон» — ПКМ на board-item в sidebar
+    //     (см. showBoardContextMenu в board.js)
+    //   • «Сохранить проект как шаблон» — ПКМ на 📚 Templates-кнопке
+    //     (см. showTemplatesButtonContextMenu в board.js)
     if (act === 'gen-text') {
       // открываем text-gen modal; если есть fromNode — подставляем @ref в промпт
       if (!await ensureApiKey('text')) return;

package/renderer/settings.js

@@ -347,6 +347,15 @@ async function renderNodeBody(node, body) {
     if (nodeEl) { _mediaHydrationObserver.unobserve(nodeEl); nodeEl.__hydrate = null; }
 
     if (node.type === 'audio') {
+      // Промпт (текст TTS) виден всегда — даже после генерации. Юзер
+      // должен понимать что говорит голос без открытия Settings-modal'я.
+      const promptText = node.generated?.rawPrompt || node.generated?.prompt;
+      if (promptText) {
+        const pp = document.createElement('div');
+        pp.className = 'audio-prompt';
+        pp.textContent = promptText;
+        body.appendChild(pp);
+      }
       const fname = document.createElement('div');
       fname.className = 'filename';
       fname.textContent = node.file;
@@ -416,7 +425,20 @@ async function renderNodeBody(node, body) {
           // Раньше "metadata" грузил chunk для duration/dimensions с каждой ноды на selectBoard.
           media.preload = 'none';
         }
-        media.addEventListener('mousedown', e => e.stopPropagation());
+        // Click на media-элементе = выбрать ноду (как клик по header'у).
+        // НЕ делаем preventDefault — иначе сломаются нативные video-controls
+        // (play/pause/seek). stopPropagation чтобы не запустился rubber-band
+        // селектор холста.
+        media.addEventListener('mousedown', e => {
+          e.stopPropagation();
+          if (e.metaKey || e.ctrlKey || e.shiftKey) {
+            toggleSelection(node.id);
+          } else if (!state.selectedNodeIds.has(node.id)) {
+            clearSelection();
+            state.selectedNodeIds.add(node.id);
+          }
+          renderSelection();
+        });
         // Заменяем placeholder ИЛИ ранее показанный thumbnail
         const target = (nodeEl && nodeEl.__thumbEl && nodeEl.__thumbEl.parentNode)
                      ? nodeEl.__thumbEl
@@ -497,6 +519,23 @@ async function renderNodeBody(node, body) {
       playRow.appendChild(playBtn);
       body.appendChild(playRow);
     }
+  } else if (node.type === 'image' && !node.file && (node.generated?.rawPrompt || node.generated?.prompt)) {
+    // Fallback: image-нода с промптом, но без файла (ещё не генерилась
+    // и status != 'draft'). Показываем preview-блок чтобы юзер видел
+    // что собирается генерироваться.
+    const wrap = document.createElement('div');
+    wrap.className = 'gen-pending';
+    const ic = document.createElement('div');
+    ic.style.cssText = 'font-size:36px; opacity:0.7;';
+    ic.textContent = '🖼';
+    const st = document.createElement('div');
+    st.className = 'state-text';
+    st.textContent = 'Не сгенерировано — открой ↻ для запуска';
+    const pp = document.createElement('div');
+    pp.className = 'prompt-preview';
+    pp.textContent = node.generated?.rawPrompt || node.generated?.prompt || '';
+    wrap.append(ic, st, pp);
+    body.appendChild(wrap);
   }
 }
 

package/renderer/styles.css

@@ -230,15 +230,18 @@
     margin-bottom: 14px; text-align: center;
     flex-shrink: 0;
   }
-  /* Recents в горизонтальную ленту со скроллом. Карточки фиксированной
-     ширины чтобы scroll работал предсказуемо. */
+  /* Recents — плитка (responsive grid). Карточки фиксированной ширины,
+     заполняют ряд слева направо, при нехватке места переносятся. Скроллится
+     вертикально, если карточек много. */
   .welcome-recent-grid {
-    display: flex; flex-direction: row; gap: 16px;
-    overflow-x: auto; overflow-y: hidden;
-    padding: 8px 32px 24px;
-    scroll-snap-type: x proximity;
-  }
-  .welcome-recent-grid::-webkit-scrollbar { height: 8px; }
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+    gap: 16px;
+    overflow-y: auto; overflow-x: hidden;
+    padding: 8px 52px 24px;
+    align-content: start;
+  }
+  .welcome-recent-grid::-webkit-scrollbar { width: 8px; }
 
   /* === Глобальные dark-scrollbars === */
   /* Firefox */
@@ -257,8 +260,9 @@
     background: #232323; border: 1px solid #333; border-radius: 8px;
     overflow: hidden; cursor: pointer; transition: border-color 0.12s, transform 0.12s;
     display: flex; flex-direction: column;
-    width: 240px; flex-shrink: 0;
-    scroll-snap-align: start;
+    /* Grid-layout: ширина задаётся grid-column'ом (responsive),
+       fixed-width убран. position:relative нужен для absolute-расположенного × delete. */
+    position: relative;
   }
   /* Карточка «Открыть проект» — стилизована под обычную recent-карточку,
      но контент не превью, а большая иконка + надпись. */
@@ -1237,8 +1241,20 @@
     background: #141414;
   }
   .gen-pending .prompt-preview {
-    font-size: 11px; color: #aaa; line-height: 1.4; text-align: center;
-    max-height: 60px; overflow-y: auto; word-break: break-word;
+    font-size: 12px; color: #bbb; line-height: 1.4; text-align: center;
+    /* Большой max-height — на нодах побольше виден весь промпт; на маленьких
+       — обрезается со скроллом. Раньше было 60px (~3 строки) — мало. */
+    max-height: 240px; overflow-y: auto; word-break: break-word;
+    width: 100%;
+  }
+  /* Промпт под filename аудио-ноды (постоянно — даже после генерации).
+     Для TTS юзеру важно видеть текст без открытия Settings-modal'я. */
+  .node-body .audio-prompt {
+    font-size: 11px; color: #aaa; line-height: 1.4;
+    margin: 4px 0 6px;
+    max-height: 80px; overflow-y: auto; word-break: break-word;
+    background: #1a1a1a; padding: 6px 8px; border-radius: 4px;
+    border: 1px solid #2a2a2a;
   }
   .gen-pending .state-text { font-size: 11px; color: #888; }
   .gen-error {

package/renderer/templates.js

@@ -21,21 +21,60 @@
 //   5. Записать scene.json
 //   6. selectBoard(новый board)
 
+// Прогресс upload/download шаблонов. Дублирует значение в двух местах:
+// (а) штатный прогресс-бар внутри templates-модалки — виден когда юзер
+//     активно работает с библиотекой; (б) фиксированный toast в верху
+//     экрана — виден всегда, в т.ч. когда юзер открыл шаблон проекта
+//     с welcome-screen и templates-модалка не открыта.
 const TPL_PROGRESS = {
   el: () => document.getElementById('tplProgress'),
   label: () => document.getElementById('tplProgressLabel'),
   bar: () => document.getElementById('tplProgressBar'),
+  toast: () => {
+    let t = document.getElementById('tplToast');
+    if (t) return t;
+    // Лениво создаём toast — div поверх всего, fixed top-center.
+    t = document.createElement('div');
+    t.id = 'tplToast';
+    t.style.cssText =
+      'position:fixed; top:16px; left:50%; transform:translateX(-50%);' +
+      'background:#1a1a1a; border:1px solid #3a3a3a; border-radius:8px;' +
+      'padding:10px 14px; box-shadow:0 8px 28px rgba(0,0,0,0.6);' +
+      'z-index:99999; min-width:340px; max-width:600px; display:none;';
+    t.innerHTML =
+      '<div id="tplToastLabel" style="font-size:12px; color:#ddd; margin-bottom:6px;"></div>' +
+      '<div style="width:100%; height:6px; background:#333; border-radius:3px; overflow:hidden;">' +
+      '<div id="tplToastBar" style="width:0; height:100%; background:#3a5a8a; transition:width 0.2s;"></div>' +
+      '</div>';
+    document.body.appendChild(t);
+    return t;
+  },
   show(label) {
-    TPL_PROGRESS.el().classList.remove('hidden');
-    TPL_PROGRESS.label().textContent = label;
-    TPL_PROGRESS.bar().style.width = '0%';
+    if (TPL_PROGRESS.el()) {
+      TPL_PROGRESS.el().classList.remove('hidden');
+      TPL_PROGRESS.label().textContent = label;
+      TPL_PROGRESS.bar().style.width = '0%';
+    }
+    const t = TPL_PROGRESS.toast();
+    t.style.display = 'block';
+    document.getElementById('tplToastLabel').textContent = label;
+    document.getElementById('tplToastBar').style.width = '0%';
   },
   update(done, total, label) {
-    if (label) TPL_PROGRESS.label().textContent = label;
     const pct = total > 0 ? Math.round((done / total) * 100) : 0;
-    TPL_PROGRESS.bar().style.width = pct + '%';
+    if (TPL_PROGRESS.el()) {
+      if (label) TPL_PROGRESS.label().textContent = label;
+      TPL_PROGRESS.bar().style.width = pct + '%';
+    }
+    const t = TPL_PROGRESS.toast();
+    if (label) document.getElementById('tplToastLabel').textContent = label;
+    document.getElementById('tplToastBar').style.width = pct + '%';
+  },
+  hide() {
+    if (TPL_PROGRESS.el()) TPL_PROGRESS.el().classList.add('hidden');
+    const t = document.getElementById('tplToast');
+    if (t) t.style.display = 'none';
   },
-  hide() { TPL_PROGRESS.el().classList.add('hidden'); },
 };
 
 function tplStatus(msg, isError) {
@@ -77,7 +116,13 @@ async function refreshTemplatesList() {
       throw new Error(err.error || `HTTP ${r.status}`);
     }
     const data = await r.json();
-    const items = Array.isArray(data) ? data : (data.items || data.templates || []);
+    let items = Array.isArray(data) ? data : (data.items || data.templates || []);
+    // Когда проект открыт — модалка работает в режиме «добавить сцену»;
+    // project-шаблоны не имеют смысла (они создают новый проект, не
+    // добавляют board в текущий). Скрываем их из списка.
+    if (state.filmHandle) {
+      items = items.filter(t => t.kind !== 'project');
+    }
     renderTemplatesList(items);
   } catch (e) {
     list.innerHTML = '';
@@ -135,18 +180,27 @@ function renderTemplatesList(items) {
       openBtn.title = 'Выбрать папку и развернуть в неё проект';
       openBtn.addEventListener('click', () => openProjectTemplate(t.id, t.name));
     } else {
-      openBtn.disabled = !state.filmHandle;
-      openBtn.title = state.filmHandle ? 'Скачать локально и открыть как новую сцену' : 'Сначала открой проект';
+      // Scene-templates: при открытом проекте — добавляются board'ом внутрь;
+      // без проекта (welcome-screen) — создаётся новый проект с одной этой
+      // сценой (см. openTemplate: ветка createdNewProject).
+      openBtn.disabled = false;
+      openBtn.title = state.filmHandle
+        ? 'Скачать локально и открыть как новую сцену'
+        : 'Создать новый проект с этой сценой';
       openBtn.addEventListener('click', () => openTemplate(t.id, t.name));
     }
 
-    const delBtn = document.createElement('button');
-    delBtn.className = 'danger';
-    delBtn.textContent = '🗑';
-    delBtn.title = 'Удалить шаблон';
-    delBtn.addEventListener('click', () => deleteTemplateConfirm(t.id, t.name));
-
-    card.append(info, openBtn, delBtn);
+    card.append(info, openBtn);
+    // Корзина — для своих шаблонов и для админов (canModify приходит с
+    // сервера, см. canModifyTemplate в spaces/server/api/templates.ts).
+    if (t.canModify || t.mine) {
+      const delBtn = document.createElement('button');
+      delBtn.className = 'danger';
+      delBtn.textContent = '🗑';
+      delBtn.title = t.mine ? 'Удалить свой шаблон' : 'Удалить шаблон (admin)';
+      delBtn.addEventListener('click', () => deleteTemplateConfirm(t.id, t.name));
+      card.appendChild(delBtn);
+    }
     list.appendChild(card);
   }
 }
@@ -272,9 +326,42 @@ async function saveCurrentProjectAsTemplate() {
     alert('Сначала открой проект');
     return;
   }
-  const defaultName = state.filmHandle.name || 'Проект';
-  const name = await askName('Имя шаблона проекта:', defaultName, defaultName, { okText: 'Сохранить' });
-  if (!name) return;
+
+  // Меta — может содержать templateId (если проект из шаблона) и fileHashes.
+  const meta = (await readProjectMeta(state.filmHandle)) || {};
+
+  // Если проект из шаблона + юзер автор (или админ) → предлагаем выбор.
+  // canModify приходит с сервера: ownerId === userId OR ctx.account.is('Admin').
+  let updateExisting = null; // template object или null
+  if (meta.templateId) {
+    try {
+      const r = await fetch(`/api/templates/${encodeURIComponent(meta.templateId)}`);
+      if (r.ok) {
+        const tpl = await r.json();
+        if (tpl.canModify) updateExisting = tpl;
+      }
+    } catch {}
+  }
+
+  let mode = 'create'; // 'create' | 'update'
+  let name;
+  if (updateExisting) {
+    const choice = await askChoice(
+      'Сохранить шаблон проекта',
+      [`Обновить «${updateExisting.name}»`, 'Создать новый шаблон'],
+      `Обновить «${updateExisting.name}»`,
+    );
+    if (!choice) return;
+    if (choice.startsWith('Обновить')) {
+      mode = 'update';
+      name = updateExisting.name;
+    }
+  }
+  if (mode === 'create') {
+    const defaultName = state.filmHandle.name || 'Проект';
+    name = await askName('Имя шаблона проекта:', defaultName, defaultName, { okText: 'Сохранить' });
+    if (!name) return;
+  }
 
   const modal = document.getElementById('templatesModal');
   if (modal) modal.classList.remove('hidden');
@@ -284,33 +371,43 @@ async function saveCurrentProjectAsTemplate() {
   tplStatus('');
 
   try {
-    // 1. Собираем все board'ы (characters / locations / episodes).
+    // 1. Собираем все board'ы.
     const allBoards = await collectProjectBoards(state.filmHandle);
     if (!allBoards.length) {
       throw new Error('В проекте нет ни одной сцены/персонажа/локации');
     }
 
-    // 2. Считаем общее число файлов для прогресса.
     const totalFiles = allBoards.reduce((sum, b) => sum + b.mediaFiles.length, 0);
     let uploadedTotal = 0;
+    let reusedTotal = 0; // dedup'нутые из meta.fileHashes
+    const oldHashes = meta.fileHashes || {};
+    const newHashes = {}; // обновлённый кэш для записи обратно в meta
 
-    // 3. Для каждого board'а — читаем manifest, загружаем файлы, копим
-    //    структуру { kind, name, manifest, files: {relPath: cdnUrl} }.
+    // 2. Для каждого board'а — собираем boardsPayload с files map.
     const boardsPayload = [];
     for (const b of allBoards) {
       let manifest = {};
       try {
         const sceneFh = await b.handle.getFileHandle('scene.json');
         manifest = JSON.parse(await (await sceneFh.getFile()).text());
-      } catch {
-        // Без scene.json пропускаем — это не board.
-        continue;
-      }
+      } catch { continue; }
       const filesMap = {};
       for (const f of b.mediaFiles) {
+        const blob = await f.fileHandle.getFile();
+        const metaKey = `${b.kind}/${b.name}/${f.relPath}`;
+        const cached = oldHashes[metaKey];
+        // Dedup: если файл не менялся (size + mtime совпадают) — переиспользуем CDN-URL.
+        if (cached && cached.size === blob.size && cached.mtime === blob.lastModified) {
+          filesMap[f.relPath] = cached.url;
+          newHashes[metaKey] = cached;
+          reusedTotal++;
+          uploadedTotal++;
+          TPL_PROGRESS.update(uploadedTotal, totalFiles,
+            `[${b.kind}/${b.name}] ${f.relPath} (cached, ${uploadedTotal}/${totalFiles})`);
+          continue;
+        }
         TPL_PROGRESS.update(uploadedTotal, totalFiles,
           `[${b.kind}/${b.name}] ${f.relPath} (${uploadedTotal + 1}/${totalFiles})`);
-        const blob = await f.fileHandle.getFile();
         const r = await fetch('/api/upload', {
           method: 'POST',
           headers: {
@@ -325,42 +422,68 @@ async function saveCurrentProjectAsTemplate() {
         }
         const { url } = await r.json();
         filesMap[f.relPath] = url;
+        newHashes[metaKey] = { url, size: blob.size, mtime: blob.lastModified };
         uploadedTotal++;
       }
-      boardsPayload.push({
-        kind: b.kind,
-        name: b.name,
-        manifest,
-        files: filesMap,
-      });
+      boardsPayload.push({ kind: b.kind, name: b.name, manifest, files: filesMap });
     }
 
     TPL_PROGRESS.update(uploadedTotal, totalFiles, 'Загрузка обложки…');
     const coverUrl = await uploadProjectCoverIfAny();
-    TPL_PROGRESS.update(uploadedTotal, totalFiles, 'Регистрация шаблона проекта…');
 
-    // 4. POST /api/templates с kind='project' и manifest.boards = [...].
-    const r = await fetch('/api/templates', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        name,
-        kind: 'project',
-        manifest: {
-          boards: boardsPayload,
-          projectName: state.filmHandle.name,
-          ...(coverUrl ? { coverUrl } : {}),
-        },
-        files: {},  // всё внутри manifest.boards[i].files
-      }),
-    });
-    if (!r.ok) {
-      const err = await r.json().catch(() => ({}));
-      throw new Error(err.error || `HTTP ${r.status}`);
+    const body = {
+      name,
+      kind: 'project',
+      manifest: {
+        boards: boardsPayload,
+        projectName: state.filmHandle.name,
+        ...(coverUrl ? { coverUrl } : {}),
+      },
+      files: {},
+    };
+
+    let resultId;
+    if (mode === 'update') {
+      TPL_PROGRESS.update(uploadedTotal, totalFiles, `Обновление «${updateExisting.name}»…`);
+      const r = await fetch(`/api/templates/${encodeURIComponent(updateExisting.id)}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+      });
+      if (!r.ok) {
+        const err = await r.json().catch(() => ({}));
+        throw new Error(err.error || `HTTP ${r.status}`);
+      }
+      resultId = updateExisting.id;
+    } else {
+      TPL_PROGRESS.update(uploadedTotal, totalFiles, 'Регистрация шаблона проекта…');
+      const r = await fetch('/api/templates', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+      });
+      if (!r.ok) {
+        const err = await r.json().catch(() => ({}));
+        throw new Error(err.error || `HTTP ${r.status}`);
+      }
+      const created = await r.json();
+      resultId = created.id;
     }
 
+    // Обновляем meta-файл — сохраняем новый templateId (или подтверждаем
+    // существующий) + актуальный fileHashes для следующего save.
+    await writeProjectMeta(state.filmHandle, {
+      version: 1,
+      templateId: resultId,
+      templateName: name,
+      savedAt: Date.now(),
+      fileHashes: newHashes,
+    });
+
     TPL_PROGRESS.hide();
-    tplStatus(`Шаблон проекта «${name}» сохранён (${allBoards.length} board'ов, ${totalFiles} файл${totalFiles === 1 ? '' : 'ов'})`);
+    const reusedNote = reusedTotal ? `, ${reusedTotal} переиспользовано из кэша` : '';
+    const action = mode === 'update' ? 'обновлён' : 'сохранён';
+    tplStatus(`Шаблон проекта «${name}» ${action} (${allBoards.length} board'ов, ${totalFiles} файл${totalFiles === 1 ? '' : 'ов'}${reusedNote})`);
     await refreshTemplatesList();
   } catch (e) {
     TPL_PROGRESS.hide();
@@ -411,20 +534,58 @@ async function collectProjectBoards(filmHandle) {
   return validBoards;
 }
 
+// Guard от повторного входа: showDirectoryPicker валится с
+// «File picker already active» если юзер быстро кликнул карточку
+// дважды или если предыдущий picker ещё не закрылся.
+let _openProjectTplInFlight = false;
+
+// =================== Meta-файл проекта ===================
+// `<project>/.kingkont-meta.json` хранит:
+//   { templateId, templateName, fileHashes: { relPath: { url, size, mtime } } }
+// Используется для:
+//   • проверки «можно ли обновить шаблон» (templateId известен)
+//   • dedup-а при повторной заливке (если файл не менялся — переиспользуем
+//     CDN-URL вместо загрузки)
+const META_FILE = '.kingkont-meta.json';
+
+async function readProjectMeta(filmHandle) {
+  if (!filmHandle) return null;
+  try {
+    const fh = await filmHandle.getFileHandle(META_FILE);
+    const txt = await (await fh.getFile()).text();
+    return JSON.parse(txt);
+  } catch { return null; }
+}
+
+async function writeProjectMeta(filmHandle, meta) {
+  if (!filmHandle) return;
+  try {
+    const fh = await filmHandle.getFileHandle(META_FILE, { create: true });
+    const w = await fh.createWritable();
+    await w.write(JSON.stringify(meta, null, 2));
+    await w.close();
+  } catch (e) {
+    console.warn('writeProjectMeta failed:', e?.message || e);
+  }
+}
+
 // =================== Open project template ===================
 // Просим юзера выбрать parent-папку. Создаём в ней новую папку с именем
 // проекта. Скачиваем все boards со всеми files. Открываем filmHandle.
 async function openProjectTemplate(templateId, suggestedName) {
+  if (_openProjectTplInFlight) return;
   if (typeof window.showDirectoryPicker !== 'function') {
     alert('Браузер не поддерживает выбор папки. Открой проект через File-System-Access.');
     return;
   }
 
+  _openProjectTplInFlight = true;
   // 1. Парент-папка от юзера.
   let parentHandle;
   try {
     parentHandle = await window.showDirectoryPicker({ mode: 'readwrite' });
   } catch (e) {
+    _openProjectTplInFlight = false;
     if (e.name === 'AbortError') return; // юзер закрыл диалог
     alert('Не удалось выбрать папку: ' + e.message);
     return;
@@ -437,7 +598,7 @@ async function openProjectTemplate(templateId, suggestedName) {
     suggestedName || '',
     { okText: 'Создать и открыть' },
   );
-  if (!projectName) return;
+  if (!projectName) { _openProjectTplInFlight = false; return; }
 
   TPL_PROGRESS.show('Получение шаблона…');
   tplStatus('');
@@ -461,6 +622,9 @@ async function openProjectTemplate(templateId, suggestedName) {
     let downloadedTotal = 0;
 
     // 5. Для каждого board'а — создаём папку, качаем файлы, пишем scene.json.
+    // По ходу собираем fileHashes для meta — `<kind>/<board>/<relPath>` → cdnUrl.
+    // (size/mtime читаем из созданного файла после write — нужно для dedup.)
+    const fileHashes = {};
     for (const b of boards) {
       let parent = filmHandle;
       if (b.kind === 'character') {
@@ -479,12 +643,31 @@ async function openProjectTemplate(templateId, suggestedName) {
         if (!fr.ok) throw new Error(`download ${b.name}/${relPath}: HTTP ${fr.status}`);
         const buf = await fr.arrayBuffer();
         await writeBoardFile(boardHandle, relPath, new Uint8Array(buf));
+        // Запомним size+mtime для dedup'а при следующем save.
+        try {
+          const parts = relPath.split('/');
+          let dh = boardHandle;
+          for (let i = 0; i < parts.length - 1; i++) dh = await dh.getDirectoryHandle(parts[i]);
+          const fh = await dh.getFileHandle(parts[parts.length - 1]);
+          const f = await fh.getFile();
+          const key = `${b.kind}/${b.name}/${relPath}`;
+          fileHashes[key] = { url: cdnUrl, size: f.size, mtime: f.lastModified };
+        } catch {}
         downloadedTotal++;
       }
       // scene.json — manifest board'а.
       await writeBoardFile(boardHandle, 'scene.json', JSON.stringify(b.manifest || {}, null, 2));
     }
 
+    // Meta: запоминаем шаблон-источник + размеры/мтайм всех файлов для dedup'а.
+    await writeProjectMeta(filmHandle, {
+      version: 1,
+      templateId: tpl.id,
+      templateName: tpl.name || '',
+      downloadedAt: Date.now(),
+      fileHashes,
+    });
+
     // 6. Открываем созданный проект.
     TPL_PROGRESS.update(totalFiles, totalFiles, 'Открытие проекта…');
     // Чистим stale lastBoard:<name> — иначе если у юзера раньше был
@@ -513,20 +696,59 @@ async function openProjectTemplate(templateId, suggestedName) {
     TPL_PROGRESS.hide();
     tplStatus('Ошибка открытия проекта: ' + e.message, true);
     console.error('open project template failed', e);
+  } finally {
+    _openProjectTplInFlight = false;
   }
 }
 
 // =================== Open template (download all files + create board) ===================
+// Если есть открытый проект — board создаётся внутри него.
+// Если проекта нет (welcome-screen) — просим выбрать parent-папку, создаём
+// новый проект с одной сценой/персонажем/локацией из шаблона, открываем.
 async function openTemplate(templateId, suggestedName) {
-  if (!state.filmHandle) { alert('Сначала открой проект'); return; }
+  // Welcome-flow: создаём новый проект под одну сцену.
+  let createdNewProject = false;
+  if (!state.filmHandle) {
+    if (typeof window.showDirectoryPicker !== 'function') {
+      alert('Браузер не поддерживает выбор папки.'); return;
+    }
+    let parentHandle;
+    try {
+      parentHandle = await window.showDirectoryPicker({ mode: 'readwrite' });
+    } catch (e) {
+      if (e.name === 'AbortError') return;
+      alert('Не удалось выбрать папку: ' + e.message);
+      return;
+    }
+    const projectName = await askName(
+      'Имя нового проекта:',
+      suggestedName || 'Из шаблона',
+      suggestedName || '',
+      { okText: 'Создать' },
+    );
+    if (!projectName) return;
+    try {
+      const filmHandle = await parentHandle.getDirectoryHandle(projectName, { create: true });
+      try { localStorage.removeItem(`lastBoard:${projectName}`); } catch {}
+      await openFilm(filmHandle);
+      createdNewProject = true;
+    } catch (e) {
+      alert('Не удалось создать папку проекта: ' + e.message);
+      return;
+    }
+  }
 
   // 1. Спросить имя нового board'а в текущем проекте.
-  const name = await askName(
-    'Имя для скачанной сцены:',
-    suggestedName || 'из шаблона',
-    suggestedName || '',
-    { okText: 'Скачать и открыть' },
-  );
+  // Если только что создали проект — имя сцены берём из шаблона без вопроса
+  // (юзер уже задал имя проекта, лишний диалог раздражает).
+  const name = createdNewProject
+    ? (suggestedName || 'Сцена 1')
+    : await askName(
+        'Имя для скачанной сцены:',
+        suggestedName || 'из шаблона',
+        suggestedName || '',
+        { okText: 'Скачать и открыть' },
+      );
   if (!name) return;
 
   TPL_PROGRESS.show('Получение шаблона…');

package/server.js

@@ -245,6 +245,13 @@ async function handleTemplateDelete(res, id) {
   } catch (e) { sendError(res, e, 502); }
 }
 
+async function handleTemplateUpdate(req, res, id) {
+  try {
+    const body = await readJson(req);
+    send(res, 200, await providers.updateTemplate(id, body, getSettings()));
+  } catch (e) { sendError(res, e, 502); }
+}
+
 // =============================================================================
 // Static files (renderer assets).
 // =============================================================================
@@ -290,6 +297,7 @@ const server = createServer(async (req, res) => {
       const m = url.pathname.match(/^\/api\/templates\/([^/]+)$/);
       if (m) {
         if (req.method === 'GET')    return handleTemplateGet(res, decodeURIComponent(m[1]));
+        if (req.method === 'POST')   return handleTemplateUpdate(req, res, decodeURIComponent(m[1]));
         if (req.method === 'DELETE') return handleTemplateDelete(res, decodeURIComponent(m[1]));
       }
     }

package/skill/SKILL.md

@@ -132,6 +132,115 @@ Backward-compat: если в scene.json остался старый формат
 `settings.defaultPrompts: { image: "..." }` — CLI и UI конвертируют
 его в массив на лету; следующее сохранение перепишет в новый формат.
 
+#### Когда заполнять defaultPrompts по умолчанию
+
+Если юзер описывает сцену **как кадр фильма/сериала/последовательности** —
+сразу при создании сцены пропиши в `defaultPrompts` визуальный стиль кадров.
+Это сэкономит юзеру тонну ручного ввода и сохранит консистентность всех
+генераций в сцене.
+
+Что добавлять (зависит от описания):
+
+- **Технические характеристики камеры**: «35mm film», «70mm IMAX», «shot
+  on Arri Alexa», «handheld camera», «steadicam», «drone shot», «macro
+  lens», «anamorphic lens (cinematic widescreen with horizontal lens
+  flares)».
+- **Освещение**: «natural daylight», «golden hour», «overcast soft
+  lighting», «harsh midday sun», «cinematic three-point lighting»,
+  «practical sources only», «moody low-key lighting», «high-key bright»,
+  «neon accents».
+- **Композиция и план**: «wide establishing shot», «medium close-up»,
+  «extreme close-up», «over-the-shoulder», «Dutch angle», «symmetrical
+  Wes-Anderson framing», «rule of thirds».
+- **Цветовая палитра / grading**: «teal and orange», «desaturated muted
+  tones», «vintage Kodachrome», «cold blue tint», «warm sepia», «black
+  and white high contrast».
+- **Жанровый/режиссёрский референс**: «in the style of Christopher
+  Nolan», «Wes Anderson aesthetic», «David Fincher dark moody», «Wong
+  Kar-wai dreamy slow-motion», «Roger Deakins cinematography»,
+  «Studio Ghibli animation style», «1970s grindhouse film grain».
+- **Период/эпоха**: «1990s film aesthetic», «retro VHS look»,
+  «contemporary photoreal», «futuristic cyberpunk neon».
+- **Атмосфера**: «foggy atmosphere», «dust particles in the air»,
+  «volumetric god rays», «slight motion blur», «shallow depth of field
+  with bokeh».
+
+Пример: юзер сказал «давай сцену про детектива в нуар-фильме 50-х в
+дождливом Нью-Йорке».
+
+Создай сцену, и сразу после `add-board` добавь в `scene.json →
+settings.defaultPrompts`:
+
+```json
+[
+  { "id": "...", "text": "1950s film noir aesthetic, black and white high contrast, dramatic shadows", "kinds": ["image","video"], "enabled": true },
+  { "id": "...", "text": "rainy New York street, wet asphalt reflecting neon signs, foggy atmosphere", "kinds": ["image","video"], "enabled": true },
+  { "id": "...", "text": "anamorphic lens, shallow depth of field, cinematic composition", "kinds": ["image","video"], "enabled": true }
+]
+```
+
+Раздели на 2-4 prompt'а (а не один длинный) — юзер потом сможет временно
+выключить какой-то один в gen-modal'е (например прохладную палитру для
+конкретной картинки, оставив остальное).
+
+После создания сцены **сообщи юзеру** что defaultPrompts настроены, и
+покажи текстом что именно — чтобы он мог поправить.
+
+#### Раскадровка: разноси повторяющееся в @-ссылки или defaultPrompts
+
+Когда юзер просит **раскадровку** (storyboard) — серию кадров одной
+сцены/эпизода — **не дублируй общие части в каждый промпт**. Вместо
+повторения извлекай их одним из двух способов:
+
+**1. Persistent описания → отдельные ноды (text/image) + @-ссылки.**
+
+Если в каждом кадре повторяется один и тот же **персонаж, локация,
+объект, реквизит** — заведи отдельную text/image-ноду и в промптах
+кадров ссылайся на неё через `@имя`. CLI и UI резолвят `[@имя]` в
+полный текст ноды (или прикладывают image как референс) на этапе
+генерации.
+
+Пример. Юзер просит раскадровку «детектив идёт по улице, видит труп,
+звонит партнёру». Не пиши в каждый промпт «молодой детектив в потрёпанном
+сером плаще с блокнотом, тёмные волосы, усталое лицо». Вместо:
+
+```bash
+# Сначала — text-нода с описанием персонажа.
+kingkont add-node <project> <board> --kind=text --name="Анна-детектив" \
+  --text="Молодая женщина-следователь лет 30, потрёпанный серый плащ, \
+тёмные волосы собраны в хвост, усталое лицо, в руках блокнот."
+
+# Потом каждый кадр — короткий промпт с @-ссылкой:
+kingkont gen <project> <board> --kind=image --name="кадр-1" \
+  --prompt="[@Анна-детектив] идёт вдоль кирпичной стены, ночь, дождь" \
+  --refs="@Анна-детектив"
+
+kingkont gen <project> <board> --kind=image --name="кадр-2" \
+  --prompt="[@Анна-детектив] склоняется над телом, освещение от уличного фонаря" \
+  --refs="@Анна-детектив"
+```
+
+Это даёт **визуальную консистентность** (модель видит то же описание),
+плюс если юзер захочет уточнить персонажа — поправит ОДНУ ноду, не все
+кадры.
+
+**2. Universal стиль/съёмка → defaultPrompts сцены.**
+
+Если повторяется НЕ конкретный объект, а **как мы снимаем эту сцену**
+(освещение, камера, цветокор, жанр) — кладёшь в `settings.defaultPrompts`
+(см. раздел выше про defaultPrompts). Каждый кадр потом не нуждается в
+этих словах — они автоматически префиксуются ко всем генерациям.
+
+Чек-лист при раскадровке:
+
+- [ ] Персонажи / локации / реквизит описаны как text/image-ноды → ссылки `@`
+- [ ] Стиль съёмки (камера / свет / палитра / жанр) → `settings.defaultPrompts`
+- [ ] Промпт КАДРА содержит ТОЛЬКО что отличает его от других — действие,
+      ракурс, момент в кадре
+
+Если соблюсти оба правила — типичный кадр умещается в одну фразу
+(«[@Анна-детектив] открывает дверь»), и вся сцена выглядит цельно.
+
 ## ⚠️ Text-ноды — генерируй САМ, не через `kingkont gen --kind=text`
 
 Ты — Claude. Когда юзер просит «напиши диалог», «придумай реплику»,