544 字
3 分鐘

Agweb 怎麼用?在 macOS 觀察本機 WebKit 介面驗收

本文目錄

當 coding agent 在跑本機 UI 驗收、你還要繼續打字時,Agweb 的用途是把 WebKit 分頁集中在一個可觀察的視窗。macOS 26 以上可從 release 裝 App,再從 Help 安裝 CLI。Dashboard 用 ⌘D 開啟,可以看各工作區的頁面與最近命令。以下以 v0.3.0 的用法為準。 Agweb v0.3.0 · 專案 README

用本機介面做一次可觀察的驗收#

先開發伺服器,再用獨立工作區開啟自己的頁面。以下的 4321 是本機伺服器的示意連接埠,依專案調整。

Terminal window
agweb -w ui-check open http://localhost:4321/
agweb -w ui-check snapshot

從 snapshot 取得實際顯示的按鈕名稱或元素 ref,再對該元素操作。例如驗收站內搜尋,可以讓代理打開搜尋面板,輸入一個已知會命中的詞,讀到結果後再清空,回報一次命中的標題和清空後的畫面。Dashboard 同時檢查操作是否發生在預期分頁、有沒有跑錯工作區。比對行為時,記錄頁面路徑、操作和可觀察結果,這份資料也可以帶回現有自動測試。

-w 用於分開工作區的分頁。指定同一個具名 profile 的不同工作區會共用登入狀態。若測的是訪客或權限不同的角色,分別用乾淨工作區與獨立的測試 profile,並以頁面顯示的帳號或訪客狀態驗收。這也能避免一次登出改變另一組用例的起始狀態。 Agweb 工作區與 profile 說明

保留跨瀏覽器測試的分工#

Agweb 跑系統 WebKit,適合看到本機頁面在這個引擎的互動結果。需要 Chrome DevTools Protocol、Chromium 專屬行為或其他引擎的回歸證據時,保留原本的 Playwright 或 Chrome 測試。官方 README 也列出 route 的 mock 範圍為 fetch 與 XHR。若要定位頁面載入、靜態圖片或樣式表相關問題,改用對應的瀏覽器網路檢查工具。已在 Codex 桌面內建瀏覽器操作的讀者,可參考Codex 瀏覽器外掛的排查流程。

參考資料:

Agweb v0.3.0 release

Agweb v0.3.0 README

Agweb 怎麼用?在 macOS 觀察本機 WebKit 介面驗收
https://laplusda.com/posts/agweb-local-webkit-ui-check/
作者
Zero
發佈於
2026-11-16
許可協議
CC BY-NC-SA 4.0