Rodger-Wang
|
7ce56f693d
|
client: 通话翻译音频链路修复（iOS GATT 写入、后台保活、状态竞态）
iOS 上恒玄走的是 GATT over BR/EDR 而非 BLE，之前按 BLE 模型处理导致一连串问题。
本次改动都有真机数据支撑（2026-09-21 压测）。
GATT 写入（bluetooth_manager）
- 写类型改为优先 .withoutResponse。ATT 是请求-响应协议，带应答写每包等 ACK，
追不上下行 50 包/秒，表现为音频越听越滞后。
- canSendWriteWithoutResponse 只作观测、不作门槛。它是 CoreBluetooth 为 BLE
设计的提示，在 BR/EDR GATT 上不反映真实能力（实测 100% 为 false 却零丢弃）；
拿它当闸门会死锁：不写就不回调，不回调就永不翻真，实测 548 包只出去 11 个。
- 控制命令无条件直发、不排队。排到积压音频后面会让 AA 09/AA 06/queryCallState
全部发不出去，曾被误判成「固件换了命令号」。
- 不再对标准电池服务 0x180F 做任何 ATT 操作：它在 Echo-one 上是空壳（值恒为 0），
而挂在它上面的读/订阅会把整条 ATT 通道堵死。
后台存活（translation）
- 通话翻译期间持有 BackgroundKeepalive。两路音频全走耳机 GATT，手机侧没有
AVAudioSession 的实际 I/O，UIBackgroundModes=audio 不成立，切后台几十秒后
上行被掐断：WebSocket 还连着，但服务端收不到语音，靠默认 VAD 每 30 秒强切一句，
吐出空译文或幻觉 —— 表现为「切后台后只剩译文、原文全没」。
- BackgroundKeepalive 不再无条件把音频类别改成 .playback，避免踩掉通话翻译
正在跑的 .playAndRecord 录音链路。
状态竞态（azure_speech / device_hub）
- markReady 的就绪状态记在插件上、建桥时继承。建桥与 AST 异步初始化是两条独立
路径，初始化先完成时那句 optional chaining 打在 nil 上静默丢失，之后 ready
恒为 false、上行帧全积在环形缓冲里，表现为「打开通话翻译没反应，再开一次才好」。
- DeviceHub.inCall 改以会话快照为准。事件会随 worker 在断连时被 dispose 而丢失，
重连后 ever 又不回调当前值，且后续重复赋同值不触发，永远不会自愈。
可观测性
- 下行发送器与 GATT 写入的日志从 NSLog 改为 os_log（release/profile 包里
idevicesyslog 只收得到 os_log），并经 DeviceSession.diagnostics() 暴露给 Dart，
写入文件日志后可用 devicectl 直接拉取，不依赖 usbmuxd。
- 新增 inCall 变化、闸门拦截、通话状态翻转、前后台切换四处观测点。
其它
- DeviceSession 新增 diagnostics()（默认空表）；SmartcarSession 因是 implements
而非 extends，同步补了实现。
- CLAUDE.md 记录本次全部实测结论，含 BB 8E 为通话状态权威、BB 02/03 是噪声
（已知问题，本次未改判定）。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
41e3a023a3
|
client: 蓝牙名白名单（EaiRec/EaiCar）；连接即按账号登记绑定；iOS 崩溃加固；弱网翻译超时
- 设备名闸门：支架只认 EaiRec/EAIMAR/Pad Note，车载香薰只认 EaiCar，固件名对不上直接不连；
一次性清掉此前被归一化名字污染的配对记录；Smartcar 资源与 agent 命名统一改为 EaiCar
- 绑定登记：新增 DeviceBindRegistry（按 uid|MAC 去重），支架也进 verifyConnected，
登录态从无到有时补报一次，换账号不再漏切绑定
- iOS 崩溃加固：补 NSPhotoLibraryAddUsageDescription（保存思维导图/统计图必崩）；
StsAgent 先配音频会话再 installTap 并校验格式；支架录音两处 installTap 加 0Hz 守卫；
AzureTtsHelper 播放队列改加锁队列（三线程裸改 Array，release 下崩）；
MicrophoneCapture 主线程不再用信号量等权限弹窗（看门狗误杀）
- 网络：connectionError 给中文文案；实时翻译请求 12s 超时，不再跟 30s 默认值等
- 附：AI 助手中枢设计文档 v0.2（未动代码）
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
4 weeks ago |
|
Rodger-Wang
|
c14580d7db
|
client: 设备默认图去背；AI 页编排跟随设备；香薰 AI 回复走蓝牙；OTA 状态如实显示
设备默认图
- default.png / default_icon.png 是 assets/images/devices 里仅有的两张**不透明带底图**
（892×1152 竖版海报 + 浅蓝渐变底），而设备页展示区是 1.14:1 的横宽框，
BoxFit.contain 后成了中间一条窄的蓝色卡片、左右大片留白，深色模式下尤其突兀。
改成去背透明（948×828 / 176×154），主体自己铺满框、周围就是页面背景，代码零适配。
- device_images.dart 记下这条约定，免得以后又丢一张竖版带底图进来。
AI 页按设备铺编排（连着香薰却显示全量功能）
- _load() 的一次性迁移会改 enabledIds 却**不更新基线 _lastAppliedKey**，
尤其 _migrateDefaultLayout 会把 defaultEnabled 里缺的全部 append 回来 ——
香薰编排铺成 3 项，重启后被追加成 11 项，基线还停在 3 项，
于是 applyDeviceDefaults 判定「用户动过编排」，从此再也不铺，且怎么重连都恢复不了。
现在：当前编排若是自动铺的就整个跳过这些迁移；已经坏掉的装机由
_rebaseDeviceDefaultsBaseline 一次性把基线抬到现状（判据收紧到迁移留下的特征形态）。
- AgentDefaults.bind 补跑一次当前状态：GetX 的 ever 拿不到绑定那一刻已有的值，
而设备是被动回连的，完全可能赶在 bind 之前就绪。
- 断开设备后回退到 DeviceHub.lastKnownVendor：设备图和「设备管理」在断连后都显示
最近那台设备，AI 页却停在上一台铺的编排里，于是出现「图是耳机、功能是香薰」。
为此给 DeviceHub 加 lastKnownVendor，并把它与 lastKnownName 抽成同一个来源 ——
各算各的就还会自相矛盾。
- test/agent_module_defaults_test.dart 6 个用例守这条规则。
车载香薰唤醒 AI 后回复从手机扬声器出来
- 下行本来就设计成走经典蓝牙 A2DP，坏在共用的音频会话上：defaultToSpeaker 把输出
钉在内置扬声器，选项里只有 allowBluetooth（HFP）而没有 allowBluetoothA2dp
（playAndRecord 下 A2DP 输出默认是关的）。而这条链路采音在设备上走 BLE opus，
手机压根不录音，用 playAndRecord 本身就是错配。
- EmaiAudioSession 分档：香薰走新的 playbackOnly（.playback 类别，输出跟随系统路由），
EMAI 页「按住说话」仍是 playAndRecord（去掉 defaultToSpeaker 会退回听筒，更糟），
只补上 allowBluetoothA2dp。原生 PcmSpeakerPlayer 明确不碰 AVAudioSession，改这一处即可。
固件升级页
- 后台没给产品配过固件时，页面显示的是绿色的「已是最新」——这是假话，会让人以为
手上固件是最新的而不再去查。改成三态：找不到产品配置 / 服务端暂无固件版本 / 有新版本·已是最新。
新文案 otaNoServerVersion 已补齐 41 个语言文件（i18n_audit total_missing=0）。
- 产品找到但版本为空时打一条点名 warn，不再和「拉取失败」混在一起。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
4 weeks ago |
|
Rodger-Wang
|
27cabe1bde
|
client: 设备内核抽象、Smartcar 车载香薰接入与语音纪要等一批改动
工作区里累积的 Flutter 客户端改动，随本轮一并入库。主要涉及：
- lib/devices/ 设备内核：DeviceHub / DevicePlugin / DeviceSession 抽象，
恒玄(bes)、EaiRec 支架(holder)、Smartcar 车载香薰(smartcar) 各自的插件实现，
业务层不再直接依赖任何厂商类；分层边界由 test/devices/ 下的测试守着
- local_plugins/device_plugin_interface、device_smartcar、recorder_holder：
纯 Dart 契约与原生侧实现
- lib/modules/ 能力模块注册表、语音纪要、OTA 升级等模块
- test/ 新增设备协议、Ogg Opus 时长、模块注册表、路由等金测试
- ios/sync_spm_platform.sh：修 Xcode 直接构建时 SPM 平台版本被打回 13.0 的问题
验证：dart analyze lib 无 error（264 条 warning 均为 HEAD 上既有的 unused_import /
avoid_print 等 lint，非本次引入）。未跑真机与打包。
注：这批不是本次会话中由 Claude 编写的，此处仅做入库。
|
4 weeks ago |
