kingkont 0.7.39 → 0.7.41

package/settings.html

@@ -169,6 +169,27 @@
     </div>
   </div>
 
+  <h2>Для Claude</h2>
+  <div class="card">
+    <div style="font-size:13px; color:var(--text); margin-bottom:8px;">
+      Скилл <code>kingkont</code> для Claude Code
+    </div>
+    <div class="hint" style="margin-top:0; margin-bottom:12px;">
+      Положит <code>SKILL.md</code> в папку настроек Claude Code в твоём
+      домашнем каталоге (macOS/Linux: <code>~/.claude/skills/kingkont/</code>;
+      Windows: <code>%USERPROFILE%\.claude\skills\kingkont\</code>). Claude
+      сможет управлять проектами KingKont (создавать ноды, запускать
+      генерации) без открытия приложения. После установки нужен
+      <code>/reload</code> в Claude Code.
+    </div>
+    <div class="row">
+      <button id="installSkill" class="secondary">Установить skill для Claude</button>
+      <span class="saved" id="skillSaved" style="margin-left:auto;">Установлено ✓</span>
+    </div>
+    <div class="hint" id="skillPath" style="display:none; margin-top:8px; word-break:break-all; font-family:ui-monospace,monospace; color:var(--ok);"></div>
+    <div class="error" id="skillError" style="display:none;"></div>
+  </div>
+
   <div class="actions">
     <span class="saved" id="saved">Сохранено</span>
     <button class="secondary" id="cancel">Закрыть</button>
@@ -309,6 +330,41 @@ function escapeHtml(s) {
   return String(s).replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
 }
 
+// Кнопка «Установить skill для Claude» — копирует skill/SKILL.md в
+// ~/.claude/skills/kingkont/ (или %USERPROFILE%\.claude\skills\kingkont\
+// на Windows) через main-process IPC. После успеха показывает реальный путь.
+$('installSkill').addEventListener('click', async () => {
+  const btn = $('installSkill');
+  const ok  = $('skillSaved');
+  const err = $('skillError');
+  const pathEl = $('skillPath');
+  err.style.display = 'none';
+  pathEl.style.display = 'none';
+  ok.classList.remove('show');
+  btn.disabled = true;
+  btn.textContent = 'Устанавливаю…';
+  try {
+    const res = await window.claudeMd.installSkill();
+    if (res?.ok) {
+      btn.textContent = 'Переустановить skill для Claude';
+      ok.classList.add('show');
+      setTimeout(() => ok.classList.remove('show'), 2500);
+      if (res.path) {
+        pathEl.style.display = '';
+        pathEl.textContent = '✓ ' + res.path;
+      }
+    } else {
+      throw new Error(res?.error || 'Не удалось установить');
+    }
+  } catch (e) {
+    err.style.display = '';
+    err.textContent = 'Ошибка: ' + e.message;
+    btn.textContent = 'Попробовать снова';
+  } finally {
+    btn.disabled = false;
+  }
+});
+
 loadSettings();
 </script>
 </body>

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 — fraзы вроде «открой/запусти kingkont», «открой редактор сцен», «добавь сцену/персонажа/локацию», «добавь ноду на холст», «сгенерируй картинку/видео/голос/SFX/музыку/текст», или работа с папкой содержащей _characters/ _locations/ <scene>/scene.json. Skill знает формат данных и API-ключи из настроек kingkont, может править 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) для управления нодами и запуска генераций — ключи берутся автоматически из настроек приложения. Для визуальной работы поднимает UI через `npx -y kingkont serve`.
 ---
 
 # KingKont · Chatium — Skill
@@ -201,106 +201,188 @@ open -a "Google Chrome" "http://localhost:17893/"
 
 Если ключа не хватает — попроси юзера задать в редакторе через `Cmd+,`.
 
-## Программная генерация (без UI)
+## Работа без UI через CLI (предпочтительно)
 
-Запусти `npx kingkont serve` в фоне — сервер становится прокси к KIE/
-ElevenLabs/OpenRouter с уже подставленными ключами из settings.json.
-Дёргай endpoints прямым curl/fetch:
+`kingkont` устанавливается глобально: `npm i -g kingkont`. После этого все
+команды ниже работают **без открытого приложения** — правят `scene.json`
+напрямую через FS, а генерации запускают через те же провайдеры, что и UI
+(KIE / Chatium / ElevenLabs / OpenRouter), используя ключи из
+`settings.json`.
 
