Permissões
10. Permissões
Modos
Em Configurações → Permissões:
| Modo | Comportamento |
|---|---|
| Perguntar a cada site | Pede na primeira ação em cada domínio |
| Permitir ações automaticamente (recomendado) (padrão) | Não pergunta; respeita a lista de bloqueio |
| Bloquear ações | Só leitura; nenhuma interação é executada |
O que nunca pede permissão
Leitura e coisas de bastidor: listar abas, abrir aba, ler a página, buscar elemento, extrair texto, ler console, ler rede, redimensionar janela e gravar quadros do GIF. Também não pedem: iniciar e parar a gravação de GIF.
O card de permissão
Quando uma ação precisa de aprovação, o card aparece sobre o painel e mostra:
- o host em destaque, com um ponto de alerta;
- o que será feito (“Navegar de a.com para b.com”, “Clicar na página”, “Preencher campo ref_3”, “Executar JavaScript na página”…);
- detalhes: título da aba, URL de destino, valor que será digitado (até 2.000 caracteres), nomes dos arquivos;
- uma prévia (screenshot) quando existir;
- o nome da conversa, se o pedido for de outra conversa (“Sessão: …”).
As opções:
| Botão | Efeito |
|---|---|
| Permitir uma vez (Enter) | Só esta ação |
| Permitir nesta sessão | Libera o host enquanto essa conversa existir (guardado só em memória) |
| Permitir sempre para exemplo.com | Grava o host na lista de permitidos |
| Negar (Esc) | Recusa a ação |
Pedidos de navegação entre domínios e de plano têm botões próprios: Permitir / Permitir sempre para … / Recusar e Aprovar plano / Recusar.
O rodapé do card lembra: “Você pode revogar permissões em Configurações. O agente nunca deve comprar, criar contas ou burlar captchas sem sua confirmação.”
Tempo para responder
O padrão é 60 segundos. Se você não responder, a ação é negada. O tempo pode ser mudado em Configurações (30 s, 1 min, 2 min, 5 min).
Com o painel fechado
O pedido vira notificação do sistema (“OpenCode Browser: aprovação pendente”) e toca um aviso sonoro. Clicar na notificação abre o painel já com o pedido na tela.
Várias conversas pedindo ao mesmo tempo
Os pedidos entram numa fila: o da conversa que você está vendo aparece primeiro; ao responder, o próximo entra — com o nome da conversa de origem. Nada é perdido nem expira escondido, e ao reabrir o painel todos os pendentes reaparecem.
Enquanto um card está aberto ele cobre o painel, inclusive se for de outra conversa. Para liberar rápido, use Esc (nega) ou responda.
Listas de permitidos e bloqueados
Em Configurações → Permissões:
- Sites sempre permitidos (um por linha)
- Sites sempre bloqueados (um por linha)
O bloqueio é avaliado antes de tudo: se o host está na lista de bloqueados, nem o modo “permitir automaticamente” libera.
O formato é só o host, minúsculo, exatamente como aparece na barra de endereços — sem https://, sem caminho, sem porta e sem curinga:
| Entrada | Funciona? | Por quê |
|---|---|---|
github.com | Sim | É o host |
docs.github.com | Sim | Subdomínio é outro host (precisa de linha própria) |
localhost | Sim | Host sem porta |
https://github.com | Não | O esquema não faz parte do host |
github.com/repo | Não | Caminho não faz parte do host |
*.github.com | Não | Não existe curinga |
GitHub.com | Não | A comparação diferencia maiúsculas |
Cada linha é comparada por igualdade. Digitar https://… não dá erro na tela, mas não tem efeito — vale a pena conferir depois de salvar.