Dive 是一款开源的 MCP 主机桌面应用，可无缝集成任何支持函数调用功能的 LLM。✨

功能 🎯

• 🌐 通用 LLM 支持：兼容 ChatGPT、Anthropic、Ollama 以及与 OpenAI 兼容的模型
• 💻 跨平台：适用于 Windows、MacOS 和 Linux
• 🔄 模型上下文协议：实现 stdio 和 SSE 模式下的无缝 MCP AI 代理集成
• ☁️ OAP 云集成：通过 OAPHub.ai 一键访问托管的 MCP 服务器，无需复杂的本地部署
• 🏗️ 双架构：现代 Tauri 版本与传统 Electron 版本并存，以获得最佳性能
• 🌍 多语言支持：支持 24 种以上语言，包括英语、繁体中文、简体中文、西班牙语、日语、韩语、德语、法语、意大利语、葡萄牙语、俄语、泰语、越南语、菲律宾语、印尼语、波兰语、土耳其语、乌克兰语、瑞典语、挪威语、芬兰语和老挝语
• ⚙️ 高级 API 管理：支持多个 API 密钥及通过 model_settings.json 切换模型
• 🛠️ 精细工具控制：可启用或禁用单个 MCP 工具，实现精准定制
• 💡 自定义指令：个性化系统提示，以调整 AI 行为
• ⌨️ 键盘快捷键：全面的热键支持，方便高效导航和操作（重命名、设置、重新加载、新建聊天等）
• 📝 聊天草稿保存：自动保存聊天输入草稿，防止数据丢失
• 🔄 自动更新机制：自动检查并安装最新应用更新
• 🔐 MCP 服务器认证：新增对 MCP 服务器认证的支持

  ⚠️ 注意：此功能目前不稳定，可能需要频繁重新授权

• 🛠️ 内置本地工具：开箱即用的预配置工具——Fetch（网页请求）、文件管理器（读写文件）和 Bash（命令执行）
• 🤖 MCP 服务器安装代理：智能代理，帮助您自动安装和配置 MCP 服务器
• 🔔 多轮 elicitation 支持：在 UI 中同时处理多个 MCP elicitation 请求
• 📁 @ 文件路径搜索：扩展聊天输入中的 @ 关键字，用于搜索文件路径

最新更新（2026/02/26）— v0.14.0+ 🎉

• 🛠️ 技能与斜杠命令：支持技能和更多斜杠命令
• 🔍 聊天记录搜索：支持聊天记录搜索

平台可用性

平台	Electron	Tauri
Windows	✅	✅
macOS	✅	🔜
Linux	✅	✅

迁移说明：现有的本地 MCP/LLM 配置仍完全支持。OAP 集成是附加功能，不会影响当前工作流程。

下载与安装 ⬇️

获取 Dive 的最新版本：

Windows 用户：🪟

可选择两种架构：

• Tauri 版本（推荐）：安装包较小（<30MB），采用现代架构
• Electron 版本：传统架构，完全稳定
• 启动后会自动下载 Python 和 Node.js 环境

MacOS 用户：🍎

• Electron 版本：下载 .dmg 版本
• 您需要自行安装 Python 和 Node.js（使用 npx uvx）环境
• 按照安装提示完成设置

Linux 用户：🐧

可选择两种架构：

• Tauri 版本：现代架构，安装包更小
• Electron 版本（推荐）：传统架构，采用 .AppImage 格式
• 您需要自行安装 Python 和 Node.js（使用 npx uvx）环境
• 对于 Ubuntu/Debian 用户：
  • 可能需要添加 --no-sandbox 参数
  • 或修改系统设置以允许沙盒
  • 运行 chmod +x 使 AppImage 可执行
• 对于 Arch 用户：
  • 如果您使用的是 Arch Linux，可以使用 AUR 助手 安装 dive。例如：paru -S dive-ai

MCP 设置选项

有关详细说明，请参阅 MCP 服务器设置。

最简单的入门方式！立即访问企业级 MCP 工具：

1. 在 OAPHub.ai 注册
2. 使用一键深度链接或配置文件连接到 Dive
3. 享受免配置的托管 MCP 服务器——无需 Python、Docker 或复杂依赖项

优势：

• ✅ 无需任何配置
• ✅ 跨平台兼容性
• ✅ 企业级可靠性
• ✅ 自动更新与维护

构建 🛠️

更多详情请参阅 BUILD.md。

贡献 🤝

