kingkont 0.9.3 → 0.10.1

package/index.html

@@ -130,6 +130,7 @@
     </div>
     <button id="charSettingsBtn" style="display:none;" title="Настройки персонажа">⚙</button>
     <button id="timelineBtn" title="Показать/скрыть таймлайн">🎬 Таймлайн</button>
+    <button id="chatBtn" title="Чат с Claude (Cmd+J)" onclick="window.kingChat?.toggle?.()">💬 Чат</button>
     <!-- скрытые, но используемые элементы (logic ссылается по id) -->
     <span id="hint" class="path" style="display:none;"></span>
     <span id="boardBadge" class="badge" style="display:none;"></span>
@@ -609,6 +610,8 @@
 <!-- cloudProjects.js — после templates.js, переиспользует TPL_PROGRESS,
      walkBoardFiles, collectProjectBoards, uploadProjectCoverIfAny из templates.js. -->
 <script src="renderer/cloudProjects.js"></script>
+<!-- chat.js — Claude-чат для управления сценой через tools (Cmd+J). -->
+<script src="renderer/chat.js"></script>
 
 </body>
 </html>

package/lib/providers.js

@@ -432,8 +432,10 @@ async function waitForGeneration(taskId, settings, opts = {}) {
 /**
  * @returns {Promise<{ text, model, cost?, provider }>}
  */
-async function generateText({ prompt, model = 'anthropic/claude-sonnet-4', system, images, settings: s }) {
-  if (!prompt) throw new Error('нужен prompt');
+async function generateText({ prompt, messages: msgsIn, model = 'anthropic/claude-sonnet-4', system, images, settings: s }) {
+  if (!prompt && !(Array.isArray(msgsIn) && msgsIn.length)) {
+    throw new Error('нужен prompt или messages');
+  }
 
   // Приоритет: OpenRouter direct (если useOpenrouter+key) → Chatium → ошибка.
   // Юзер явно включил прямой коннектор → используем его (Chatium-кредиты
@@ -442,10 +444,11 @@ async function generateText({ prompt, model = 'anthropic/claude-sonnet-4', syste
   const directOpenrouter = s.useOpenrouter && process.env.OPENROUTER_API_KEY;
 
   if (s.useChatium && s.chatium?.token && s.chatium?.base && !directOpenrouter) {
-    const body = {
-      prompt, model, system,
-      images: Array.isArray(images) ? images.filter(i => i?.url) : undefined,
-    };
+    // Если переданы messages — шлём их напрямую (chat-режим, multi-turn).
+    // Chatium-side /api/text уважает body.messages — игнорирует prompt+images.
+    const body = msgsIn?.length
+      ? { messages: msgsIn, model, system }
+      : { prompt, model, system, images: Array.isArray(images) ? images.filter(i => i?.url) : undefined };
     const taskId = await chatiumStart(s, 'text', body);
     const result = await chatiumWait(s, taskId, { timeoutMs: 120000 });
     return {
@@ -464,17 +467,23 @@ async function generateText({ prompt, model = 'anthropic/claude-sonnet-4', syste
   }
   const key = process.env.OPENROUTER_API_KEY;
 
-  const messages = [];
-  if (system) messages.push({ role: 'system', content: system });
-  if (Array.isArray(images) && images.length) {
-    const content = [{ type: 'text', text: prompt }];
-    for (const img of images) {
-      if (!img?.url) continue;
-      content.push({ type: 'image_url', image_url: { url: img.url } });
-    }
-    messages.push({ role: 'user', content });
+  // Для OpenRouter: либо переданы готовые messages, либо собираем из prompt+images.
+  let messages;
+  if (msgsIn?.length) {
+    messages = system ? [{ role: 'system', content: system }, ...msgsIn] : msgsIn;
   } else {
-    messages.push({ role: 'user', content: prompt });
+    messages = [];
+    if (system) messages.push({ role: 'system', content: system });
+    if (Array.isArray(images) && images.length) {
+      const content = [{ type: 'text', text: prompt }];
+      for (const img of images) {
+        if (!img?.url) continue;
+        content.push({ type: 'image_url', image_url: { url: img.url } });
+      }
+      messages.push({ role: 'user', content });
+    } else {
+      messages.push({ role: 'user', content: prompt });
+    }
   }
   logCall('POST', 'OpenRouter', 'https://openrouter.ai/api/v1/chat/completions', `model=${model} prompt=${prompt.length}ch`);
   const r = await fetch('https://openrouter.ai/api/v1/chat/completions', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.9.3",
+  "version": "0.10.1",
   "description": "KingKont · Chatium — нод-редактор сцен с AI-генерацией (картинки/видео/голос/SFX/музыка/текст)",
   "main": "main.js",
   "bin": {

package/renderer/board.js

@@ -949,6 +949,9 @@ async function closeProject() {
   // Помечаем что юзер вышел явно — на следующем старте autoload пропускается.
   // Cmd+R после close = welcome, а не реоткрытие.
   try { localStorage.setItem('welcomeOnNextStart', '1'); } catch {}
+  // Чат привязан к одному проекту — чистим историю при выходе чтобы
+  // не путал контекст следующего открытого проекта.
+  if (window.kingChat?.clear) window.kingChat.clear();
   stopExternalWatcher();
   // Сбрасываем UI таймлайна/превью — иначе при возврате через welcome
   // в новый проект остаётся фрейм/дорожки прошлого.

package/renderer/chat.js

@@ -0,0 +1,507 @@
+// renderer/chat.js — Чат с Claude для управления сценой через LLM-tools.
+//
+// Архитектура:
+//   - Отдельный модуль (этот файл) — НЕ трогает board.js / generate.js напрямую.
+//   - Использует window.* публичные функции (selectBoard, askName, scheduleSave,
+//     mutateNode, refreshSidebar, и т.п.), либо мутирует state.currentBoard
+//     и зовёт renderCanvas() / scheduleSave().
+//   - LLM через POST /api/text (server.js → providers.generateText). Это даёт
+//     доступ к KingKont (Chatium) и OpenRouter одновременно — выбор делает
+//     server по настройкам.
+//
+// Tool-protocol (text-embedded — работает с любой моделью без native function-calling):
+//   Модель в ответе может выдать одну или несколько строк вида:
+//     <tool>{"name":"add_node","args":{"kind":"image","prompt":"sunset"}}</tool>
+//   Мы парсим эти блоки, исполняем последовательно, формируем результаты:
+//     <tool_result>{"name":"add_node","ok":true,"result":{"id":"abc-123"}}</tool_result>
+//   Шлём их как user-message обратно модели → она продолжает и/или говорит
+//   итоговый ответ. Цикл до `done` (без tool_call'ов в ответе) или max-iterations.
+//
+// Tools (минимальный полезный набор для v1):
+//   list_scenes, select_scene, add_scene, read_scene, add_node,
+//   update_node_prompt, connect_nodes, delete_node, generate_node
+//
+// Сохранение conversation: in-memory (state.chatHistory), сбрасывается на
+// новый проект. Для persistence — ToDo (дописать в .kingkont-meta.json).
+
+(function () {
+  function $(id) { return document.getElementById(id); }
+  const MAX_TOOL_ITERATIONS = 8;
+
+  // ============== TOOL DEFINITIONS ==============
+  // Каждый tool: name, description, params (schema-doc для модели), handler.
+  // Handler — async (args) → result-object либо throw.
+
+  const TOOLS = {
+    list_scenes: {
+      description: 'Список всех досок (сцен / персонажей / общих) текущего проекта.',
+      params: '{}',
+      async handler() {
+        if (!state.filmHandle) throw new Error('проект не открыт');
+        const eps = (await listEpisodes(state.filmHandle)).map(b => ({ kind: 'episode', name: b.name }));
+        const chs = (await listCharacters(state.filmHandle)).map(b => ({ kind: 'character', name: b.name }));
+        const lcs = (await listLocations(state.filmHandle)).map(b => ({ kind: 'location', name: b.name }));
+        return { scenes: eps, characters: chs, locations: lcs, current: state.currentBoard ? { kind: state.currentBoard.kind, name: state.currentBoard.name } : null };
+      },
+    },
+
+    select_scene: {
+      description: 'Открыть указанную доску. После этого read_scene/add_node работают с ней.',
+      params: '{"kind":"episode|character|location","name":"<exact-name>"}',
+      async handler({ kind, name }) {
+        if (!state.filmHandle) throw new Error('проект не открыт');
+        const list = kind === 'character' ? await listCharacters(state.filmHandle)
+                   : kind === 'location'  ? await listLocations(state.filmHandle)
+                   : await listEpisodes(state.filmHandle);
+        const found = list.find(b => b.name === name);
+        if (!found) throw new Error(`не найдено: ${kind}/${name}`);
+        await selectBoard({ kind, ...found });
+        return { ok: true };
+      },
+    },
+
+    add_scene: {
+      description: 'Создать новую доску.',
+      params: '{"kind":"episode|character|location","name":"<unique-name>"}',
+      async handler({ kind, name }) {
+        if (!state.filmHandle) throw new Error('проект не открыт');
+        let parent;
+        if (kind === 'character')      parent = await state.filmHandle.getDirectoryHandle('_characters', { create: true });
+        else if (kind === 'location')  parent = await state.filmHandle.getDirectoryHandle('_locations', { create: true });
+        else                           parent = state.filmHandle;
+        const handle = await parent.getDirectoryHandle(name, { create: true });
+        if (typeof refreshSidebar === 'function') await refreshSidebar();
+        await selectBoard({ kind, name, handle });
+        return { ok: true, kind, name };
+      },
+    },
+
+    read_scene: {
+      description: 'Текущая доска: список нод (id, type, name?, prompt?, file?, x, y) и связи.',
+      params: '{}',
+      async handler() {
+        const b = state.currentBoard;
+        if (!b) throw new Error('доска не выбрана — используй select_scene');
+        const nodes = (b.metadata.nodes || []).map(n => ({
+          id: n.id,
+          type: n.type,
+          name: n.name || null,
+          x: n.x, y: n.y,
+          prompt: n.generated?.rawPrompt || n.generated?.prompt || null,
+          file: n.file || null,
+          status: n.status || (n.file ? 'done' : 'draft'),
+          modelKey: n.generated?.modelKey || null,
+        }));
+        const connections = (b.metadata.connections || []).map(c => ({ from: c.from, to: c.to, toPort: c.toPort || null }));
+        const settings = b.metadata.settings || {};
+        return { kind: b.kind, name: b.name, nodes, connections, settings };
+      },
+    },
+
+    add_node: {
+      description: 'Добавить ноду на текущую доску. Для image/video/audio promptа можно задать prompt — нода будет в draft-состоянии (юзер запустит generation отдельно или используй generate_node).',
+      params: '{"type":"image|video|audio|text","name":"<optional>","prompt":"<optional>","x":<optional>,"y":<optional>,"text":"<for-type=text>","modelKey":"<optional>"}',
+      async handler({ type, name, prompt, x, y, text, modelKey }) {
+        if (!state.currentBoard) throw new Error('доска не выбрана');
+        if (!['image','video','audio','text','label'].includes(type)) throw new Error(`unknown type: ${type}`);
+        // Авто-координаты — справа от последней ноды.
+        const last = state.currentBoard.metadata.nodes[state.currentBoard.metadata.nodes.length - 1];
+        const nx = typeof x === 'number' ? x : (last ? last.x + 320 : 100);
+        const ny = typeof y === 'number' ? y : (last ? last.y : 100);
+        const id = (crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).slice(2));
+        const node = { id, type, x: nx, y: ny };
+        if (name) node.name = name;
+        if (type === 'text' && typeof text === 'string') {
+          node.text = text;
+          // .md создастся при saveBoardMetadata.
+        }
+        if (prompt && type !== 'text' && type !== 'label') {
+          node.status = 'draft';
+          node.generated = { rawPrompt: prompt, prompt, modelKey: modelKey || undefined };
+        }
+        state.currentBoard.metadata.nodes.push(node);
+        scheduleSave();
+        if (typeof renderCanvas === 'function') await renderCanvas();
+        return { ok: true, id };
+      },
+    },
+
+    update_node_prompt: {
+      description: 'Обновить промпт у image/video/audio ноды (без re-генерации).',
+      params: '{"id":"<node-id>","prompt":"<new>"}',
+      async handler({ id, prompt }) {
+        const b = state.currentBoard;
+        if (!b) throw new Error('доска не выбрана');
+        const node = b.metadata.nodes.find(n => n.id === id);
+        if (!node) throw new Error(`нода не найдена: ${id}`);
+        node.generated = { ...(node.generated || {}), rawPrompt: prompt, prompt };
+        scheduleSave();
+        if (typeof renderCanvas === 'function') await renderCanvas();
+        return { ok: true };
+      },
+    },
+
+    connect_nodes: {
+      description: 'Соединить две ноды (from → to). toPort: "image" | "video" | "audio" — куда подаём ссылку (опционально, для @-резолва при генерации).',
+      params: '{"from":"<id>","to":"<id>","toPort":"image|video|audio (optional)"}',
+      async handler({ from, to, toPort }) {
+        const b = state.currentBoard;
+        if (!b) throw new Error('доска не выбрана');
+        if (!b.metadata.nodes.find(n => n.id === from)) throw new Error(`from-нода не найдена: ${from}`);
+        if (!b.metadata.nodes.find(n => n.id === to)) throw new Error(`to-нода не найдена: ${to}`);
+        const conns = b.metadata.connections;
+        if (conns.find(c => c.from === from && c.to === to)) return { ok: true, note: 'связь уже есть' };
+        const conn = { from, to };
+        if (toPort) conn.toPort = toPort;
+        conns.push(conn);
+        scheduleSave();
+        if (typeof renderConnections === 'function') renderConnections();
+        return { ok: true };
+      },
+    },
+
+    delete_node: {
+      description: 'Удалить ноду. Файл (если есть) переедет в _deleted/.',
+      params: '{"id":"<node-id>"}',
+      async handler({ id }) {
+        const b = state.currentBoard;
+        if (!b) throw new Error('доска не выбрана');
+        const node = b.metadata.nodes.find(n => n.id === id);
+        if (!node) throw new Error(`нода не найдена: ${id}`);
+        const el = document.querySelector(`.node[data-id="${id}"]`);
+        if (typeof deleteNode === 'function') await deleteNode(node, el);
+        else {
+          // Fallback: просто убираем из массива.
+          b.metadata.nodes = b.metadata.nodes.filter(n => n.id !== id);
+          b.metadata.connections = (b.metadata.connections || []).filter(c => c.from !== id && c.to !== id);
+          scheduleSave();
+          if (typeof renderCanvas === 'function') await renderCanvas();
+        }
+        return { ok: true };
+      },
+    },
+
+    generate_node: {
+      description: 'Запустить генерацию для draft-ноды (image/video/audio). Возвращает сразу — генерация идёт в фоне.',
+      params: '{"id":"<node-id>"}',
+      async handler({ id }) {
+        const b = state.currentBoard;
+        if (!b) throw new Error('доска не выбрана');
+        const node = b.metadata.nodes.find(n => n.id === id);
+        if (!node) throw new Error(`нода не найдена: ${id}`);
+        if (typeof regenerateNode !== 'function') throw new Error('regenerateNode недоступен');
+        regenerateNode(node);
+        return { ok: true, note: 'генерация запущена в фоне' };
+      },
+    },
+  };
+
+  // System-prompt: объясняет модели tool-protocol + что доступно.
+  function buildSystemPrompt() {
+    const lines = [
+      'Ты — ассистент в KingKont (нод-редактор сцен с AI-генерацией).',
+      'Помогаешь пользователю строить раскадровки: создавать сцены, добавлять/связывать ноды (image/video/audio/text), задавать промпты, запускать генерацию.',
+      '',
+      'ИНСТРУМЕНТЫ. Чтобы что-то сделать, выдай в своём ответе одну или несколько строк ровно в таком формате:',
+      '<tool>{"name":"<tool_name>","args":{...}}</tool>',
+      'Я выполню каждый tool и пришлю результаты как <tool_result>{...}</tool_result> в следующем сообщении. После результатов продолжай (можешь звать ещё tools или дать финальный ответ).',
+      '',
+      'Доступные инструменты:',
+    ];
+    for (const [name, def] of Object.entries(TOOLS)) {
+      lines.push(`- ${name} — ${def.description}`);
+      lines.push(`  args: ${def.params}`);
+    }
+    lines.push('');
+    lines.push('Правила:');
+    lines.push('- Не выдумывай id нод — сначала read_scene/list_scenes.');
+    lines.push('- Не выдумывай имена сцен — list_scenes покажет реальные.');
+    lines.push('- Если нужен новый id для add_node — оставь поле пустым, вернётся в результате.');
+    lines.push('- Для генерации используй generate_node ПОСЛЕ add_node с promptом.');
+    lines.push('- Отвечай по-русски, кратко. Объясняй что делаешь, без лишней воды.');
+    return lines.join('\n');
+  }
+
+  // ============== TOOL-CALL PARSER ==============
+  function parseToolCalls(text) {
+    const out = [];
+    const re = /<tool>\s*([\s\S]*?)\s*<\/tool>/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      try {
+        const obj = JSON.parse(m[1]);
+        if (obj && typeof obj.name === 'string') out.push({ name: obj.name, args: obj.args || {} });
+      } catch (e) {
+        out.push({ _parseError: e.message, raw: m[1] });
+      }
+    }
+    return out;
+  }
+  function stripToolCalls(text) {
+    return text.replace(/<tool>[\s\S]*?<\/tool>/g, '').trim();
+  }
+
+  // ============== UI ==============
+  let history = [];   // [{role: 'user'|'assistant'|'system', content: string, tools?: [...], results?: [...]}]
+  let busy = false;
+
+  function renderHistory() {
+    const list = $('chatList');
+    if (!list) return;
+    list.innerHTML = '';
+    for (const m of history) {
+      if (m.role === 'system') continue;
+      const div = document.createElement('div');
+      div.className = 'chat-msg chat-msg-' + m.role;
+      const lbl = document.createElement('div');
+      lbl.className = 'chat-msg-role';
+      lbl.textContent = m.role === 'user' ? 'Вы' : 'Claude';
+      div.appendChild(lbl);
+      const body = document.createElement('div');
+      body.className = 'chat-msg-body';
+      body.textContent = m.content || '';
+      div.appendChild(body);
+      // Tool-calls collapsible.
+      if (Array.isArray(m.tools) && m.tools.length) {
+        for (const tc of m.tools) {
+          const t = document.createElement('details');
+          t.className = 'chat-tool';
+          const sum = document.createElement('summary');
+          sum.textContent = `🔧 ${tc.name}` + (tc._error ? '  (ошибка)' : tc._ok ? '  ✓' : '');
+          t.appendChild(sum);
+          const pre = document.createElement('pre');
+          pre.textContent = JSON.stringify({ args: tc.args, result: tc.result, error: tc._error }, null, 2);
+          t.appendChild(pre);
+          div.appendChild(t);
+        }
+      }
+      list.appendChild(div);
+    }
+    list.scrollTop = list.scrollHeight;
+  }
+
+  function appendStatus(msg) {
+    const list = $('chatList');
+    if (!list) return;
+    const div = document.createElement('div');
+    div.className = 'chat-status';
+    div.textContent = msg;
+    list.appendChild(div);
+    list.scrollTop = list.scrollHeight;
+    return div;
+  }
+
+  // ============== LLM call + tool-loop ==============
+  async function callLLM(messages, system) {
+    const r = await fetch('/api/text', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        messages, system,
+        model: 'anthropic/claude-sonnet-4.6',
+      }),
+    });
+    if (!r.ok) {
+      const err = await r.json().catch(() => ({}));
+      throw new Error(err.error || `HTTP ${r.status}`);
+    }
+    const d = await r.json();
+    return d.text || '';
+  }
+
+  // Превращает internal history → массив для /api/text. tool_results
+  // объединяем в user-message (модель видит их как ответы юзера на её запрос).
+  function historyToMessages() {
+    const out = [];
+    for (const m of history) {
+      if (m.role === 'system') continue;
+      out.push({ role: m.role, content: m.content });
+    }
+    return out;
+  }
+
+  async function runTool(name, args) {
+    const def = TOOLS[name];
+    if (!def) throw new Error(`unknown tool: ${name}`);
+    return await def.handler(args || {});
+  }
+
+  async function send(userText) {
+    if (busy) return;
+    if (!userText.trim()) return;
+    busy = true;
+    history.push({ role: 'user', content: userText });
+    renderHistory();
+    const status = appendStatus('Claude думает…');
+    const system = buildSystemPrompt();
+    try {
+      let iter = 0;
+      while (iter < MAX_TOOL_ITERATIONS) {
+        iter++;
+        const text = await callLLM(historyToMessages(), system);
+        const toolCalls = parseToolCalls(text);
+        const cleanText = stripToolCalls(text);
+        const assistantMsg = {
+          role: 'assistant',
+          content: cleanText,
+          tools: [],
+        };
+        history.push(assistantMsg);
+
+        if (!toolCalls.length) {
+          // Финальный ответ — больше нечего исполнять.
+          status.remove();
+          renderHistory();
+          break;
+        }
+
+        // Исполняем tools, собираем результаты.
+        status.textContent = `Выполняю ${toolCalls.length} tool(s)…`;
+        const results = [];
+        for (const tc of toolCalls) {
+          if (tc._parseError) {
+            results.push({ name: 'parse_error', error: tc._parseError, raw: tc.raw });
+            assistantMsg.tools.push({ name: 'parse_error', _error: tc._parseError });
+            continue;
+          }
+          try {
+            const r = await runTool(tc.name, tc.args);
+            results.push({ name: tc.name, ok: true, result: r });
+            assistantMsg.tools.push({ name: tc.name, args: tc.args, result: r, _ok: true });
+          } catch (e) {
+            results.push({ name: tc.name, ok: false, error: e?.message || String(e) });
+            assistantMsg.tools.push({ name: tc.name, args: tc.args, _error: e?.message || String(e) });
+          }
+        }
+        renderHistory();
+
+        // Шлём результаты обратно как user-message (чтобы Claude увидел и продолжил).
+        const resultsMsg = results.map(r => `<tool_result>${JSON.stringify(r)}</tool_result>`).join('\n');
+        history.push({ role: 'user', content: resultsMsg });
+        // Не рендерим этот системный turn (renderHistory его отфильтровывает) —
+        // на самом деле он role='user', придётся скрыть руками. Делаем простую
+        // эвристику: если content начинается с <tool_result>, не показываем.
+        // Тут же — это можно сделать через флаг.
+      }
+      if (iter >= MAX_TOOL_ITERATIONS) {
+        appendStatus(`⚠ остановился после ${MAX_TOOL_ITERATIONS} итераций`);
+      }
+    } catch (e) {
+      status.textContent = '⚠ ' + (e?.message || e);
+      status.classList.add('error');
+    } finally {
+      busy = false;
+    }
+  }
+
+  // Скрываем tool_result-сообщения из UI (они нужны только модели).
+  // renderHistory вызывает renderHistory — оставлю как есть, плюс добавлю
+  // фильтр прямо там. Уже добавлен через role-check, но tool_result идут
+  // как role='user' с content начинающимся с <tool_result>. Дофильтруем:
+  const _origRender = renderHistory;
+  // (пере-оборачиваю чтобы не дублировать DOM-логику)
+  function renderHistoryFiltered() {
+    const list = $('chatList');
+    if (!list) return;
+    list.innerHTML = '';
+    for (const m of history) {
+      if (m.role === 'system') continue;
+      if (m.role === 'user' && m.content?.startsWith('<tool_result>')) continue;  // системный turn
+      const div = document.createElement('div');
+      div.className = 'chat-msg chat-msg-' + m.role;
+      const lbl = document.createElement('div');
+      lbl.className = 'chat-msg-role';
+      lbl.textContent = m.role === 'user' ? 'Вы' : 'Claude';
+      div.appendChild(lbl);
+      const body = document.createElement('div');
+      body.className = 'chat-msg-body';
+      body.textContent = m.content || '';
+      div.appendChild(body);
+      if (Array.isArray(m.tools) && m.tools.length) {
+        for (const tc of m.tools) {
+          const t = document.createElement('details');
+          t.className = 'chat-tool';
+          const sum = document.createElement('summary');
+          sum.textContent = `🔧 ${tc.name}` + (tc._error ? '  (ошибка)' : tc._ok ? '  ✓' : '');
+          t.appendChild(sum);
+          const pre = document.createElement('pre');
+          pre.textContent = JSON.stringify({ args: tc.args, result: tc.result, error: tc._error }, null, 2);
+          t.appendChild(pre);
+          div.appendChild(t);
+        }
+      }
+      list.appendChild(div);
+    }
+    list.scrollTop = list.scrollHeight;
+  }
+  // Перебиндим
+  renderHistory = renderHistoryFiltered;
+
+  // ============== UI wiring ==============
+  function ensureUI() {
+    if ($('chatPanel')) return;
+    const panel = document.createElement('aside');
+    panel.id = 'chatPanel';
+    panel.className = 'chat-panel hidden';
+    panel.innerHTML = `
+      <div class="chat-header">
+        <strong>💬 Чат</strong>
+        <span class="spacer"></span>
+        <button id="chatClear" title="Очистить историю">⌫</button>
+        <button id="chatClose" title="Закрыть">×</button>
+      </div>
+      <div id="chatList" class="chat-list"></div>
+      <div class="chat-input-row">
+        <textarea id="chatInput" placeholder="Что нужно сделать со сценой? (Cmd+Enter — отправить)" rows="3"></textarea>
+        <button id="chatSend" class="primary" title="Отправить (Cmd+Enter)">▶</button>
+      </div>
+    `;
+    document.body.appendChild(panel);
+    $('chatClose').addEventListener('click', () => panel.classList.add('hidden'));
+    $('chatClear').addEventListener('click', () => {
+      if (!confirm('Очистить историю чата?')) return;
+      history = [];
+      renderHistory();
+    });
+    $('chatSend').addEventListener('click', () => {
+      const ta = $('chatInput');
+      const txt = ta.value.trim();
+      if (!txt) return;
+      ta.value = '';
+      send(txt);
+    });
+    $('chatInput').addEventListener('keydown', e => {
+      if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) {
+        e.preventDefault();
+        $('chatSend').click();
+      }
+    });
+  }
+
+  function toggle() {
+    ensureUI();
+    const panel = $('chatPanel');
+    panel.classList.toggle('hidden');
+    if (!panel.classList.contains('hidden')) {
+      setTimeout(() => $('chatInput')?.focus(), 50);
+    }
+  }
+
+  // Public API.
+  window.kingChat = {
+    toggle,
+    open: () => { ensureUI(); $('chatPanel').classList.remove('hidden'); setTimeout(() => $('chatInput')?.focus(), 50); },
+    close: () => $('chatPanel')?.classList.add('hidden'),
+    send,
+    clear: () => { history = []; renderHistory(); },
+    tools: TOOLS,
+  };
+
+  // Hot-key: Cmd+J (как Cmd+L в IDE, но не конфликтует) — toggle чата.
+  document.addEventListener('keydown', e => {
+    if ((e.metaKey || e.ctrlKey) && e.key === 'j') {
+      e.preventDefault();
+      toggle();
+    }
+  });
+})();

package/renderer/cloudProjects.js

@@ -196,7 +196,46 @@
   async function openCloudProject(projectId, suggestedName, opts = {}) {
     const s = await getSettings();
     if (!isLoggedIn(s)) { alert('Войдите в KingKont'); return; }
-    // 1. Проверяем синхронизирован ли уже локально.
+
+    // 0. Если этот cloud-проект ранее был сохранён ИЗ папочного — открываем
+    //    оригинальную папку (с уже скачанными файлами) и не качаем ничего.
+    //    Mapping cloudFolder:<projectId> → folderName ставит saveCloudProject.
+    //    Папка должна быть granted в FSAH (юзер раз дал — handle живёт в IDB).
+    if (!opts.forceRefresh) {
+      try {
+        const folderName = await idbGet(`cloudFolder:${projectId}`);
+        if (folderName) {
+          const folderHandle = await idbGet(`handle:${folderName}`);
+          if (folderHandle) {
+            // Verify permission still granted (без user-gesture не запрашиваем).
+            let g = 'prompt';
+            try { g = await folderHandle.queryPermission({ mode: 'readwrite' }); } catch {}
+            if (g === 'granted') {
+              // Дополнительно проверим что в папке лежит meta с тем же cloudProjectId
+              // (юзер мог перенести/изменить — тогда fallback на download).
+              try {
+                const metaFh = await folderHandle.getFileHandle('.kingkont-meta.json');
+                const metaTxt = await (await metaFh.getFile()).text();
+                const meta = JSON.parse(metaTxt);
+                if (meta.cloudProjectId === projectId) {
+                  state.cloudProjectId = projectId;
+                  state.cloudDirty = false;
+                  touchCloudOpened(projectId);
+                  await openFilm(folderHandle);
+                  setCloudButtonsVisibility();
+                  return;
+                }
+              } catch {}
+              // Permission granted но meta не совпала — обнуляем mapping
+              // (idbSet(null) — простой способ без отдельного idbDel).
+              try { await idbSet(`cloudFolder:${projectId}`, null); } catch {}
+            }
+          }
+        }
+      } catch {}
+    }
+
+    // 1. Проверяем синхронизирован ли уже в userData/cloud-projects/<id>/.
     if (window.cloudFs) {
       try {
         const metaText = await window.cloudFs.readText(projectId, '.kingkont-meta.json');
@@ -489,6 +528,22 @@
         });
       }
 
+      // 5) Если это ПАПОЧНЫЙ проект (не cloud-shim), запоминаем mapping
+      //    cloudProjectId → folderName в IDB. Когда юзер позже откроет
+      //    этот же cloud-проект из welcome, openCloudProject подхватит
+      //    оригинальную папку (с уже скачанными файлами) и НЕ будет
+      //    качать всё заново. Mapping живёт в той же IDB-схеме что
+      //    handle:<name>: cloudFolder:<projectId> = name.
+      if (!window.cloudFsShim?.isCloudHandle?.(state.filmHandle)) {
+        try {
+          await idbSet(`cloudFolder:${projectId}`, state.filmHandle.name);
+          // Также запоминаем cloudProjectId на текущей сессии — чтобы
+          // следующий save без перезахода не ловил «папочный → новый cloud».
+          state.cloudProjectId = projectId;
+          if (window.cloudProjects?.setVisibility) window.cloudProjects.setVisibility();
+        } catch {}
+      }
+
       PROGRESS.hide();
       markClean();
       const stats = reused

package/renderer/styles.css

@@ -247,6 +247,83 @@
     justify-content: flex-end;
   }
   /* Используем те же .balance-info pill'ы что и в sidebar-footer'е. */
+
+  /* === Чат-панель (Cmd+J — toggle, или window.kingChat.toggle()) === */
+  .chat-panel {
+    position: fixed; right: 0; top: 0; bottom: 0; width: 420px;
+    background: #1a1a1a; border-left: 1px solid #333;
+    display: flex; flex-direction: column;
+    z-index: 80;
+    box-shadow: -8px 0 32px rgba(0,0,0,0.4);
+  }
+  .chat-panel.hidden { display: none; }
+  .chat-header {
+    display: flex; align-items: center; gap: 6px;
+    padding: 10px 12px; border-bottom: 1px solid #2a2a2a;
+    color: #ddd; font-size: 13px;
+  }
+  .chat-header .spacer { flex: 1; }
+  .chat-header button {
+    background: transparent; border: 1px solid #333; color: #aaa;
+    border-radius: 4px; padding: 2px 8px; cursor: pointer; font-size: 12px;
+  }
+  .chat-header button:hover { background: #2a2a2a; color: #fff; }
+  .chat-list {
+    flex: 1; overflow-y: auto; padding: 12px;
+    display: flex; flex-direction: column; gap: 12px;
+  }
+  .chat-msg {
+    display: flex; flex-direction: column; gap: 4px;
+    padding: 10px 12px; border-radius: 8px;
+    font-size: 13px; line-height: 1.5;
+  }
+  .chat-msg-user { background: #1f2a3a; border: 1px solid #2a3a4a; }
+  .chat-msg-assistant { background: #1f1f1f; border: 1px solid #2a2a2a; }
+  .chat-msg-role {
+    font-size: 10px; text-transform: uppercase; letter-spacing: 0.5px;
+    color: #888;
+  }
+  .chat-msg-user .chat-msg-role { color: #6a9; }
+  .chat-msg-assistant .chat-msg-role { color: #c97; }
+  .chat-msg-body {
+    color: #e0e0e0; white-space: pre-wrap; word-break: break-word;
+  }
+  .chat-tool {
+    margin-top: 6px; background: #0e0e0e; border: 1px solid #2a2a2a;
+    border-radius: 4px; padding: 4px 8px; font-size: 11px;
+  }
+  .chat-tool summary {
+    cursor: pointer; color: #aac; outline: none;
+    font-family: ui-monospace, 'SF Mono', monospace;
+  }
+  .chat-tool pre {
+    margin: 6px 0 0; color: #888; font-size: 10px;
+    white-space: pre-wrap; word-break: break-all; max-height: 200px;
+    overflow-y: auto;
+  }
+  .chat-status {
+    color: #888; font-size: 11px; padding: 6px 10px;
+    background: #1a1a1a; border-radius: 4px; align-self: center;
+    font-style: italic;
+  }
+  .chat-status.error { color: #f88; background: #2a1818; }
+  .chat-input-row {
+    display: flex; gap: 6px; padding: 10px 12px;
+    border-top: 1px solid #2a2a2a; background: #1a1a1a;
+  }
+  .chat-input-row textarea {
+    flex: 1; resize: vertical; min-height: 50px; max-height: 200px;
+    background: #0e0e0e; color: #e0e0e0; border: 1px solid #333;
+    border-radius: 4px; padding: 8px; font-size: 13px; font-family: inherit;
+  }
+  .chat-input-row textarea:focus { outline: none; border-color: #4a6a9a; }
+  .chat-input-row button {
+    align-self: stretch; padding: 0 16px;
+    background: #e33377; color: #fff; border: none; border-radius: 4px;
+    cursor: pointer; font-size: 16px;
+  }
+  .chat-input-row button:hover { background: #d12a6a; }
+  .chat-input-row button:disabled { opacity: 0.5; cursor: default; }
   .welcome-open {
     margin-top: 16px;
     padding: 12px 28px; font-size: 15px; font-weight: 600;