MBAgent 下载、安装与首次启动
MBAgent 是候鸟浏览器的官方配套组件，集成在候鸟安装包内，无需单独下载。本篇带您完成从下载安装包到第一次打开 MBAgent 的全部步骤。
NOTE
本篇适用版本：候鸟浏览器 v3.0 及以上（MBAgent 内置于安装包）。 如果您已经安装了候鸟浏览器，可以直接跳到 第三节 首次启动 MBAgent。
一、下载候鸟浏览器安装包
第一步：访问下载页
- 打开您电脑上的任意浏览器（Chrome / Edge / 火狐都行）
- 访问候鸟浏览器官方下载页：https://www.mbbrowser.com/download
- 根据您的系统选择对应版本：
| 系统 | 推荐版本 | 安装包大小 |
|---|---|---|
| Windows 11 / Windows 10（64 位） | 最新正式版 | 约 588 MB |
| Windows 7 / Windows 8.1 | 不支持AI | 412MB |
TIP
如何查看系统版本：右键点击桌面"此电脑" → 属性 → 在"系统类型"一行可以看到是 64 位还是 32 位操作系统。
第二步：保存安装包
点击下载按钮后，浏览器会保存一个 .exe 安装包到您的"下载"文件夹，文件名形如：
AI_20260921_MBbrowserSetup_9.18.58.198_Core_140.exe下载时间取决于您的网速，一般 30 秒到 2 分钟。
二、安装候鸟浏览器（含 MBAgent）
第一步：运行安装程序
- 双击下载好的
.exe文件 - 如果系统弹出"用户账户控制"询问是否允许，点击 "是"
- 安装向导自动启动，进入欢迎页面
第二步：同意协议
在用户协议页面，点击 "我同意" 继续。
第三步：选择安装位置
推荐使用默认安装路径：
C:\Program Files\MbbrowserNOTE
不建议修改安装路径。MBAgent 与候鸟浏览器深度集成，自定义路径可能导致某些功能（如命令行调用、API 接口）出现异常。
第四步：选择组件
安装向导会列出可安装的组件，确保以下两项都被勾选：
- ✅ 候鸟浏览器主程序（必选）
- ✅ MBAgent 候鸟企业人工智能助手（必选，新版本默认勾选）
- ⬜ 候鸟浏览器桌面快捷方式（推荐勾选）
- ⬜ WebView2 运行时（系统已装则无需勾选）
第五步：等待安装完成
点击 "安装" 后，等待进度条走完。整个过程约 1-3 分钟。
第六步：完成安装
安装完成后，桌面会出现两个图标：
🟦 候鸟浏览器 ← 主程序入口（mbbrowser.exe）
🤖 MBAgent ← AI 助手入口三、首次启动 MBAgent
NOTE
截图说明：上图为 MBAgent 主窗口启动后的全屏布局截图（顶部标签栏 + 左侧会话与环境列表 + 中间新建任务面板 + 右侧已加载浏览器列表）。您首次启动时也将看到这一整体布局。
第一步：先启动候鸟浏览器并登录账号
IMPORTANT
重要：MBAgent 必须连接到候鸟浏览器的账号才能使用。首次使用请按以下顺序启动：
- 双击桌面 "候鸟浏览器" 图标，启动主程序
- 输入您的候鸟账号和密码登录
- 确认左侧环境列表里能看到您创建的环境
- 不要关闭 候鸟浏览器，回到桌面
第二步：启动 MBAgent
- 双击桌面 "MBAgent" 图标（或者从开始菜单 → 候鸟浏览器 → MBAgent 启动）
- MBAgent 启动后会弹出"选择工作目录"窗口
- 选择您要 MBAgent 操作的文件夹（候鸟浏览器默认工作目录或您常用的项目目录），点击 "开始"
- 几秒钟后，MBAgent 主窗口打开，标题栏显示 "MBAgent - 候鸟 - 企业人工智能助手"
第三步：选择 AI 模型
MBAgent 启动后会要求您选择首次使用的 AI 模型：
- 在弹出的"模型选择"对话框里，挑一个您喜欢的模型
- 推荐初学者使用 候鸟官方模型 - deepseek-v4-flash（速度快、成本低）
- 点击 "确认"
TIP
模型后续可以随时切换，不必纠结第一次选哪个。详见 模型选择与 Provider 配置。
第四步：完成新手引导
MBAgent 会显示一个简短的新手引导，介绍主界面的几个区域。您可以直接点击 "知道了" 跳过，或者花 1 分钟浏览一下。
四、认识 MBAgent 主界面
MBAgent 启动后，您会看到一个分为三个区域的主窗口：
Provider
KMS 入口
（聊天 / 项目 / 终端 / 文件 / 团队 / UI / Shell / 浏览器）
各区域功能速览
| 区域 | 主要功能 | 详细文档 |
|---|---|---|
| 顶部标签栏 | 聊天 / 项目 / 终端 / 文件 / 团队 / UI / Shell / 浏览器 | 全功能菜单导览 |
| 模型选择器 | 快速切换当前 AI 模型 | 模型选择与 Provider 配置 |
| 左侧会话列表 | 历史对话、按项目分组、置顶 | 任务面板详解 |
| 中间主区 | 当前标签页的展示区 | 任务面板详解 |
| 底部输入框 | 输入您的需求，支持文字+图片+文件 | 第一次使用 MBAgent |
五、常见安装问题
1. 双击 MBAgent 图标没反应
原因：候鸟浏览器主程序没有启动，或者没有登录账号。
解决：
- 确认候鸟浏览器已启动并登录
- 重新启动 MBAgent
2. 模型列表是空的
原因：候鸟账号未开通 AI 模型额度。
解决：
- 访问候鸟控制台：https://www.mbbrowser.com/console
- 进入 AI 模型 → 开通对应模型的额度
- 回到 MBAgent → 设置 → 刷新模型列表
3. 启动后中文显示乱码
原因：系统区域设置问题。
解决：
- Windows 设置 → 时间和语言 → 语言 → Windows 显示语言 → 改为 简体中文（中国）
- 重启电脑后再启动 MBAgent
4. 安装时提示"已安装更新版本"
原因：电脑里残留了旧版候鸟文件夹。
解决：
- 控制面板 → 程序与功能 → 卸载旧版候鸟浏览器
- 手动删除残留文件夹
C:\Program Files\Mbbrowser - 重新运行新版本安装包
5. 工作目录窗口一直转圈
原因：候鸟浏览器主程序没有启动，MBAgent 无法读取候鸟账号信息。
解决：
- 完全关闭 MBAgent
- 启动候鸟浏览器并登录
- 重新启动 MBAgent
六、更新 MBAgent
MBAgent 随候鸟浏览器主程序一起更新。当您更新候鸟浏览器时，MBAgent 也自动升级到对应版本。
更新方式：
- 候鸟浏览器启动时会自动检测新版本
- 弹出更新提示后，点击 "立即更新"
- 更新完成后重启候鸟浏览器，再启动 MBAgent 即可
IMPORTANT
更新前建议关闭 MBAgent 和候鸟浏览器。不要在 MBAgent 执行任务时更新，否则可能造成任务中断。
下一步：第一次使用 MBAgent → 跟 AI 说第一句话，看它怎么帮您干活。