瀏覽器 | 藍莓辦公(LanMate)使用手冊
使用奇安信版藍莓辦公?查看奇安信版使用手冊

瀏覽器

藍莓辦公透過內建瀏覽器技能 lanmate-browser-use 操作網頁,有三種後端:

模式 用在哪
內建瀏覽器(預設) 右側面板「瀏覽器」Tab,你和藍莓辦公看同一個頁面
外部 Chrome(擴充功能橋接) 需要沿用你真實 Chrome 的登入狀態、擴充功能與指紋
Playwright 獨立 Chromium 需要乾淨環境、網路攔截或獨立視窗時;本機通常沒有預裝,不保證可用

內建瀏覽器

從右側面板「瀏覽器」Tab 開啟。每個分頁獨立執行,與主視窗共用 lanmate-browser 登入狀態。藍莓辦公開啟頁面時會自動鎖定瀏覽器,你能即時看到它的操作;點底部的「解鎖控制」可以隨時接管。

它怎麼「看」頁面

不是一上來就截圖,而是按成本從低到高:

  1. 語意快照:回傳頁面結構樹與可互動元素,每個元素帶 @eN 引用(如 @e7)
  2. 正文 / 連結 / 圖片:只需要內容時直接取
  3. 主控台日誌:頁面報錯、白屏、介面失敗時先看日誌
  4. 截圖:只有版面、圖片、Canvas 這類必須看畫面時才截

操作元素優先使用 @eN 引用,不猜 CSS 選擇器。頁面導覽或 DOM 變化後,舊引用會失效,需要重新快照。

需要你接手的時候

遇到驗證碼、登入、簡訊驗證碼、付款確認這類只有人能做的步驟,藍莓辦公會呼叫 request_help:瀏覽器自動解鎖並跳出提示列,你完成後它繼續。你也可以設定完成條件(例如登入後 URL 包含 /dashboard),它會在條件滿足後自動接著做。

外部 Chrome 擴充功能

設定 → 擴充功能 → 瀏覽器,開啟「允許控制外部瀏覽器」,再安裝並連上配套的 Chrome 擴充功能:

  1. 開啟擴充功能管理頁
  2. 載入本機外掛資料夾
  3. 擴充功能與本機藍莓辦公建立連線

連線成功後,內建模式的請求會自動路由到你的真實 Chrome,沿用登入狀態。擴充功能 0.3.0 起,點選、懸停、按鍵走真實 CDP 輸入;首次使用 Chrome 會顯示「正在被偵錯」提示列。

「已連線」和「允許路由」是兩件事:擴充功能裝好也連上了,但設定開關沒開時,狀態會顯示已連線、未允許。

安全設定

設定項 預設值 說明
允許執行 JavaScript 關 開啟後才允許注入 JS;嚴格 CSP 網站會回退到 CDP
網站審批 開 首次造訪需要批准,1.0.1 起按網站(host)記住
任務預設瀏覽器 內建 可切換為外部 Chrome
限制管道工具檔案存取 開 管道工具只能存取目前工作目錄內的檔案

安全紅線:

下載的檔案去哪了

內建瀏覽器的下載會自動存入目前會話的工作區,產物面板可直接預覽;無法解析安全目錄的會話保留系統儲存對話框。

使用示例

打開公司 OA 系統,幫我把這個月的考勤記錄導出來

藍莓辦公會開啟內建瀏覽器 → 導覽到 OA → 需要登入時把控制權交給你 → 找到考勤頁面 → 點選匯出。