我们欢迎社区贡献！以下是您可以提供帮助的方式：

开发环境搭建

1. 分支仓库
2. 克隆您的分支：git clone https://github.com/YOUR_USERNAME/Dive.git
3. 安装依赖：npm install
4. 开始开发：npm run dev（Electron）或 cargo tauri dev（Tauri）
5. 进行更改并彻底测试
6. 提交拉取请求

许可证 📄

Dive 是根据 MIT 许可证 许可的开源软件。

与我们联系 🌐

• 💬 加入我们的 Discord
• 🐦 在 Twitter/X、Reddit 和 Thread 上关注我们
• ⭐ 在 GitHub 上为我们点赞
• 🐛 在我们的 问题追踪器 中报告问题

Dive AI Agent 快速上手指南

Dive 是一款开源的 MCP（Model Context Protocol）主机桌面应用，能够无缝集成任何支持函数调用能力的 LLM。它支持跨平台运行，并提供图形化界面来管理 MCP 工具、本地命令及云端服务。

环境准备

系统要求

Dive 提供两种架构版本，请根据需求选择：

• Tauri 版（推荐）：安装包小（<30MB），性能更优。
  • 支持：Windows, Linux
  • macOS 支持即将推出
• Electron 版：传统架构，功能稳定。
  • 支持：Windows, macOS, Linux

前置依赖

• Windows (Tauri/Electron)：无需手动安装，启动后会自动下载 Python 和 Node.js 环境。
• macOS / Linux：需手动安装以下环境：
  • Python
  • Node.js (包含 npx 和 uvx)

Linux 用户特别注意：

• Ubuntu/Debian 用户运行 Electron 版时可能需要添加 --no-sandbox 参数或调整系统沙箱设置。
• 运行 AppImage 前需执行 chmod +x <文件名> 赋予执行权限。
• Arch Linux 用户可直接使用 AUR 助手安装（见安装步骤）。

安装步骤

方式一：直接下载正式版（推荐普通用户）

访问 GitHub Releases 下载对应系统的安装包。

• Windows: 下载 .exe 安装程序（优先选择 Tauri 版）。
• macOS: 下载 .dmg 文件（目前仅 Electron 版）。
• Linux:
  • 通用：下载 .AppImage (Electron) 或对应包 (Tauri)。
  • Arch Linux: 使用 AUR 助手安装：

    paru -S dive-ai
    # 或使用 yay
    yay -S dive-ai
    

方式二：源码构建（开发者）

如果你希望贡献代码或体验最新开发版：

1. 克隆仓库：

   git clone https://github.com/YOUR_USERNAME/Dive.git
   cd Dive
   

2. 安装依赖：

   npm install
   

3. 启动开发环境：

   • Electron 版:

     npm run dev
     

   • Tauri 版:

     cargo tauri dev
     

基本使用

1. 配置大模型 (LLM)

启动 Dive 后，进入设置页面配置你的 LLM：

• 支持 ChatGPT, Anthropic, Ollama 及兼容 OpenAI 接口的模型。
• 在 model_settings.json 或通过 UI 界面管理多个 API Key 和模型切换。

2. 连接 MCP 服务

Dive 提供两种连接方式：

方案 A：一键接入云端服务（最简单）

无需本地部署 Python/Docker，适合快速开始：

1. 访问 OAPHub.ai 注册账号。
2. 获取一键连接链接或配置文件。
3. 在 Dive 中导入，即可立即使用企业级 MCP 工具。

方案 B：本地配置

• 内置工具：默认启用 Fetch (网络请求), File Manager (文件读写), Bash (命令执行)。
• 自定义工具：在设置中启用/禁用特定 MCP 工具，或配置本地 stdio/SSE 模式的 MCP Server。
• 智能安装：使用内置的 "MCP Server Installer Agent" 自动帮助安装和配置新的 MCP 服务。

3. 开始对话

• 在主界面输入框直接与 AI 对话。
• 使用工具：输入 @ 可搜索并引用文件路径；输入 / 可使用斜杠命令（如新建聊天、切换技能等）。
• 快捷键：支持重命名、设置、重载、新建聊天等操作（详见设置中的快捷键列表）。
• 草稿保护：输入内容会自动保存为草稿，防止意外丢失。

4. 高级功能

• 多语言支持：界面已原生支持简体中文等 24+ 种语言。
• 自动更新：应用会自动检查并安装最新版本。
• 权限管理：可在 UI 中同时处理多个 MCP 授权请求。