kingkont 0.7.41 → 0.7.43

package/bin/kingkont.js

@@ -106,7 +106,12 @@ if (cmd && NODE_COMMANDS[cmd]) {
   process.env.PORT = String(port);
   const targetPath = args[1] && !args[1].startsWith('--') ? path.resolve(args[1]) : null;
   const { start } = require(path.join(root, 'server.js'));
-  start(port).then(actualPort => {
+  // Live-чтение settings.json на каждый запрос — так же как в Electron-режиме
+  // (main.js). Без этого use*-флаги и chatium.token не доходят до server.js,
+  // и провайдеры (chatium / openrouter / kie / elevenlabs) висят выключенными,
+  // даже если юзер залогинен через UI приложения.
+  const startOpts = { getSettings: () => settingsLib.loadSettings() };
+  start(port, startOpts).then(actualPort => {
     const url = `http://localhost:${actualPort}/`;
     console.log(`\n▶  KingKont готов: ${url}`);
     if (targetPath) console.log(`   подразумеваемый проект: ${targetPath}`);

package/main.js

@@ -764,19 +764,41 @@ app.whenReady().then(async () => {
 
   // Фиксированный порт нужен потому что Chromium хранит IndexedDB и FSAH-handle
   // per-origin (http://localhost:PORT). Со случайным портом каждый запуск
-  // получал бы новую пустую IDB. Если порт занят — fallback на случайный, но
-  // тогда recents-handle потеряется (это меньшая беда, чем падение запуска).
-  // server.js на каждый запрос читает live-настройки через getSettings — это
-  // позволяет переключать use*-флаги через UI без перезапуска. settings.json
-  // на диске единственный источник правды; readSettings() делает свежий read.
+  // получал бы новую пустую IDB и юзер должен заново указывать папки в recents.
+  //
+  // RETRY на 17893: при relaunch'е старый instance отпускает singleton-lock
+  // быстрее, чем macOS освобождает TCP-сокет (TIME_WAIT). Без retry сразу
+  // падаем на random и теряем handle. 8×500мс = 4 сек обычно хватает.
+  // server.js на каждый запрос читает live-настройки через getSettings —
+  // settings.json на диске единственный источник правды.
   const startOpts = { getSettings: () => readSettings() };
-  try {
-    port = await start(17893, startOpts);
-  } catch {
-    console.warn('port 17893 busy, falling back to random');
+  const PRIMARY_PORT = 17893;
+  const RETRIES = 8;
+  let lastErr;
+  for (let i = 0; i < RETRIES; i++) {
+    try { port = await start(PRIMARY_PORT, startOpts); break; }
+    catch (e) {
+      lastErr = e;
+      if (e.code !== 'EADDRINUSE') break; // не race — нет смысла ретраить
+      console.warn(`port ${PRIMARY_PORT} busy (attempt ${i + 1}/${RETRIES}), waiting…`);
+      await new Promise(r => setTimeout(r, 500));
+    }
+  }
+  if (!port) {
+    // Сначала попробуем фиксированные fallback'и (17894/17895/...) —
+    // это сохранит хотя бы часть recents (origin будет стабильным от
+    // запуска к запуску при условии что 17893 хронически занят).
+    for (const p of [17894, 17895, 17896, 17897, 17898, 17899]) {
+      try { port = await start(p, startOpts); console.warn(`fell back to port ${p}`); break; }
+      catch { /* try next */ }
+    }
+  }
+  if (!port) {
+    // Последний резерв — случайный порт (потеряем handle).
+    console.warn('all stable ports busy, falling back to random (recents-handle will be lost)');
     try { port = await start(0, startOpts); }
     catch (e) {
-      console.error('Server failed to start:', e);
+      console.error('Server failed to start:', e || lastErr);
       app.quit();
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.7.41",
+  "version": "0.7.43",
   "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/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) для управления нодами и запуска генераций — ключи берутся автоматически из настроек приложения. ВАЖНО: каждая нода живёт в конкретной доске (сцене/персонаже/локации) — если юзер не указал доску явно, СПРОСИ его в какой добавить, не создавай новые сцены без явного запроса. Для визуальной работы поднимает UI через `npx -y kingkont serve`.
 ---
 
 # KingKont · Chatium — Skill
@@ -23,6 +23,42 @@ KingKont — нод-редактор сцен фильма/сериала с AI-
 - Любые правки тексту, перестановка нод, чистка истории, бэкап — все
   через прямую правку `scene.json` и `texts/*.md`.
 
+## ⚠️ ОБЯЗАТЕЛЬНОЕ ПРАВИЛО: всегда уточняй доску
+
+**НИКОГДА не создавай новые сцены без явного запроса юзера.** Каждая нода
+живёт в конкретной доске (сцене / персонаже / локации). Если юзер просит
+«сгенерируй картинку», «добавь ноду», «вставь голос» — это значит
+«внутри какой-то существующей доски», а не «создай новую».
+
+### Алгоритм перед любой операцией создания нод
+
+1. Запусти `kingkont open <project>` чтобы получить список существующих
+   досок проекта.
+2. Если юзер не указал доску явно — **спроси у него** в чём именно
+   работать:
+   - Если есть только одна сцена / `currentBoard` сохранён — используй её.
+   - Если несколько и юзер не уточнил — выведи нумерованный список и
+     спроси номер. Пример: «У тебя есть сцены: 1) Серия 1, 2) Серия 2,
+     3) Серия 4.1. В какой добавить?»
+3. Не предлагай создать новую сцену пока юзер сам не попросит словами
+   вроде «новая сцена», «создай сцену», «добавь эпизод».
+4. Если юзер прислал N фото — все ноды идут в **одну** выбранную доску,
+   а не в N разных.
+
+### Как создавать новые сцены (только когда явно попросили)
+
+Команды CLI для add-node — НЕ создают сцену; они работают только с
+существующими досками. Чтобы создать новую сцену, нужно:
+
+```bash
+mkdir -p <project>/<имя_новой_сцены>
+echo '{"nodes":[],"connections":[]}' > <project>/<имя_новой_сцены>/scene.json
+# Дальше — обычные kingkont add-node / kingkont gen с этой доской
+```
+
+Аналогично для персонажа: `<project>/_characters/<имя>/scene.json`.
+Для локации: `<project>/_locations/<имя>/scene.json`.
+
 ## Как открыть UI редактора
 
 ```bash
@@ -345,6 +381,34 @@ kingkont upload <file>      # печатает публичный URL
 
 **«Открой редактор»** → `npx -y kingkont serve` + сообщить URL для Chrome.
 
+### Юзер просит сгенерировать что-то (картинку/видео/голос/SFX/текст)
+
+**Сначала всегда** — определи доску. Не угадывай и не создавай новую.
+
+```bash
+kingkont open <project>     # JSON со списком всех досок
+```
+
+Если юзер уже назвал доску в реплике («добавь в Серию 1», «на сцене Прощание»)
+— используй её. Иначе спроси: «У тебя есть сцены: 1) Серия 1, 2) Серия 2,
+3) Серия 4.1. В какой добавить?» — и **жди ответа**.
+
+Если юзер прислал несколько фото/референсов и сказал «вот, сгенери что-то по
+ним» — это НЕ повод создать N новых сцен по одной на каждое фото. Это
+повод спросить «в какой сцене разложить эти N кадров?».
+
+После того как доска определена:
+
+```bash
+kingkont gen <project> <board> --kind=image --prompt="..." --refs=@ref1
+```
+
+### Юзер просит добавить персонажа / локацию / новую сцену
+
+Только тогда создавай папки. Триггерные фразы: «новая сцена», «добавь
+сцену», «создай эпизод», «новый персонаж», «добавь персонажа», «новая
+локация».
+
 **«Добавь персонажа Анна»**:
 ```bash
 mkdir -p <project>/_characters/Анна
@@ -354,26 +418,37 @@ kingkont gen <project> _characters/Анна --kind=image --name=sheet \
   --prompt="портрет молодой женщины-следователя" --model=nano-banana-2
 ```
 
-**«Добавь текстовую ноду на сцену "Прощание" с таким текстом …»**:
+**«Создай новую сцену "Финал"»**:
+```bash
+mkdir -p <project>/Финал
+echo '{"nodes":[],"connections":[]}' > <project>/Финал/scene.json
+```
+После этого можно сразу генерить ноды в неё:
+```bash
+kingkont gen <project> Финал --kind=text --name=script --prompt="..."
+```
+
+### Узкие сценарии
+
+**«Добавь текстовую ноду на сцену "Прощание"»**:
 ```bash
 kingkont add-node <project> Прощание --kind=text --name=plot --text="ТЕКСТ"
 ```
 
-**«Свяжи ноды @А и @Б»**:
+**«Свяжи ноды @А и @Б»** (в одной доске):
 ```bash
 kingkont connect <project> Прощание А Б
 ```
 
-**«Сгенерируй SFX "камни сыпятся"»**:
+**«Сгенерируй SFX "камни сыпятся" в Серии 1»**:
 ```bash
-kingkont gen <project> <board> --kind=audio --sub-kind=sfx \
+kingkont gen <project> 'Серия 1' --kind=audio --sub-kind=sfx \
   --prompt="rocks falling, gravel cascading" --duration=3
 ```
 (SFX-модель ElevenLabs работает лучше на английском — переводи русский промпт.)
 
-**«Сделай i2v видео из этой картинки»**:
+**«Сделай i2v видео из этой картинки»** (нода @hero уже в доске):
 ```bash
-# Нода @hero уже есть в этой доске:
 kingkont gen <project> <board> --kind=video --refs=@hero \
   --model=kling-3.0 --prompt="hero turns and walks away"
 ```