Полное руководство по интерфейсу (Все кнопки)

На этой странице описаны каждая кнопка, переключатель и элемент управления внутри интерфейса Gamedev AI в редакторе Godot.

🗂️ Основные вкладки (Main Tabs)

Плагин имеет 3 вкладки в верхней части панели:

• Chat — основная панель взаимодействия с ИИ.
• Settings — управление ключами API, пресетами, промптами и индексацией.
• Git — нативный интегрированный контроль версий GitHub.

---

💬 Вкладка чата (Chat Tab)

Верхняя панель (Top Bar)

Кнопка	Функция
Preset Selector	Выпадающее меню для быстрого переключения между различными настройками провайдеров/моделей (например, "Gemini 3.1", "GPT-4o").
A- / A+	Уменьшение или увеличение размера шрифта в чате.
+ New Chat	Очищает текущий чат и начинает совершенно новую сессию.
⊙ History	Выпадающий список всех прошлых разговоров. Нажмите на один, чтобы восстановить полный контекст этой сессии.
💾 Summarize to Memory	Отправляет автоматический запрос ИИ для резюмирования архитектурных решений текущего разговора и сохранения их в персистентную память проекта.

Область чата (OutputDisplay)

• Отображает сообщения, отформатированные с помощью BBCode, с жирным шрифтом, курсивом, встроенным кодом и подсветкой синтаксиса для блоков кода.
• Кликабельные ссылки на файлы проекта (открываются в редакторе при нажатии).
• При наведении на текст для быстрого копирования появляется плавающая кнопка Copy.

Плеер TTS (Text-to-Speech)

Управление	Функция
▶ Read Aloud	Преобразует последний ответ ИИ в голос и воспроизводит его. Идеально подходит для прослушивания объяснений во время программирования.
⏹ Stop	Останавливает воспроизведение аудио.
Полоса прогресса	Для перемотки аудио вперед или назад.
Скорость (1.0x - 2.0x)	Управляет темпом воспроизведения.

Кнопки быстрого действия (Quick Action Buttons)

Кнопка	Что делает
✧ Refactor	Отправляет выделенный в редакторе код с запросом "Refactor this code". ИИ анализирует и предлагает структурные улучшения.
◆ Fix	Отправляет выделенный код с запросом "Fix errors in this code". ИИ идентифицирует ошибки и генерирует исправление.
💡 Explain	Отправляет выделенный код с запросом "Explain what this code does". ИИ объясняет каждую часть на русском языке.
↺ Undo	Отменяет последнее действие ИИ в проекте (используя систему Undo/Redo в Godot).
🖥 Fix Console	Читает последние красные ошибки из консоли вывода Godot и отправляет их напрямую ИИ для предложения исправлений.

Область ввода (Input Area)

Элемент	Функция
Текстовое поле	Введите ваше сообщение. Нажмите Shift + Enter для отправки.
📎 Attach	Открывает окно выбора файлов для прикрепления изображений, скриптов или любых файлов к запросу.
➤ Send	Отправляет сообщение ИИ для обработки.
Drag & Drop	Перетаскивайте узлы дерева сцены или файлы из файловой системы прямо в текстовое поле или область чата. ИИ получит полные метаданные.

Настройки промпта (Dropdown)

Эти опции сгруппированы под иконкой ⚙️ рядом с кнопкой отправки.

Настройка	Функция
Включить контекст	При активации плагин автоматически добавляет полное содержимое текущего открытого скрипта в редакторе к отправляемому сообщению.
Отправить скриншот	При активации он автоматически делает скриншот окна Godot и отправляет его вместе с сообщением для визуального анализа ИИ.
Сначала план	При активации ИИ не будет писать код. Он ответит только подробным планом. После проверки нажмите кнопку «Выполнить план», чтобы он начал кодить.
Режим наблюдения	При активации ИИ автоматически отслеживает консоль вывода Godot. Если он обнаружит критические ошибки, он предложит исправления автоматически.

---

⚙️ Вкладка настроек (Settings Tab)

Управление пресетами (Presets)

Элемент	Функция
Preset Selector	Выпадающее меню для выбора сохраненных пресетов.
Add	Создает новый пустой пресет.
Edit	Открывает панель редактирования (Название, Провайдер, API Ключ, Base URL, Модель).
Delete	Навсегда удаляет выбранный пресет.
Done Editing	Закрывает панель редактирования и сохраняет изменения.

Поля редактирования пресета

Поле	Описание
Preset Name	Идентификационное имя (например, "Gemini 3.1 Free").
Provider	Выбор между "Gemini" и "OpenAI / OpenRouter".
API Key	Ключ API выбранного провайдера.
Base URL	Базовый URL API (только для OpenAI/OpenRouter).
Model Name	Точное имя модели (например, gemini-2.5-flash, gpt-4o).

Язык (Language)

Элемент	Функция
Language Selector	Выпадающее меню для выбора языка интерфейса и ответов ИИ (русский, Português BR, English и другие).

Пользовательский системный промпт (Custom System Prompt)

Большое текстовое поле для фиксированных правил, которым ИИ всегда будет следовать. Пример: "Используй статическую типизацию во всех функциях. Комментируй на русском языке."

Кнопка	Функция
✨ Enhance Instructions with AI	Отправьте ваши текущие инструкции ИИ для автоматического улучшения (технические детали, лучшие практики). Предварительный просмотр перед принятием.

Векторная база данных (Vector Database)

Элемент	Функция
File List	Визуальный список всех файлов .gd в проекте со статусом индексации.
🔍 Scan Changes	Сканирует проект на наличие новых, измененных или удаленных файлов с момента последней индексации.
⚡ Index Codebase	Запускает процесс векторной индексации всех измененных скриптов через Embeddings API.

---

🐙 Вкладка Git (Git Tab)

Начальная настройка

Элемент	Функция
Initialize Repository	Инициализирует репозиторий Git в папке проекта (если он еще не существует).
Remote URL	Поле для вставки URL репозитория GitHub (например, https://github.com/user/repo.git).
Set Remote	Устанавливает URL удаленного репозитория.

Основные операции

Кнопка	Функция
🔃 Refresh Status	Обновляет статус Git (измененные/неотслеживаемые файлы, текущая ветка).
⬇️ Pull	Загружает последние изменения из удаленного репозитория.
✨ Auto-Generate Commit Message	ИИ анализирует все диффы и автоматически генерирует профессиональное сообщение для коммита.
Commit & Sync (Push)	Создает коммит для всех изменений с сообщением и отправляет их на GitHub.

Ветки (Branches)

Элемент	Функция
Branch Label	Отображает имя текущей ветки.
Branch Name Input	Поле для ввода имени новой или существующей ветки.
Checkout/Create Branch	Создает новую ветку или переключается на существующую.

Экстренные действия

Кнопка	Функция
⚠️ Undo Uncommitted Changes	Отменяет все локальные незакоммиченные изменения (возвращает к последнему коммиту). Требует подтверждения.
⚠️ Force Pull Overwrite	Полностью очищает и перезаписывает вашу локальную папку точным состоянием из облака. Требует подтверждения.
⚠️ Force Push	Перезаписывает историю удаленного репозитория локальной версией. Используйте с осторожностью!

---

📋 Панель диффов (Diff Panel - Обзор кода)

Когда ИИ генерирует или изменяет код, в чате появляется панель сравнения:

Элемент	Функция
Diff View	Отображение удаленных (красный) и добавленных (зеленый) строк бок о бок.
Apply Changes	Принимает изменения и применяет их к реальному файлу. Действие записывается в Undo/Redo Godot.
Skip	Отклоняет изменения. Ни один файл не модифицируется.