seção 01
Um core de identidade, vários adaptadores
Cada plataforma entrega eventos em um formato diferente. O Discord tem servidores, canais, mensagens e voz; Twitch e YouTube oferecem chats e eventos de transmissão; TikTok e OBS podem exigir observação ou OCR no setup suportado; VRChat recebe parâmetros por OSC. Replicar a personalidade e a política em cada integração criaria comportamentos divergentes.
A arquitetura usa adaptadores para normalizar eventos e um roteador central para escolher como o core deve recebê-los. A persona efetiva, inclusive quando o modo Rebelde está autorizado, vem do estado protegido do runtime. Isso reduz o risco de um canal manter uma persona antiga depois de logout ou expiração da prova.
- Origem identifica a plataforma, canal e tipo de evento.
- Prioridade favorece menções, perguntas e continuidade sem deixar uma pessoa dominar a fila.
- Cooldown limita frequência e protege a experiência da live.
- Política decide se a saída pode ser texto, voz, expressão de avatar ou nenhuma resposta.
- O core mantém identidade; o adaptador não inventa uma personalidade paralela.
seção 02
Discord: canais configurados, wake word e confirmação
O bridge do Discord pode escutar canais configurados e respeita a persona efetiva. O painel administrativo descobre servidores e canais aos quais o bot tem acesso sem bloquear a interface principal. Para funcionar fora dos testes, bot, token, intents, permissões do servidor, canais e dispositivo de voz precisam estar corretos.
Wake word e confirmação continuam importantes. Uma frase no canal não deve desligar a Naomi, alterar configuração ou executar uma ação crítica sem o caminho de confirmação previsto. Conteúdo do Discord é entrada externa não confiável, mesmo quando parece vir de uma pessoa conhecida.
seção 03
Live Host: seleção em vez de leitura indiscriminada
NaomiLiveHost recebe eventos normalizados, aplica prioridade, cooldown e política e encaminha somente os selecionados. A sala central pode recuperar perguntas ou chamadas que um adaptador perdeu e manter contexto curto por participante, mas o chat comum inteiro não deve virar fala automática.
- YouTube pode usar integração oficial com descoberta da transmissão e polling do chat autorizado.
- Twitch pode usar EventSub e caminhos de leitura compatíveis com o modo configurado.
- TikTok e OBS possuem caminhos que dependem da janela real, recorte, escala e qualidade do OCR.
- Eventos passam por moderação, prioridade e limites antes de chegar à geração de resposta.
- Publicação automática de destaques ou punições irreversíveis não faz parte da autonomia segura padrão.
APIs e interfaces mudam. Uma integração pode estar sólida no código e parar por escopo OAuth, revisão de aplicativo, sessão vencida ou alteração da plataforma. A bancada pré-live deve confirmar login, leitura, resposta, reconexão e encerramento para cada canal que será usado.
seção 04
VRChat, OSC e avatar: expressão não é automação irrestrita
OSC transmite estados e parâmetros autorizados para VRChat ou ferramentas de avatar. Ele pode coordenar expressão, fala e presença, mas depende de destino ativo, porta, parâmetros compatíveis e avatar preparado. Código no cliente não cria automaticamente os parâmetros dentro de um avatar publicado.
A visão e a geração de texto permanecem separadas da saída OSC. Um evento visual pode sugerir uma reação, mas a política decide se e quando a expressão é publicada. No modo Live com visão, a expressão acompanha uma saída de áudio confirmada, em vez de disparar atalhos diretamente para o jogo em foco.
- Verifique nomes e faixas dos parâmetros no avatar de destino.
- Teste OSC local antes de adicionar voz, Live e automação de janela.
- Mantenha um comando de parada e um estado neutro recuperável.
- Não permita que texto público escolha livremente nomes de parâmetros ou valores do runtime.
seção 05
Roteamento de áudio: quem ouve qual saída
Em um setup simples, a pessoa fala pelo microfone e ouve TTS no alto-falante. Em Discord ou VRChat, o público pode precisar receber a voz por um cabo virtual enquanto o operador continua ouvindo localmente. Se o cabo entra novamente na captura da Naomi, a assistente pode ouvir a si mesma ou duplicar áudio na transmissão.
- 01MapeieAnote microfone físico, entrada do cabo, saída do cabo, monitor local, entrada do OBS e dispositivo usado por cada aplicativo.
- 02Teste isoladoValide microfone e TTS sem plataforma externa, depois acrescente um destino por vez.
- 03Evite retornoGaranta que a saída TTS não reapareça como fala humana no dispositivo escutado pela Naomi.
- 04InterrompaTeste barge-in e o botão de parar enquanto uma resposta longa está tocando.
- 05ReconecteDesconecte e reconecte USB ou Bluetooth para verificar se o runtime se recupera sem escolher um dispositivo inesperado.
seção 06
Privacidade, moderação e memória em público
Tokens de plataforma ficam protegidos no computador do streamer e não devem aparecer em prompt, log público ou relatório de suporte. Chat bruto não é memória privada da Naomi. O contexto curto da sessão serve à conversa atual e deve expirar; métricas persistentes precisam ser agregadas e não reversíveis para uma pessoa específica.
A Naomi pode classificar e ignorar conteúdo, mas não substitui uma equipe de moderação. Banimento, exclusão ou ação irreversível precisa permanecer com o operador ou com uma política humana claramente configurada. Mensagens de crise entram em um guard determinístico antes de LLM, automações e memória.
- Informe ao público quando IA, voz sintética ou leitura automatizada participam da transmissão.
- Limite respostas escritas e faladas para não dominar o chat.
- Revise a classificação etária e as regras de cada plataforma.
- Não use memória privada do operador como material de comentário público.
- Encerre observadores e revogue sessões ao terminar a live.
seção 07
Checklist antes de entrar ao vivo
- Confirme a conta e o canal corretos em cada plataforma.
- Teste leitura, prioridade, cooldown e uma resposta de texto controlada.
- Teste TTS, monitor local, cabo virtual, OBS e ausência de eco.
- Valide avatar, parâmetros OSC, estado neutro e botão de parada.
- Confira que janelas sensíveis não estão no monitor ou recorte observado.
- Use o perfil de desempenho com jogo e OBS abertos durante o teste.
- Tenha um caminho manual para pausar Naomi e continuar a transmissão.
- Depois da live, desconecte plataformas e confira se observadores encerraram.
respostas diretas
Perguntas frequentes
A Naomi responde todas as mensagens da live?
Não. O Live Host seleciona eventos por prioridade, continuidade, justiça, cooldown e política. Chat comum inteiro não deve virar resposta automática.
Uma mensagem do Discord pode controlar meu computador?
Não deveria. Conteúdo externo não concede autorização. Ações sensíveis continuam sujeitas a política, identidade e confirmação.
Preciso de cabo virtual para usar voz no Discord ou VRChat?
Depende do roteamento escolhido. Um cabo virtual é comum para entregar TTS como microfone ao aplicativo, mas precisa ser configurado para não criar retorno ou duplicação.
A Naomi configura meu avatar VRChat automaticamente?
Não. O avatar precisa expor parâmetros compatíveis e o destino OSC deve estar ativo. A Naomi envia somente os estados autorizados que o projeto de avatar entende.
Integração testada no código significa pronta para minha live?
Não. OAuth, permissões, rede, versão da plataforma, dispositivos e layout de janela precisam ser validados no ambiente real.