kingkont 0.7.46 → 0.7.47

package/lib/cli.js

@@ -210,10 +210,18 @@ async function cmdGen({ positional, flags }) {
     if (subKind === 'music') return await runMusicGeneration(root, ref, node, { prompt, durationMs: flags['duration-ms'] || flags.durationMs, settings, flags });
     return await runTtsGeneration(root, ref, node, { text: prompt, voice: flags.voice, ttsModel: flags['tts-model'] || flags.ttsModel, settings, flags });
   }
-  // image | video
+  // image | video — aspectRatio с фоллбеком на scene.settings.aspectRatio
+  // (per-board дефолт). Если ни флаг, ни scene не указали — провайдер
+  // получит undefined и применит свой дефолт (обычно '16:9' / модель-зависимо).
+  const aspectFromFlag = flags['aspect-ratio'] || flags.aspectRatio;
+  const aspectFromScene = scene.settings?.aspectRatio;
+  const finalAspect = aspectFromFlag || aspectFromScene;
+  if (!aspectFromFlag && aspectFromScene) {
+    console.error(`[gen] using board's default aspectRatio: ${aspectFromScene}`);
+  }
   return await runMediaGeneration(root, ref, node, {
     kind, prompt, modelKey: flags.model, imageInputs, videoInputs,
-    aspectRatio: flags['aspect-ratio'] || flags.aspectRatio,
+    aspectRatio: finalAspect,
     resolution: flags.resolution,
     duration: flags.duration,
     firstFrame: flags['first-frame'] || flags.firstFrame,

package/lib/projectFs.js

@@ -119,6 +119,7 @@ async function loadScene(root, ref) {
     location: data.location || null,
     timeline: data.timeline || null,
     history: data.history || null,
+    settings: data.settings || null,
   };
   // Подгрузить .md для text-нод (как делает renderer в loadBoardMetadata).
   for (const n of scene.nodes) {
@@ -158,6 +159,8 @@ async function saveScene(root, ref, scene) {
     location: scene.location || null,
     timeline: scene.timeline || null,
     history: scene.history && (scene.history.past?.length || scene.history.future?.length) ? scene.history : null,
+    // settings: { aspectRatio: '9:16' | ... } — per-board дефолтные параметры.
+    ...(scene.settings && Object.keys(scene.settings).length ? { settings: scene.settings } : {}),
   };
   await fsp.writeFile(path.join(dir, 'scene.json'), JSON.stringify(payload, null, 2));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.7.46",
+  "version": "0.7.47",
   "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/board.js

@@ -674,6 +674,11 @@ function showBoardContextMenu(kind, item, clientX, clientY) {
     try { await renameBoard(kind, item.name, newName); }
     catch (err) { alert('Не удалось переименовать: ' + (err?.message || err)); }
   });
+  // Соотношение сторон по умолчанию для генераций image/video в этой
+  // доске. Хранится в scene.json → settings.aspectRatio. Используется
+  // как fallback когда нода ещё не имеет своего aspect и юзер не выбрал
+  // его в gen-modal'е.
+  add('▭ Соотношение сторон…', () => promptBoardAspectRatio(kind, item));
   if (kind === 'character') {
     add('⚙ Свойства персонажа', () => {
       // Открываем панель этого персонажа и потом её character-modal
@@ -689,6 +694,44 @@ function showBoardContextMenu(kind, item, clientX, clientY) {
   setTimeout(() => document.addEventListener('mousedown', closeNodeMenu, { once: true }), 0);
 }
 
+// Спросить у юзера новый default aspectRatio для доски.
+// Сохраняется в scene.json → settings.aspectRatio. Если доска сейчас
+// активна (state.currentBoard) — обновляем in-memory и сразу saveScheduled.
+// Иначе пишем напрямую через loadBoardMetadata + saveBoardMetadata.
+const ASPECT_OPTIONS = ['9:16', '16:9', '1:1', '4:5', '5:4', '4:3', '3:4', '2:3', '3:2', '21:9'];
+async function promptBoardAspectRatio(kind, item) {
+  const isActive = state.currentBoard?.kind === kind && state.currentBoard.name === item.name;
+  const current = isActive
+    ? (state.currentBoard.metadata.settings?.aspectRatio || '9:16')
+    : (await loadBoardMetadata(item.handle)).settings?.aspectRatio || '9:16';
+  const choices = ASPECT_OPTIONS.join(' / ');
+  const ans = window.prompt(
+    `Соотношение сторон для генераций image/video в «${item.name}».\n` +
+    `Применяется когда нода или gen-модалка не указывают своё.\n\n` +
+    `Доступные значения: ${choices}\n` +
+    `Текущее: ${current}`,
+    current,
+  );
+  if (ans == null) return;
+  const trimmed = ans.trim();
+  if (!trimmed) return;
+  if (!ASPECT_OPTIONS.includes(trimmed)) {
+    alert('Неподдерживаемое значение. Доступны: ' + choices);
+    return;
+  }
+  if (isActive) {
+    if (!state.currentBoard.metadata.settings) state.currentBoard.metadata.settings = {};
+    state.currentBoard.metadata.settings.aspectRatio = trimmed;
+    scheduleSave();
+  } else {
+    // Доска не активна — пишем напрямую.
+    const meta = await loadBoardMetadata(item.handle);
+    meta.settings = { ...(meta.settings || {}), aspectRatio: trimmed };
+    await saveBoardMetadata(item.handle, meta);
+  }
+  console.log(`[board] ${kind}/${item.name} aspectRatio → ${trimmed}`);
+}
+
 // Переименовать board (папку): создать новую папку с тем же именем, перенести
 // содержимое, удалить старую. На macOS-FSAH прямого rename нет, делаем
 // copy+remove. Если board сейчас открыт — переоткрываем после переноса.
@@ -1007,6 +1050,9 @@ async function selectBoard(board) {
       location: meta.location || null,
       timeline: meta.timeline || [],
       history: meta.history || { past: [], future: [] },
+      // settings: дефолтные параметры генерации в этой доске.
+      // aspectRatio фоллбэчит на '9:16' если поле не задано.
+      settings: meta.settings || { aspectRatio: '9:16' },
     },
     urls: {},
     dirty: false,
@@ -1166,6 +1212,7 @@ async function reloadCurrentBoardFromDisk() {
     location: meta.location || null,
     timeline: meta.timeline || [],
     history: meta.history || { past: [], future: [] },
+    settings: meta.settings || board.metadata.settings || { aspectRatio: '9:16' },
   };
   board.dirty = false;
   board.lastDiskMtime = await _readSceneMtime(board.handle);

package/renderer/generate.js

@@ -1484,14 +1484,20 @@ async function startGenerationJob(node, kind, prompt, mediaRefs, boardHandle, bK
       n.generated = { ...(n.generated || {}), state: 'submitting' };
     });
     const submitBody = { kind, prompt, imageInputs, videoInputs, model: modelKey };
+    // Приоритет aspectRatio:
+    //   1) node.generated.aspectRatio (если ноду уже генерили с этим)
+    //   2) state.currentBoard.metadata.settings.aspectRatio (доска-уровень)
+    //   3) state.imageAspect / state.videoAspect (глобальный localStorage)
+    // Так per-board настройка перебивает глобальный фоллбэк.
+    const boardAspect = state.currentBoard?.metadata?.settings?.aspectRatio || null;
     if (kind === 'video') {
       submitBody.duration = node.generated?.duration ?? state.videoDuration;
       submitBody.resolution = node.generated?.resolution ?? state.videoResolution;
-      submitBody.aspectRatio = node.generated?.aspectRatio ?? state.videoAspect;
+      submitBody.aspectRatio = node.generated?.aspectRatio ?? boardAspect ?? state.videoAspect;
     } else if (kind === 'image') {
       // Grok-imagine требует aspect_ratio из {2:3, 3:2, 1:1, 9:16, 16:9}.
       // Остальные модели (nano-banana-2, seedream и др.) тоже принимают.
-      submitBody.aspectRatio = node.generated?.aspectRatio ?? state.imageAspect;
+      submitBody.aspectRatio = node.generated?.aspectRatio ?? boardAspect ?? state.imageAspect;
     }
     logJob(node.id, `POST /api/generate body: ${logSafe(submitBody)}`);
     logJob(node.id, `POST /api/generate (image_input=${imageInputs.length}, video_input=${videoInputs.length}, model=${modelKey})`);

package/renderer/state.js

@@ -248,6 +248,7 @@ async function loadBoardMetadata(boardHandle) {
   let location = null;
   let timeline = null;
   let history = null;
+  let settings = null;
   // 1) Пробуем scene.json
   try {
     const fh = await boardHandle.getFileHandle('scene.json');
@@ -259,6 +260,7 @@ async function loadBoardMetadata(boardHandle) {
     location = data.location || null;
     timeline = data.timeline || null;
     history = data.history || null;
+    settings = data.settings || null;
   } catch {
     // 2) Легаси: .editor.json
     try {
@@ -270,6 +272,7 @@ async function loadBoardMetadata(boardHandle) {
       character = data.character || null;
       location = data.location || null;
       timeline = data.timeline || null;
+      settings = data.settings || null;
       legacyEditor = true;
       migrated = true;
     } catch {}
@@ -298,7 +301,7 @@ async function loadBoardMetadata(boardHandle) {
     try { await boardHandle.removeEntry('.editor.json'); } catch {}
   }
 
-  return { nodes, connections, view, character, location, timeline, history, _migrated: migrated };
+  return { nodes, connections, view, character, location, timeline, history, settings, _migrated: migrated };
 }
 
 async function saveBoardMetadata(boardHandle, meta) {
@@ -322,6 +325,9 @@ async function saveBoardMetadata(boardHandle, meta) {
     timeline: meta.timeline || null,
     history: meta.history && (meta.history.past?.length || meta.history.future?.length)
       ? meta.history : null,
+    // settings: { aspectRatio: '9:16' | ... } — per-board дефолтные параметры
+    // генерации. Если null/пусто — не пишем поле в JSON, чтобы файл был чище.
+    ...(meta.settings && Object.keys(meta.settings).length ? { settings: meta.settings } : {}),
   };
   await writeFile(boardHandle, 'scene.json', JSON.stringify(payload, null, 2));
   // Возвращаем свежий mtime — внешний file-watcher (poller в board.js) сравнит

package/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: kingkont
-description: Use this skill when the user works with a KingKont project — a film/series scene editor where each scene is a folder with scene.json. Triggers — фразы вроде «открой/запусти kingkont», «открой редактор сцен», «добавь сцену/персонажа/локацию», «добавь ноду на холст», «сгенерируй картинку/видео/голос/SFX/музыку/текст», или работа с папкой содержащей _characters/ _locations/ <scene>/scene.json. Skill знает формат данных и использует CLI `kingkont <cmd>` (open/list/board/add-node/gen/connect/rm-node/upload/voices/balance) для управления нодами и запуска генераций — ключи берутся автоматически из настроек приложения. ВАЖНО: каждая нода живёт в конкретной доске (сцене/персонаже/локации) — если юзер не указал доску явно, СПРОСИ его в какой добавить, не создавай новые сцены без явного запроса. Для визуальной работы поднимает UI через `npx -y kingkont serve`.
+description: Use this skill when the user works with a KingKont project — a film/series scene editor where each scene is a folder with scene.json. Triggers — фразы вроде «открой/запусти kingkont», «открой редактор сцен», «добавь сцену/персонажа/локацию», «добавь ноду на холст», «сгенерируй картинку/видео/голос/SFX/музыку/текст», или работа с папкой содержащей _characters/ _locations/ <scene>/scene.json. Skill знает формат данных и использует CLI `kingkont <cmd>` (open/list/board/add-node/gen/connect/rm-node/upload/voices/balance) для управления нодами и запуска генераций — ключи берутся автоматически из настроек приложения. ВАЖНО: (1) каждая нода живёт в конкретной доске — если юзер не указал доску, СПРОСИ; не создавай новые сцены без явного запроса. (2) Перед генерацией image/video проверь scene.json → settings.aspectRatio; если поле отсутствует — СПРОСИ юзера под какой формат генерить (9:16/16:9/1:1/...), сохрани его выбор в scene.json как дефолт. Для визуальной работы поднимает UI через `npx -y kingkont serve`.
 ---
 
 # KingKont · Chatium — Skill
@@ -59,6 +59,50 @@ echo '{"nodes":[],"connections":[]}' > <project>/<имя_новой_сцены>/
 Аналогично для персонажа: `<project>/_characters/<имя>/scene.json`.
 Для локации: `<project>/_locations/<имя>/scene.json`.
 
+## ⚠️ Aspect ratio для image/video — обязательно уточняй
+
+Каждая доска имеет дефолтный aspect ratio в `scene.json` →
+`settings.aspectRatio`. Это поле управляет под какой формат генерится
+картинка/видео.
+
+### Алгоритм перед `kingkont gen --kind=image|video`
+
+1. **Прочитай `scene.json` выбранной доски.**
+2. **Если `settings.aspectRatio` задан** → используй его автоматически
+   (CLI сам подхватит — флаг `--aspect-ratio` не нужен).
+3. **Если `settings.aspectRatio` отсутствует** — НЕ предполагай и НЕ
+   ставь дефолт сам. **Спроси юзера**: «Под какой формат генерим? —
+   9:16 (вертикаль), 16:9 (горизонталь), 1:1 (квадрат), 4:5, 4:3, 3:4,
+   2:3, 3:2, 21:9. По умолчанию — 9:16.»
+4. После ответа юзера **сохрани его выбор как дефолт** для этой доски,
+   чтобы в следующий раз не спрашивать. Сделай это правкой `scene.json`:
+   добавь/обнови ключ `"settings": { "aspectRatio": "<выбранный>" }`.
+5. После этого можешь запускать `kingkont gen --aspect-ratio=<выбор>` —
+   или без флага, CLI прочитает scene.
+
+### Пример
+
+```bash
+# Юзер: "сгенери картинку героя в Серии 1"
+# Шаг 1: проверяем текущий aspect
+kingkont board <project> 'Серия 1' --json | jq '.settings.aspectRatio'
+# null → не задан
+
+# Шаг 2: спрашиваем юзера. Получаем «вертикаль».
+# Шаг 3: правим scene.json — ставим aspectRatio: '9:16'
+
+# Шаг 4: генерим (CLI прочитает settings.aspectRatio автоматически)
+kingkont gen <project> 'Серия 1' --kind=image --prompt="..."
+
+# Альтернативно: указать явно (CLI отдаст приоритет флагу)
+kingkont gen <project> 'Серия 1' --kind=image --prompt="..." --aspect-ratio=9:16
+```
+
+Если юзер сам в просьбе указал формат («сгенери картинку 16:9», «вертикальную»,
+«квадратное видео») — используй его сразу, не спрашивай. Заодно обнови
+`settings.aspectRatio`, если он отличается от текущего и юзер явно сказал
+«пусть в этой сцене будет такой формат» (или если поле было null).
+
 ## Как открыть UI редактора
 
 ```bash