kingkont 0.7.48 → 0.7.50

package/lib/providers.js

@@ -216,8 +216,27 @@ async function startGeneration(args) {
   if (kind !== 'image' && kind !== 'video') throw new Error(`unknown kind: ${kind}`);
   if (!prompt && kind !== 'video') throw new Error('prompt обязателен');
 
+  // Приоритет провайдеров:
+  //   1) KIE — если useKie=true И KIE_API_KEY И модель поддерживается KIE
+  //      (юзер явно включил прямой коннектор → используем его, экономим
+  //       Chatium-кредиты).
+  //   2) Chatium — fallback, либо если модель не входит в KIE (kling-3.0,
+  //      veo-3.1, runway и т.д.).
+  //   3) Если ни один не доступен — ошибка.
+  const kieMap = kind === 'video' ? KIE_VIDEO_MODELS : KIE_IMAGE_MODELS;
+  const kieKey = modelKey || (kind === 'video' ? 'seedance-2' : 'nano-banana-2');
+  const kieAvailable = s.useKie && process.env.KIE_API_KEY;
+  const kieSupportsModel = !!kieMap[kieKey];
+
+  if (kieAvailable && kieSupportsModel) {
+    return await _startGenerationViaKie({ kind, prompt, key: kieKey, imageInputs, videoInputs, aspectRatio, resolution, duration });
+  }
+
   // Chatium-путь.
   if (s.useChatium && s.chatium?.token && s.chatium?.base) {
+    if (kieAvailable && !kieSupportsModel) {
+      console.warn(`[providers] KIE включен, но не поддерживает "${kieKey}" → fallback на KingKont`);
+    }
     const map = kind === 'video' ? CHATIUM_VIDEO_MODELS : CHATIUM_IMAGE_MODELS;
     const fullModel = resolveModel(map, modelKey, kind === 'video' ? 'bytedance/seedance-2-fast' : 'nano-banana-2');
     if (!fullModel) {
@@ -241,14 +260,19 @@ async function startGeneration(args) {
     return { taskId: 'chatium:' + taskId, provider: 'kingkont' };
   }
 
-  // KIE-путь.
-  if (!s.useKie) {
-    throw new Error(kind === 'video'
-      ? 'Войдите в KingKont или KIE для видео.'
-      : 'Войдите в KingKont или KIE для картинок.');
+  // Ни один провайдер не доступен.
+  if (s.useKie && !process.env.KIE_API_KEY) {
+    throw new Error('KIE включён, но KIE_API_KEY не задан в настройках.');
   }
+  throw new Error(kind === 'video'
+    ? 'Войдите в KingKont или KIE для видео.'
+    : 'Войдите в KingKont или KIE для картинок.');
+}
+
+// Внутренний helper: KIE-путь startGeneration. Вынесен чтобы не дублировать
+// логику между «KIE первичный» и старым «KIE fallback».
+async function _startGenerationViaKie({ kind, prompt, key, imageInputs, videoInputs, aspectRatio, resolution, duration }) {
   const map = kind === 'video' ? KIE_VIDEO_MODELS : KIE_IMAGE_MODELS;
-  const key = modelKey || (kind === 'video' ? 'seedance-2' : 'nano-banana-2');
   const fullModel = map[key];
   if (!fullModel) throw new Error(`unknown ${kind} model: ${key}`);
 
@@ -364,7 +388,13 @@ async function waitForGeneration(taskId, settings, opts = {}) {
 async function generateText({ prompt, model = 'anthropic/claude-sonnet-4', system, images, settings: s }) {
   if (!prompt) throw new Error('нужен prompt');
 
-  if (s.useChatium && s.chatium?.token && s.chatium?.base) {
+  // Приоритет: OpenRouter direct (если useOpenrouter+key) → Chatium → ошибка.
+  // Юзер явно включил прямой коннектор → используем его (Chatium-кредиты
+  // не тратим). OpenRouter принимает все те же model-slugs что Chatium-text
+  // (anthropic/claude-sonnet-4, openai/gpt-4o, google/gemini-..., etc.).
+  const directOpenrouter = s.useOpenrouter && process.env.OPENROUTER_API_KEY;
+
+  if (s.useChatium && s.chatium?.token && s.chatium?.base && !directOpenrouter) {
     const body = {
       prompt, model, system,
       images: Array.isArray(images) ? images.filter(i => i?.url) : undefined,
@@ -379,9 +409,13 @@ async function generateText({ prompt, model = 'anthropic/claude-sonnet-4', syste
     };
   }
 
-  if (!s.useOpenrouter) throw new Error('Войдите в KingKont или OpenRouter для генерации текста.');
+  if (!directOpenrouter) {
+    if (s.useOpenrouter && !process.env.OPENROUTER_API_KEY) {
+      throw new Error('OpenRouter включён, но OPENROUTER_API_KEY не задан в настройках.');
+    }
+    throw new Error('Войдите в KingKont или OpenRouter для генерации текста.');
+  }
   const key = process.env.OPENROUTER_API_KEY;
-  if (!key) throw new Error('OPENROUTER_API_KEY не задан');
 
   const messages = [];
   if (system) messages.push({ role: 'system', content: system });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.7.48",
+  "version": "0.7.50",
   "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

@@ -1136,14 +1136,19 @@ async function selectBoard(board) {
 
 // =============================================================================
 // External file watcher (FSAH polling).
-// FSAH не имеет нативного file-watch API — поллим scene.json's lastModified
-// раз в EXTERNAL_POLL_MS. Если mtime новее чем lastDiskMtime (который мы
-// обновляем при каждом своём write) — кто-то правил scene.json извне.
+// FSAH не имеет нативного file-watch API — поллим scene.json's lastModified.
+// Если mtime новее чем lastDiskMtime (который мы обновляем при каждом своём
+// write) — кто-то правил scene.json извне.
 //   • dirty=false → тихо перечитать и перерендерить
 //   • dirty=true  → confirm() «перечитать с диска? текущие правки утеряются»
+//
+// Интервал адаптивный: когда окно в фокусе — 300мс (юзер видит изменения
+// от skill/CLI почти моментально, прогрессивно: добавил ноду — увидел).
+// Когда вкладка скрыта — 3 сек (экономим CPU, юзер всё равно не смотрит).
 // =============================================================================
 
-const EXTERNAL_POLL_MS = 2000;
+const EXTERNAL_POLL_MS_ACTIVE = 300;
+const EXTERNAL_POLL_MS_HIDDEN = 3000;
 let _externalWatchTimer = null;
 let _externalReloadInFlight = false;
 
@@ -1158,11 +1163,23 @@ function stopExternalWatcher() {
   if (_externalWatchTimer) { clearInterval(_externalWatchTimer); _externalWatchTimer = null; }
 }
 
+function _currentPollInterval() {
+  return document.hidden ? EXTERNAL_POLL_MS_HIDDEN : EXTERNAL_POLL_MS_ACTIVE;
+}
+
 function startExternalWatcher() {
   stopExternalWatcher();
-  _externalWatchTimer = setInterval(checkExternalChanges, EXTERNAL_POLL_MS);
+  _externalWatchTimer = setInterval(checkExternalChanges, _currentPollInterval());
 }
 
+// При смене visibility пересоздаём timer с новым интервалом.
+document.addEventListener('visibilitychange', () => {
+  if (_externalWatchTimer) {
+    stopExternalWatcher();
+    _externalWatchTimer = setInterval(checkExternalChanges, _currentPollInterval());
+  }
+});
+
 async function checkExternalChanges() {
   if (_externalReloadInFlight) return;
   if (!state.currentBoard?.handle) { stopExternalWatcher(); return; }

package/skill/SKILL.md

@@ -150,6 +150,39 @@ kingkont gen <project> <board> --kind=text --name=name \
 
 В обычной просьбе «напиши X» — **пиши сам**.
 
+## ⚠️ Изменения визуально — добавляй ноды по одной
+
+Если открыто приложение KingKont, оно поллит `scene.json` каждые 300мс
+и автоматически перерисовывает холст когда обнаруживает внешнюю правку.
+Это значит **юзер видит каждую новую ноду как только ты её добавил**.
+
+Поэтому когда нужно добавить несколько нод — **не батчи их в один скрипт**,
+запускай `kingkont add-node` (или `gen`) по одной команде за раз. Между
+командами юзер видит как ноды появляются прогрессивно.
+
+✅ Хорошо (юзер видит появление каждой ноды):
+```bash
+kingkont add-node <project> <board> --kind=text --name=intro --text="..."
+# (юзер видит ноду на холсте через ~300мс)
+kingkont add-node <project> <board> --kind=text --name=dialog --text="..."
+# (видит вторую)
+kingkont add-node <project> <board> --kind=text --name=outro --text="..."
+# (видит третью)
+```
+
+❌ Плохо (юзер видит «бах» — все ноды одним кадром):
+```bash
+# Все три node'а пишутся в scene.json одним save'ом — на холсте они
+# появятся одновременно.
+kingkont add-node ... --kind=text --name=intro && \
+kingkont add-node ... --kind=text --name=dialog && \
+kingkont add-node ... --kind=text --name=outro
+```
+(Это технически работает, но менее «живое» ощущение.)
+
+Для длинных операций (десяток+ нод) можно объединять — юзер не различит
+батчи быстрее ~1 сек. Но от 3 до 5-7 нод — добавляй по одной.
+
 ## Как открыть UI редактора
 
 ```bash