Tridactyl扩展失效问题排查：Gnome屏幕阅读器导致的键盘事件拦截

问题现象

Tridactyl是一款Firefox浏览器的高效键盘操作扩展，近期有用户反馈该扩展突然停止正常工作。主要症状表现为：

• 扩展似乎始终处于插入模式，无法响应大多数快捷键
• 部分功能键如":"偶尔可用但不稳定
• 某些特定按键如"j"和"Esc"仍能正常工作
• 问题出现在所有网站上，且在不同Firefox版本(包括稳定版和测试版)中重现

排查过程

用户进行了多方面的排查尝试：

1. 检查了扩展版本(1.24.1)和Firefox版本(133.0)
2. 尝试在隐私窗口中运行，排除其他扩展干扰
3. 创建全新的Firefox配置文件进行测试
4. 甚至完全删除.Mozilla目录重新初始化环境
5. 在不同Linux发行版(Fedora 41和NixOS)上对比测试

在调试过程中发现控制台出现"Unexpected pre-existing callContextData"错误信息，但并非直接相关。通过使用在线键盘事件测试页面，发现不仅是Tridactyl扩展，整个Firefox浏览器都无法正常接收大部分键盘事件。

根本原因

经过深入排查，最终发现问题根源在于Gnome桌面环境的屏幕阅读器(辅助功能)被意外启用。这一功能会拦截并处理键盘输入事件，导致：

1. 浏览器无法接收到完整的键盘事件流
2. 只有部分特定按键能够穿透屏幕阅读器的拦截
3. 问题仅影响实现了辅助功能支持的应用程序(如浏览器)，其他应用表现正常

解决方案

解决方法非常简单：

1. 检查Gnome顶部状态栏，寻找辅助功能/屏幕阅读器图标
2. 关闭屏幕阅读器功能
3. 浏览器立即恢复正常接收所有键盘输入

经验总结

这类问题的排查思路值得借鉴：

1. 当浏览器扩展出现异常时，首先确认是否是浏览器本身的问题
2. 使用最简单的测试环境(如键盘事件测试页面)隔离问题
3. 考虑系统级因素，特别是辅助功能类设置
4. 不同应用程序表现差异可能指向系统级配置问题

对于Linux桌面用户，特别是使用Gnome环境的开发者，应当注意辅助功能可能带来的意外影响。这类问题往往没有明显的视觉提示，但会严重影响键盘输入的处理流程。