kingkont 0.20.17 → 0.20.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.20.17",
+  "version": "0.20.18",
   "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/generate.js

@@ -516,6 +516,13 @@ $('textGenSubmit').addEventListener('click', async () => {
   // Собираем image-mentions из промпта (видение для модели). Видео/audio в
   // OpenRouter chat не поддерживается — игнорируем.
   const allMediaRefs = (typeof gatherMediaRefs === 'function') ? gatherMediaRefs(rawPrompt) : [];
+  // + источник pendingConnectionFrom (anchor-drag → новая text-нода): если
+  // юзер протянул из image-ноды в gen-text, картинка автоматически попадает
+  // в контекст. Видео-источники для text-gen бесполезны (OpenRouter chat
+  // их не съест), но мы оставляем в общем списке — фильтр ниже их уберёт.
+  for (const pf of _pendingConnectionFromRef()) {
+    if (!allMediaRefs.some(r => r.file === pf.file)) allMediaRefs.push(pf);
+  }
   const imageRefs = allMediaRefs.filter(r => r.type === 'image' && r.file);
   // Резолвим mentions: text-ноды → инлайн .md, image-ноды → маркеры [image N].
   const resolvedPrompt = (typeof resolveMentions === 'function') ? resolveMentions(rawPrompt, imageRefs) : rawPrompt;
@@ -1202,6 +1209,63 @@ function presetPicksForBoard() {
   if (b?.kind === 'location' && b.name)  state.pickedLocName = b.name;
 }
 
+// Собирает image/video ноды, ИЗ которых есть connection В targetNodeId.
+// Юзер: «если в ноду 'входит' несколько других нод-картинок или 'нод-видео'
+// — подавай их тоже как референсы». Когда граф уже выражает связь
+// (юзер протянул стрелку), не заставляем юзера ещё и писать @name в
+// промпте — автоматически подмешиваем источники к refs.
+// Используется в:
+//   • genSubmit (новая нода) — для state.pendingConnectionFrom (anchor-drag)
+//     это уже учитывается отдельно, т.к. там ещё нет node.id; здесь же
+//     полезно когда юзер ставит несколько связей через drag-line ДО
+//     запуска gen-modal'а (редкий кейс).
+//   • regenerateInto (существующая нода) — все incoming-edges с
+//     image/video-источниками. Главный кейс: юзер связал draft-ноду с
+//     несколькими картинками и нажал «↻ Перегенерировать».
+function gatherIncomingMediaRefs(targetNodeId) {
+  const refs = [];
+  const board = state.currentBoard;
+  if (!board || !targetNodeId) return refs;
+  const conns = board.metadata.connections || [];
+  const nodes = board.metadata.nodes || [];
+  for (const c of conns) {
+    if (c.to !== targetNodeId) continue;
+    const src = nodes.find(n => n.id === c.from);
+    if (!src) continue;
+    if (src.type !== 'image' && src.type !== 'video') continue;
+    if (!src.file) continue; // источник ещё не готов — не блокируем gen, просто пропускаем
+    refs.push({
+      key: `incoming:${src.id}`,
+      name: src.name || src.file.split('/').pop(),
+      type: src.type,
+      file: src.file,
+      boardHandle: board.handle,
+    });
+  }
+  return refs;
+}
+
+// Источник pendingConnectionFrom (для NEW ноды, когда node.id ещё не
+// существует). Возвращает массив с одним рефом или пустой.
+function _pendingConnectionFromRef() {
+  const refs = [];
+  if (!state.pendingConnectionFrom) return refs;
+  const board = state.currentBoard;
+  if (!board) return refs;
+  const src = (board.metadata.nodes || []).find(n => n.id === state.pendingConnectionFrom);
+  if (!src) return refs;
+  if (src.type !== 'image' && src.type !== 'video') return refs;
+  if (!src.file) return refs;
+  refs.push({
+    key: `incoming:${src.id}`,
+    name: src.name || src.file.split('/').pop(),
+    type: src.type,
+    file: src.file,
+    boardHandle: board.handle,
+  });
+  return refs;
+}
+
 // Собрать рефы из выбранных персонажей и локации (sheet'ы)
 function gatherPickedSheetRefs() {
   const refs = [];
@@ -1715,6 +1779,14 @@ $('genSubmit').addEventListener('click', async () => {
     if (mediaRefs.some(r => r.file === pr.file && r.boardHandle === pr.boardHandle)) continue;
     mediaRefs.push(pr);
   }
+  // Incoming-edge источник для НОВОЙ ноды (anchor-drag из image/video ноды).
+  // Юзер: «если в ноду 'входит' нода-картинка/видео — подавай её тоже как
+  // референс». Для NEW ноды есть только pendingConnectionFrom (один источник);
+  // существующая нода с множественными incoming обрабатывается в regenerateInto.
+  for (const pf of _pendingConnectionFromRef()) {
+    if (mediaRefs.some(r => r.file === pf.file && r.boardHandle === pf.boardHandle)) continue;
+    mediaRefs.push(pf);
+  }
   const missing = mediaRefs.filter(r => !r.file || r.status === 'generating');
   if (missing.length) {
     alert('Эти ноды ещё не готовы: ' + missing.map(m => '@' + m.name).join(', '));

package/renderer/media.js

@@ -843,6 +843,17 @@ async function regenerateInto(node, kind, rawPrompt, opts = {}) {
       if (refs.some(r => r.file === pr.file && r.boardHandle === pr.boardHandle)) continue;
       refs.push(pr);
     }
+    // Incoming-edge refs: для text-нод OpenRouter chat принимает image-входы.
+    // Юзер: «если в ноду 'входит' нода-картинка/видео — подавай её как реф».
+    // Видео для text-gen бесполезно (модели не глотают video frames в chat
+    // API), поэтому фильтруем по image.
+    if (typeof gatherIncomingMediaRefs === 'function') {
+      for (const ir of gatherIncomingMediaRefs(node.id)) {
+        if (ir.type !== 'image') continue;
+        if (refs.some(r => r.file === ir.file && r.boardHandle === ir.boardHandle)) continue;
+        refs.push(ir);
+      }
+    }
     const missing = refs.filter(r => !r.file || r.status === 'generating');
     if (missing.length) {
       alert('Эти ноды ещё не готовы: ' + missing.map(m => '@' + (m.name || m.id)).join(', '));
@@ -875,6 +886,17 @@ async function regenerateInto(node, kind, rawPrompt, opts = {}) {
       if (refs.some(r => r.file === pr.file && r.boardHandle === pr.boardHandle)) continue;
       refs.push(pr);
     }
+    // Incoming-edge refs (image/video → image/video нода). Юзер: «если в
+    // ноду 'входит' несколько других нод-картинок или 'нод-видео' —
+    // подавай их тоже как референсы». Граф уже выражает связь, не нужно
+    // дублировать через @name в промпте. Берём ВСЕ incoming media-источники
+    // — не только pending-anchor, как для NEW ноды.
+    if (typeof gatherIncomingMediaRefs === 'function') {
+      for (const ir of gatherIncomingMediaRefs(node.id)) {
+        if (refs.some(r => r.file === ir.file && r.boardHandle === ir.boardHandle)) continue;
+        refs.push(ir);
+      }
+    }
     const missing = refs.filter(r => !r.file || r.status === 'generating');
     if (missing.length) {
       alert('Эти ноды ещё не готовы: ' + missing.map(m => '@' + (m.name || m.id)).join(', '));

package/skill/SKILL.md

@@ -395,6 +395,7 @@ open -a "Google Chrome" "http://localhost:17893/"
       },
       "status": "generating" | "draft" | "error",  // отсутствует если нода готова
       "error": "...",
+      "description": "опц. текст-аннотация под image/video нодой",  // см. раздел «Описания нод»
       "linkedBoard": {                       // опц., ссылка на другую доску
         "kind": "episode" | "character" | "location",
         "name": "Сцена 2"                    // имя целевой доски (handle резолвится в runtime)
@@ -479,6 +480,66 @@ open -a "Google Chrome" "http://localhost:17893/"
    }
    ```
 
+## Описания нод (image / video)
+
+`image` и `video` ноды могут нести **текст-аннотацию** — `node.description`.
+Это полноценная замена «соседней text-ноды»: вместо отдельной ноды юзер
+может прикрепить описание прямо к картинке/видео, и оно «едет» вместе с
+нодой по холсту.
+
+**Формат** (поле в ноде):
+```json5
+{
+  "type": "image" | "video",
+  "file": "images/foo.jpg",
+  "x": 100, "y": 100, "width": 280, "height": 280,
+  "description": "Лес ночью, луна за облаками, тишина — общий план."
+}
+```
+
+Поддерживается только для `type` ∈ `{image, video}`. Для `audio` и `text` —
+игнорируется (у text — сам текст уже в `.md`, у audio — иногда нет визуального
+места под caption).
+
+**Где отображается**:
+
+Описание рендерится **вне** ноды — как отдельный sibling-блок на холсте,
+плотно под нижней границей ноды. Раньше пробовали инлайн внутри `.node`,
+но `image/video` задают фиксированный aspect-ratio + `paint-containment`
+у `.node` клипит overflow → текст ниже не был виден. Теперь:
+
+- Позиция: `left = node.x`, `top = node.y + node.height + 4`
+- Ширина = `node.width` (точно по ширине ноды)
+- Высота = `auto` по контенту (текст любой длины помещается)
+- Движется вместе с нодой при drag, resize, fit-to-media
+
+**UI**:
+- ПКМ на image/video ноде → «📝 Добавить описание…» (или «📝 Изменить
+  описание…» если уже есть). Открывает большую textarea-модалку (Cmd+Enter
+  — сохранить).
+- Если описание пустое — sidecar-элемент удаляется из DOM (нода визуально
+  возвращается к «голой» картинке).
+
+**Когда использовать описание vs соседнюю text-ноду**:
+
+- **Описание** — короткая аннотация, привязанная к этому конкретному кадру:
+  «фон облака», «крупный план рук», «свет от свечи». Юзер видит контекст
+  картинки не уходя глазами в сторону.
+- **Отдельная text-нода** — самостоятельный смысловой блок (диалог, сценарий,
+  заметка), который должен быть отдельной сущностью на холсте (рисуем
+  связи, переставляем независимо от кадра).
+
+**Через CLI / правку scene.json**:
+
+```bash
+# Добавить описание к существующей ноде (правка scene.json напрямую):
+# найди ноду по name или id, добавь поле "description"
+```
+
+Прямой CLI-флаг для description пока **не реализован**. Если нужно массово
+проставить описания — правь `scene.json` через `jq` или скриптом, редактор
+подхватит при следующем открытии доски.
+
 ## Ссылки на доски (link-to-scene)
 
 Нода может содержать ссылку на другую сцену/персонажа/локацию того же
@@ -497,7 +558,15 @@ open -a "Google Chrome" "http://localhost:17893/"
 - ПКМ на ноде → «🔗 Сделать ссылку на сцену…» (picker всех досок проекта,
   кроме текущей). Меняется на «🔗 Перейти → <имя>» + «⛓️‍💥 Убрать ссылку»
   когда ссылка уже есть.
-- На ноде со ссылкой — значок 🔗 в правом-верхнем углу.
+- На ноде со ссылкой — **большая явная кнопка «Перейти → <имя сцены>»**
+  внизу ноды (чуть выше нижней границы, абсолютно позиционирована поверх
+  контента). Раньше был маленький значок 🔗 в правом-верхнем углу, но юзер
+  попросил убрать в пользу явной кнопки — она читабельнее на маленьких
+  preview-картинках. Для `drawing`-нод (стрелок) кнопка скрыта — она там
+  визуально странная.
+- В share-модалке (расшарить проект) рядом с «Расшарить» есть кнопка
+  «↗ Перейти» — открывает share-ссылку в новой вкладке для быстрого
+  превью что увидит получатель.
 - Дабл-клик на ноде = переход (перебивает обычное действие dblclick типа
   fullscreen-просмотра).
 - Если целевая доска переименована/удалена — алерт «не найдена».
@@ -508,6 +577,38 @@ open -a "Google Chrome" "http://localhost:17893/"
 структура). Но переименование целевой доски ломает ссылку — нужно
 обновлять вручную в scene.json или пересоздавать через ПКМ.
 
+**Через CLI**: прямого `kingkont link-node` пока нет — правь
+`scene.json` напрямую, добавь к ноде поле `linkedBoard`.
+
+## Connections как авто-референсы (incoming edges)
+
+Если в image/video/text-ноду **«входит» другая нода** (есть `connection`
+где `to === thisNode.id`) — её содержимое **автоматически** идёт в refs
+при генерации/регенерации этой ноды. Юзер не обязан дублировать `@name`
+в промпте — граф уже выражает связь.
+
+Правила (применяются при genSubmit и regenerateInto):
+- Источник `type: image` → добавляется как image-реф (всегда).
+- Источник `type: video` → добавляется как video-реф для image/video-нод;
+  для text-нод **пропускается** (OpenRouter chat API не глотает video).
+- Источник без `file` (ещё не сгенерирован / draft) → пропускается, чтобы
+  не блокировать gen alert'ом «нода ещё не готова».
+- Источник `type: text|audio|drawing|label` → не добавляется в refs
+  (для text-источников юзер должен явно писать `[@name]` в промпте,
+  это позволяет контролировать ГДЕ инлайнится содержимое).
+
+Кейсы где это даёт «бесплатные» референсы:
+- **New нода через anchor-drag**: тянешь линию от image-ноды на пустое
+  место → меню → «Сгенерить картинку» → новая нода получает источник как
+  ref без писанины в промпте.
+- **Regen существующей ноды с несколькими incoming**: связал draft-image с
+  тремя image-источниками (характер + локация + propsheet), нажал
+  «↻ Перегенерировать» — все три попадают в refs автоматически.
+
+Если нужно НЕ использовать какой-то incoming источник как реф — удали
+саму connection (`scene.json → connections[]`) или временно переименуй
+источник так чтобы он не нашёлся (или unfile его — `delete n.file`).
+
 ## Файловые операции
 
 - **Удаление ноды**: файл переезжает в `<root>/_deleted/<уникальное-имя>`.