连接
Joy-Con 没有出现在连接页
- 在“系统设置 → 蓝牙”确认手柄已经完成配对。
- 让手柄靠近 Mac，并按一下实体按键唤醒。
- 在 JoyHarness 连接页选择“重新检测手柄”。
如果 macOS 蓝牙列表也看不到手柄，先处理系统配对；JoyHarness 无法替代系统蓝牙连接。
权限
显示已连接，但按键没有输出
这种情况通常说明读取手柄正常，但快捷键输出权限不完整。打开“权限”页，确认辅助功能已经授权。
如果菜单栏、电量和连接状态正常，只有实际输入无效，优先重新确认辅助功能授权。
状态
页面显示“按键响应已暂停”
暂停不会断开 Joy-Con，但所有语音与快捷键动作都会停止执行。在连接页或菜单栏状态菜单中选择“继续响应”即可恢复。
服务
后台服务尚未运行或状态读取失败
在连接页使用“启动后台服务”或“重新启动后台服务”。状态恢复后，再确认按键响应卡显示“已就绪”。
不要先删除配置。 服务异常与按键方案是两件事；重置配置不会修复一个没有运行的后台服务。
诊断
问题仍未解决
从菜单栏状态菜单选择“导出诊断信息”。诊断内容用于定位连接、服务和权限状态，不包含录音或语音文字。