Mbbrowser 幫助

繁體中文

简体中文
English
한국어
Русский
日本語
Português
Tiếng Việt
Français

繁體中文

简体中文
English
한국어
Русский
日本語
Português
Tiếng Việt
Français

Appearance

常見問題（FAQ） ​

本篇匯總了 MBAgent 使用過程中的常見問題與解決方案。

NOTE

找不到答案？ 請聯繫候鳥客服或在控制台提交反饋：https://www.mbbrowser.com/console

一、安裝與啟動 ​

Q1：MBAgent 支持哪些 Windows 版本？ ​

A：支持 Windows 10 / 11。Windows 7 需要使用舊版本的 MBAgent（不再單獨維護）。

Q2：MBAgent 的安裝包多大？ ​

A：約 80 MB，包含 Rust 編譯的可執行文件、依賴庫、UI 組件、圖標字體、內置提示詞模板。

Q3：安裝後雙擊沒反應？ ​

A：

  1. 右鍵 → 以管理員身份運行
  2. 檢查 Windows Defender 是否誤報，把 MBAgent 加入白名單
  3. 查看日誌：%LOCALAPPDATA%\mbagent\logs\install.log
  4. 卸載後重新安裝

Q4：能否離線使用？ ​

A：MBAgent 本體可以離線啟動，但調用 AI 模型需要網絡。如果模型是本地部署（如 Ollama），可以完全離線。

Q5：如何徹底卸載？ ​

A：

  1. 控制面板 → 程序和功能 → 卸載 MBAgent
  2. 手動刪除剩餘文件夾：
    • %LOCALAPPDATA%\mbagent
    • %APPDATA%\mbagent
  3. 清理註冊表（可選）

二、配置與 API Key ​

Q6：API Key 應該從哪裡獲取？ ​

A：

Q7：API Key 會被上傳嗎？ ​

A：不會。API Key 僅存儲在本地 Windows Credential Manager，不會上傳到任何服務器。

Q8：忘記保存 API Key 怎麼辦？ ​

A：刪除現有配置，重新添加。所有 Key 都只存儲在本地，無法找回，只能重新創建。

Q9：如何切換不同模型的 API Key？ ​

A：在設置 → Provider 中，每個 Provider 可以單獨配置 Key。不同模型的 Key 互不影響。

Q10：第三方中轉站的 Key 怎麼配置？ ​

A：

  1. 添加自定義 Provider
  2. Base URL 填寫中轉站地址（如 https://ai.ehouniao.com/v1）
  3. API Key 填寫中轉站分配的 Key
  4. 選擇對應的模型

三、模型相關 ​

Q11：MBAgent 支持哪些模型？ ​

A：當前支持：

  • 候鳥官方：deepseek-v4-flash、deepseek-v4-pro、deepseek-v4-vision、deepseek-v4-coder、gpt-5-mini、gpt-5-nano、gpt-5.6、gpt-5.6-sol、gpt-6.0、gpt-6.0-sol、claude-sonnet-4、claude-opus-4.5、gemini-2.5-flash、gemini-2.5-pro
  • OpenAI：GPT 系列
  • Anthropic：Claude 系列
  • Google：Gemini 系列
  • 自定義：兼容 OpenAI API 格式的服務

Q12：模型一直"加載中"怎麼辦？ ​

A：

  1. 檢查網絡連接
  2. 檢查 API Key 是否正確
  3. 檢查 API 餘額
  4. 切換到其他模型試試
  5. 查看日誌排查錯誤

Q13：模型回覆很慢？ ​

A：

  1. 切換到更小的模型（如 deepseek-v4-flash）
  2. 檢查網絡（可能跨國訪問）
  3. 避開 API 高峰時段
  4. 開啟流式輸出（默認開啟）

Q14：模型回覆被截斷？ ​

A：

  1. 可能是上下文窗口不足，開新會話
  2. 可能是 API 端超時，讓 AI 繼續
  3. 可能是網絡波動，重新發送

Q15：如何查看 Token 消耗？ ​

A：

四、會話與記憶庫 ​

Q16：會話存儲在哪裡？ ​

A：%LOCALAPPDATA%\mbagent\sessions\

Q17：如何遷移會話到新電腦？ ​

A：

  1. 導出會話為 JSON
  2. 在新電腦導入
  3. 或直接複製 sessions 目錄

