Razer Atheris（刺鳞树蝰）：problema bizarro — não tem memória onboard, mas ainda fica a configuração dos botões laterais da conta antiga

AIDO debug
1

Razer Atheris (雷蛇刺鳞树蝰): oficialmente “sem memória onboard”, mas o mapeamento dos botões laterais de uma conta antiga do Synapse fica “grudado” e persiste entre computadores

Dispositivo: Razer Atheris / 雷蛇刺鳞树蝰
VID/PID identificado no macOS: 0x1532:0x0062
Principal forma de conexão: receptor USB 2,4 GHz

Sintoma

Esse Razer Atheris foi configurado antes no Synapse do Windows para ter um botão lateral vinculado a Ctrl+W. Depois, ao conectar no Mac, mesmo com o Synapse desinstalado no Mac, o botão lateral continuava disparando Ctrl+W / comportamentos do tipo fechar aba.

O mais absurdo é: nas especificações oficiais, o Atheris diz não ter perfis configuráveis em memória onboard. Em teoria, um Mac sem Synapse não deveria “herdar” o atalho do Windows configurado no Synapse antigo; o padrão deveria voltar a ser os botões laterais normais:

  • Mouse Button 4: voltar
  • Mouse Button 5: avançar

Mas na prática não é isso. O vínculo antigo de Ctrl+W continua valendo em outro Mac.

A descoberta mais importante

Ao entrar no Synapse 4 com uma conta nova da Razer, os botões laterais aparecem e se comportam com a configuração padrão correta; com o Synapse aberto, fica normal.

Mas quando levo o mouse para outro Mac que não tem Synapse, ele volta para a configuração antiga de Ctrl+W.

No fim, o método que realmente resolveu foi: entrar no Synapse 4 com a conta antiga da Razer (a mesma que tinha configurado Ctrl+W) e apagar todas as configurações/perfis (profiles) dessa conta. Só depois disso o mouse voltou de verdade ao comportamento padrão dos botões laterais.

Então, pelo visto, não é um “profile onboard” completo, e sim algum tipo de “estado atual de mapeamento de botões” escondido (ou estado de migração de configuração na nuvem da conta antiga) entre o Synapse/o mouse/o receptor 2,4G.

Processo de investigação

Nessa investigação eu rodei bastante; abaixo está o que eu testei.

1. Sair do BetterTouchTool

Primeiro suspeitei que o BTT estivesse mapeando os botões laterais para fechar janela.

Resultado: mesmo saindo do BTT, o problema continuou. Na configuração do BTT até existiam ações de botões do mouse, mas desta vez não era o BTT em execução causando isso.

2. Sair do Parallels Desktop / VM do Windows

Também suspeitei que a VM ou o passthrough USB estivesse afetando a entrada.

Resultado: mesmo fechando o Parallels, o problema continuou.

3. Desinstalar e limpar o Synapse no macOS

Depois passei a suspeitar que era resíduo do Synapse no Mac.

Fiz estas limpezas:

  • rodar o desinstalador oficial da Razer
  • limpar ~/Library/Razer
  • limpar ~/Library/Application Support/Razer
  • limpar preferences relacionadas à Razer
  • limpar Razer group containers / application scripts
  • limpar caches / HTTPStorages da Razer
  • reinstalar o desinstalador da Razer para ele desativar corretamente os componentes remanescentes do DriverKit

4. Confirmar que o Razer DriverKit sumiu

Depois da limpeza, continuei verificando o estado do sistema.

systemextensionsctl list mostrou:

0 extension(s)

No hidutil list, o Atheris já tinha voltado para o driver HID nativo da Apple:

  • AppleUserHIDEventDriver
  • AppleUserUSBHostHIDDevice

Não era mais o RazerGenericHIDDriverKit que eu tinha visto antes.

5. Confirmar que o macOS não tem remapeamento via hidutil

Continuei checando o mapeamento de teclas em nível de sistema:

hidutil property --get UserKeyMapping

O resultado foi:

(null)

Isso indica que não era o hidutil do próprio macOS que tinha transformado os botões laterais em atalho.

6. Checar processos da Razer e LaunchAgent/LaunchDaemon

Também procurei processos, LaunchAgent e LaunchDaemon relacionados à Razer.

Os processos reais em background da Razer já não existiam. O único processo que batia com Synapse era da própria Apple:

/System/Library/PrivateFrameworks/Synapse.framework/...

Isso não tem relação com a Razer.

Os plists de LaunchAgent/LaunchDaemon da Razer também já não estavam mais lá; só restavam alguns pkg receipts e estado antigo do launchd — em teoria, isso já não deveria influenciar a entrada HID do mouse.

Solução final

O que resolveu de verdade foram as configurações dentro da conta antiga da Razer.

Passo a passo:

  1. Abrir o Synapse 4 no Windows.
  2. Entrar com a conta antiga da Razer (a que foi usada quando você configurou o botão lateral como Ctrl+W).
  3. Apagar todos os profiles e configurações relacionados ao Atheris / Synapse nessa conta.
  4. Checar a camada Standard e a camada Hypershift, confirmando que os botões laterais não estão vinculados a atalhos de teclado.
  5. Restaurar os botões laterais para Default ou configurar manualmente como:
    • Mouse Button 4
    • Mouse Button 5
  6. Desconectar e reconectar o mouse e testar no Mac sem Synapse.

Depois de apagar as configurações da conta antiga, finalmente no Mac sem Synapse também voltou ao comportamento normal dos botões laterais.

Como eu entendo esse bug

Isso não parece um “profile de memória onboard” no sentido tradicional, porque oficialmente o Atheris não tem slots de profile onboard gerenciáveis.

Mas ele de fato tem algum tipo de estado persistente:

  • o profile na nuvem da conta antiga faz o botão lateral continuar se comportando como Ctrl+W
  • a configuração padrão de uma conta nova só consegue sobrescrever temporariamente enquanto o Synapse está rodando
  • ao trocar para um Mac sem Synapse, volta para o mapeamento antigo
  • só depois de apagar o profile da conta antiga é que esse mapeamento some de verdade

Então a explicação mais plausível é: existe um bug de sincronização ou migração entre o Synapse 4 / a configuração em nuvem do Synapse / o estado atual de mapeamento no dispositivo ou no receptor.
“Sem profile de memória onboard” não significa “não existe absolutamente nenhum estado persistente de mapeamento atual no dispositivo ou no receptor”.

Caminho de diagnóstico para quem vier depois

Se você também tiver um Razer Atheris em que os botões laterais viraram do nada algum atalho de teclado, dá para seguir esta ordem de verificação:

  1. Primeiro, feche BTT, Karabiner, SteerMouse, USB Overdrive, Mac Mouse Fix, Parallels etc., que podem interceptar entradas.
  2. Use hidutil property --get UserKeyMapping para ver se o macOS tem remapeamento no sistema.
  3. Use systemextensionsctl list e hidutil list para checar se ainda existe Razer DriverKit.
  4. Se isso tudo estiver normal, foque em achar “aquela conta da Razer que configurou esse atalho na época”.
  5. Entre com a conta antiga no Synapse 4, apague o profile antigo ou mude explicitamente os botões laterais de volta para Mouse Button 4/5.

Nesta vez, o que realmente foi útil foi o passo 5.