MangoIDE

Linux 指南 · MangoIDE 0.1.0

MangoIDE 文档

在 Linux 上安装、配置和使用 MangoIDE

前往下载
01

兼容性与要求

当前 Linux 版本面向 64 位计算机。

  • x86_64 / amd64 架构。
  • glibc (libc6) 2.39 或更新版本。
  • X11 或 Wayland 图形会话。
  • 远程智能体和依赖下载需要网络。
Terminal 
dpkg --print-architecture
ldd --version

只有系统提供 glibc 2.39 或更新版本时，Ubuntu、Zorin OS 和 Debian 才能运行当前版本。较旧发行版可能无法启动。

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

配置 AI 智能体

打开“设置”和“AI 智能体”，使用内置智能体或添加新智能体。

  • 选择“添加智能体”。
  • 设置清晰的名称、提供商和模型。
  • 仅在需要时输入 API 密钥。本地 Codex 可使用已安装的 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。
  • 智能体打开错误目录：发送请求前先打开正确项目。

需要帮助？

请先完成上述检查。如果问题仍然存在，请在报告中提供 Linux 发行版、版本和完整错误信息。

报告错误