O que é a extensão de Safari do PocketHook?#
Uma extensão de Safari para macOS que permite ao seu Agent Server auto-hospedado trabalhar dentro do seu navegador real: abrir e fechar separadores, ler páginas, encontrar e clicar em controlos, preencher formulários e capturar ecrãs — na sua sessão, com os seus inícios de sessão, na sua máquina.
Tudo corre localmente. A extensão só comunica com o Agent Server no seu próprio Mac (loopback), e nada é enviado para qualquer outro lado.
Instalação#
A extensão vem incluída com o Agent Server como uma app macOS notarizada — sem App Store, sem Xcode:
bun run safari:install
Isto instala a Pockethook Safari.app em /Applications e abre-a. Depois, no Safari:
- Definições → Extensões — ative PocketHook Safari e conceda acesso aos sites.
- Gere um código de emparelhamento de utilização única no servidor:
bun run safari:code
- Abra o popup da extensão na barra de ferramentas do Safari, introduza o código e prima Pair. Um ponto verde significa que está ligado.
Verifique a ligação a qualquer momento com bun run safari:status.
Níveis de permissão#
É você que decide quanta autonomia o agente recebe, por servidor, com bun run safari:config:
| Nível | O que significa |
|---|---|
confirm (predefinição) | Cada clique com efeitos externos (votar, submeter, publicar, comprar…) pede primeiro a sua confirmação |
autonomous | Votos, follows e submissões correm sem perguntar; pagamentos, eliminações permanentes e alterações de conta ou segurança continuam a pedir |
readonly | Apenas navegar, inspecionar e capturar — clicar e escrever estão desativados |
O que o agente pode fazer#
- Abrir, navegar e fechar separadores
- Inspecionar uma página: controlos visíveis com seletores estáveis, estado e atributos semânticos
- Encontrar controlos pelo texto visível ou pelos atributos identificadores
- Clicar e preencher formulários (com suporte a frameworks, com verificação antes/depois)
- Fazer scroll e capturar ecrãs, entregues de volta no seu chat
Cada ação reporta o que realmente aconteceu — incluindo se um clique mudou de facto alguma coisa — para que o agente verifique em vez de adivinhar.
Modelo de segurança#
- Apenas loopback — a extensão liga-se exclusivamente a endereços locais que você configura.
- Códigos de utilização única — os códigos expiram ao fim de 5 minutos e só valem uma vez; a credencial resultante nunca sai do seu Mac.
- Expiração de comandos — os comandos que a extensão não recolheu em 20 segundos são descartados, pelo que nada é executado tarde.
- As chaves ficam consigo — pagamentos e ações destrutivas exigem sempre a sua confirmação explícita, em todos os níveis de permissão que permitem clicar.
- Auditável — o JavaScript da extensão é distribuído legível dentro do bundle da app.
Transferência#
A extensão vem incluída com o Agent Server (assets/safari/PocketHook-Safari.zip), ou obtenha-a diretamente: PocketHook-Safari.zip — assinada e notarizada para macOS.