Що таке розширення 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.