-### `POST http://localhost:17893/api/text` — текст (OpenRouter)
-```json
-{
-  "prompt": "...",
-  "model": "anthropic/claude-sonnet-4",  // или openai/gpt-4o, google/gemini-..., etc
-  "system": "опционально system prompt",
-  "images": [{ "url": "data:image/jpeg;base64,..." }]  // vision-режим
-}
+> Все `<project>` — путь к корню проекта KingKont (где живут `_characters/`,
+> `_locations/`, папки сцен).
+> Все `<board>` принимаются в любом из форматов:
+> `Scene1`, `_characters/Anna`, `characters/Anna`, `_locations/Office`.
+> `<nodeId>` принимается как полный uuid либо как имя ноды (через `--name`).
+
+### Чтение
+
+```bash
+kingkont open <project>                    # структура проекта (с --json — JSON)
+kingkont list <project>                    # списки досок
+kingkont board <project> <board>           # одна доска (с --json — полный JSON)
+kingkont status <project> <board> <id>     # прогресс in-flight задачи
+kingkont balance                           # балансы всех включённых провайдеров
+kingkont voices                            # все ElevenLabs голоса
 ```
-Возвращает `{ "text": "...", "model": "..." }`.
 
-### `POST http://localhost:17893/api/sfx` — звуковой эффект (ElevenLabs)
-```json
-{
-  "text": "heavy door slamming with echo",   // лучше английский
-  "durationSeconds": 3,                       // 0.5–22, опц.
-  "promptInfluence": 0.3                      // 0–1, опц.
-}
+### Создание / правка нод
+
+```bash
+# Просто добавить пустую ноду без генерации:
+kingkont add-node <project> <board> --kind=text  --name=plot --text="..."
+kingkont add-node <project> <board> --kind=image --name=hero
+kingkont add-node <project> <board> --kind=video --name=intro [--x=200 --y=100]
+
+# Связать ноды (по id или по name):
+kingkont connect <project> <board> plot hero
+
+# Удалить ноду (файл переезжает в _deleted/):
+kingkont rm-node <project> <board> hero
 ```
-Возвращает `audio/mpeg` (mp3 stream). Сохрани в `<board>/audio/sfx_<ts>.mp3`.
 
-### `POST http://localhost:17893/api/music` — музыка (ElevenLabs)
-```json
-{
-  "prompt": "epic orchestral cinematic, slow buildup, hopeful",
-  "durationMs": 30000   // опц.
-}
+### Генерация — главная команда `gen`
+
+`gen` совмещает «создать ноду + сразу запустить генерацию + дождаться + сохранить
+файл в нужную подпапку доски». Блокируется до завершения (для image — секунды,
+для video — до 10 мин).
+
+```bash
+# Картинка через KingKont/KIE (модель — короткий ключ или полный slug)
+kingkont gen <project> <board> --kind=image --prompt="..." --model=nano-banana-2
+kingkont gen <project> <board> --kind=image --prompt="..." --model=grok --aspect-ratio=16:9
+
+# С референсами — @-ссылки на ноды/character/location в проекте
+kingkont gen <project> <board> --kind=image --prompt="hero in @office" \
+  --refs=@Anna,@office --model=nano-banana-2
+
+# Видео (Seedance, Veo, Kling и др. через Chatium):
+kingkont gen <project> <board> --kind=video --prompt="..." \
+  --model=seedance-2 --aspect-ratio=16:9 --duration=5
+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
+
+# Голос (TTS):
+kingkont gen <project> <board> --kind=audio --prompt="Привет, мир" \
+  --voice=JBFqnCBsd6RMkjVDRZzb
+
+# SFX (звуковой эффект, лучше en-промпт):
+kingkont gen <project> <board> --kind=audio --sub-kind=sfx --prompt="heavy door slam" --duration=3
+
+# Музыка:
+kingkont gen <project> <board> --kind=audio --sub-kind=music \
+  --prompt="cinematic orchestral hopeful" --duration-ms=30000
 ```
-Возвращает `audio/mpeg`.
 
-### `POST http://localhost:17893/api/tts` — речь (ElevenLabs)
-```json
-{
-  "text": "...",
-  "voiceId": "JBFqnCBsd6RMkjVDRZzb",   // ElevenLabs voice id
-  "modelId": "eleven_v3"
-}
+После `gen` нода имеет `n.file` (относительный путь к сохранённому файлу),
+а в `n.generated.creditsCharged` — стоимость, если её вернул провайдер.
+
+### Перезапустить ноду в статусе `error` или `draft`
+
+```bash
+kingkont generate <project> <board> <nodeId>
 ```
-Возвращает `audio/mpeg`.
 
-### `POST http://localhost:17893/api/generate` — image/video (KIE, async)
-```json
-{
-  "kind": "image" | "video",
-  "prompt": "...",
-  "model": "nano-banana-2" | "flux-schnell" | "sdxl-lightning"
-         | "seedream" | "seedream-5-lite" | "grok"
-         | "seedance-2",  // для video — bytedance/seedance-2
-  "imageInputs": ["http(s) URL"],        // опц., референсы
-  "aspectRatio": "16:9",
-  "resolution": "1K"
-}
+Берёт `n.generated.prompt` и `n.generated.model` из существующей ноды, резолвит
+её `n.generated.refs`, запускает заново.
+
+### Доступные модели
+
+| `--kind` | Поставщик | `--model` ключи |
+|---|---|---|
+| `image` | KingKont / KIE | `nano-banana-2`, `nano-banana-pro`, `grok`, `grok-i2i`, `seedream-5-lite`, `flux-schnell`, `sdxl-lightning` |
+| `video` | KingKont | `seedance-2`, `seedance-2-fast`, `veo-3.1`, `kling-o1`, `kling-3.0`, `kling-v3-omni`, `wan-2.7-i2v`, `runway`, `grok-i2v`, `grok-t2v` |
+| `video` | KIE | `seedance-2` |
+| `text` | KingKont / OpenRouter | `anthropic/claude-sonnet-4`, `openai/gpt-4o`, `google/gemini-2.0-flash`, etc |
+| `audio` (TTS) | KingKont | `qwen/qwen3-tts`, `elevenlabs/v3`, `minimax/speech-02-hd`, `google/gemini-3.1-flash-tts-preview` |
+| `audio` (TTS) | ElevenLabs | `eleven_v3` (форсится при прямом ElevenLabs-подключении) |
+| `audio` (sfx/music) | KingKont / ElevenLabs | без `--model` |
+
+Если указанная модель не поддерживается активным провайдером — CLI вернёт
+понятную ошибку со списком доступных.
+
+### Загрузка файла в storage
+
+```bash
+kingkont upload <file>      # печатает публичный URL
 ```
-Возвращает `{ "taskId": "..." }`. Затем поллить:
 
-### `GET http://localhost:17893/api/poll?taskId=...`
-Возвращает `{ "status": "pending" | "done" | "error", "url": "https://..." }`.
-Когда `done` — скачай `url` (это публичный URL картинки/видео).
+Полезно когда юзер просит «сделай эту картинку референсом для генерации» —
+сначала аплоадим, потом передаём URL в `--refs`.
+
+### `--json` для машино-читаемого вывода
+
+Все команды поддерживают `--json` — печатают строгий JSON в stdout (логи и
+прогресс генерации идут в stderr). Используй для парсинга в скриптах.
+
+## HTTP API (альтернатива — когда UI или сервер запущены)
+
+Если по каким-то причинам CLI недоступен (другая машина, скрипт с curl,
+интеграция в другой инструмент) — все те же возможности доступны через HTTP.
+Запусти `npx -y kingkont serve` и дёргай endpoints:
 
