什麼是 PocketHook Safari 延伸功能？#
一個 macOS Safari 延伸功能，讓您自架的 Agent Server 在您真實的瀏覽器中工作：開啟和關閉標籤頁、讀取頁面、尋找並點按控制項、填寫表單、擷取螢幕截圖 — 在您的工作階段中，使用您的登入狀態，在您自己的機器上。
一切都在本機執行。延伸功能只與您自己 Mac 上的 Agent Server 通訊（loopback 回送），不會向任何其他地方傳送任何資料。
安裝#
延伸功能與 Agent Server 一起以經過公證的 macOS 應用程式形式提供 — 不需要 App Store，不需要 Xcode：
bun run safari:install
這會將 Pockethook Safari.app 安裝到 /Applications 並啟動它。接著，在 Safari 中：
- 設定 → 延伸功能 — 啟用 PocketHook Safari 並授予網站存取權。
- 在伺服器上產生一次性配對碼：
bun run safari:code
- 在 Safari 工具列中開啟延伸功能的彈出視窗，輸入配對碼並按下 Pair。綠點表示已連線。
隨時可用 bun run safari:status 檢查連線狀態。
權限層級#
您可以透過 bun run safari:config 依伺服器決定代理獲得多少自主權：
| 層級 | 含義 |
|---|---|
confirm (預設) | 每次帶有外部影響的點按（投票、送出、發佈、購買…）都會先詢問您 |
autonomous | 投票、追蹤和送出無需詢問即可執行；付款、永久刪除以及帳號或安全性變更仍會詢問 |
readonly | 僅可瀏覽、檢查和擷取 — 點按和輸入皆停用 |
代理能做什麼#
- 開啟、瀏覽和關閉標籤頁
- 檢查頁面：帶有穩定選擇器、狀態和語意屬性的可見控制項
- 透過可見文字或識別屬性尋找控制項
- 點按並填寫表單（可感知前端框架，附前後驗證）
- 捲動頁面並擷取螢幕截圖，截圖會回傳到您的聊天中
每個動作都會回報實際發生了什麼 — 包括點按是否真的改變了什麼 — 讓代理去驗證而不是猜測。
安全模型#
- 僅限 loopback — 延伸功能只連線到您設定的本機位址。
- 一次性配對碼 — 配對碼 5 分鐘後過期且只能使用一次；產生的憑證永遠不會離開您的 Mac。
- 指令過期 — 延伸功能在 20 秒內未取走的指令會被捨棄，因此不會有任何延遲執行。
- 鑰匙在您手中 — 付款和破壞性動作在任何允許點按的權限層級下都一律需要您的明確確認。
- 可稽核 — 延伸功能的 JavaScript 以可讀形式隨應用程式套件一起提供。
下載#
延伸功能與 Agent Server 一起打包提供（assets/safari/PocketHook-Safari.zip），也可直接下載：PocketHook-Safari.zip — 已為 macOS 簽署並公證。