kingkont 0.7.47 → 0.7.49

package/package.json

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

@@ -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) для управления нодами и запуска генераций — ключи берутся автоматически из настроек приложения. ВАЖНО: (1) каждая нода живёт в конкретной доске — если юзер не указал доску, СПРОСИ; не создавай новые сцены без явного запроса. (2) Перед генерацией image/video проверь scene.json → settings.aspectRatio; если поле отсутствует — СПРОСИ юзера под какой формат генерить (9:16/16:9/1:1/...), сохрани его выбор в scene.json как дефолт. Для визуальной работы поднимает 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 как дефолт. (3) Для text-нод НЕ используй `kingkont gen --kind=text` — пиши текст сам в ответе, потом сохраняй через `kingkont add-node --kind=text --text="..."` (heredoc для многострочного). Для визуальной работы поднимает UI через `npx -y kingkont serve`.
 ---
 
 # KingKont · Chatium — Skill
@@ -103,6 +103,86 @@ kingkont gen <project> 'Серия 1' --kind=image --prompt="..." --aspect-ratio
 `settings.aspectRatio`, если он отличается от текущего и юзер явно сказал
 «пусть в этой сцене будет такой формат» (или если поле было null).
 
+## ⚠️ Text-ноды — генерируй САМ, не через `kingkont gen --kind=text`
+
+Ты — Claude. Когда юзер просит «напиши диалог», «придумай реплику»,
+«сделай сценарий», «текстовую ноду с описанием…» — **генерируй текст
+прямо в ответе**, как обычный chat-output. **Не запускай**
+`kingkont gen --kind=text` — это бессмысленный round-trip через
+Chatium/OpenRouter (тратит кредиты юзера, медленнее, и качество
+скорее всего хуже того что ты сгенерируешь сам).
+
+После того как ты сгенерировал текст — **сохрани его в ноду** через
+`kingkont add-node --kind=text` (с `--text="..."` или через heredoc для
+многострочного контента):
+
+```bash
+# Однострочный текст:
+kingkont add-node <project> <board> --kind=text --name=replica \
+  --text="— Ты опять опоздал."
+
+# Многострочный — heredoc, чтобы не экранировать кавычки и переводы строк:
+kingkont add-node <project> <board> --kind=text --name=script \
+  --text="$(cat <<'EOF'
+СЦЕНА 1.
+Полицейский участок. Поздний вечер.
+
+— Где была между 8 и 11?
+— У подруги. Можешь проверить.
+— Уже проверили.
+EOF
+)"
+```
+
+CLI создаст ноду и положит контент в `<board>/texts/<имя>_<id8>.md` с
+правильным `n.file` указателем в `scene.json`.
+
+### Когда `kingkont gen --kind=text` всё-таки нужен
+
+Только если юзер **явно просит** использовать другую модель — например
+«сгенерируй через Claude Sonnet 4 в KingKont» или «через Gemini».
+В таких редких кейсах:
+
+```bash
+kingkont gen <project> <board> --kind=text --name=name \
+  --prompt="..." --model=anthropic/claude-sonnet-4
+```
+
+В обычной просьбе «напиши 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
@@ -342,9 +422,16 @@ kingkont gen <project> <board> --kind=video --prompt="..." \
 kingkont gen <project> <board> --kind=video --prompt="..." \
   --model=kling-3.0 --refs=@hero       # i2v: ref → image_urls автоматически
 
-# Текст (Claude/Gemini/etc через Chatium или OpenRouter):
-kingkont gen <project> <board> --kind=text --name=script \
-  --prompt="напиши диалог двух полицейских" --model=anthropic/claude-sonnet-4
+# Текст: НЕ запускай `kingkont gen --kind=text` — пиши текст САМ в чате
+# (ты Claude, генерация через приложение бессмысленный round-trip).
+# Затем сохрани результат в ноду одной командой:
+kingkont add-node <project> <board> --kind=text --name=script \
+  --text="$(cat <<'EOF'
+Здесь полный текст, который ты сам сгенерировал в ответе юзеру.
+Многострочный, с диалогами, ремарками — всё что нужно.
+EOF
+)"
+# (см. отдельный раздел «Text-ноды — генерируй сам, не через CLI» ниже.)
 
 # Голос (TTS):
 kingkont gen <project> <board> --kind=audio --prompt="Привет, мир" \
@@ -467,10 +554,8 @@ kingkont gen <project> _characters/Анна --kind=image --name=sheet \
 mkdir -p <project>/Финал
 echo '{"nodes":[],"connections":[]}' > <project>/Финал/scene.json
 ```
-После этого можно сразу генерить ноды в неё:
-```bash
-kingkont gen <project> Финал --kind=text --name=script --prompt="..."
-```
+После этого можно генерить ноды (текст — пишешь сам, см. раздел ниже;
+картинки/видео/аудио — через `kingkont gen`).
 
 ### Узкие сценарии