-### `POST http://localhost:17893/api/upload` — загрузить локальный файл в KIE
-Передай binary в body, заголовок `X-File-Name: filename.jpg`.
-Возвращает `{ "url": "https://..." }` — этот URL можно класть в
-`imageInputs`.
+| Метод | Путь | Что |
+|---|---|---|
+| POST | `/api/text` | текст: `{prompt, model, system?, images?}` → `{text, model, cost?}` |
+| POST | `/api/tts` | TTS: `{text, voice/voiceId, ttsModel?}` → `audio/mpeg` |
+| POST | `/api/sfx` | SFX: `{text, durationSeconds?, promptInfluence?}` → `audio/mpeg` |
+| POST | `/api/music` | Music: `{prompt, durationMs?}` → `audio/mpeg` |
+| POST | `/api/generate` | image/video: `{kind, prompt, model, imageInputs?, aspectRatio?, ...}` → `{taskId}` |
+| GET | `/api/poll?taskId=...` | poll → `{status: pending\|done\|error, url?, cost?}` |
+| POST | `/api/upload` | upload binary, header `X-File-Name: ...` → `{url, hash, size}` |
+| GET | `/api/proxy?url=...` | прокси для CORS-bypass |
+| GET | `/api/balance/all` | балансы всех провайдеров |
+| GET | `/api/voices` | список ElevenLabs голосов |
 
