Tiện ích mở rộng Safari của PocketHook là gì?#
Một tiện ích mở rộng Safari cho macOS cho phép Agent Server tự lưu trữ của bạn làm việc ngay trong trình duyệt thật của bạn: mở và đóng tab, đọc trang, tìm và nhấp vào các điều khiển, điền biểu mẫu và chụp ảnh màn hình — trong phiên của bạn, với các đăng nhập của bạn, trên máy của bạn.
Mọi thứ chạy cục bộ. Tiện ích mở rộng chỉ giao tiếp với Agent Server trên chính chiếc Mac của bạn (loopback), và không có gì được gửi đi bất kỳ đâu khác.
Cài đặt#
Tiện ích mở rộng đi kèm với Agent Server dưới dạng ứng dụng macOS đã được notarize — không cần App Store, không cần Xcode:
bun run safari:install
Lệnh này cài đặt Pockethook Safari.app vào /Applications và khởi chạy nó. Sau đó, trong Safari:
- Cài đặt → Tiện ích mở rộng — bật PocketHook Safari và cấp quyền truy cập trang web.
- Tạo mã ghép nối dùng một lần trên máy chủ:
bun run safari:code
- Mở popup của tiện ích mở rộng trên thanh công cụ của Safari, nhập mã và nhấn Pair. Chấm màu xanh lá nghĩa là bạn đã kết nối.
Kiểm tra kết nối bất cứ lúc nào với bun run safari:status.
Các mức quyền#
Bạn quyết định agent được tự chủ đến đâu, theo từng máy chủ, với bun run safari:config:
| Mức | Ý nghĩa |
|---|---|
confirm (mặc định) | Mọi cú nhấp có tác động ra bên ngoài (bình chọn, gửi, đăng, mua…) đều hỏi bạn trước |
autonomous | Bình chọn, theo dõi và gửi chạy mà không cần hỏi; thanh toán, xóa vĩnh viễn và thay đổi tài khoản hoặc bảo mật vẫn hỏi |
readonly | Chỉ điều hướng, kiểm tra và chụp — nhấp chuột và gõ phím bị tắt |
Agent có thể làm gì#
- Mở, điều hướng và đóng tab
- Kiểm tra một trang: các điều khiển hiển thị với selector ổn định, trạng thái và thuộc tính ngữ nghĩa
- Tìm điều khiển theo văn bản hiển thị hoặc thuộc tính nhận dạng
- Nhấp chuột và điền biểu mẫu (nhận biết framework, có xác minh trước/sau)
- Cuộn trang và chụp ảnh màn hình, gửi ngược về cuộc trò chuyện của bạn
Mỗi hành động đều báo cáo điều gì thực sự đã xảy ra — bao gồm việc một cú nhấp có thực sự thay đổi gì hay không — để agent xác minh thay vì đoán mò.
Mô hình bảo mật#
- Chỉ loopback — tiện ích mở rộng chỉ kết nối đến các địa chỉ cục bộ mà bạn cấu hình.
- Mã ghép nối dùng một lần — mã hết hạn sau 5 phút và chỉ dùng được một lần; thông tin xác thực tạo ra không bao giờ rời khỏi Mac của bạn.
- Hết hạn lệnh — các lệnh mà tiện ích mở rộng không nhận trong vòng 20 giây sẽ bị loại bỏ, nên không có gì được thực thi trễ.
- Bạn giữ chìa khóa — thanh toán và các hành động phá hủy luôn cần xác nhận rõ ràng của bạn, ở mọi mức quyền cho phép nhấp chuột.
- Có thể kiểm tra — JavaScript của tiện ích mở rộng được đóng gói ở dạng đọc được bên trong gói ứng dụng.
Tải xuống#
Tiện ích mở rộng được đóng gói cùng Agent Server (assets/safari/PocketHook-Safari.zip), hoặc tải trực tiếp: PocketHook-Safari.zip — đã ký và notarize cho macOS.