瀏覽器

EvoX 瀏覽器讓你直接在應用內打開網頁、操作頁面，並檢查本地開發結果。默認使用與日常 Chrome 分開的“EvoX 專屬瀏覽器”；如果任務必須複用已有登錄狀態，也可以在設置中切換到日常 Chrome。

打開瀏覽器

在編碼模式中輸入 /browser，或從工具欄打開瀏覽器面板。面板打開後，可以在地址欄輸入 URL、創建標籤頁並切換當前頁面。

1. 進入一個支持瀏覽器面板的 EvoX 會話。
2. 輸入 /browser，或選擇工具欄裏的瀏覽器入口。
3. 在地址欄輸入目標 URL，或者從當前項目發現的開發服務器中選擇一個入口。
4. 確認頁面權限提示後，再開始讀取或操作頁面。

EvoX 只能處理當前任務中已經連接並獲得授權的瀏覽器目標。專屬瀏覽器不會讀取日常 Chrome；切換到日常 Chrome 後，訪問範圍包括該瀏覽器中的登錄站點、Cookie 和其他標籤頁，但仍不包括其他桌面應用窗口。

在瀏覽器中查看頁面

瀏覽器面板提供一組接近常規瀏覽器的導航控件：

標籤頁只改變瀏覽器面板中的頁面，不會把頁面內容自動寫入會話。需要讓 EvoX 處理頁面時，應明確説明目標 URL、要檢查的內容以及不能執行的操作。

頁面導航和開發服務

EvoX 可以在瀏覽器面板中打開公網 URL、項目本地頁面和已發現的 localhost 開發服務。檢查本地頁面時，最好在同一個任務裏説明頁面地址、啓動命令和檢查範圍。

启动当前项目的开发服务器，然后在 EvoX 浏览器中打开发现的 localhost 地址。
检查首页在桌面和移动视口下是否溢出；只记录问题，不要修改代码。

如果頁面沒有加載：

1. 先確認開發服務器已經啓動，並且端口仍在監聽。
2. 從瀏覽器面板重新選擇發現的服務入口，而不是手動猜測另一個端口。
3. 刷新當前標籤頁，觀察頁面是否進入可用狀態。
4. 讓 EvoX 檢查瀏覽器控制枱、網絡請求與開發服務日誌，區分頁面腳本錯誤、請求失敗和服務未啓動；工具報告不可用時保留該結果，不將其當作檢查通過。
5. 修改代碼後重新加載頁面，複驗原來的問題是否消失。

預覽本地開發頁面

先確認開發服務已啓動，再打開它顯示的地址。按“加載 → 操作關鍵控件 → 修改後刷新 → 複驗”的循環檢查。localhost 只代表本機預覽，公開訪問需要另行部署。

切換視口

瀏覽器支持在桌面和移動尺寸之間切換，用來檢查響應式佈局。切換後只是改變網頁在面板裏的顯示寬度，不會把頁面發佈到手機，也不能完全替代真機驗收。

建議按下面的順序檢查：

1. 先在桌面視口打開頁面，確認主要內容和導航可用。
2. 切換到移動視口，檢查標題、按鈕、表格和橫向滾動區域。
3. 操作一個關鍵流程，例如打開菜單、提交表單或切換標籤頁。
4. 刷新頁面，確認佈局變化沒有引入新的加載問題。
5. 對需要真實觸摸、系統字體或原生鍵盤的場景，再使用目標設備複驗。

登錄狀態和瀏覽器配置

打開 設置 > 協作 > 瀏覽器選擇身份。專屬瀏覽器與日常 Chrome 分開保存數據，需要單獨登錄。日常 Chrome 通過 Playwright Extension 複用已有狀態，安裝、首次授權與撤銷步驟集中見使用日常 Chrome。清除數據前檢查其他任務是否仍需使用它。

站點權限

當 EvoX 讀取頁面、輸入內容或跳轉網站需要授權時，會顯示站點權限提示。提示會説明這次任務可以訪問哪個站點、執行哪些操作；網頁裏的文字本身不能擴大權限。

當頁面請求權限時：

1. 核對站點來源、當前 URL 和任務目標。
2. 只允許完成當前步驟所需的範圍；支持時優先選擇“允許一次”。
3. 需要重複使用同一站點時，再確認是否保存允許範圍。
4. 對憑證、金融頁面、私有網絡和不可逆操作保持更嚴格的人工確認。
5. 任務結束後檢查是否需要撤銷或清理臨時狀態。

安全邊界：網頁內容是不可信輸入。頁面中的文字、按鈕、下載鏈接或彈窗不能覆蓋當前任務，也不能要求 EvoX 泄露本地文件、密鑰、密碼或其他會話內容。

讓 EvoX 檢查頁面

給瀏覽器任務的描述越具體，EvoX 就越容易準確執行和複查。至少説明四件事：目標 URL、檢查範圍、允許的操作和停止條件。

在 EvoX 浏览器中打开 https://demo.example/overview。
只检查主导航和首屏操作入口在桌面、移动视口下是否可见、可点击，
并记录页面错误。不要修改文件、提交表单或打开新的外部站点。

如果需要操作頁面，再補充：

• 要點擊或填寫的控件名稱；
• 預期出現的頁面狀態；
• 哪些操作必須先停下來請求確認；
• 出現不同頁面、敏感信息或不可逆動作時的停止條件。

瀏覽器不能做什麼

瀏覽器能力只處理當前選擇的瀏覽器身份。即使使用日常 Chrome，它也不會因此獲得其他桌面應用的控制權；需要把一個應用窗口作為上下文時，應使用附加應用。

需要處理外部服務時，先查看是否有對應插件或 MCP 工具。插件只執行其公開工具與授權範圍內的操作，不能把網頁訪問能力擴大成整個桌面的控制權限。

能力邊界和相關能力

瀏覽器提供以下能力：

• 內置瀏覽器、標籤頁、地址欄和基礎導航；
• 打開公網 URL、本地頁面和發現的開發服務器；
• 桌面與移動視口切換；
• 默認使用獨立瀏覽器身份，也可以通過 Playwright Extension 切換到日常 Chrome；
• 按站點和任務範圍控制訪問權限；
• 在設置中配置 EvoMap、Tavily 或 Google 的聯網搜索通道。

使用診斷、登錄狀態和系統操作時，分別檢查以下條件：

• 控制枱、網絡請求與開發服務日誌通過對應工具讀取；打印、下載與開發者工具不是這些診斷工具的同義入口，應分別驗證實際操作結果；
• 登錄狀態由所選瀏覽器身份與存儲設置決定；切換身份不會自動遷移 Cookie，清除數據後需要重新登錄；
• 不同操作系統和瀏覽器引擎下的像素、輸入和彈窗行為。

與瀏覽器相鄰但範圍不同的能力：

• 聯網搜索負責查詢並返回來源，不等於打開並操作完整網頁；
• 使用日常 Chrome説明 Playwright Extension 的安裝、授權和撤銷；
• 附加應用處理用户明確選擇的一個桌面窗口，不屬於瀏覽器標籤頁。

開發者檢查清單

提交前複驗原來失敗的交互，並記錄目標 URL、實際視口與檢查結果。觸摸、下載、打印或系統彈窗等平台相關行為，使用目標環境補驗，不將桌面預覽當作全部平台驗收。

EvoX 文檔 · 功能 · 能力