Pular para o conteúdo principal

Tutorial: Configuração no macOS

Este tutorial guia você pelo processo completo de integração específico do macOS para o Rephlo, desde a instalação até seu primeiro comando via drag-select. Se você já concluiu a Instalação e Configuração geral, este tutorial aborda os detalhes do macOS com mais profundidade.

Objetivo​

O macOS tem requisitos exclusivos de segurança e privacidade que afetam o funcionamento do Rephlo. Diferente do Windows, onde os atalhos globais funcionam de imediato, o macOS exige consentimento explícito do usuário para Accessibility e Screen Recording. Este tutorial garante que você configure tudo corretamente para que o conjunto completo de recursos do Rephlo esteja disponível desde o primeiro dia.

Pré-requisitos​

RequisitoDetalhes
Versão do macOS10.15 Catalina ou posterior
ArquiteturaApple Silicon (M1/M2/M3/M4) ou Intel (x64)
Espaço em disco~250 MB para o pacote do aplicativo
Ollama (opcional)Se você planeja usar modelos locais, instale o Ollama separadamente

Etapa 1: Baixar e instalar​

1.1 Baixe o Rephlo​

Acesse https://rephlo.app/download e baixe o pacote mais recente para macOS:

  • Rephlo-macos-arm64.dmg para Macs com Apple Silicon (M1/M2/M3/M4)
  • Rephlo-macos-x64.dmg para Macs Intel

1.2 Instale em Applications​

  1. Abra o arquivo .dmg baixado.
  2. Arraste Rephlo.app para a pasta /Applications.
  3. Ejete a imagem de disco.

1.3 Primeira execução — Gatekeeper​

Na primeira vez que você abrir o Rephlo, o Gatekeeper do macOS pode bloqueá-lo com uma mensagem: "Rephlo.app cannot be opened because the developer cannot be verified."

Para prosseguir:

  1. Não dê duplo clique no aplicativo. Em vez disso, clique com o botão direito (ou Control-clique) em Rephlo.app na pasta /Applications.
  2. Selecione "Open" no menu de contexto.
  3. Na caixa de diálogo de confirmação, clique em "Open" novamente.

O macOS memoriza essa escolha. As próximas execuções funcionam normalmente com duplo clique.

Por que isso acontece? O Gatekeeper do macOS avisa sobre aplicativos baixados fora da Mac App Store. O método clicar com o botão direito > Open contorna essa verificação para o aplicativo atual.

Etapa 2: Conceder as permissões necessárias​

Por que as permissões são necessárias​

O Rephlo escuta atalhos globais e lê o texto selecionado no momento em que você aciona um comando, o que no macOS exige a permissão de Accessibility. A permissão de Screen Recording é exigida separadamente para a captura de screenshots.

Sem essas permissões, a integração do Rephlo com o sistema não funcionará.

2.1 O PermissionPreCheckDialog​

Imediatamente após a primeira execução, o Rephlo exibe o PermissionPreCheckDialog:

2.2 Conceda a permissão de Accessibility​

  1. No PermissionPreCheckDialog, clique em "Open System Settings" ao lado de Accessibility.
  2. O macOS abre System Settings > Privacy & Security > Accessibility.
  3. Localize o Rephlo na lista de aplicativos.
  4. Ative o botão ON.
  5. Se solicitado, autentique-se com sua senha do macOS ou Touch ID.
  6. Retorne à caixa de diálogo do Rephlo.

2.3 Conceda a permissão de Screen Recording​

  1. No PermissionPreCheckDialog, clique em "Open System Settings" ao lado de Screen Recording.
  2. O macOS abre System Settings > Privacy & Security > Screen Recording.
  3. Localize o Rephlo na lista de aplicativos.
  4. Ative o botão ON.
  5. Autentique-se se solicitado.
  6. Retorne à caixa de diálogo do Rephlo.

2.4 Verifique e reinicie​

  1. De volta à caixa de diálogo do Rephlo, clique em "Check Again".
  2. As duas permissões agora devem aparecer como Granted.
  3. Encerre o Rephlo completamente (clique com o botão direito no ícone da barra de menu > Exit, ou Cmd+Q).
  4. Reabra o Rephlo a partir de /Applications. Algumas alterações de permissão no macOS exigem uma reinicialização completa para entrar em vigor.

Dica: Se as caixas de seleção ainda mostrarem "Not Granted" depois de ativar as permissões, tente encerrar o Rephlo, aguardar alguns segundos e reabri-lo. Às vezes o macOS armazena em cache o estado de permissão anterior.

Etapa 3: Configure seu primeiro provedor​

Com as permissões concedidas, configure um provedor de IA para que o Rephlo possa processar seus comandos.

  1. Clique no ícone do Rephlo na barra de menu e selecione "Settings" (ou abra o Dashboard e navegue até Settings).
  2. Vá em Settings > LLM Providers.
  3. Escolha um provedor na lista:
ProvedorO que você precisa
OpenAIChave de API em platform.openai.com
AnthropicChave de API em console.anthropic.com
GoogleChave de API em aistudio.google.dev
GroqChave de API em console.groq.com
xAI (Grok)Chave de API em console.x.ai
OpenRouterChave de API em openrouter.ai
Azure OpenAIURL de endpoint + chave de API do seu portal Azure
OllamaInstalação local, sem necessidade de chave (endpoint: http://localhost:11434)
OpenAI-CompatibleURL de endpoint + chave de API para qualquer serviço compatível
  1. Insira sua API Key (e a URL do endpoint, se aplicável).
  2. Clique em Test Connection para verificar.
  3. Clique em Save.

Recomendação para começar rápido: Se você é novo em APIs de IA, OpenAI ou Anthropic são as mais simples de configurar. Se preferir privacidade total, sem dependência de nuvem, instale o Ollama e use modelos locais.

Etapa 4: Conheça os atalhos do macOS​

O Rephlo usa atalhos padrão específicos de cada plataforma. Veja os padrões do macOS comparados com Windows/Linux:

AçãomacOSWindows / Linux
Context Menu OverlayShift+Cmd+CCtrl+Shift+Alt+C
Screenshot CaptureShift+Cmd+SCtrl+Shift+Alt+S
Drag-Select ModifierCmdCtrl
Zoom InCmd+PlusCtrl+Plus
Zoom OutCmd+MinusCtrl+Minus
Reset ZoomCmd+0Ctrl+0

Personalizando os atalhos​

Todos os atalhos são totalmente personalizáveis:

  1. Abra Settings > Hotkeys.
  2. Clique no campo de atalho que você deseja alterar.
  3. Pressione a combinação de teclas desejada.
  4. Clique em Save.

Dica: Se um atalho entrar em conflito com outro aplicativo (por exemplo, Spotlight, Alfred ou Raycast), escolha outra combinação. O Rephlo avisará se o atalho escolhido já estiver em uso pelo sistema.

Etapa 5: Teste com Drag-Select​

O fluxo de drag-select é a maneira mais rápida de usar o Rephlo no macOS. Vamos experimentar:

5.1 Abra qualquer aplicativo de texto​

Abra TextEdit, Notes, Safari ou qualquer aplicativo com texto selecionável.

5.2 Realize o drag-select​

  1. Mantenha pressionada a tecla Cmd (o modificador padrão de drag-select no macOS).
  2. Enquanto mantém Cmd pressionado, clique e arraste o mouse sobre um trecho de texto para selecioná-lo.
  3. Ao soltar o botão do mouse, a sobreposição do Rephlo aparece imediatamente perto do cursor.

5.3 Execute um comando​

  1. Na sobreposição, clique em "Summarize" (ou em qualquer outro comando).
  2. O Rephlo envia o texto selecionado ao provedor de IA configurado.
  3. O resultado aparece na sobreposição.
  4. Clique em Copy para colocar o resultado na área de transferência, ou em Insert para substituir o texto original.

Nota: A tecla modificadora do drag-select é personalizável. Vá em Settings > Hotkeys > Text Selection Trigger para trocá-la de Cmd para outra tecla, se preferir.

Solução de problemas específicos do macOS​

Os atalhos não funcionam​

Sintoma: Pressionar Shift+Cmd+C não faz nada. A sobreposição não aparece.

Causa: A permissão de Accessibility não foi concedida, ou o aplicativo não foi reiniciado após a concessão da permissão.

Correção:

  1. Abra System Settings > Privacy & Security > Accessibility.
  2. Confirme que o Rephlo está ativado (ON).
  3. Se já estava ativado, desative (OFF) e ative (ON) novamente.
  4. Encerre e reabra o Rephlo.

A captura de screenshot não funciona​

Sintoma: Os comandos de screenshot falham ou produzem uma imagem em branco.

Causa: A permissão de Screen Recording não foi concedida.

Correção:

  1. Abra System Settings > Privacy & Security > Screen Recording.
  2. Confirme que o Rephlo está ativado (ON).
  3. Encerre e reabra o Rephlo.

A sobreposição não aparece​

Sintoma: Você pressiona o atalho ou faz o drag-select, mas nenhuma janela de sobreposição aparece.

Possíveis causas e correções:

Possível causaCorreção
Accessibility não concedidaConceda a permissão de Accessibility e reinicie
O aplicativo não está rodando como pacote .appInicie a partir de /Applications/Rephlo.app, não via dotnet run
Conflito de atalho com outro aplicativoVerifique Settings > Hotkeys em busca de conflitos; altere a combinação
O aplicativo está pausadoClique com o botão direito no ícone da barra de menu; se "Resume Rephlo" for exibido, clique nele

O Gatekeeper bloqueia o aplicativo em toda inicialização​

Sintoma: O macOS continua exibindo o aviso "developer cannot be verified".

Correção: Confirme que você clicou com o botão direito e selecionou "Open" na primeira execução. Se o problema persistir:

  1. Abra System Settings > Privacy & Security.
  2. Role até a seção Security.
  3. Você deve ver uma mensagem informando que o Rephlo está bloqueado. Clique em "Open Anyway".

O Rephlo não aparece nas listas de permissões​

Sintoma: Você abre System Settings > Accessibility, mas o Rephlo não está listado.

Correção: Inicie o Rephlo pelo menos uma vez. O macOS só adiciona aplicativos às listas de permissões depois que o aplicativo tenta usar o recurso protegido pela primeira vez. Após iniciá-lo, verifique novamente a lista de permissões.

Próximos passos​

Agora você está totalmente configurado no macOS. Aqui estão os próximos passos recomendados: