Системные требования

GOGIES IDE оптимизирована для быстрой и легкой работы. Она работает на стандартных веб-серверах без необходимости сложных сред выполнения Node.js на стороне хостинга.

  • Веб-сервер: Apache, Nginx или встроенный PHP-сервер.
  • Версия PHP: PHP 7.4 или новее (рекомендуется PHP 8.x).
  • Расширения PHP: curl, sqlite3, zip, а также права на запись в папку data/.
  • Браузер клиента: Современный веб-браузер с поддержкой Javascript ES6 (Chrome, Firefox, Safari, Edge).
  • Дополнительные зависимости ИИ-агента: Установите эти компоненты в системе для разблокировки всех возможностей ИИ-агента GOGIES:
    • Node.js: Необходим для сборщиков проекта (npm/vite), серверов разработки и автоматизации.
    • Docker: Обеспечивает безопасное изолированное тестирование кода и служб в песочнице.
    • ImageMagick: Позволяет агенту оптимизировать, обрезать и конвертировать изображения для повышения производительности.

Установка

Следуйте этим инструкциям для развертывания GOGIES IDE на вашем сервере:

1. Клонирование репозитория

Клонируйте репозиторий непосредственно в корневой каталог веб-сервера:

git clone https://github.com/alhelalat/GOGIES-AI-IDE.git /var/www/html/ide

2. Настройка разрешений каталогов

IDE записывает историю сессий, настройки и резервные копии в каталог data/. Предоставьте права на запись пользователю веб-сервера (обычно www-data в Ubuntu/Debian):

cd /var/www/html/ide
chmod -R 775 data
chown -R www-data:www-data data
Рекомендация по безопасности

Поскольку IDE предоставляет доступ к терминалу авторизованным пользователям, вам следует привязать веб-сервер к адресу localhost (127.0.0.1) вместо 0.0.0.0, чтобы предотвратить внешний доступ из локальной сети.

Первоначальная настройка

После настройки каталогов откройте браузер и перейдите к встроенному установщику:

http://localhost/ide/install.php

Мастер установки поможет вам выполнить следующие шаги:

  1. Проверка путей: Автоматически определяет корневой каталог приложения и проверяет права доступа к папке данных.
  2. Учетная запись администратора: Создайте имя пользователя и пароль главного администратора.
  3. Первая рабочая область: Укажите имя и абсолютный путь к папке на сервере, в которой вы планируете вести разработку.

По завершении работы установщик создаст файл config.php, и вы будете перенаправлены на страницу авторизации.

Управление рабочими областями

Рабочие области позволяют разделять различные проекты разработки. Вы можете создавать отдельные области для разных клиентов или микросервисов.

Для переключения рабочих областей используйте выпадающий список в левом нижнем углу интерфейса IDE. Это мгновенно обновит пути сессии и перегрузит дерево файлов.

Интерфейс управления рабочими областями и пользователями

Управление файлами

Дерево файлов с левой стороны позволяет взаимодействовать со структурой каталогов активного проекта:

  • Создание файлов/папок: Нажимайте кнопки создания файлов и папок в верхней части проводника.
  • Действия контекстного меню: Нажмите правой кнопкой мыши на файл или папку, чтобы вызвать меню:
    • Rename: Переименовать выбранный ресурс.
    • Copy: Создать мгновенную копию в текущей папке.
    • Download: Скачать файл на локальный компьютер.
    • Decompress: Распаковать ZIP-архив непосредственно на сервере.
    • Delete: Рекурсивно удалить файлы и папки (требует подтверждения).

Редактор кода

Редактор основан на Ace Editor. Поддерживает подсветку синтаксиса для CSS, JS, HTML, PHP, Markdown, JSON и Python.

Файлы, защищенные от записи, открываются в **режиме только для чтения** (помечается специальным значком). Кнопка сохранения для таких файлов скрыта.

Интерфейс и настройки Ace Editor

Права доступа пользователей

Учетные записи и права доступа хранятся в массиве data/users/users.php. Администратор обладает правами *, дающими полный контроль.

Обычные разработчики могут быть ограничены рамками конкретной рабочей области, предотвращая доступ к чужим файлам конфигураций.

Менеджер баз данных

