kingkont 0.7.48 → 0.7.49

package/package.json

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

@@ -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