Rodger-Wang
|
1f9925773d
|
清理：第 3 批，Flutter 业务代码孤儿文件、死路由、无人用的服务与依赖（约 7500 行 + 24MB 素材）
- 23 个从 main.dart 不可达的孤儿文件（火山 ASR/TTS/声音复刻一组 3635 行、goodsai 页、
siri_orb/global_ai_orb、intro_overlay_builder、杰理 OTA 残留弹窗与 model 等）
- lib/modules/voice_replication 整目录：Routes.voiceReplication 唯一引用在注释里
- 注册但无人 find 的服务：TranslationUsage / MicrosoftTranslation / Navigation / Location
- api.dart 三个服务端已无接口的方法：getAliToken / getMusicUrl / getproducts
- pub 依赖：tencentcloud_cos_sdk_plugin、flutter_tts、flutter_shaders、flutter_svg、synchronized、
markdown（flutter_markdown 仍会传递依赖）、pip；shaders/ 随 flutter_shaders 一起去掉
- 素材：assets/images/agents（19MB）、assets/weather（2MB）、explore*、defaultPicture*、
robot_light/glasses_light/qqmusic/music、两个 lottie、listening.mp3
- dart analyze 报的 unused_import 31 处、unused_element 17 个（含连带暴露的 4 个）、
unused_field 8 个、unused_local_variable 8 处，全部清零
⚠️ pubspec.lock：仓库里这份锁与 pubspec 早已对不上（改动前的 pubspec 跑 pub get 也会重解析 82 行），
本次重解析后 firebase_auth 6.7.0 拉进的 firebase-auth 24.2.0 要求 Kotlin 2.3、工程是 2.1.10，
Android 编不过；故把 firebase_core / firebase_auth 钉回 4.13.0 / 6.5.7（pubspec 里有说明）。
其余 36 项均为小版本升级。
验证：dart analyze 无 error 且 unused_* 为 0；flutter test 221 全过；
flutter build apk --debug 与 flutter build ios --no-codesign 均通过。
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
(cherry picked from commit 355632a5b41818d33ff9c36b08440777d955cd62)
|
2 weeks ago |
|
Rodger-Wang
|
98e640ecfe
|
client(ios),docs: bundle id 修正、版本号 1.0.2+21，CLAUDE.md 记录本轮四条结论
- GoogleService-Info.plist 三份副本的 BUNDLE_ID 由上一代的 com.saitong.voitrans
改成真实的 com.yimai.eaimar。⚠️ PROJECT_ID 仍是 voitrans：plist 是从 Firebase
控制台下载的，要正的话得在那边注册新的 iOS 应用再重新下载三份。
- pubspec 版本 1.0.2+19 → +21；Xcode 自动改写的工程文件（MARKETING_VERSION 1.0.2）。
- CLAUDE.md 新增/更新四节：通话翻译耳机杂音的四个独立原因；德语/意大利语卡死的
并发初始化竞态与三层修法；版本更新判定的 2026-09-23 新口径；后台上传 APK 报
「必须先选择应用」的原因（X-App-Id 只有绑定应用的账号才有）。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
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
|
3709aa6e3b
|
services: 语音纪要 ASR 按优先级自动回退；翻译区分「语种不支持」与瞬时失败；OSS 配置在作用域归一后可兜底定位
- echomeet: SubmitTranscribeTask 首选 ASR 失败时按 Priority 依次尝试其它启用的识别服务，
并把 AsrSvcId 写回任务，回调才能找到对的服务；原先一次失败就 TranscribeFail
- user_translate: 阿里 10005/10033（语向不支持/语种拼写错）不再当成瞬时错误，
直接回「该语言暂不支持翻译」；挪威语 nb-NO/nn-NO/no-NO 映射到 no
- model_translate: 「跳过未接入 MT 服务」的告警去重，不再刷满日志
- ossconf: appName 为空时按指纹唯一匹配（作用域归一后全局行已不存在）
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 |
|
Rodger-Wang
|
63634532ce
|
语音纪要等待态换成自绘动效；修 tasktype 存两张表导致重进后等待态消失
## 等待态
原来是 assets/lottie/meeting_wait.json —— 一张「JOIN」对话气泡插画，和本页在做的事
（把音频变成文稿）没有任何关系，配色也与全站的 222° 冷蓝灰不搭，深色主题下更是一块
突兀的白。改成自绘：上面一排声波表示音频正在被读，下面几条带流光的骨架行预告即将
生成的文稿形状，两者共用同一个 AnimationController。
自绘而不是再换一个 Lottie：① 不用为一个等待态再背一份 json 资源；② 颜色全部走
AppPalette，明暗主题自动跟随，插画做不到；③ 四个 tab（概览/发言/全文/思维导图）
共用同一个等待态，自绘好调。meeting_wait.json 一并删除（全仓零引用；assets/lottie/
在 pubspec 里是按目录声明的，不用改配置）。
## 重进后等待态消失 —— tasktype 在两张表里各存一份
真机上那条记录的实际状态是 meeting.tasktype=1 / meetingdetails.tasktype=0：
列表页读前者，显示「转写中」；详情页读后者，拿到 0，于是什么等待态都没有。
两张表分头写，而且中间态漏了：
- submitTask / refreshTask / readTask 只调 editMeetingTitle，**只写 meeting**
- _queryTask 里写 meetingdetails 的两次都藏在里程碑分支里（>=3、==5/6），
1→2（等待转写→转写中）这一跳、以及失败态 10002，meetingdetails 一次都不写
首次进入之所以有动画，靠的是详情控制器里那句内存赋值 meetingDetails.value.tasktype=1；
控制器一销毁，重进读库就是 0 —— 表现为「退出重进特效就不见了」。
改法：
1. SqfliteApi.setMeetingTaskType(id, type)：一个事务同时写两张表，成为写 tasktype 的
**唯一入口**。⚠️ 别再直接 editMeetingTitle({'tasktype': x})，那只写一张。
2. 轮询里的状态推进从两个里程碑分支里提到分支之后无条件执行 —— 数据先落、状态最后推，
详情页的 ever(tasktype) 监听读到新状态时数据已经就位。tasktype.value 同样不再只在
分支里更新，1→2 这一跳现在也会通知 UI。
3. 详情页以 meeting 表那份为准（它是历史上唯一每次状态变化都会写的），给**存量**错位
数据兜底：不用等下一次状态跳变就能立刻正常。
真机验证（华为 ALN-AL80）：用那条 details=0/meeting=1 的错位记录进详情，等待态正常
（改前是空白页）；退出重进，等待态仍在；退出后查库两张表都是 1；轮询把状态推到失败态后
两张表都是 10002（改前 details 恒为 0）；终态下等待态正确消失、显示「分析失败」。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
4 weeks ago |
|
Rodger-Wang
|
abd0922d78
|
设备图改成按设备名从本地取；修同传页 GetX 报错遮挡与 AI 页 2px 溢出
## 设备图：关键字映射 → 按名字取图
原来是一张写死的映射表（名字里含 echo-one/deepvoice/buds… 就用 earphone.png），
加一个产品就要回代码里加一条。改成直接按设备名找
`assets/images/devices/<设备名>.png` 与 `<设备名>_icon.png`，
加新产品只要按这个命名把图丢进目录——pubspec 里该目录是**按目录**声明的，
新文件自动打包，代码和配置都不用动。
四个展示点统一到 DeviceImages：设备页主图、设备管理列表小图标、
恒玄固件升级页、杰理固件升级页。其中：
- 设备管理小图标原来是 Material 图标 + 紫色渐变块，现在换成产品实拍图，
底色仍区分连接状态（换成图之后原来靠渐变色传达的「这台连着」就没了）。
⚠️ 这一页取图用的是**服务端下发的 devicename** 而不是当前蓝牙广播名——
它列的是绑定关系，可能包含此刻没连上的设备，用当前连接名会让所有行显示成同一台。
- 杰理固件升级页原来拉服务端 productimage 网络图，一并去掉：产品图统一走本地，
留着会出现「同一台设备在设备页显示本地图、在升级页显示另一张网络图」。
匹配三级，从严到宽：完全相同 → 忽略大小写 → 最长前缀（兜 `Echo-one_L`
这类带后缀的广播名）。第三级必须取**最长**匹配，否则目录里同时有 `Echo` 和
`Echo-one` 时前者会把后者的设备抢走。
启动时读一次 AssetManifest（main.dart）记下目录里实际有哪些图。不做这一步就只能
靠 Image.asset 的 errorBuilder 在渲染失败时兜底，那是**静默**的——美术漏出一张图
或命名对不上，界面直接变通用图，没有任何地方看得出来。现在会打 warn。
资源侧：earphone.png → Echo-one.png（同一张耳机实拍图，只是改名以适配新规则），
补上缺失的 default_icon.png，删掉已无引用的 earphone*/record_card*（省约 1.6MB）。
## 修同传/面对面页「一层阴影盖住标题和返回键」
不是阴影，是 Flutter 的错误控件。translation_view 的 AppBar 里有个 Obx 写成
`Platform.isIOS && controller.currentMode.value == ...`，安卓上 && 短路，
右半边根本不执行，这个 Obx 一个可观测变量都没订阅到，GetX 判「用法不当」抛错，
错误控件顶替了整条 AppBar（debug 红框、release 灰框）。iOS 上 Platform.isIOS
为真会继续求值，所以只有安卓复现。把可观测变量提到平台判断之前读即可。
全仓扫过，同样写法只此一处。
## 修 AI 页三张卡片 RIGHT OVERFLOWED BY 2.0 PIXELS
VIP 区容器有一圈 Border.all()（默认宽 1.0），Border 画在 padding 内侧、左右各占
1px，而列宽计算只扣了 padding 没扣 border，于是正好多出 2px。把 border 宽度提成
具名常量与计算共用，免得改一处又错位。
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 |
