Skip to content

macOS: AhaKey Studio 一直扫描中,系统蓝牙和语音可用但界面等待设备 #34

@Rolling-meatballs

Description

@Rolling-meatballs

问题描述

macOS 上 AhaKey Studio 一直处于扫描中 / 等待设备,始终扫描不到设备。

但从用户侧看,设备并不是完全不可用:

  • 系统蓝牙里看起来已经连接设备。
  • 语音功能可以正常使用。
  • Capless / Capswriter 类语音能力也能正常拉起。
  • AhaKey Studio 界面仍持续显示“等待设备”。

复现情况

  1. 打开 AhaKey Studio。
  2. 设备在系统蓝牙侧已连接,语音功能可用。
  3. AhaKey Studio 仍持续扫描设备。
  4. 多次等待后仍无法进入设备已连接状态。

本地日志现象

ble-comm.log 中反复出现:

蓝牙已开启
开始扫描 AhaKey 设备…
扫描超时,继续后台轮询设备
后台轮询中,尝试寻找设备…
开始扫描 AhaKey 设备…

permission-request.log 中也能看到权限链路无法读到拨杆状态:

diagnostic: no_switch_in_reply
switchState: null
claudeBehavior: ask

后续还出现过:

diagnostic: no_agent_reply

需要确认的问题

  1. AhaKey Studio 的设备识别是否依赖自定义 BLE 通道 / Service 0x7340,而不是系统蓝牙里的普通连接或 HID / 语音链路?
  2. 如果系统蓝牙已连接、语音功能可用,但 Studio 一直显示“等待设备”,官方推荐优先排查哪些点?
  3. 自动模式 / 自动批准是否必须在 Agent 通过 BLE 读到拨杆 switchState 后才会生效?
  4. 这种情况是否需要重装 / 重新安装 Agent + Hook,或者清理旧的 LaunchAgent 配置?

期望行为

如果系统蓝牙侧已连接且设备可用于语音输入,希望 AhaKey Studio 能明确提示当前缺失的是哪一条链路,例如:

  • 自定义 BLE 服务未发现
  • Agent 未运行
  • Agent socket 不存在
  • BLE 被主 App / Agent 另一方占用
  • 已连接 HID / 语音链路,但配置链路未连接

这样用户能区分“蓝牙已连接但配置链路未连接”和“设备完全没连接”。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions