Uso Avançado: Configuração Profunda e Otimização

Esta seção ajuda você a dominar os recursos avançados do opencode-notify, entendendo profundamente as opções de configuração, otimizando a experiência de notificação e personalizando o comportamento das notificações de acordo com suas necessidades.

Caminho de Aprendizado

Recomenda-se estudar o conteúdo desta seção na seguinte ordem:

1. Referência de Configuração

Entenda completamente todas as opções de configuração disponíveis e suas funções.

• Domine a estrutura e sintaxe dos arquivos de configuração
• Aprenda métodos de personalização de efeitos sonoros de notificação
• Entenda os cenários de uso do interruptor de notificação de sub-sessão
• Conheça o método de configuração de substituição de tipo de terminal

2. Detalhes dos Horários Silenciosos

Aprenda como definir horários silenciosos para evitar interrupções em horários específicos.

• Configure o início e o fim dos horários silenciosos
• Trate horários silenciosos que atravessam a noite (por exemplo, 22:00 - 08:00)
• Desabilite temporariamente o recurso silencioso quando necessário
• Entenda a prioridade dos horários silenciosos em relação a outras regras de filtragem

3. Princípios de Detecção de Terminal

Aprofunde-se no mecanismo de funcionamento da detecção automática de terminal.

• Aprenda como o plugin identifica mais de 37 tipos de emuladores de terminal
• Entenda a implementação da detecção de foco na plataforma macOS
• Domine o método de especificação manual do tipo de terminal
• Entenda o comportamento padrão quando a detecção falha

4. Uso Avançado

Domine técnicas de configuração e melhores práticas.

• Estratégias de configuração para evitar spam de notificações
• Ajuste o comportamento das notificações de acordo com o fluxo de trabalho
• Recomendações de configuração para ambientes de múltiplas janelas e múltiplos terminais
• Otimização de desempenho e técnicas de solução de problemas

Pré-requisitos

Antes de começar o estudo desta seção, recomenda-se completar primeiro os seguintes conteúdos básicos:

• ✅ Início Rápido: Conclua a instalação e configuração básica do plugin
• ✅ Como Funciona: Entenda os recursos principais do plugin e o mecanismo de monitoramento de eventos
• ✅ Recursos da Plataforma (opcional): Conheça os recursos específicos da plataforma que você está usando

Sugestão de Aprendizado

Se você apenas deseja personalizar os efeitos sonoros de notificação ou definir horários silenciosos, pode ir diretamente para as subpáginas correspondentes. Se encontrar problemas, pode consultar a seção de referência de configuração a qualquer momento.

Próximos Passos

Após concluir o estudo desta seção, você pode continuar explorando:

• Solução de Problemas: Resolva problemas comuns e dificuldades
• Perguntas Frequentes: Entenda os tópicos de maior interesse dos usuários
• Explicação dos Tipos de Eventos: Aprofunde-se em todos os tipos de eventos monitorados pelo plugin
• Exemplos de Arquivos de Configuração: Visualize exemplos completos de configuração e comentários

---

Clique para expandir e ver a localização do código-fonte

Tempo de atualização: 2026-01-27

Funcionalidade	Caminho do Arquivo	Linha
Definição da Interface de Configuração	src/notify.ts	30-48
Configuração Padrão	src/notify.ts	56-68
Carregamento de Configuração	src/notify.ts	90-114
Verificação de Horários Silenciosos	src/notify.ts	181-199
Detecção de Terminal	src/notify.ts	145-176
Mapeamento de Nomes de Processos de Terminal	src/notify.ts	71-84

Interfaces Principais:

• NotifyConfig: Interface de configuração, contém todos os itens configuráveis
• quietHours: Configuração de horários silenciosos (enabled/start/end)
• sounds: Configuração de sons (idle/error/permission)
• terminal: Substituição de tipo de terminal (opcional)

Constantes Principais:

• DEFAULT_CONFIG: Valores padrão de todos os itens de configuração
• TERMINAL_PROCESS_NAMES: Tabela de mapeamento de nomes de terminal para nomes de processos macOS