雷蛇刺鳞树蝰 Atheris：没有板载内存却残留旧账号侧键配置的离谱问题

AIDO debug
1

雷蛇刺鳞树蝰 Atheris：标称没有板载内存，但旧 Synapse 账号的侧键配置会跨电脑残留

设备：Razer Atheris / 雷蛇刺鳞树蝰
macOS 识别到的 VID/PID：0x1532:0x0062
主要连接方式：2.4GHz USB 接收器

现象

这只 Razer Atheris 之前在 Windows 的雷云里把一个侧键绑定成了 Ctrl+W。后来接到 Mac 上，哪怕 Mac 上已经卸载雷云，侧键还是会触发 Ctrl+W / 关闭标签页一类的行为。

这件事最离谱的点是：Atheris 官方规格写的是没有板载内存配置文件。按理说，没装雷云的 Mac 不应该继续吃到旧 Windows 雷云里配过的侧键快捷键，默认应该回到普通鼠标侧键：

  • Mouse Button 4：后退
  • Mouse Button 5：前进

但实际不是。旧的 Ctrl+W 绑定会在别的 Mac 上继续生效。

最关键的发现

用一个新的 Razer 账号登录雷云 4，侧键会显示并表现为正确的默认配置；雷云开着的时候正常。

但是把鼠标拿去连另一台没装雷云的 Mac，它又回到旧的 Ctrl+W 配置。

最后真正解决问题的方法是：用当初配置过 Ctrl+W 的旧 Razer 账号登录雷云 4，然后删除这个旧账号里的所有配置/profile。删完之后，鼠标才真正恢复默认侧键行为。

所以它看起来不是完整的“板载 profile”，而是雷云/鼠标/2.4G 接收器里某种隐藏的“当前按键映射状态”或旧账号云配置迁移状态。

排查过程

这次排查走了很多弯路，下面这些都试过。

1. 退出 BetterTouchTool

先怀疑是 BTT 把鼠标侧键映射成了关窗口。

结果退出 BTT 后问题仍然存在。BTT 配置里确实有过鼠标按钮动作，但这次不是正在运行的 BTT 造成的。

2. 退出 Parallels Desktop / Windows 虚拟机

也怀疑过是不是虚拟机或 USB 直通在影响输入。

结果关掉 Parallels 后问题仍然存在。

3. 卸载并清理 macOS 版雷云

随后重点怀疑 Mac 版雷云残留。

做过这些清理：

  • 跑 Razer 官方卸载器
  • 清理 ~/Library/Razer
  • 清理 ~/Library/Application Support/Razer
  • 清理 Razer 相关 preferences
  • 清理 Razer group containers / application scripts
  • 清理 Razer caches / HTTPStorages
  • 重新恢复一次 Razer 卸载器，让它正确停用残留的 DriverKit 组件

4. 验证 Razer DriverKit 已经消失

清理后继续验证系统状态。

systemextensionsctl list 显示：

0 extension(s)

hidutil list 里 Atheris 已经回到 Apple 原生 HID 驱动：

  • AppleUserHIDEventDriver
  • AppleUserUSBHostHIDDevice

不再是之前看到的 RazerGenericHIDDriverKit。

5. 验证 macOS 没有 hidutil 重映射

继续查系统级按键映射：

hidutil property --get UserKeyMapping

结果是：

(null)

说明不是 macOS 自带的 hidutil 把侧键改成了快捷键。

6. 查 Razer 进程和 LaunchAgent/LaunchDaemon

也查了 Razer 相关进程、LaunchAgent、LaunchDaemon。

Razer 的实际后台进程已经没有了。唯一匹配到 Synapse 的进程是 Apple 自己的：

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

这个和雷蛇无关。

Razer 的 LaunchAgent/LaunchDaemon plist 也已经不在了，只剩一些 pkg receipt 和旧 launchd 状态，这些理论上不再影响鼠标 HID 输入。

最终解决方法

真正解决的是旧 Razer 账号里的配置。

步骤：

  1. 在 Windows 上打开雷云 4。
  2. 用当初配置过 Ctrl+W 侧键的旧 Razer 账号登录。
  3. 删除这个账号里所有 Atheris / Synapse 相关 profile 和配置。
  4. 检查 Standard 层和 Hypershift 层，确认侧键都没有绑定键盘快捷键。
  5. 把侧键恢复为 Default，或者手动设置成：
    • Mouse Button 4
    • Mouse Button 5
  6. 拔插鼠标，再拿去没有雷云的 Mac 上测试。

删掉旧账号配置之后，没装雷云的 Mac 上也终于恢复正常侧键行为。

我对这个 bug 的理解

这不像传统意义上的“板载内存 profile”，因为 Atheris 官方就是没有可管理的板载 profile 槽。

但它又确实有某种持久状态：

  • 旧账号的云端 profile 能让侧键继续表现为 Ctrl+W
  • 新账号的默认配置只能在雷云运行时临时覆盖
  • 换到没装雷云的 Mac 后，又会回到旧映射
  • 删除旧账号 profile 后，才真正清掉这个映射

所以比较合理的解释是：雷云 4 / 雷云云配置 / 设备或接收器里的当前映射状态之间有同步或迁移 bug。
“没有板载内存配置文件”不等于“设备或接收器里完全没有任何可持久化的当前按键映射状态”。

给后来人的判断路径

如果你也遇到 Razer Atheris 侧键莫名其妙变成某个键盘快捷键，可以按这个顺序排查：

  1. 先退出 BTT、Karabiner、SteerMouse、USB Overdrive、Mac Mouse Fix、Parallels 等会拦截输入的软件。
  2. 用 hidutil property --get UserKeyMapping 查 macOS 是否有系统重映射。
  3. 用 systemextensionsctl list 和 hidutil list 查是否还有 Razer DriverKit。
  4. 如果这些都正常，重点去找“当初配置这个快捷键的那个 Razer 账号”。
  5. 用旧账号登录 Synapse 4，删除旧 profile，或者把侧键明确改回 Mouse Button 4/5。

这次真正有用的是第 5 步。