Совместимость и требования
Текущая версия для Linux предназначена для 64-битных компьютеров.
- Архитектура x86_64 / amd64.
- glibc (libc6) 2.39 или новее.
- Графическая сессия X11 или Wayland.
- Интернет для удалённых агентов и загрузки зависимостей.
dpkg --print-architecture
ldd --versionUbuntu, Zorin OS и Debian поддерживаются только в версиях с glibc 2.39 или новее. На старом дистрибутиве программа может не запуститься.
Установка пакета Debian (.deb)
Рекомендуется для совместимых версий Ubuntu, Zorin OS, Debian и производных.
- Откройте страницу загрузки на своём языке.
- Загрузите пакет Debian amd64.
- Откройте его в менеджере программ или выполните команду ниже.
- Запустите MangoIDE из меню или командой mangoide.
cd ~/Downloads
sudo apt install ./mangoide_0.1.0_amd64.debПортативный архив
Установка не требуется, но требования к архитектуре и glibc сохраняются.
- Загрузите архив x86_64.
- Распакуйте его в выбранную папку.
- Запустите файл в подпапке bin.
- Храните папку share рядом с программой.
cd ~/Downloads
tar -xzf MangoIDE-linux-x86_64-0.1.0.tar.gz
cd MangoIDE-linux-x86_64-0.1.0
./bin/mangoideПервый запуск и проекты
MangoIDE всегда работает в выбранной папке проекта.
- Используйте Файл > Новый проект для создания или открытия.
- Значок папки быстро меняет каталог.
- После перезапуска восстанавливаются последний проект и беседа.
- Новый проект получает AGENTS.md, agent-text и obsidian-brain.
- Технические папки визуально отделены от кода.
Настройка ИИ-агентов
Откройте Настройки и ИИ-агенты, чтобы выбрать встроенного или добавить нового агента.
- Нажмите Добавить агента.
- Выберите имя, поставщика и модель.
- Введите API-ключ только при необходимости. Локальный Codex может использовать установленную сессию входа.
- Включите внешний модуль зрения для анализа изображений текстовой моделью.
- Сохраните и выберите агента и модель под полем чата.
- Модели зависят от поставщика, аккаунта и инструментов; идентификатор можно ввести вручную.
Память Obsidian и AGENTS.md
Каждый проект хранит собственную техническую память внутри своей папки.
- ./obsidian-brain хранит ошибки, исправления, решения, проверки и идеи.
- AGENTS.md передаёт агентам правила, команды и путь к памяти.
- Заметки должны относиться только к текущему проекту.
- Внешняя старая память доступна только для чтения без явного разрешения.
- agent-text хранит беседы и вложения.
Добавляйте AGENTS.md и общие заметки в систему контроля версий. Никогда не храните в них API-ключи и секреты.
Чат, терминал и разрешения
Chat Agents объединяет модели, вложения и ход работы, а терминал выполняет команды проекта.
- Single использует одного агента; Multi ограниченно координирует выбранных агентов.
- Прикрепляйте несколько файлов или вставляйте снимки экрана.
- Следите за чтением, изменениями, командами, сборкой и проверками.
- Выбирайте минимальный доступ; Full нужен только для сети или расширенного доступа.
- Node.js, npm, Java, Gradle и Android SDK должны быть установлены на компьютере.
- Запускайте и останавливайте команды во встроенном терминале.
Устранение неполадок
Эти проверки решают большинство частых проблем.
- «GLIBC_x.xx not found»: обновите дистрибутив или дождитесь сборки для старой glibc.
- Пакет не ставится: проверьте amd64 и используйте apt для точной диагностики.
- Агент не отвечает: проверьте поставщика, модель, API-ключ или локальный вход.
- Нет npm, Gradle или другой команды: установите её и перезапустите MangoIDE.
- Сетевая сборка не работает: проверьте связь и используйте Full только при необходимости.
- Открыта неверная папка: сначала выберите правильный проект.
Нужна помощь?
Сначала выполните проверки выше. Если проблема остаётся, укажите дистрибутив, его версию и полный текст ошибки.
