瀏覽器
藍莓辦公透過內建瀏覽器技能 lanmate-browser-use 操作網頁,有三種後端:
| 模式 | 用在哪 |
|---|---|
| 內建瀏覽器(預設) | 右側面板「瀏覽器」Tab,你和藍莓辦公看同一個頁面 |
| 外部 Chrome(擴充功能橋接) | 需要沿用你真實 Chrome 的登入狀態、擴充功能與指紋 |
| Playwright 獨立 Chromium | 需要乾淨環境、網路攔截或獨立視窗時;本機通常沒有預裝,不保證可用 |
內建瀏覽器
從右側面板「瀏覽器」Tab 開啟。每個分頁獨立執行,與主視窗共用 lanmate-browser 登入狀態。藍莓辦公開啟頁面時會自動鎖定瀏覽器,你能即時看到它的操作;點底部的「解鎖控制」可以隨時接管。
它怎麼「看」頁面
不是一上來就截圖,而是按成本從低到高:
- 語意快照:回傳頁面結構樹與可互動元素,每個元素帶
@eN引用(如@e7) - 正文 / 連結 / 圖片:只需要內容時直接取
- 主控台日誌:頁面報錯、白屏、介面失敗時先看日誌
- 截圖:只有版面、圖片、Canvas 這類必須看畫面時才截
操作元素優先使用 @eN 引用,不猜 CSS 選擇器。頁面導覽或 DOM 變化後,舊引用會失效,需要重新快照。
需要你接手的時候
遇到驗證碼、登入、簡訊驗證碼、付款確認這類只有人能做的步驟,藍莓辦公會呼叫 request_help:瀏覽器自動解鎖並跳出提示列,你完成後它繼續。你也可以設定完成條件(例如登入後 URL 包含 /dashboard),它會在條件滿足後自動接著做。
外部 Chrome 擴充功能
設定 → 擴充功能 → 瀏覽器,開啟「允許控制外部瀏覽器」,再安裝並連上配套的 Chrome 擴充功能:
- 開啟擴充功能管理頁
- 載入本機外掛資料夾
- 擴充功能與本機藍莓辦公建立連線
連線成功後,內建模式的請求會自動路由到你的真實 Chrome,沿用登入狀態。擴充功能 0.3.0 起,點選、懸停、按鍵走真實 CDP 輸入;首次使用 Chrome 會顯示「正在被偵錯」提示列。
「已連線」和「允許路由」是兩件事:擴充功能裝好也連上了,但設定開關沒開時,狀態會顯示已連線、未允許。
安全設定
| 設定項 | 預設值 | 說明 |
|---|---|---|
| 允許執行 JavaScript | 關 | 開啟後才允許注入 JS;嚴格 CSP 網站會回退到 CDP |
| 網站審批 | 開 | 首次造訪需要批准,1.0.1 起按網站(host)記住 |
| 任務預設瀏覽器 | 內建 | 可切換為外部 Chrome |
| 限制管道工具檔案存取 | 開 | 管道工具只能存取目前工作目錄內的檔案 |
安全紅線:
- 不在銀行、SSO 登入、密碼管理員頁面執行腳本讀取 Cookie、Token 或密碼
- 快照裡的密碼框值會自動打碼為
[redacted],不要嘗試繞過 - 不把登入狀態 Cookie / Storage 寫進對話或檔案
下載的檔案去哪了
內建瀏覽器的下載會自動存入目前會話的工作區,產物面板可直接預覽;無法解析安全目錄的會話保留系統儲存對話框。
使用示例
打開公司 OA 系統,幫我把這個月的考勤記錄導出來
藍莓辦公會開啟內建瀏覽器 → 導覽到 OA → 需要登入時把控制權交給你 → 找到考勤頁面 → 點選匯出。