问题描述
macOS 上 AhaKey Studio 一直处于扫描中 / 等待设备,始终扫描不到设备。
但从用户侧看,设备并不是完全不可用:
- 系统蓝牙里看起来已经连接设备。
- 语音功能可以正常使用。
- Capless / Capswriter 类语音能力也能正常拉起。
- AhaKey Studio 界面仍持续显示“等待设备”。
复现情况
- 打开 AhaKey Studio。
- 设备在系统蓝牙侧已连接,语音功能可用。
- AhaKey Studio 仍持续扫描设备。
- 多次等待后仍无法进入设备已连接状态。
本地日志现象
ble-comm.log 中反复出现:
蓝牙已开启
开始扫描 AhaKey 设备…
扫描超时,继续后台轮询设备
后台轮询中,尝试寻找设备…
开始扫描 AhaKey 设备…
permission-request.log 中也能看到权限链路无法读到拨杆状态:
diagnostic: no_switch_in_reply
switchState: null
claudeBehavior: ask
后续还出现过:
diagnostic: no_agent_reply
需要确认的问题
- AhaKey Studio 的设备识别是否依赖自定义 BLE 通道 / Service
0x7340,而不是系统蓝牙里的普通连接或 HID / 语音链路?
- 如果系统蓝牙已连接、语音功能可用,但 Studio 一直显示“等待设备”,官方推荐优先排查哪些点?
- 自动模式 / 自动批准是否必须在 Agent 通过 BLE 读到拨杆
switchState 后才会生效?
- 这种情况是否需要重装 / 重新安装 Agent + Hook,或者清理旧的 LaunchAgent 配置?
期望行为
如果系统蓝牙侧已连接且设备可用于语音输入,希望 AhaKey Studio 能明确提示当前缺失的是哪一条链路,例如:
- 自定义 BLE 服务未发现
- Agent 未运行
- Agent socket 不存在
- BLE 被主 App / Agent 另一方占用
- 已连接 HID / 语音链路,但配置链路未连接
这样用户能区分“蓝牙已连接但配置链路未连接”和“设备完全没连接”。
问题描述
macOS 上 AhaKey Studio 一直处于扫描中 / 等待设备,始终扫描不到设备。
但从用户侧看,设备并不是完全不可用:
复现情况
本地日志现象
ble-comm.log中反复出现:permission-request.log中也能看到权限链路无法读到拨杆状态:后续还出现过:
需要确认的问题
0x7340,而不是系统蓝牙里的普通连接或 HID / 语音链路?switchState后才会生效?期望行为
如果系统蓝牙侧已连接且设备可用于语音输入,希望 AhaKey Studio 能明确提示当前缺失的是哪一条链路,例如:
这样用户能区分“蓝牙已连接但配置链路未连接”和“设备完全没连接”。