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
|
8b50e52572
|
client: 通话翻译字幕错位/总结残留/退不出去/切后台被冻结，及 B 路说话人门限
真机实测（Android，恒玄耳机）逐条定位后修，原生能改的都在原生层改。
字幕乱（AliyunBailianE2EHelper，Android/iOS 同改）
- 原文流与译文流各自按到达顺序自己发号，两条流的切句本来就不一致，off-by-one
一旦发生就一路错到底。改成认服务端的 item_id：译文帧的 item_id 经 itemParent
（response item → input item）映射回原文那条，取不到才退回本地发号。
- response.audio_transcript 的 text 是累计值、delta 才是增量，此前一律当增量
append，于是出现「Hello,Hello,Hello,」。改成按字段名分支：有 delta 就追加，
只有 text 就整段替换。
- connectionGeneration 守住 onOpen/onMessage/onFailure/onClosed（iOS 用 activeTask
弱引用按任务身份判），旧 socket 的迟到回调不再打进新会话；stopContinuousConversation
同步清 webSocket/isStarted。
翻译结束后「总结内容」还留在屏幕上
- AliyunAstCallback.onSessionFinished 会把整场累计文本当作一条 translated 再发
一次，表现就是一大坨总结。不再发；原文缓存改为按 utteranceId 存，上限 32 条。
结束后无法再翻译、返回按钮像被遮挡
- 退出时那颗延时 Get.delete 会误杀刚重新进来的页面。按 tag 记活跃页面数
（_PageAliveMarker + _aliveCount），还有人用就跳过销毁。
重进页面提示「未在通话中」
- 耳机对 0xD1/0xD2（进/出通话模式）的应答被当成通话状态上报，把 isCallOngoing
改掉了。这两个 type 改为只记日志，不动通话状态。
切后台功能被关掉
- 前台服务类型加 phoneCall：microphone|phoneCall (132)，ROM 的进程冻结不再掐断
通话翻译。startForeground 带类型失败时回退到仅 microphone。stopService 改用
context.stopService，后台也能调。
- AST 掉线自动重连（1s/2s/4s，最多 3 次），回到前台按 _astHealthy 补一次；
重连后的新会话用 800ms 宽限期，否则会被原来的 2s 窗口吞掉重试。
B 路说话人门限（PeerSpeechGate，新增 + 11 个单测）
- 声音复刻配的是 frequency=once，只在会话开头刻一次音色。B 路会话一启动就建立，
此时对端多半还没开口，先收到的是机主的串音（实测 B 路 ASR 配 language=en 却
识别出机主刚说的中文），于是把机主音色刻成了「对端音色」，两个人听起来一样。
- 未开门期间音频进环形缓冲，开门瞬间整段补发——对端先开口时第一句的开头一个字
都不能丢。fallbackFrames 到时强行开门：门限太严会让对端整通电话不被翻译，
太松只是音色可能刻错，后者轻得多。
- 每次会话重建（含断线重连）都 reset，否则重连后照样刻到串音。
已知未尽：Android 14+ 会拒绝 phoneCall 这个前台服务类型并回退成仅 microphone，
那里的冻结保护不生效；rmsThreshold=600 尚未在真机上标定（上一轮跑到了兜底强开）。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 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 |
|
Rodger-Wang
|
110cbcb026
|
prod-deploy: 阿龙段的 SSH 私钥路径改为可被环境变量覆盖
三个 prod-deploy.sh 的 along 段都写死 /Users/liwei1dao/liwei/密钥/...，
该路径只在原作者机器上存在，换一台机就跑不了部署。改成
${DEPLOY_KEY:-<原路径>}，默认值不变（原机器行为不受影响），
其它机器用 DEPLOY_KEY=~/xxx.pem ./prod-deploy.sh 即可。
写法与 dev-deploy.sh 的 along 段保持一致。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
edc414bc61
|
设备管理按在线排序；恒玄日志在 release 里恢复可见、电量补查重试
设备管理页：
- 在线设备排最前，其余保持服务端顺序。用「两个桶拼起来」而不是 List.sort，
Dart 的 sort 不保证稳定，按 0/1 排会让离线设备的相对顺序每次刷新都变。
- 排序结果不会自己重算：列表的 Obx 只收集到 allDevices 一个可观察对象，
所以挂 ever(deviceStatus/connectedDeviceId/deviceMac) 在连接变化时重排，
onClose 里 dispose。
- isConnected 补上 deviceMac 比对，与 unbindDevice 里的判据对齐。
只比 connectedDeviceId 的话 iOS 上恒为 false（那是 peripheral UUID
不是 MAC），列表全显示未连接、排序也白排。
日志：
- Logger 的 console 开关原来是 !kReleaseMode。配上 release 级别 = warning，
结果是 debug/info 被级别挡掉、warn/error 被开关挡掉，release 包里一条都
到不了 logcat。为真机排查写的那套恒玄抓帧诊断，在真正拿去测的包里全是
死代码。现在 release 也开，级别门槛仍是 warning。
- 恒玄的原始帧 / 未识别回包 / 电量 / 固件版本 / 命令探测一律改 warn 级，
这样正式包里也留得住——定位新固件命令号只能靠这些第一手字节。
电量：
- 握手里只发一次 AA 09 不够（那一刻 SPP 刚建好、命令可能被丢；协议 3.1.10
这帧也可能只在状态变化时主动推）。加 3s/8s/20s 三次补查，拿到就停，
断开即取消。不做长期轮询：探测命令占着 SPP 会让录音/翻译排队。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
80c6ea1be3
|
iOS 真机排查：修同传播报路由、录音时长与电平崩溃
一轮 iPhone 真机联调里发现并修掉的一组问题，多数是既有缺陷，两处是我在
本轮前期改出来的回归（已在注释里标明，避免以后再踩）。
同传播报路由（AzureTtsHelper.swift，phone_call 分支）
这一支被改坏过三次，结论固定在注释里：
① 最早 `.defaultToSpeaker` + `overrideOutputAudioPort(.speaker)`
→ 连了 A2DP 也被强拽到外放；元凶是那次 override（已删）。
② 修 ① 时把 `.defaultToSpeaker` 一并删了 → 删过头：`.playAndRecord` 的
默认输出是**听筒**，没耳机时译文几乎听不见（「翻译出来了但不播报」）。
③ 补回 `.defaultToSpeaker` 且 mode 设成 `.videoChat`（为了 AEC）
→ `.videoChat` 本身偏好内置扬声器，连了耳机又被拽到外放，绕回 ①。
现在按**有没有耳机**分两支：有耳机走 `.default` + 仅 A2DP；没耳机走
`.videoChat` + `.defaultToSpeaker`（外放且开回声消除）。分支口径与采集侧
MicrophoneCapture 启用 voice processing 的条件完全一致，两边不再打架。
没有这个 AEC 时，外放的译文会被自己的麦克风收回去，ASR 当成新一句再翻一遍。
现场录音（bes_recording_service.dart）
- 时长改为按**已写入的数据量**算（32 字节 = 1ms），与 WAV 头一致，
因此界面时长与文件实际播放长度永远相等。墙钟算不准：耳机收到 AA 59 后
要 1.8~6.5 秒才上行首帧，还会把等待期缓存的音频一次性补推，实测数据量
比「首帧到停止」的墙钟窗口还多 21~45%，从哪头计时都对不齐。
真机验证：音频19.15s/墙钟18.88s、音频18.72s/墙钟18.69s，
等效采样率均为 16000Hz 整、0 丢帧。
- 修 `_updateLevel` 的 `asInt16List(offsetInBytes, …)`：原生来的 Uint8List
是带 offset 的视图，偏移为奇数时必抛 RangeError。原来藏在 try 里被吞掉，
表现是波形/电平一直不动（数据本身没丢）。改成按小端手工拼 int16，
与 BesCallRecordingService._writeStereo 同一修法。
⚠️ 本轮我一度把它挪到写入之前且未包 try，一抛异常整个 _onPcm 中断、
音频一帧都写不进去（实测 6990 次未捕获异常）——现在它排在写入成功之后
并单独包 try，波形挂了绝不能影响录音。
- 音频写入排成 Future 队列。Stream.listen 的 async 回调不会被等待，
每秒上百帧必然重叠，而 RandomAccessFile 同一时刻只允许一个异步操作。
（事后核对通话录音同样写法却没丢数据，所以这条是防御性的，不是主因。）
识别异常与状态收口（translation_controller.dart）
- 新增 _abortRecognition：catch / error / canceled 三条异常路径统一回滚，
**把录音一起停掉**。此前 `isRecording` 全文件只有一处 `= true`、从来没被
置回 false，识别挂了右上角还在计时；异常路径更是连 stopRecording 都不调。
标记同时收口进 stopRecording，所有停止路径都覆盖得到。
- startRecognition 点击即点亮 isPreparing（view 早已绑好按钮反馈，只是从来
没人设过它，点下去毫无视觉变化，就是「点了没反应」）。
- `await _modeInitFuture` 补 3 秒超时。它是本轮前期为消除语言竞态加的，
但没有超时——iOS 首次要激活音频会话、连着蓝牙还要等音频路由，一旦迟迟
不返回点击就永久卡住。把「可能用错语言」换成「可能完全卡住」是坏交易，
超时后走兜底 initialize，至少起得来。
- 三段耗时打点提到 warning 级：release 的日志级别就是 warning，用 info 打
在真机上一条都留不下。
其它
- Logger 在非 release 下同时 print 一份：`developer.log` 只进 VM service 的
logging stream，`flutter run` 控制台看不到、调试态下 idevicesyslog 也抓不到，
真机排查时加了一堆打点却一条都看不见。
- 连接握手不再自动跑 probeCommands：每条间隔 400ms、一轮十几秒，期间 SPP
通道被占满，用户点录音/翻译的指令只能排队。需要重扫时手动调。
本次在固件 0.0.3 上的扫描结果记进注释（0x0B/0C/0D/0F/10/19 有回包，
但取值都不像电量百分比，电量命令仍未定位到）。
- 通话状态变化打出触发它的原始字节，便于排查「刚连上就被判成通话中」。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
24e17b3434
|
收拢积压改动：恒玄 OTA、发版配置拆表、实名认证、芯片厂商/代工厂管理等
把工作区里积压的多轮改动一次性入库。主要几块：
客户端
- 恒玄 OTA 打通：新增 local_plugins/bes_ota_manager（自包含 BES SDK，
Android Java + iOS ObjC，SPP OTA 2.0），路由切到 BesOtaUpgradeView /
BesOtaUpgradeController，配套下载服务；杰理那套文件保留但已不挂路由。
- 通话翻译新增阿里 3.5 档（alibaba35_language_config.dart，
qwen3.5-livetranslate-flash-realtime + 实时声音复刻）。
- 实名认证接入、游客登录改走服务端 api_sgin 的 Tourists 分支、
功能闸门由 GuestGuard 改为 IdVerifyGuard。
- 41 个语种文案同步（OTA 新增 28 个 key 等）。
- 默认主题改为浅色，不跟随系统。
服务端
- 发版类配置拆表：app_release（版本控制 / 游客显隐，一应用一行）与
channel_app（渠道级下载地址 / 上架状态 / 支付渠道）分家，
新增 comm/apprelease.go 与 console/api_apprelease.go。
- 授权码字符串整体移除：删除 utils/license 包，新增 utils/devcode
（MAC 规范化与 PID 反解），配套迁移 SQL 在 docs/migrations/。
- console 新增芯片厂商、代工厂、用户管理接口与对应 admin 页面。
- 身份证实名核验（sys/idverify）与第三方服务的服务端专用类别。
其它
- .gitignore 补挡 apps/services/lego/sys/gin/log-*.log：gin 子系统跑起来
会按时间戳滚动生成日志（多为 0 字节），与 apps/services/comm/log 同一
性质，不进版本管理。已跟踪的 log-2026-08-20 那个仍在库里，未动。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
2d1ee0b783
|
apps/client 首次入库（Flutter 移动端）
从 /Users/yunyanzhineng/work/eaimar_client-main 搬入，未带原 .git，历史留在原仓库。
3215 个文件 / 约 118MB，其中约 40MB 是构建必需的预编译 SDK（azure_speech 的
MicrosoftCognitiveServicesSpeech.xcframework、device_jieli 的 JL_BLEKit 等）。
build/ (5.2G)、ios/Pods/ (311M)、android/.gradle/ (120M) 已由 .gitignore 挡掉。
本次入库的代码包含两项刚做完的改动：
1) 游客登录入口接上服务端开关。此前 _checkGuestLoginConfig() 恒定写死 true，
入口根本不读配置。现改为取服务端算好的结论，并把入口所在的 Builder 改成 Obx
——配置是异步拿到的，Builder 只渲染 onInit 时的初值 false，入口再也不会出现。
拿不到配置时按隐藏处理：默认显示会在送审期把不该露的入口露给审核员。
⚠️ 已发布的老客户端关不掉（写死 true），只对本版及以后生效。
2) iOS 上架合规修复：
- 移除 ATT/IDFA：删掉 Info.plist 的 NSUserTrackingUsageDescription、
SKAdNetworkItems、NSAdvertisingAttributionReportEndpoint，删掉 splash 里的
授权请求与 app_tracking_transparency 依赖。本 App 从不读取 IDFA，也没有任何
广告/归因 SDK，弹框纯粹劝退用户，还要在 App Store Connect 申报追踪数据类型。
- ios/Podfile 里那段 config.build_settings.delete('NSUserTrackingUsageDescription')
是无效代码（该 key 在 Info.plist 里，不是 build setting），换成注释说明。
- 通讯录符号（ITMS-90683 被拒原因）随之一并解决：permission_handler 走 SPM 后
按 Info.plist 有无对应 key 决定编不编，判定结果被 SwiftPM 按内容哈希缓存，
改完 plist 必须清 DerivedData 与 manifests 缓存才会重新求值。
另附 GOOGLE_PLAY_RELEASE_CHECKLIST.md：Google Play 上架阻塞项的实测梳理
（targetSdk 36 与 Billing 8 的 2026-08-31 期限、16KB 页对齐不合规的两个 .so、
支付回退逻辑的下架风险）。
⚠️ android/app/sign/ 下的 eaimar.keystore 与 Eaimar.properties（含明文签名密码）
随本次提交入库，与本仓库"私有仓库下接受真实凭据"的既有取舍一致。
仓库若要公开，这两个必须先摘出去。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
1 month ago |