-### `GET http://localhost:17893/api/proxy?url=...`
-Прокси для скачивания произвольных http(s)-URL минуя CORS.
+Те же ключи и роутинг, что и CLI — не дублируй логику в curl-скриптах,
+лучше используй `kingkont`.
 
 ## Распространённые сценарии для агента
 
-**«Открой редактор»** → `npx -y kingkont serve` + сообщить URL.
+**«Открой редактор»** → `npx -y kingkont serve` + сообщить URL для Chrome.
 
-**«Добавь персонажа Анна»** → `mkdir -p _characters/Анна`, создать
-минимальный `_characters/Анна/scene.json`:
-```json
-{ "nodes": [], "connections": [], "character": { "voice": null }, "view": { "zoom": 1, "scrollLeft": 0, "scrollTop": 0 }, "timeline": { "tracks": [], "playhead": 0 } }
+**«Добавь персонажа Анна»**:
+```bash
+mkdir -p <project>/_characters/Анна
+echo '{"nodes":[],"connections":[]}' > <project>/_characters/Анна/scene.json
+# Дальше — генерим character sheet:
+kingkont gen <project> _characters/Анна --kind=image --name=sheet \
+  --prompt="портрет молодой женщины-следователя" --model=nano-banana-2
+```
+
+**«Добавь текстовую ноду на сцену "Прощание" с таким текстом …»**:
+```bash
+kingkont add-node <project> Прощание --kind=text --name=plot --text="ТЕКСТ"
+```
+
+**«Свяжи ноды @А и @Б»**:
+```bash
+kingkont connect <project> Прощание А Б
 ```
 
-**«Добавь текстовую ноду на сцену "Прощание" с таким текстом ...»**:
-1. Записать `Прощание/texts/<slug>.md` с текстом.
-2. Прочитать `Прощание/scene.json`, добавить новую node-запись (`type: 'text'`,
-   уникальный uuid v4, `file: "texts/<slug>.md"`, `x/y` подальше от
-   существующих), записать обратно.
+**«Сгенерируй SFX "камни сыпятся"»**:
+```bash
+kingkont gen <project> <board> --kind=audio --sub-kind=sfx \
+  --prompt="rocks falling, gravel cascading" --duration=3
+```
+(SFX-модель ElevenLabs работает лучше на английском — переводи русский промпт.)
 
-**«Свяжи ноды @А и @Б»** → найти их id по `name` в `scene.json`, добавить
-`{from: "<id-A>", to: "<id-Б>"}` в `connections[]`.
+**«Сделай i2v видео из этой картинки»**:
+```bash
+# Нода @hero уже есть в этой доске:
+kingkont gen <project> <board> --kind=video --refs=@hero \
+  --model=kling-3.0 --prompt="hero turns and walks away"
+```
 
-**«Сгенерируй SFX "камни сыпятся"»** → `POST /api/sfx` с translated en-промптом
-(модель Sound Generation на не-en тексте делает TTS-fallback), сохранить mp3
-в `<board>/audio/sfx_<ts>.mp3`, добавить audio-ноду в scene.json с
-`generated.subKind = "sfx"`.
+## Не трогай руками
 
-**Не трогай**: `node.history[]`, `metadata.history.past/future` — это
-снимки сцены для Cmd+Z. Поломав, потеряешь возможность отката. Поля с
-UUID `id` тоже не меняй — на них завязаны связи и timeline-clips.
+- `node.history[]`, `metadata.history.past/future` — снимки сцены для Cmd+Z.
+- `id` нод (UUID) — на них завязаны связи и timeline-clips.
+- `_deleted/` — корзина (юзер может восстановить через Cmd+Z в редакторе).
 
 ## Шорткаты редактора (для подсказок юзеру)