kingkont 0.7.47 → 0.7.48

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.7.47",
+  "version": "0.7.48",
   "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) для управления нодами и запуска генераций — ключи берутся автоматически из настроек приложения. ВАЖНО: (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,53 @@ 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» — **пиши сам**.
+
 ## Как открыть UI редактора
 
 ```bash
@@ -342,9 +389,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 +521,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`).
 
 ### Узкие сценарии