Что такое расширение Safari от PocketHook?#
Расширение Safari для macOS, которое позволяет вашему самостоятельно размещаемому Agent Server работать внутри вашего настоящего браузера: открывать и закрывать вкладки, читать страницы, находить и нажимать элементы управления, заполнять формы и делать скриншоты — в вашей сессии, с вашими логинами, на вашей машине.
Всё работает локально. Расширение общается только с Agent Server на вашем собственном Mac (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.