В GOGIES IDE встроен удобный менеджер баз данных, позволяющий проверять и изменять таблицы прямо рядом с кодом.

Встроенная консоль управления базами данных

Поддерживаемые БД

Поддерживаются базы данных SQLite, MySQL и PostgreSQL. Данные подключений хранятся на сервере в зашифрованном виде.

Запросы и инспектирование

  • Инспектор таблиц: Просмотр структуры схем, определений таблиц, индексов и первичных ключей.
  • Интерактивная консоль SQL: Выполняйте произвольные SQL-запросы прямо в браузере с выводом результатов в табличном виде.

Резервное копирование и восстановление

Среда предоставляет надежные функции резервного копирования для сохранения прогресса разработки.

Панель истории резервного копирования и восстановления

Создание резервной копии

При нажатии кнопки создания копии архивируются:

  1. Все файлы исходного кода и настройки текущего проекта.
  2. Профили подключения к базам данных.
  3. Базы данных SQLite и структуры MySQL/PostgreSQL с данными (в виде дампов SQL).

Результат упаковывается в ZIP-архив и сохраняется в каталоге данных.

Восстановление системы

Для отката выберите резервную копию и нажмите кнопку восстановления. IDE распакует файлы и восстановит состояние баз данных через PDO-транзакции.

ИИ-Агент GOGIES

В GOGIES IDE интегрирован автономный ИИ-помощник для совместного написания кода.

Интерфейс чата и история автономного ИИ-агента

Принцип работы

Агент использует инструменты, представленные в виде XML-тегов. IDE перехватывает эти теги, запускает соответствующие операции и возвращает результат агенту.

Последовательное выполнение действий

Если ИИ отправляет несколько команд одновременно, IDE ставит их в очередь и запускает последовательно, собирая все результаты.

Пользовательские правила (agent_rules.md)

Вы можете создать файл agent_rules.md в корне проекта, чтобы задать агенту инструкции по стилю написания кода.

Режимы подтверждения

В панели управления ИИ можно настроить режим выполнения потенциально опасных команд:

  • Спрашивать (по умолчанию): IDE выводит карточку с предпросмотром изменений и ожидает клика по кнопке.
  • Авто-подтверждение: Автоматически выполняет все действия без запроса.
  • Авто-отклонение: Запрещает ИИ изменять файлы и выполнять команды.

Интеграция ИИ-провайдеров (Локальные и Облачные)

Интеграция поддерживает локальные ИИ-модели для конфиденциальности данных и облачные сервисы для высокой производительности.

Интерфейс настройки провайдеров ИИ

1. Настройка облачных моделей

Вы можете подключить API популярных коммерческих ИИ-сервисов:

  • OpenAI: Выберите провайдер openai, укажите URL https://api.openai.com/v1, модель gpt-4o и введите ваш API-ключ.
  • Anthropic: Укажите провайдер anthropic, URL https://api.anthropic.com, модель claude-3-5-sonnet-latest и ваш API-ключ.
  • Google Gemini: Укажите провайдер gemini, URL https://generativelanguage.googleapis.com/v1beta/openai, модель gemini-2.5-flash и ваш API-ключ.

2. Использование локальных моделей (Ollama)

Вы можете запустить полностью локальную модель с помощью Ollama:

  1. Установите Ollama: Скачайте и запустите установщик в системе: 
    curl -fsSL https://ollama.com/install.sh | sh
  2. Загрузите модель: Выполните команду загрузки модели, например: ollama pull qwen2.5-coder:7b: 
    ollama pull qwen2.5-coder:7b
  3. Настройка IDE: Выберите шаблон Ollama в настройках, убедитесь в доступности адреса http://localhost:11434/v1 и укажите название загруженной модели.

Справочник API

Вы можете взаимодействовать с бэкендом IDE программно через POST-запросы к файлу api.php.

Доступные действия

  • get_file_content: Возвращает содержимое файла. 
    POST api.php?action=get_file_content&path=index.php
  • save_file_content: Сохраняет исходный текст в указанный путь. 
    POST api.php?action=save_file_content
Body parameters: path=index.php, content=your_code
  • list_files: Возвращает список файлов и папок. 
    POST api.php?action=list_files&path=assets/css