Q18：會話太多佔用空間怎麼辦？ ​

A：

  1. 刪除不需要的舊會話
  2. 設置自動清理（保留最近 N 個）
  3. 導出後從本地刪除

Q19：記憶庫和會話有什麼區別？ ​

A：

  • 會話：某次對話的歷史，跨會話不共享
  • 記憶庫：跨會話保留的長期信息

Q20：清空記憶庫後 AI 還記得嗎？ ​

A：不記得。所有長期記憶都會被清除。建議清空前先導出備份。

Q21：可以單獨刪除某條記憶嗎？ ​

A：可以。在記憶庫面板中找到該條，點擊刪除。

五、瀏覽器控制 ​

Q22：MBAgent 無法連接到候鳥瀏覽器？ ​

A：

  1. 確認候鳥瀏覽器已啟動
  2. 確認環境已打開
  3. 重啟候鳥瀏覽器和 MBAgent
  4. 檢查防火牆
  5. 嘗試更換端口

Q23：AI 操作瀏覽器時崩潰？ ​

A：

  1. 查看崩潰日誌：%LOCALAPPDATA%\mbagent\logs\crash.log
  2. 升級到最新版本
  3. 重啟候鳥瀏覽器和 MBAgent
  4. 提交反饋附上日誌

Q24：賬號登入失敗？ ​

A：

  1. 確認賬號密碼正確
  2. 確認網絡通暢
  3. 確認賬號未被風控
  4. 確認網站是否需要短信驗證
  5. 嘗試切換指紋

Q25：AI 操作太慢？ ​

A：

  1. 提升網絡帶寬
  2. 減少頁面截圖頻率
  3. 關閉不必要的等待
  4. 使用更高效的提示詞

Q26：候鳥瀏覽器必須啟動嗎？ ​

A：是的。MBAgent 通過 CDP 連接候鳥瀏覽器，候鳥瀏覽器未啟動時無法使用瀏覽器相關功能。

六、文件與命令 ​

Q27：AI 讀寫了我的隱私文件？ ​

A：

  1. 立即檢查操作日誌
  2. 調整文件訪問權限設置
  3. 添加敏感路徑到"始終拒絕"
  4. 必要時更換相關密碼

Q28：命令執行失敗？ ​

A：

  1. 確認命令語法正確
  2. 確認工作目錄正確
  3. 確認有執行權限
  4. 查看錯誤信息

Q29：能否讓 AI 執行 PowerShell 命令？ ​

A：可以。MBAgent 默認使用 PowerShell，執行命令前會彈窗確認。

Q30：AI 刪除了我的文件，能恢復嗎？ ​

A：

  1. 檢查回收站
  2. 如果是 Git 管理的，從 Git 恢復
  3. 如果有備份，從備份恢復
  4. 使用文件恢復軟件（成功率不高）

WARNING

強烈建議：

  • 重要項目使用 Git 管理
  • 定期備份重要文件
  • AI 操作前打開審批彈窗

七、定時與循環任務 ​

Q31：定時任務沒有按時執行？ ​

A：

  1. 確認 MBAgent 在運行（當前版本依賴主進程）
  2. 確認時間設置正確
  3. 確認時區設置正確
  4. 查看任務狀態

Q32：如何停止所有後台任務？ ​

A：

  • 狀態欄 → 全部停止
  • 快捷鍵 Ctrl+Shift+Alt+K
  • 命令行 mbagent task stop-all

Q33：循環任務會無限執行嗎？ ​

A：默認會無限執行，直到：

  • 手動停止
  • 達到設置的最大執行次數
  • 達到結束時間
  • 任務模板被刪除

Q34：如何讓 MBAgent 關閉後任務仍能執行？ ​

A：當前版本不支持。建議：

  • 保持 MBAgent 運行
  • 或使用 Windows 任務計劃程序喚醒 MBAgent

八、性能與穩定性 ​

Q35：MBAgent 佔用 CPU 高？ ​

A：

  1. 檢查後台任務數量
  2. 減少並發任務
  3. 關閉不需要的標籤頁
  4. 升級到最新版本

Q36：MBAgent 佔用內存高？ ​

A：

  1. 清理舊會話
  2. 關閉不需要的後台任務
  3. 重啟 MBAgent

Q37：MBAgent 卡頓？ ​

