MangoIDE

Руководство Linux · MangoIDE 0.1.0

Документация MangoIDE

Установка, настройка и использование MangoIDE в Linux

Перейти к загрузкам
01

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

Текущая версия для Linux предназначена для 64-битных компьютеров.

  • Архитектура x86_64 / amd64.
  • glibc (libc6) 2.39 или новее.
  • Графическая сессия X11 или Wayland.
  • Интернет для удалённых агентов и загрузки зависимостей.
Terminal
dpkg --print-architecture
ldd --version

Ubuntu, Zorin OS и Debian поддерживаются только в версиях с glibc 2.39 или новее. На старом дистрибутиве программа может не запуститься.

02

Установка пакета Debian (.deb)

Рекомендуется для совместимых версий Ubuntu, Zorin OS, Debian и производных.

  • Откройте страницу загрузки на своём языке.
  • Загрузите пакет Debian amd64.
  • Откройте его в менеджере программ или выполните команду ниже.
  • Запустите MangoIDE из меню или командой mangoide.
Terminal
cd ~/Downloads
sudo apt install ./mangoide_0.1.0_amd64.deb
03

Портативный архив

Установка не требуется, но требования к архитектуре и glibc сохраняются.

  • Загрузите архив x86_64.
  • Распакуйте его в выбранную папку.
  • Запустите файл в подпапке bin.
  • Храните папку share рядом с программой.
Terminal
cd ~/Downloads
tar -xzf MangoIDE-linux-x86_64-0.1.0.tar.gz
cd MangoIDE-linux-x86_64-0.1.0
./bin/mangoide
04

Первый запуск и проекты

MangoIDE всегда работает в выбранной папке проекта.

  • Используйте Файл > Новый проект для создания или открытия.
  • Значок папки быстро меняет каталог.
  • После перезапуска восстанавливаются последний проект и беседа.
  • Новый проект получает AGENTS.md, agent-text и obsidian-brain.
  • Технические папки визуально отделены от кода.
05

Настройка ИИ-агентов

Откройте Настройки и ИИ-агенты, чтобы выбрать встроенного или добавить нового агента.

  • Нажмите Добавить агента.
  • Выберите имя, поставщика и модель.
  • Введите API-ключ только при необходимости. Локальный Codex может использовать установленную сессию входа.
  • Включите внешний модуль зрения для анализа изображений текстовой моделью.
  • Сохраните и выберите агента и модель под полем чата.
  • Модели зависят от поставщика, аккаунта и инструментов; идентификатор можно ввести вручную.
06

Память Obsidian и AGENTS.md

Каждый проект хранит собственную техническую память внутри своей папки.

  • ./obsidian-brain хранит ошибки, исправления, решения, проверки и идеи.
  • AGENTS.md передаёт агентам правила, команды и путь к памяти.
  • Заметки должны относиться только к текущему проекту.
  • Внешняя старая память доступна только для чтения без явного разрешения.
  • agent-text хранит беседы и вложения.

Добавляйте AGENTS.md и общие заметки в систему контроля версий. Никогда не храните в них API-ключи и секреты.

07

Чат, терминал и разрешения

Chat Agents объединяет модели, вложения и ход работы, а терминал выполняет команды проекта.

  • Single использует одного агента; Multi ограниченно координирует выбранных агентов.
  • Прикрепляйте несколько файлов или вставляйте снимки экрана.
  • Следите за чтением, изменениями, командами, сборкой и проверками.
  • Выбирайте минимальный доступ; Full нужен только для сети или расширенного доступа.
  • Node.js, npm, Java, Gradle и Android SDK должны быть установлены на компьютере.
  • Запускайте и останавливайте команды во встроенном терминале.
08

Устранение неполадок

Эти проверки решают большинство частых проблем.

  • «GLIBC_x.xx not found»: обновите дистрибутив или дождитесь сборки для старой glibc.
  • Пакет не ставится: проверьте amd64 и используйте apt для точной диагностики.
  • Агент не отвечает: проверьте поставщика, модель, API-ключ или локальный вход.
  • Нет npm, Gradle или другой команды: установите её и перезапустите MangoIDE.
  • Сетевая сборка не работает: проверьте связь и используйте Full только при необходимости.
  • Открыта неверная папка: сначала выберите правильный проект.

Нужна помощь?

Сначала выполните проверки выше. Если проблема остаётся, укажите дистрибутив, его версию и полный текст ошибки.

Сообщить об ошибке