雷蛇刺鳞树蝰 Atheris: el absurdo problema de conservar la configuración de los botones laterales de una cuenta antigua pese a no tener memoria integrada

AIDO debug
1

Razer Atheris: en teoría sin memoria integrada, pero la configuración de los botones laterales de una cuenta antigua de Synapse “se queda” y persiste entre ordenadores

Dispositivo: Razer Atheris / 雷蛇刺鳞树蝰
VID/PID detectado en macOS: 0x1532:0x0062
Método principal de conexión: receptor USB de 2,4 GHz

Síntomas

A este Razer Atheris, en Windows, se le había asignado en Razer Synapse un botón lateral a Ctrl+W. Luego, al conectarlo al Mac, aunque Synapse ya estaba desinstalado en el Mac, el botón lateral seguía disparando Ctrl+W / comportamientos tipo cerrar pestaña.

Lo más absurdo es: en las especificaciones oficiales del Atheris pone que no tiene perfiles de configuración en memoria integrada. En teoría, un Mac sin Synapse no debería seguir “comiéndose” el atajo del botón lateral configurado antes en Synapse de Windows; debería volver al comportamiento por defecto de un ratón con botones laterales normales:

  • Mouse Button 4: atrás
  • Mouse Button 5: adelante

Pero en la práctica no es así. La asignación antigua de Ctrl+W sigue funcionando en otros Mac.

El hallazgo clave

Si inicias sesión en Synapse 4 con una cuenta nueva de Razer, los botones laterales aparecen y se comportan con la configuración por defecto correcta; con Synapse abierto, todo va bien.

Pero si te llevas el ratón a otro Mac donde no hay Synapse instalado, vuelve a la configuración antigua de Ctrl+W.

Al final, el método que realmente lo solucionó fue: iniciar sesión en Synapse 4 con la cuenta antigua de Razer con la que se había configurado Ctrl+W en su día, y borrar todas las configuraciones/perfiles de esa cuenta. Solo después de borrar eso, el ratón recuperó de verdad el comportamiento por defecto de los botones laterales.

Así que parece que no es un “perfil integrado” completo, sino algún tipo de “estado actual de mapeo de botones” oculto, o un estado de migración de configuración en la nube de la cuenta antigua, entre Synapse/ratón/receptor 2,4G.

Proceso de diagnóstico

Este diagnóstico dio muchas vueltas; probé todo lo de abajo.

1. Salir de BetterTouchTool

Primero sospeché que BTT estaba mapeando el botón lateral a cerrar ventana.

Pero al salir de BTT el problema seguía. En la configuración de BTT sí había acciones para botones del ratón, pero esta vez no lo estaba causando un BTT en ejecución.

2. Salir de Parallels Desktop / VM de Windows

También sospeché que la VM o el passthrough USB estuvieran afectando a la entrada.

Pero al cerrar Parallels el problema seguía.

3. Desinstalar y limpiar Synapse para macOS

Después, el foco pasó a posibles residuos de Synapse en el Mac.

Hice estas limpiezas:

  • Ejecutar el desinstalador oficial de Razer
  • Limpiar ~/Library/Razer
  • Limpiar ~/Library/Application Support/Razer
  • Limpiar preferences relacionadas con Razer
  • Limpiar Razer group containers / application scripts
  • Limpiar Razer caches / HTTPStorages
  • Restaurar/ejecutar de nuevo el desinstalador de Razer para que deshabilitara correctamente componentes residuales de DriverKit

4. Verificar que Razer DriverKit ya había desaparecido

Tras la limpieza, seguí verificando el estado del sistema.

systemextensionsctl list mostraba:

0 extension(s)

En hidutil list, el Atheris ya había vuelto al controlador HID nativo de Apple:

  • AppleUserHIDEventDriver
  • AppleUserUSBHostHIDDevice

Ya no era el RazerGenericHIDDriverKit que había visto antes.

5. Verificar que macOS no tenía remapeo con hidutil

Seguí revisando el mapeo de teclas a nivel de sistema:

hidutil property --get UserKeyMapping

El resultado fue:

(null)

Eso indica que no era el hidutil incorporado de macOS el que había cambiado el botón lateral a un atajo.

6. Revisar procesos de Razer y LaunchAgent/LaunchDaemon

También revisé procesos relacionados con Razer, LaunchAgent y LaunchDaemon.

Ya no quedaban procesos reales en segundo plano de Razer. El único proceso que coincidía con Synapse era de Apple:

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

Esto no tiene nada que ver con Razer.

Los plist de LaunchAgent/LaunchDaemon de Razer tampoco estaban ya; solo quedaban algunos pkg receipt y estados antiguos de launchd, que en teoría ya no deberían afectar a la entrada HID del ratón.

Solución final

Lo que realmente lo solucionó fue la configuración guardada en la cuenta antigua de Razer.

Pasos:

  1. Abrir Synapse 4 en Windows.
  2. Iniciar sesión con la cuenta antigua de Razer con la que se había configurado el botón lateral como Ctrl+W.
  3. Borrar todos los perfiles y configuraciones relacionados con Atheris / Synapse en esa cuenta.
  4. Revisar la capa Standard y la capa Hypershift, y confirmar que los botones laterales no están asignados a atajos de teclado.
  5. Restaurar los botones laterales a Default, o configurarlos manualmente como:
    • Mouse Button 4
    • Mouse Button 5
  6. Desconectar y volver a conectar el ratón, y luego probarlo en un Mac sin Synapse.

Después de borrar la configuración de la cuenta antigua, por fin se recuperó el comportamiento normal de los botones laterales incluso en el Mac sin Synapse.

Mi interpretación de este bug

Esto no se parece al “perfil en memoria integrada” en el sentido tradicional, porque oficialmente el Atheris no tiene ranuras de perfiles integrados administrables.

Pero sí tiene algún tipo de estado persistente:

  • Un perfil en la nube de la cuenta antigua puede hacer que el botón lateral siga comportándose como Ctrl+W
  • La configuración por defecto de una cuenta nueva solo puede sobrescribirlo temporalmente mientras Synapse está en ejecución
  • Al pasar a un Mac sin Synapse, vuelve al mapeo antiguo
  • Solo al borrar el perfil de la cuenta antigua se elimina de verdad ese mapeo

Así que una explicación razonable es que hay un bug de sincronización o migración entre Synapse 4 / la configuración en la nube de Synapse / el estado de mapeo actual en el dispositivo o en el receptor.
“No tener perfiles de configuración en memoria integrada” no equivale a “no tener absolutamente ningún estado persistente del mapeo actual de botones en el dispositivo o el receptor”.

Ruta de diagnóstico para los que vengan después

Si tú también te encuentras con que el botón lateral del Razer Atheris se convierte misteriosamente en algún atajo de teclado, puedes seguir este orden para diagnosticar:

  1. Primero, salir de BTT, Karabiner, SteerMouse, USB Overdrive, Mac Mouse Fix, Parallels y otros programas que interceptan la entrada.
  2. Usar hidutil property --get UserKeyMapping para ver si macOS tiene algún remapeo a nivel de sistema.
  3. Usar systemextensionsctl list y hidutil list para ver si todavía queda algún Razer DriverKit.
  4. Si todo eso está normal, céntrate en encontrar “la cuenta de Razer con la que se configuró ese atajo en su día”.
  5. Iniciar sesión en Synapse 4 con la cuenta antigua, borrar el perfil antiguo o volver a poner explícitamente los botones laterales en Mouse Button 4/5.

En esta ocasión, lo que de verdad sirvió fue el paso 5.