A：

  1. 重啟 MBAgent
  2. 清理磁盤空間
  3. 檢查殺毒軟件是否干擾
  4. 升級到最新版本

Q38：MBAgent 崩潰後如何恢復？ ​

A：

  1. 重啟 MBAgent
  2. 之前的會話會自動加載
  3. 檢查崩潰日誌
  4. 如果反覆崩潰，卸載後重新安裝

九、安全與隱私 ​

Q39：MBAgent 會上傳我的代碼嗎？ ​

A：取決於模型：

  • 候鳥官方：通過候鳥 API 發送，但候鳥不會存儲
  • OpenAI 等：發送給第三方，受其隱私政策約束
  • 本地模型：完全本地處理

Q40：如何保護敏感信息？ ​

A：

  1. 不要在對話中明文發送
  2. 使用本地變量
  3. 設置敏感詞過濾
  4. 重要操作前先 review

Q41：操作日誌會被上傳嗎？ ​

A：不會。操作日誌僅存儲在本地。

Q42：MBAgent 會自動更新嗎？ ​

A：不會自動更新。MBAgent 通過候鳥瀏覽器主程序更新。當候鳥瀏覽器更新時，會順帶更新 MBAgent。

十、錯誤排查 ​

Q43：報錯 "Failed to bind port 9527" ​

A：

  1. 9527 端口被佔用
  2. 查找佔用進程：netstat -ano | findstr 9527
  3. 殺死該進程或重啟電腦
  4. 如仍報錯，更換 MBAgent 端口（設置 → 高級）

Q44：報錯 "API authentication failed" ​

A：

  1. API Key 無效或過期
  2. 重新生成 API Key
  3. 檢查 Provider 配置

Q45：報錯 "Context length exceeded" ​

A：

  1. 上下文超過模型窗口
  2. 開新會話
  3. 壓縮歷史
  4. 使用上下文更大的模型

Q46：報錯 "Tool execution timeout" ​

A：

  1. 工具執行超時（默認 30 秒）
  2. 檢查網絡
  3. 增加超時時間（設置 → 高級）
  4. 分步執行

Q47：報錯 "Browser disconnected" ​

A：

  1. 候鳥瀏覽器斷開
  2. 重新連接
  3. 重啟候鳥瀏覽器

十一、其他 ​

Q48：MBAgent 與候鳥瀏覽器的關係？ ​

A：

  • MBAgent 是候鳥瀏覽器的內置組件
  • 隨候鳥瀏覽器一起安裝、更新
  • 卸載候鳥瀏覽器會卸載 MBAgent
  • 需要候鳥瀏覽器運行才能使用瀏覽器控制功能

Q49：MBAgent 是否收費？ ​

A：

  • MBAgent 本身免費
  • 調用 AI 模型需要 API Key，會產生 API 費用
  • 候鳥官方用戶可以使用贈送的 AI 額度

Q50：如何升級 MBAgent？ ​

A：

  1. 候鳥瀏覽器主程序升級時會自動升級 MBAgent
  2. 或手動下載新版安裝包

Q51：MBAgent 是否開源？ ​

A：核心組件不開源，但提供標準 API 和擴展機制。

Q52：如何聯繫客服？ ​

A：

十二、附錄 ​

A. 快捷鍵速查 ​

快捷鍵功能
Ctrl+N新建會話
Ctrl+O打開會話
Ctrl+S保存會話
Ctrl+,設置
Ctrl+Q退出
F1幫助
Ctrl+Enter發送消息
Esc取消回覆
Ctrl+Shift+P切換權限模式
Ctrl+Shift+T定時任務列表
Ctrl+Shift+K後台任務面板

B. 配置文件位置 ​

%LOCALAPPDATA%\mbagent\
├── config.json          # 主配置
├── memory\              # 記憶庫
├── sessions\            # 會話歷史
├── tasks\               # 任務模板
├── logs\                # 日誌
├── screenshots\         # 截圖
└── ...

C. 默認端口 ​

服務端口
MBAgent 主進程9527
CDP（候鳥瀏覽器）由候鳥客戶端動態分配

D. 相關鏈接 ​

TIP

找不到答案？

  1. 查閱 幫助文檔
  2. 在候鳥用戶群反饋
  3. 聯繫候鳥客服
  4. 提交 Issue