Peekaboo 是做什麼的？
使用 Peekaboo 來檢查 macOS UI、對目標元素進行操作，並驗證結果。
以下範例使用 v4 語法。請執行 peekaboo --version 以及已安裝命令的 --help 查看說明；
若使用舊版本，請依該版本的說明操作。
OpenClaw Bridge
當電腦控制啟用、提供者設為 Peekaboo 且 Peekaboo Bridge 啟用時，OpenClaw macOS 應用程式會託管 Peekaboo Bridge。 在透過該主機執行時，請保留現有的 OpenClaw socket 選項：
export PEEKABOO_BRIDGE_SOCKET="${PEEKABOO_BRIDGE_SOCKET:-$HOME/Library/Application Support/OpenClaw/bridge.sock}"
peekaboo bridge status --json
請確認所選的主機與 socket 是您預期使用的。保留明確指定的
PEEKABOO_BRIDGE_SOCKET 或 --bridge-socket 選項。如果所需的主機
不可用，請回報該結果；不要清除選項或切換電腦控制提供者來讓命令成功執行。
權限歸屬於執行操作的程序或 Bridge 主機。
除非呼叫端具有所需權限，否則請勿傳遞 --no-remote。
尋找已安裝的命令
請使用葉節點命令的說明查看旗標與目標要求，而不是在不同命令間複製旗標。 使用根命令的說明來探索可用命令：
peekaboo --help
peekaboo app list --help
peekaboo see --help
peekaboo press --help
peekaboo drag --help
V4 移除了下列舊的命令根：
| 舊命令 | V4 命令 |
|---|---|
list apps | app list |
image | see --no-elements 用於不含元素偵測的像素截圖 |
hotkey | press 搭配和弦，如 cmd+shift+t |
swipe | drag --from … --to … |
對於其他操作，包括點擊、輸入、滾動以及管理視窗或選單，
請使用 peekaboo <command> --help。將命令選項放在葉節點命令之後；
--json 要求結構化輸出。
檢查、操作、驗證
從應用程式清單與目標的新鮮視圖開始：
peekaboo app list --json
peekaboo see --app Safari --window-title "Example" --annotate \
--path /tmp/peekaboo-example.png --json
在操作前讀取回傳的元素。將操作綁定到預期的應用程式、視窗以及 最新的快照；請勿重複使用範例元素 ID。操作後，再次檢查 UI 並 確認要求的結果。當視窗變更或目標過期時，請重新整理觀察結果。
若要進行不含元素偵測的螢幕截圖：
peekaboo see --mode screen --screen-index 0 --no-elements --retina \
--path /tmp/peekaboo-screen.png --json
原始鍵盤和弦需要明確的前景互動或由 press 接受的新鮮精確視窗收據。
拖曳總是移動共享游標，並且需要 --foreground。當前景互動已授權時：
peekaboo press cmd+shift+t --app Safari --foreground --json
peekaboo drag --from 100,500 --to 100,200 --duration 800ms --foreground --json
請使用目前觀察結果中的實際目標與座標。建議使用明確的持續時間單位，
例如 800ms；請查閱每個命令的說明了解其選項與先決條件。
疑難排解
- 若收到命令已移除的錯誤，請使用已安裝 CLI 所指定的取代命令。
- 若遇到主機或權限失敗，請對所選主機檢查
peekaboo bridge status --json和peekaboo permissions status --json。 - 若遇到定位目標失敗，請查閱葉節點命令的說明，並使用
see取得最新的 UI 狀態。 - 在 macOS 15+ 上，私密視窗選取器提示與基礎的螢幕錄製授權是分開的， 即使 Bridge 權限正確也可能出現。