Plataformas e Integrações
Este capítulo ajuda você a entender as diferenças funcionais do opencode-notify em diferentes sistemas operacionais, dominar configurações específicas da plataforma e como fazer seu terminal ter o melhor desempenho.
Caminho de Aprendizado
1. Funcionalidades do macOS
Conheça totalmente os recursos avançados no macOS, incluindo detecção inteligente de foco, foco ao clicar em notificações e efeitos sonoros personalizados.
- Detecção de foco: determina automaticamente se o terminal é a janela ativa atual
- Foco ao clicar: alterna automaticamente para o terminal após clicar na notificação
- Efeitos sonoros personalizados: configure sons exclusivos para diferentes eventos
- Suporte a 37+ terminais: incluindo Ghostty, iTerm2, terminal integrado do VS Code, etc.
2. Funcionalidades do Windows
Domine os fundamentos e métodos de configuração de notificações na plataforma Windows.
- Notificações nativas: use o centro de notificações do Windows 10/11
- Permissões de notificação: garanta que o OpenCode tenha permissão para enviar notificações
- Configuração básica: localização do arquivo de configuração no ambiente Windows
- Notas de limitação: o Windows ainda não suporta a funcionalidade de detecção de foco
3. Funcionalidades do Linux
Entenda o mecanismo de notificações da plataforma Linux e a instalação de dependências.
- Integração libnotify: use notify-send para enviar notificações
- Suporte a ambientes de desktop: GNOME, KDE Plasma, XFCE e outros ambientes principais
- Instalação de dependências: comandos de instalação para diferentes distribuições
- Notas de limitação: o Linux ainda não suporta a funcionalidade de detecção de foco
4. Terminais Suportados
Veja todos os 37+ emuladores de terminal suportados e entenda o mecanismo de detecção automática.
- Detecção de terminal: como identificar automaticamente o tipo de terminal
- Lista de terminais: lista completa de terminais suportados
- Configuração manual: como especificar manualmente quando a detecção automática falha
- Terminais especiais: tratamento do terminal integrado do VS Code, sessões SSH remotas
Pré-requisitos
Antes de estudar este capítulo, certifique-se de ter concluído
- ✅ Início Rápido: concluiu a instalação do opencode-notify
- ✅ Como Funciona: entenda os quatro tipos de notificações e o mecanismo de filtragem inteligente
Recomendações de Seleção de Plataforma
Escolha o capítulo correspondente com base no seu sistema operacional:
| Sistema Operacional | Ordem de Estudo Recomendada | Funcionalidades Principais |
|---|---|---|
| macOS | 1. Funcionalidades do macOS → 4. Terminais Suportados | Detecção de foco, foco ao clicar, efeitos sonoros personalizados |
| Windows | 2. Funcionalidades do Windows → 4. Terminais Suportados | Notificações nativas, configuração básica |
| Linux | 3. Funcionalidades do Linux → 4. Terminais Suportados | Integração libnotify, instalação de dependências |
Recomendação Geral
Independentemente da plataforma que você usa, a lição 4 "Terminais Suportados" vale a pena estudar, pois pode ajudá-lo a entender o mecanismo de detecção de terminal e resolver problemas de configuração.
Tabela de Comparação de Funcionalidades
| Funcionalidade | macOS | Windows | Linux |
|---|---|---|---|
| Notificações nativas | ✅ | ✅ | ✅ |
| Detecção de foco do terminal | ✅ | ❌ | ❌ |
| Foco ao clicar na notificação | ✅ | ❌ | ❌ |
| Efeitos sonoros personalizados | ✅ | ✅ | ✅ (parcial) |
| Período silencioso | ✅ | ✅ | ✅ |
| Verificação de sessão pai | ✅ | ✅ | ✅ |
| Suporte a 37+ terminais | ✅ | ✅ | ✅ |
| Detecção automática de terminal | ✅ | ✅ | ✅ |
Próximos Passos
Após concluir este capítulo, você entenderá as diferenças funcionais entre diferentes plataformas e os métodos de configuração.
Recomenda-se continuar estudando:
Configuração Avançada
Aprenda todas as opções do arquivo de configuração e domine técnicas de configuração avançadas.
- Referência completa de configuração: descrições detalhadas de todas as opções de configuração
- Explicação detalhada do período silencioso: como configurar e como funciona
- Princípio de detecção de terminal: mecanismo interno de detecção automática
- Uso avançado: técnicas de configuração e práticas recomendadas
Solução de Problemas
Se encontrar problemas, veja as soluções para problemas comuns.
- Notificações não aparecem: problemas de permissão e configurações do sistema
- Falha na detecção de foco: configuração de terminal e mecanismo de detecção
- Erros de configuração: formato do arquivo de configuração e descrição dos campos
- Problemas de efeitos sonoros: configuração de efeitos sonoros e compatibilidade do sistema
Recomendações do Caminho de Aprendizado
Se você está começando a usar, recomenda-se estudar na ordem capítulos de plataforma → configuração avançada → solução de problemas. Se tiver um problema específico, pode pular diretamente para o capítulo de solução de problemas.