Rodger-Wang
|
06c01aa858
|
admin: 「版本控制」与「渠道分发」合成一页「版本与分发」(/appdist)
上半区发版配置、下半区渠道分发，顶部一个应用选择器共用。页面本体拆成
components/AppReleasePanel.vue 与 ChannelAppPanel.vue；/appversion、/channels
只留重定向。
⚠️ 合的是入口不是表。app_release 与 channel_app 维度不同，两块各读各的接口、
各自提交，绝不能做成一个大表单整包保存——app_release 那一行还被「游客显隐控制」
页共用，后端是「读整行→只覆盖本组→整行写回」，整包提交会在本页保存时清空游客
登录配置。
⚠️ 菜单 id 仍是 appversion（只改了 label 与 to）：存量后台账号的 access 清单里存
的是这个串，改 id 等于让这些账号丢入口。只勾过旧 id channels 的账号由
auth.ts 的 hasAccess 兼容放行。
发版面板同步本次的新口径：线上版本按 Android / iOS 两栏、最低支持版本可留空
（= 线上版本）、判定预览可切平台；上传 APK 传完把直链填进「默认下载地址」输入框
并写进「渠道分发 → 官方渠道(100)」，下方面板随即重拉。
⚠️ savechannelapp 是整行覆盖，所以写官方渠道地址必须「读整行→只改 address→写回」；
getchannelapps 回的是 {items:[...]} 不是裸数组，当成数组取会永远走新建分支、
把官方渠道已有的上架状态/支付渠道清零且不报任何错。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
2cf260eb05
|
服务端：音乐模块与腾讯云 COS 整体下线；新增分发桶（App 安装包与录音/固件分开放）
音乐：sys/music、sys/musicobj、modules/music、mcp/tool_music.go 全部删除，home 的
模块列表与 musicobj 初始化、两份 yaml 模板里的 musicobj 段一并去掉。起因是它的
ApiBaseUrl 指向上一代品牌域名；客户端的音乐模块本来就早已删除。
⚠️ 咪咕音乐（tool_migu_music + migu 服务）没有动，别一起当成音乐链路删了。
腾讯云 COS：sys/tencentyun 整个删除，home/api 的 cos.OnInit 与配置段、
comm.svcRuntimeSections 的 cos 托管一并去掉。头像上传改走阿里云 OSS（与
user_getuploadurl、console 后台直传同一个桶）。modules/api/api_getcostoken.go 是
孤儿（后台调的其实是 console 那个同名路由，客户端从不调），删除。后台两处的
腾讯云 COS 卡片/模板与巡检探针也删——服务端读存储配置的唯一入口只认
provider=aliyun_oss，留着是「配得上却不生效」的陷阱。存量 tencent_cos 行不动。
⚠️ 老客户端仍读业务库 config 表的 COS_* 直传腾讯云，那 5 个键别删；历史录音的
audiourl 是 COS 绝对地址，不会自动搬家。
分发桶：comm.AliyunOSSConf 加 DistBucket/DistDomain（留空用 ymai-dl /
dl.ymaikj.com），凭据与主桶共用。后台「上传 APK」走 api_getcostoken 带
target:"dist"：key 不加 EAIMAR 根前缀（分发桶直接挂在 dl.ymaikj.com 上）、目录走
白名单、按应用分子目录（一个桶放多个应用，不分目录会静默互相覆盖）。
⚠️ Content-Type 由服务端按扩展名强制并回带给前端：浏览器对 .apk 给出的 File.type
往往是空串，前端照它发 PUT 会与预签名不符、OSS 回 403，而报错里完全看不出是类型
对不上。⚠️ 分发桶必须单独配 CORS（来源 console.ymaikj.com、方法 PUT），
浏览器直传打的是桶的 OSS endpoint 而不是自定义域名。
另含下载落地页 deploy/dl（含 OSS 部署教程）与各 deploy 脚本/README 的同步更新。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
9f105bf7c8
|
会议纪要分享：链接最后一段改成服务端签发的只读票据，不再放登录 JWT
链接格式 share.ymaikj.com/share/{serverHost}/ymaikj.com/{id}/{ticket}。最后一段
以前放的是 logintoken（完整登录 JWT）——谁拿到链接就拿到了整个账号，转发进群、
被截图、进浏览器历史都等于把账号交出去，而且除了改密码没有任何失效手段。
现在是 HMAC 签名的分享票据：绑定单条记录、只读、默认 7 天过期，密钥由
FIELD_ENCRYPT_KEY 派生（上线不需要新配置项）。
- echomeet_getsharedrecord 必须在 gateway 白名单里——打开链接的人本来就没登录，
漏了是 code:18、表现为「分享链接打开一片空白」。签发端 echomeet_createsharelink
反之，不要加进白名单。
- 落地页嵌在 gateway 二进制里（go:embed），路由 GET /share/*any 必须是 catch-all：
路径里的段是数据不是文件路径，gin.Static 会去磁盘找同名文件、一律 404。
- 落地页的 ALLOWED_HOSTS 白名单不能删：serverHost 来自 URL，不校验就等于「构造
一条链接让别人的浏览器带着票据去请求任意域名」。新增环境要加一行。
- 极简 Markdown 渲染器先 esc() 再套正则，块级语法要匹配转义后的形态（引用块匹配
的是 > 不是 >），写成 > 不报错、只会静默退化成普通段落。
客户端侧：分享前先申请票据并加载提示，拿不到就不分享出一条必然打不开的链接。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
4753d37c69
|
版本更新判定改口径：按平台分版本、最低版本留空=线上版本、渠道未上架不推、地址回退链
判定仍全在服务端算好下发，客户端只拿结论。规则：
1. Android / iOS 各一套版本号：app_release 加 ios_version / ios_min_version
（启动 ALTER ... ADD COLUMN IF NOT EXISTS 幂等），原 version/min_version 只管
Android，平台由渠道号推导（只有 GlobalApple=101 是 iOS）。iOS 没填时**不回退
Android 的**——回退等于又回到共用一个版本号：Android 先发 1.0.3 而 iOS 商店还是
1.0.2 时，iOS 用户会被指向一个商店里没有的版本。
2. 最低支持版本留空 = 线上版本：勾上强更不填最低版本，就是「所有低版本都强更」；
填了则只强更低于它的，介于两者之间的仍是推荐。后台校验相应改成「至少填一个
平台的线上版本」。
3. 渠道行状态不是「已上架」（审核中/已下架）时不推送推荐更新——商店里还是旧包。
强更不受此限，它的地址会由回退链换成官方包。
4. 下载地址回退链：Android 渠道 = 本渠道（须已上架）→ 官方渠道(100) → 默认下载
地址；iOS / Google 只认本渠道，没有就空——那两处如今放的是 apk 直链。
5. 算不出任何地址时两种更新都不提示，强更也不例外：一个点了没反应又关不掉的
弹窗等于把用户锁死。
客户端三处配套：推荐更新的「稍后提醒」记住版本号，同一版本 24 小时内冷启动不再弹
（强更与手动检查不受影响）；设置页手动检查绕过 10 分钟缓存；Android 上服务端地址
打不开时回退网页下载页（iOS 不兜底，那页给的是 apk）。
另修后台上传安装包报「必须先选择应用」：X-App-Id 头来自登录态的 currentAppId，
只有绑定了应用的运营/代理账号才有；超管在页面顶部选的应用只是个 app_name 字符串，
从不进请求头。现在 uploadFile 把它放进请求体，服务端没有 X-App-Id 时按 name /
app_name 反查注册表补作用域。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
6f1686a8fd
|
client: EaiCar 设备设置面板（按能力出现、按设备回的 items 渲染）
「设备 → 设备管理」里 EaiCar 那一行整块可点（解绑按钮除外），弹底部面板拉 0x15
显示并可改：启停 0x0D / 音量 0x0B / 亮度 0x0A / 行车感应 0x11 / 摇摆 0x14 /
随机表情频次 0x13 / 随机播一个表情 0x06。
- 面板是厂商无关的：只认 DeviceCapability.settingsPanel 与 DeviceFeatures.settings*
通用键，按 settings.query 返回的 items 画控件，缺哪项不画哪项。EaiCar 插件把
通用键映射成字节（EaiCarSession.settingsCommand，纯函数，金测试逐字节钉死）。
以后耳机/支架要露设置，各自插件声明即可。
- 状态只有 0x15 一个来源：六条写命令只回 0x64 成功码，不回显新值也没有主动上报。
插件写成功后本地回填并派 settings.changed；面板从不自己推断状态。原先
_applySummary 解完 14 字节只留固件和电量，这次整份留下。
- 0x11 双向语义不同：AA 11 是行车感应开关，CC 11 是设备上报 AI 唤醒，按帧头分发。
- 「随机表情」设备只有频次（9 档秒数）；「现在随机播一个」没有原生命令，
由 app 在 0x00~0x09 里挑一个发 0x06。
- 未连接的 EaiCar 行也可点（按设备名猜品类），进去是「未连接 / 去连接」；
其它品类的行 onTap 仍为 null，行为一字不差。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
5036ab4c3f
|
client: 修通话翻译「德语/意大利语一开就卡死、只有中英正常」——并发初始化+默认参数兜底
不是语种问题，是竞态。原生阿里初始化天然 >=1.2s（A 路 init → delay(1200) →
B 路 init），期间只要再来一次 initialize/dispose，「代数」就变了，前一次返回
false；Dart 拿到 false 把 _isInitialized 清掉；接着 recognizeCallback() 看到
「未初始化」就调**无参** initialize()——默认值 provider=azure + [zh-CN,en-US]，
把刚握手成功的阿里 zh→de 会话整个换成 Azure 中英三段拼装。此后原生 provider
停在 azure、Azure 识别器一直在跑，每次 dispose 都慢几秒，下一轮更容易撞进
1.2s 窗口，**退出重进也不会好**。中英「正常」只是因为默认值恰好是中英。
修在三层，缺一层都会复发：
- azure_ast_service.dart：initialize() 串行化（_initInFlight）；记住最近一次的
provider/语言表；recognizeCallback / startContinuousTranslation 走
_ensureInitialized——先等在途初始化，仍没成就**按上次参数**补一次，
永远不用默认值，没有可复用参数就直接报错。
- translation_controller.dart：_initializeCallModeTranslationService 串行链；
isPreparing 期间忽略重复点开始；_attachBesCallTranslationBridge 开桥前先等
初始化真正落地（10s 上限）——原来靠 _modeInitFuture 3s 超时硬往下走，
桥开在原生初始化之前。
- AzureSpeechPlugin.kt/.swift：被新一代取代时打出阶段与代数、A/B 任一失败打
结果，排查先找这两行。iOS 另修一处独有差异：原先 A/B 无论成败都回 true，
Dart 以为就绪、桥照开而实际一路是空的，现在按真实结果回。
Redmi K90 Pro Max 验证：连开 9 场（it/de/en/ja/fr/ko×2/en，含切语言、关闭重开、
退出重进）全部阿里 3.5，初始化各 1.2s，87 句译文，0 错误，断粮 0 次。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
ace92c9ea1
|
client: 通话翻译耳机杂音——四个独立原因逐个修掉（Android 定性，iOS 同步）
六轮真机定位出四个叠加的原因，每修掉一个概率降一档：
1. 发包定时器系统性漂移：scheduleWithFixedDelay 从任务**结束**起算，WSOLA+G.722+
写 socket 的 1~3ms 全叠进周期，"20ms"实测 21~23ms、只有 0.9 倍速。改成
scheduleAtFixedRate 固定节拍且永不重排。
2. 起播缓冲在句中重新生效（杂音落在句中的真凶）：队列空了就要求再攒 120ms，而
变速追赶时队列中途归零很常见，等于句中硬插 120ms 静音。加 playing 标志让
起播缓冲只在句首用一次；真正的断粮单独计数并打「句中空洞」日志。
3. 恢复发包时从空缓冲起播（杂音落在句首）：两路都空就停发、耳机缓冲被榨干。
现在先塞 4 包编码静音垫底再发真音频，两路空后再续 500ms 静音才停。
4. 24k→16k 重采样是逐块独立的线性插值、无抗混叠、每块相位从零重算。换成
64 阶低通 FIR + 跨块连续（Resampler24kTo16k.kt/.swift，Python 复刻校验
1k/3k/6k 正弦）。
顺带：耳机 0xD6 帧 data[6] 的语义是「补一包」不是「改速率」，按此重写
onHeadsetPace（01 补 1 包、00 补 2 包、03 扣 1 包）；空闲那一路的静音帧改用该路
自己的编码器编零（G.722 是自适应差分，固定码流会让解码器状态跳）；裁静音加
滞回（300 进 / 600 出）+ 3ms 淡入；速率每帧最多变 0.03；150ms 内有新数据不补零
收尾；HARD_CAP_SEC 补回 30s 纯兜底。DEEPVOICE_PARITY 对照开关保持 false。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
3e05be48d6
|
client: 通话翻译下行追赶参数收紧（两端同改）：1s 起变速、2.5s 达 1.3x、0.5s 起裁静音
四轮压测 + 同一到达轨迹回放对比：>3s 积压累计时长减半、中位降 25%，零丢帧零错误。
峰值由云端单次响应长度决定，参数再收也不降，下一步只能从切句（turn_detection）下手。
CLAUDE.md 记录取舍与数据。
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
28a6089ded
|
client: 版本号 1.0.1+16 → 1.0.2+19；Xcode 自动改写的工程文件
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
c1dcfcfc60
|
client: 车载香薰 Dart 侧整体改名 Smartcar → EaiCar
目录、类名、文案键、路由、测试全部改成 EaiCar。刻意保留：原生插件 device_smartcar、
持久化厂商键 'smartcar'、模块 id 'smartcarChat'、GetStorage 两个键（改了会丢老装机的编排/白名单）。
广播名准入白名单本来就只认 EaiCar，旧名 Smartcar 在测试里仍作为被拒绝的样本保留。
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
d85f0fbaed
|
client(ios),docs: 译文积压追赶同步到 iOS 下行发送器；CLAUDE.md 记录 9-22 三条结论
- CallTranslationDownlink.swift 改成与 Android 同一套：积压 >1s 裁静音、>2s 起 WSOLA 变速不变调
（4s 达 1.3x），不丢内容；stats() 多了 backlog/rate/trimmed 三组键，原有键保留。
只动这一个文件，公开接口（start/stop/stats/resetPeaks/setIntervalMs/pushPcm）不变；
已用 iphonesimulator SDK typecheck，未上真机。
- CLAUDE.md：Android SPP 控制命令会被协议栈合帧、AST 就绪状态同页第二场必聋、译文积压追赶。
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
d1db3e5951
|
client(android): 通话翻译三处修复——同页第二场聋、call.stop 偶发丢失、译文积压追赶
全部在 Android 原生（azure_speech / bluetooth_manager 的 Kotlin），iOS 一行未动。
2026-09-22 ALN-AL80 + Echo-one 真机，配合协议栈 RFCOMM 日志逐条定位与复验。
同页第二次开始没反应（azure_speech）
- AST 就绪状态记在插件上（astSessionReady，与 iOS 同义），建桥与重新 enable 时都继承；
BesCallPcmBridge.disable() 不再把 ready 打回 false。
- 原因：markReady 只在 initialize 末尾发一次，同页面再开始只走 startContinuousTranslation，
disable() 清掉的 ready 再也没人置真，上行帧全扣在环形缓冲里。实测进页面第一场好、
之后每场 ready:false / downlinkFrames:0，退出重进又好一场。
结束指令偶发没到耳机（bluetooth_manager）
- 控制命令走单线程队列：距上一条命令 ≥30ms、距上一个实时音频包 ≥500ms 才写；
下行音频改走 writeRealtime 直发。
- 原因：BluetoothSocket 写入经本地管道，协议栈按信用一次把管道里攒着的字节合成一帧
（PORT_WriteData p_len=4 / 172 / 256），耳机一帧只解开头一条命令。8 次收尾丢 3 次，
耳机不回 BB D2、继续推音频，下一次 call.start 应答 BB D1 07 01（已在通话模式）。
修后 8 轮 0 丢，边播译文边点结束也在 0.5s 内收到 D2。
译文积压越说越慢（bluetooth_manager CallTranslationDownlink 重写）
- 积压 >1s 裁掉超过 150ms 的静音；>2s 起 WSOLA 变速不变调，4s 达 1.3x；不丢内容
（兜底丢弃常量默认关）。新增 getCallDownlinkStats 与收尾总账日志。
- 原因：译文音频突发产出、只能 1 倍速播，说话人不停顿时源时长≈原话时长，队列只涨不缩，
实测 A 路积压 6.2s。修后同量压测最大 3.2s，绝大部分时间 <1.5s，光裁静音就省了 10%，
变速最高只用到 1.11x。
其它
- translation_controller 收尾那几行日志提到 warn（release 包能看到 call.stop 有没有发）。
Co-Authored-By: Claude Fable 5.1 <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
|
8baa082d9e
|
client: 构建号递增；Xcode 自动改写的工程文件
pubspec 1.0.1+14 → +15，iOS CURRENT_PROJECT_VERSION 12 → 14。
project.pbxproj 其余改动是 Xcode 打开工程时自行改写的（objectVersion 54→60、
SPM 本地包引用的注释路径、Pods 脚本阶段补空的 inputPaths/outputPaths），
不影响构建配置。
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
|
7aef22905b
|
client: 语音翻译的语言弹窗两侧给同一张表，用过的置顶
此前左右两侧会把对侧已选的那项从列表里删掉（excludeLanguage），看起来像那个
语言没了。语音翻译（同传/面对面/音视频）不再传这个参数，选中对侧语言时由
controller 对调来避免源=目标。文本/图片翻译仍走排除——它们的源语言有「自动
检测」，对调会把这个非法值挪进目标语言。
- 对调实现体拆出 _swapLanguagesInner，不包 _runLanguageSwitch：撞上对侧时是
在已经排队进来的那次切换里调它，再包一层会等自己前面那条链，死锁。
- RecentLanguages（GetStorage）记最近选过的语言并置顶，源/目标各一份列表。
「自动检测」不是语言，不记。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
b61c4c91d7
|
client: 修助手闹钟的「同一条两张卡」与「日期落在昨天」
两处都是真机实测踩到的（2026-09-19）：
- 拾忆页重复卡片：双写迁移期同一条闹钟本地与服务端各有一份，投影层只信本地
的 synced 标志，而那只是服务端事实的影子拷贝——上传成功后进程被杀、重装、
清缓存都会把它打回 unsynced，于是凭空多一条（一张能编辑、点另一张说没同步
到服务器）。改用服务端自己带的答案：client_key / source_id 存的就是指令 id，
对上了就不再投影（pendingLocalReminders，两个键都认，历史数据里有只写一个的）。
顺带补上 _uploadReminder 成功后的 reminders.refresh()——改的是 RxList 元素
内部字段，不通知没人知道，syncPending() 那条补传路径本来就 refresh 了。
- 闹钟定到过去：模型下发的 date 偶尔早一天（会话 Start 没告诉百炼今天几号），
客户端原样信了，闹钟落到昨天那一页、而且永远不会响。rollForwardPastDate 把
过去的一次性闹钟挪到就近的未来。只管一次性的——重复闹钟的 date 是锚点，落在
过去是正常的，挪了会把第一次触发推迟一周。治本要在百炼控制台注入当前时间。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
90fe2d6c2a
|
services: 阿里机器翻译的错误解析兼容数字 Code，未开通时给出可操作的提示
排查客户端「翻译失败」时发现两处会把真实原因吞掉：
- Code / WordCount 两个字段阿里有时回字符串、有时回数字，struct 里写死 string
会让整个响应 json.Unmarshal 失败，错误变成「解析失败」，真正的服务端返回码
一个字都看不到。改用 flexStr，两种 JSON 形状都吃。
- code 10009 / "is not activated" 说的是机器翻译产品没开通或 RAM 子账号没授权
（实测：子用户 200212789836990119 缺 AliyunAlimtFullAccess）。这属于账号侧
配置，不是代码问题，所以单独给一条指名道姓的错误，别让它混在通用失败里。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
76aa2032bf
|
services: 梳理并修「账号 ↔ 实名记录」的绑定口径
useridverify 明细是权威，user.idverified/idverifiedtime 只是后台筛选用的派生
缓存，两边是两次独立写，此前会各自漂移。纯逻辑收进 idverify_binding.go：
- reconcileUserFlags：home 启动时双向校正派生标识，幂等。
- applyIdVerifyAttempt：已实名账号「修改认证」失败时，明细上的身份字段一律
不动。原实现先无条件覆盖姓名/掩码/指纹再看结果，一次填错就把账号上的实名
身份换成了没核验通过的人，verifytime 却还停在通过状态；再提交回原来那个人
又被当成换人重新计费。
- scrubCancelledUserIdVerify：注销同时清 idverified/idverifiedtime/gender。
原先只删明细行，账号在后台仍显示「已实名」、详情里却没有姓名证件。
- 换人/注销留痕到 useridverify_log，只存掩码+指纹，不存姓名（注销要清 PII）；
留痕失败只告警不阻断注销。
- alignCollation：user 表是 utf8mb4_general_ci（老库导入），gorm 新建的表是
utf8mb4_0900_ai_ci，联查直接报 1267。启动时把实名两张表 CONVERT 对齐。
CLAUDE.md 补这一节，含两条未修、属产品决策的边界（实名跟 uid 走、按应用库隔离）。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
f9b9c8c72d
|
client: 翻译默认归档进语音纪要；列表改本地优先；登录按包收敛；EMAI 走 A2DP
## 通话/同声/面对面翻译 → 语音纪要
三种翻译模式默认边翻边录，结束时把音频**连同已有转写**一起归档
（rtype=VOICETRANSLAT），服务端跳过识别、直接用智能模板（General-Autopilot）总结，
在会议纪要里就能看到。转写段的构造见 translation_export.dart（纯函数，带金测试）：
- 时间是**相对录音起点的毫秒**并扣掉暂停区间——面对面是逐句按住说话、松开就暂停的，
不扣的话越往后偏得越多；写成绝对时间戳会让点一句跳到音频末尾之外；
- 说话人用 Speaker_0/Speaker_1，与服务端转写同一口径（转写页直接把这个字段当文案显示，
裸 0/1 会和别的纪要长得不一样，喂给 LLM 抽待办时也会混出 Speaker2 这种负责人）；
- AST socket 断开后 _terminateCallOnError 会取消事件订阅，重开时收不到任何转写
（真机上表现为「有日志但转写 0 段」），改成重新订阅。
## 语音纪要列表：服务端是真源、本地 sqlite 是缓存
列表接口改回骨架字段后（服务端同批），客户端改成本地优先渲染 + 后台对齐：
- Synchrodata 重写：拉骨架 → upsert → 删掉「本地有服务端没有」的记录（连本地音频、
上传队列、轮询任务一起清）。**业务错误时 data 是 null 不是空列表**，判空错了
会把本地整个清空；
- 详情进页面时才拉整条；离线操作队列那套上行是死代码（服务端接口整个注释掉了），删除。
## 登录按包收敛
苹果包只留苹果+游客、安卓包只留微信+游客、谷歌包只留邮箱+游客。
判定抽成 resolveLoginMethods 纯函数（login_methods.dart + 8 条测试），
邮箱包还要锁死国家区号选择。
## EMAI 与其它
- 手机侧触发的对话走 A2DP 而不是语音处理通道：iOS 上 A2DP 输出与 voiceChat 模式
互斥，开了后者蓝牙耳机会当场切到手机扬声器。按当前实际输出路由决定要不要开
voiceProcessing/回声消除；
- EMAI「开始对话」闪退：探测输入格式时 new 了一个一次性 AVAudioEngine 去读 inputNode，
配置变更时崩在 AVAudioIONodeImpl（EXC_BAD_ACCESS）。改成直接问 AVAudioSession；
- 语音纪要文件名可改：每行右侧加铅笔图标，复用已有的重命名弹窗（原来只有长按菜单，
实际入口已不可达）；
- 拾忆上报 IANA 时区名：DateTime.now().timeZoneName 给的是「CST」这种缩写，
服务端 LoadLocation 解析不了、静默退回容器时区，海外用户的提醒时刻会全按北京时间算。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
811a008545
|
services: 语音纪要→拾忆→MCP 链路审计落地；修两个「什么都没发生」的既有 bug
审计与落地计划见 docs/语音纪要-拾忆-MCP链路审计与落地计划.md，已在阿龙测试环境
逐条验收通过（记录见该文档 §5.1）。
## 安全
echomeet 八个按 id 操作的接口**一处都没有比对 record.Uid 与会话 uid**，任何登录用户
改一个 id 就能读别人纪要全文、删改别人的记录、给别人的记录发起总结（扣自己算力，
但覆盖对方 summary 并触发对方的拾忆抽取）。统一改走带 uid 的查询：
- 「不存在」与「不是你的」回同一个错误码同一句话——分开回等于给出一个探测他人 id
的接口；用的还是改动前记录真不存在时的 DBError，合法用户行为无任何变化；
- 批量接口按交集处理、**不报错**：客户端轮询队列里本就可能留着已被别的设备删掉的 id，
报错会把整个轮询循环掀掉；delrecords 响应回实际删掉的那批；
- starttask 的校验排在扣算力之前，否则拒绝了还先把钱扣了；
- 回调接口是第三方来的、没有 session，不在此列。
- TestApisUseUidScopedQueries 扫源码守着：最容易复发的不是有人改回去，
而是新加接口时照旧写法抄一遍，那样既不报错也看不出来。
## gorm 的 default: 标签吞零值
mysql.Insert = db.Table().Create(model)，gorm 对带 default: 的字段**一律把零值换成
默认值**。DBMemoryItem 的 date_certain(default:true) / remind_ahead(default:5) 因此
永远写不进 false/0：测试库 25 条记录全部落成 1/5，「待定日期」分组恒为空，
会议待办还会在 08:55 响提醒——与「会议待办默认不提醒」正好相反。
⚠️ 加 Select("*") **救不了**：替换在 ConvertToCreateValues 的 reflect.Struct 分支里
无条件做，只看值是不是零值，与 Select/Omit 无关（DryRun 实测两种写法生成的 VALUES
一模一样）。改成插入后把这两列按结构体现值补写回去，并把真值还给调用方——
gorm 连结构体上的字段一起改了，不还原的话 memory_add 回给客户端的也是错的。
存量由 migrate_defaults.go 幂等修正（只碰 source=meeting 且 user_edited=0）。
## 内容门槛
6 秒的测试通话、20 秒的单人自述照样被抽成「继续进行进一步的功能测试」这类废话待办，
再靠条数凑够周报阈值又触发一次 LLM 调用。门槛卡**转写正文**不卡纪要——内容太薄时
模型按模板兜底规则照样能写出六百多字。只拦抽取与 MCP 检索，**纪要照出**：
短语音备忘是合法用法，也不判成 SummarizFail（客户端把那个码显示成「请稍后重试」，
用户会一直点）。数据缺失时按通过处理，不因上游漏传一个字段就静默关掉抽取。
## 其余
- 报告补偿：原先的 requeueIfStale 由 memory_getreport 驱动，而客户端调无参版本 →
走 latestUnconfirmedReport，那条 SQL 只查 state=Done，pending/processing/failed
永远查不出来也就永远补不了。新增 ensureRecent 挂在 memory_today：漏建的补建
（过与 cron 同一道条数闸门）、卡住的复用 requeueIfStale、失败的至多重试 3 次
（计数寄在 error_msg 的 retry=N; 前缀，fail() 必须保住它，否则上限形同虚设）。
加 enqueueOnce 判重与按报告 id 的 SETNX 生成锁，cron 与 ensure 撞上只跑一次 LLM。
- 说话人标签：finishSyncTranscribe 拼的是「Speaker 0」（空格）、其余是「Speaker_0」，
抽出来的负责人就成了 Speaker2、[Speaker_0] 各种样。四条写入路径统一走 normalizeSpeakers，
顺带修掉没开说话人分离时拼出「Speaker_」空尾巴。
- 时区：LoadMemoryLocation 现在认 IANA / 固定偏移 / CST（按 Asia/Shanghai 解释，
兜住已落库那批），认不出来仍退服务器本地时区但**打 warn**——原来是全静默的。
- 删纪要连带删自动待办（只删 user_edited=0），查询带 uid：入参来自删除请求，
光信 source_id 等于把归属校验的成果又丢一次。
- 回调幂等：两个回调既不看状态也不抢锁，与轮询撞车就各翻译一遍、各入队一次。
失败分支同样要过闸门——一条已 Completed 的记录被迟到的失败回调打回 TranscribeFail,
用户看到的就是「纪要好端端地变成了转写失败」。挡下来仍回 SUCCESS，不让第三方重投。
SubmitAITask 保持不判重（用户点的「重新生成」悄悄跳过等于按钮失灵），
自动路径改走 submitAITaskOnce。
- 重复项统计：只展开闹钟。花销展开等于虚构金额，待办的 done/undone 按次拆不开。
## 顺带修的两个既有 bug（部署验收时挖出来的）
happen_date / period_start 都是 type:date 列 + DSN parseTime=True，读进 Go 的 string
是「2026-09-07T00:00:00+08:00」。SQL 比较靠 MySQL 转换还是对的，所以这个问题
**在任何日志任何报错里都看不见**，只在 Go 侧解析它的地方发作：
1. remind.go 的 expandItem 解析不了 → **memory_upcoming 恒返回 0 个提醒时刻，
整个拾忆提醒在服务端一直空转**（真机实测：建一条每天 08:00 的闹钟，slots 为 []）；
2. 下发给客户端的 happen_date 一直是 RFC3339 而非协议约定的 YYYY-MM-DD，
客户端 _localToday() 的字符串相等比较恒不匹配、_mergeRange 在区间端点会重复。
这也是审计里「会议待办会在 08:55 响通知」只能是推演的原因：实际一条都不会响，
两个 bug 互相遮蔽。修法两层：ParseMemoryDate 容忍带时间的形式（安全网），
读路径出口统一归一（管对外格式），缺任一层都会留坑。
## 列表骨架化（同批）
echomeet_getallrecords 只回列表要用的骨架字段，original/translate/summary 占每条
97% 的字节（实测 59 条 ≈ 500KB，列表用得上的 15KB）。
⚠️ 骨架记录**绝不能写回库**：mysql.Save 是整行 UPDATE，三列会被清空。
StartTask 允许对已完成/已阅/失败的记录「重新转写」，那期间 state=Transcribing 而旧
纪要还在库里，用户切一下列表页旧转写和旧总结就没了。轮询前重新取整条再操作，
TestListEndpointNeverSavesBriefRecord 守着不许回退。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
5193b0e5e8
|
admin,console: 「会议模板」改成「会议配置」，一页管转写/总结/模板
后台恢复了会议转写段与总结段的配置入口——它们随「会议记录服务」页一起下线后，
只能直接改库（echomeet_orch），而那正是语音纪要整条流水线的服务选型来源。
- 路由 /meettemplates → /meetconfig，旧地址留重定向；**菜单 id 不变**：
存量后台账号的 access 清单里存的是这个串，改 id 等于让这些账号丢入口；
- 一页全展开不分标签页，顶部一个应用选择器三块共用——各拉各的会出现
「转写配的是 A、模板改的是 B」这种对不上的状态；
- 保存是声明式的，asr/llm 都是**指针**：缺哪个不动哪段。写成值类型的话
「保存会议总结」会带一个空的 asr 数组把转写编排整段清空；
- 翻译段(kind=2) 本页不编辑但保存时必须原样保留，跟着 reconcile 会让纪要
能转写、译文整体消失；
- 服务池查询是 app_name=? 不带 OR app_name=''：作用域归一后没有全局默认层了，
照旧版写回退查询会让一个应用读到另一个应用的服务选型，且不报任何错。
段→服务类别的映射由 TestEchoKindSvcCats 钉住：类别编号是 comm / console / admin
三处同写的，漏改一处的表现是某一段的下拉空空如也且不报错。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
3 weeks ago |
|
Rodger-Wang
|
4d97c99528
|
services: 通话录音按左右声道分轨转写，说话人直接按音轨给
客户端录的通话音频是双声道 WAV（左=本端麦克风、右=对端），而 DashScope 录音文件识别
不传 channel_id 时只转第 0 轨 —— 语音纪要里只有机主自己说的话，对方一句都没有。
- 提交前先探一次 WAV 头（probeWavChannels），确认是多声道才传 channel_id=[0,1]：
每多一轨按一份音频计费，单声道文件不该白花钱；
- 多轨结果每轨一份 transcript，说话人直接按音轨定（0=本端 1=对端），
比让服务商去分离 speaker_id 可靠得多，再按时间轴合并成一条转写。
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
|
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
|
263c72ad31
|
services: 机器翻译只在服务端接得上的 provider 里挑，别随手挑中没接的那家
线上表现：文本翻译 / 同传 / 面对面全部报「未配置机器翻译服务」，
而后台 EAIMAR 下 mt_alibaba / mt_azure / mt_volcano 三家都启用着、凭据也都填了。
根因：resolveTranslator 挑选时没有任何优先级，谁先从 postgres 返回就用谁，
这次挑中了 mt_volcano，而服务端只实现了阿里一家，于是落进「provider 不是
alibaba 就返回 nil」的分支。错误信息指向「没配置」，会把人引去后台反复检查
明明填好的凭据；而且它取决于数据库返回顺序，可能自己好、也可能自己坏。
- 新增 mtProviderPriority 白名单：只在真正接了的 provider 里挑，并给出稳定优先级。
- 挑选抽成纯函数 pickMTSvc（可脱离 postgres 测），被跳过的未接入服务打一条点名 warn。
- 缓存命中不再硬编码返回 "alibaba"，改为记住实际 provider。
- model_translate_test.go 5 个用例：未接入的要跳过、全不可用返回 nil、
停用/非 MT 类别不参与、应用行优先、provider 大小写归一。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
4 weeks ago |
|
Rodger-Wang
|
461289b780
|
services,admin: 后台赠送只发 VIP 天数与算力；console 读系数走应用连接
- giftUserResource 入参改为 vipday + compute，后台不再按功能分桶发放分钟数
（那是 2026-09 停用的旧三桶模型）；trademin/meetmin 保留为入参兼容，
老 admin 容器与历史脚本送上来的分钟数按当前系数折成算力，进同一个 addcompute。
代理余额只有 balance_vipday/trademin/meetmin 三列、没有算力列，这条路的边界在注释里写明。
- console 读换算系数改用按 X-App-Id 取出的连接（computeRatesOf）。
⚠️ console 是单例服务，InitSys 从不 mysql.OnInit，包级 comm.LoadComputeRates()
一调就 nil interface method call panic，被 gin.Recovery 兜成 HTTP 500，
前端只看得到状态码、拿不到任何业务错误；何况系数本来就按应用存在各自业务库。
新增 pkgdb_boundary_test.go 守这条边界。
- 后台上传 OTA 更新包放开 .upd 扩展名。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
4 weeks ago |
|
Rodger-Wang
|
e00b617025
|
services,admin,client: 服务配置按应用隔离、应用参数下线、客户端凭据走加密 v3
后台
- 服务配置去掉「全局默认」层，svc_config / svc_region_override / echomeet_orch
/ echomeet_orch_setting / echomeet_template 五张表统一按 app_name 隔离，
启动迁移 migrate_scope.go 幂等分配（首个应用原地改名保 id，其余拷贝）；
写接口 app_name 必填（scope_check.go）。
- 类别落库 svc_category，可增删改；内置 11 个 id 不可改不可删，运行时语义仍只挂 comm.SvcCat*。
- 「应用参数」标签页下线：业务库 config 表不再随 user_getappconfig 下发，
migrate_appparams.go 把 AGENT_TYPE / MOBILE_ELF_* 迁到服务 llm_mobile_elf、
iapCustomerServiceQQ 迁到 app_params，COMPUTE_*/NEWUSER_GIFT_* 留在 config 表不下发，
无人读的音乐/公码/导航/COS_*/MeetServers 删除，其余键保留并在启动日志告警。
- 删除 console appcfg/* 与 api 模块的 get/add/update/delconfig、唤醒音四个接口（无调用方）。
- 修 getmcpservers 仍查全局层导致 MCP 类服务永远读不到。
客户端
- 凭据改走结构化通道：user_getappconfig_v3 整体 AES-CBC 加密（api_crypto.dart，
拦截器须排在 AuthInterceptor 之前），AppConfig.cred(svcId, field, envKey) 取值，
老键名只作兜底；lib 内 AppConfig.env( 已降到 0 处调用。
- 图片翻译的 ALIBABA_VL_MODEL / ENDPOINT 改挂 ast_alibaba。
启动日志
- 删除 sys/auth/firebase（google_auth 的重复实现，零调用方，且同一错误刷两行）。
- api 模块不再每次启动无条件插入默认超管（Duplicate entry 'admin'）。
- sys/auth/* 五个包的 logger 名从复制来的 sys.tavily 各改各名；
google_auth 启动时即判断配置是否可用。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
4 weeks ago |
|
Rodger-Wang
|
268ce26bc9
|
services,admin: 凭据归一到 svc_config；后台服务配置菜单收敛；品牌商与公码下架
这一提交里有两条相对独立的线，落在同一批文件上（server.go / core.go / model.go /
CLAUDE.md 等被两边同时改到），按文件拆不开，故合并提交。
── 一、第三方凭据归一到 svc_config，后台「服务配置」从 11 项收敛到 6 项 ──
起因：凭据同时躺在两张扁平 key/value 表里——应用业务库的 config 与 console 库的
global_config，而合并下发时**全局那张赢**。同一个 AZURE_SPEECH_REGION /
OPENAI_API_KEY / VOLC_OPENSPEECH_APP_ID / XUNFEI 密钥在两边值不一样，运营在
「应用环境配置」里改半天没有任何效果，且不报错。global_config 还按区域整份复制
（14 区 × 31 键 = 473 行），实测其中 27 个键是各区同值。
- comm.SvcField 新增 EnvKey（后台字段表里的「下发键名」列）：非空时该字段的明文值
同时以这个名字出现在 user_getappconfig 的 env 里。已发布的客户端只读 env，
靠它继续供货、无需发新包；新客户端直接读结构化的 thirdsvcs。
- env 覆盖层与 thirdsvcs 走同一份 VIP 过滤，否则 VIP 过期的用户虽拿不到 AST 条目，
却仍能从 env 里读出同一套通话翻译凭据，那道闸门就形同虚设。
- 同作用域内 env_key 不允许重名（checkSvcEnvKeys 在保存时拦）：重名时下发结果取决于
服务 id 排序，表现为「凭据时对时不对」。
- 一次性迁移 migrate_envtosvc.go（console 每次启动跑、幂等）：基础值取中国区现值，
只有与基础值不同的区域才写 svc_region_override，473 行收敛到几十行。
顺带修了两行填错列的历史数据（group 里是键名、key 里是值），正是它让
ALIBABA_BAILIAN_APP_ID/WORKSPACE_ID 恒为 null、客户端一直用代码里写死的兜底值。
不删 global_config 的行（不可逆的线上凭据，留作回退依据），确认跑稳后由人手工 DROP。
- 后台：「第三方服务配置」改名「服务与环境配置」，「应用环境配置」并为其第二个标签页；
「全局环境配置」下线只留重定向；Agent 配置、通话翻译配置、会议记录服务三页删除
（前两者对应的 agent_config、call_translate_rule 两表在测试机与正式机上都是 0 行）。
⚠️ 会议记录服务删的只是后台入口，echomeet_orch 的数据与运行时都还在（两台机各 4 行，
是语音纪要识别/翻译/总结的服务选型来源），要换服务商现在只能直接改库。
阿龙测试环境实测：迁移前后 env 逐键比对，48/54 键值完全一致，丢失的 8 个全部是预期
丢弃（ALIBABA_OSS_* 与 COMMENT_* 无人读取、两个填错列的垃圾键名），无一个值发生变化。
验证中发现并修掉四个都不报错的坑：空值不能下发成 env 键（Dart 的 ?? 只兜 null，
空串会把默认值顶掉）、区域覆盖里的空串会把基础值抹成空、服务 enable=false 等于凭据
一个都不下发、启动时的模板补字段会给实例加空的加密字段导致误报「缺凭据」且保存被拒。
── 二、品牌商(identity=3)与公码下架 ──
brand 表、公码 authcode 及其全部后台页面与接口移除；账号作用域不再有 brandId，
设备/结算的归属改由渠道商推导。这部分不是本次会话中由 Claude 编写的。
验证：go build ./... + go vet ./... 通过，comm/console/user/echomeet/api 各包测试全绿；
admin npm run build 通过。
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
|
223f7d0a44
|
deploy: 移除本机连不上的 6 台服务器，顺带清掉测试里写死的下线机器凭据
云雁(yunyan)/灵谱(lingpu) 的部署目标从所有脚本移除，ENVS / PROD_ENVS / REGIONS
现在都只剩 along。那 6 台（云雁测试/上海/日本/新加坡、灵谱测试/正式）的 SSH 私钥路径
指向的是另一台开发机，本机一台都登不上（22 端口通、无可用密钥），留在交互菜单里只会误选。
- 删 deploy/{console,admin,app}/dev-deploy.sh 的 lingpu、yunyan 两段 env_profile
- 删 deploy/{console,admin}/prod-deploy.sh 的 yunyan、lingpu 两段
- 删 deploy/app/prod-deploy.sh 的 shanghai/japan/singapore 三段 region_profile
- 删 deploy/admin/deploy.sh：早期脚本，只指向灵谱且生产位留空，已被
dev-deploy/prod-deploy 取代（CLAUDE.md 里"要同步两份 deploy.sh"也是错的，
console 那份早就不存在）
- IP 与私钥路径不再记在文档里，需要时从 git 历史取回
镜像仓库刻意保留：registry.voitrans.net / registry.lingpu.net 都在，prod-build.sh
仍可选 yunyan|lingpu 推镜像（三家仓库本机都能读写，协作者仍从他那台机部署这两家）。
顺带修掉三处把已下线机器地址连明文数据库密码一起写死的测试：
- sys/nats/nats_test.go 有个真 bug——`url := "nats://<写死地址>"` 紧接着 `if url == ""`，
常量永远不为空，所谓"默认跳过"从来没生效：每次 go test 都在连那台早已废弃的机器，
白等 4.5 秒超时。现在真正读 NATS_URL 了。
- modules/{api,echomeet}/model_test.go 的 DSN 改走 API_TEST_DSN / ECHOMEET_TEST_DSN
另外给 app/prod-deploy.sh 加了一条明确报错：输入已移除的区域名（如 shanghai）原本会被
is_tag_like 当成版本号，报出"版本指定了两次"这种驴唇不对马嘴的错。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
4 weeks ago |
|
Rodger-Wang
|
c95996c251
|
修 iOS 上切到同传/面对面时字幕小窗关不掉、且中断 changeTranslationMode
_floatingWindowManager 是 late 且只在 onInit 的 `Platform.isAndroid` 分支里赋值
（iOS 走 initPlatformState 那套 SubtitlePip）。全项目 5 处引用里 4 处都带平台守卫，
**只有 _disableFloatingWindow() 那处没有** —— 而它恰恰会被 changeTranslationMode 调到
（从多媒体/通话翻译切到同传或面对面时，小窗不受支持要自动关掉）。
iOS 上后果是连锁的，且没有一条指向真因：LateInitializationError 从
changeTranslationMode 中途抛出，后面的 _reinitializeAsrService() 再也走不到；
小窗又没真的停掉，继续浮在同传/面对面页上盖住顶部的标题与按钮；偏偏小窗开关按钮
只在 call/audioVideo 两个模式才渲染，用户连关都关不掉。
- _disableFloatingWindow() 分平台，并收敛成 toggle / onClose / changeTranslationMode
三处共用的唯一出口；Android 分支补 Get.isRegistered 守卫。
- 切到不支持小窗的模式时改成**无条件**关一次，不再依赖 isFloatingWindowEnabled：
iOS 上这个标志位由 initPlatformState 里那次异步的 SubtitlePip.isActive() 回填，
和 onInit 紧接着调用的 changeTranslationMode 是竞态，回填晚一步就整个跳过。
没开着时多关一次是无害的。
真机验证（iPhone 12 / iOS 26.6.2）：改前在运行中的 App 里直接取 _floatingWindowManager
确实抛 LateInitializationError；改后走完整路径（多媒体翻译 → 开小窗 → 切同传），
changeTranslationMode 正常返回、pip=false、widget 树里 ErrorWidget 数为 0。
安卓侧（华为 ALN-AL80，debug + release）同传/面对面两页渲染不受影响。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
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
|
bb483ec008
|
落地文档补上线后体检：修好统计主键与 MCP 反代，记下一次凭据搬迁的试错
修复三项：stats_global_day 主键重建（统计快照原本会全部写入失败）、
mcp.ymaikj.com 的证书与反代（SSE 需关缓冲）、手签证书的续期 crontab。
记下一次已回滚的试错：照着「测试有值/正式为空」搬短信与微信凭据是错的，
两边是不同服务商不同账号（测试走阿里云、正式配的腾讯云），混搭后
实测报 SmsSdkAppIdVerifyFail。已恢复原状。教训：凭据搬迁前要先核对
非机密的配套字段（Provider/AppId/模板/签名）是否同一账号体系。
另记七项待决策发现，含 NPM 管理端口公网开放、两机 MySQL 大版本差异
（8.0.27 vs 26.7.0）、nats healthcheck 命令写错导致恒 unhealthy。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
4 weeks ago |
|
Rodger-Wang
|
4c7902778f
|
落地文档补执行记录：0.2.0 已上线阿龙正式服
记下与计划的三处出入，其中一条对下次新环境上线有用：
config 表要在 app 首次启动之前导入——app 启动会写
COMPUTE_LEGACY_MIGRATED 标记并占掉自增 id=1，之后再导就撞主键。
剩余两件需人工：stats_global_day 主键重建（DDL 被本次会话权限策略挡住）、
mcp.ymaikj.com 的 NPM 反代与证书。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
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>
|
4 weeks ago |
|
Rodger-Wang
|
37817f2e96
|
会员与算力：VIP 管准入、算力管计量；补上线落地文档
VIP 与算力两层权益各管一件事，判定与记账统一走 comm/compute.go：
- VIP 管功能准入（无 VIP 时 user_translate / echomeet_starttask 返回 VipRequired）；
自购记 user.vipexptime，设备赋予记在 device_mac 行上（激活日 + 天数），
两者在 ResolveUserVip 合并成有效值下发，库里仍只记自购——以前绑定礼把天数
累加进用户表，解绑时拆不开。
- 算力管用量计量，按后台系数折算，先扣设备赠送再扣用户余额。
三个旧额度桶停用，存量余额由 home 启动时一次性折进 computebalance。
- 闸门 COMPUTE_GATE 默认关：user_usages 是用完才上报、没有预扣，
现在开闸门形同虚设。
另含本次「阿龙测试服 → 正式服」上线落地文档（docs/），
以及 admin 侧商品/设备/产品/用户页的配套改动。
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
|
83aaccb2bc
|
AI 页「语音记录助手」改名「语音纪要」
副标题同步改成「语音文件汇总总结，记忆中心」，用全角逗号，与同组其它条目
（agentEmaiDesc 等）的写法一致。
顺带改了 recordingSavedDesc——它写的是「已存入语音记录助手」，不跟着改的话
页面叫「语音纪要」、保存提示还是旧名字，对不上。
11 个有 agentMeeting 的语言都给了对应翻译，不是只改中文。
⚠️ 另外 30 个语言文件根本没有这个 key（既有问题，非本次引入）。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
714a05b6d4
|
修 iOS EMAI 没有语音播报、连续对话上行断供；接入 MCP 令牌
iOS 上助手一直不出声，和这次改连续对话无关，是播报本来就坏的。三轮真机对照
实测：just_audio 喂的是「长度未知的直播 WAV 流」，AVPlayer 只发一次
`Range: bytes=0-1` 的嗅探请求就判定资源不可播，回 -11850 且 processingState
直接落 idle，一次都没真正起播。声明长度、支持 range、把收到的字节全缓存下来
允许重放，三种都试过，结论一样。ExoPlayer 不发这个嗅探请求，所以安卓一直是
好的——这就是「安卓有声、苹果没声」的全部原因。
iOS 改走原生 AVAudioEngine 排队播 PCM（PcmSpeakerPlayer），安卓不动。
验证方式：一次性灌 3 秒音频，7ms 喂完但 3708ms 才播完，证明是实时渲染不是丢弃。
连续对话的上行也是断的，服务端一直回 ClientAudioTimeout。两个原因：
- _ensureContinuousMic 被 Started 事件和 _enterContinuous 并发调用，两边都在
`_micRunning` 置位前通过守卫，同一个 recorder 被 startStream 两遍，第二次把
第一次那条流顶掉。控制器侧改成同步置位，MicPcmStreamer 内部再加一层 in-flight 去重。
- 开麦前没配好并激活音频会话。会话停在 soloAmbient 且未激活时，startStream
会**成功返回**、引擎也起得来，但输入 tap 一个 buffer 都不回调，客户端毫无报错。
麦克风和播放器统一到 EmaiAudioSession 一份会话配置：各配各的会在连续对话下
互相覆盖。iOS 固定 voiceChat——record 的 echoCancel 会打开 voice-processing 并
把 mode 改成 voiceChat 持有着，播放这边写回 default 就是两边互相掀桌子。
androidAudioAttributes 仍是 media，别改成 voiceCommunication（华为会静音）。
连续对话交互按要求改：进页面只建会话不开麦，短按开始、再按结束、可反复，
退出即停，10 秒无对话往来自动结束。计时依据必须是对话事件不是音频包——
麦克风没人说话也在稳定出包，拿它续命这个超时永远不会触发。
另修 _enterContinuous 在 reconnect() 一返回就判 `!= ready`：ready 要等服务端回
Started（一次网络往返），几乎每次都命中，于是刚打开的连续对话被当场关掉，
而 Started 稍后到达又会把麦开起来，留下一个界面上看不见的常开麦克风。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
48e31cf605
|
MCP 加会议纪要检索工具；用户类工具改用专用短时令牌鉴权
EMAI 助手此前答不了「我上次开会讲了什么」——纪要在服务端，助手拿不到。
补 search_meeting_notes 工具，配套解决身份怎么传。
身份链路（关键取舍）：
百炼是第三方，MCP 请求经它转发，所以不能把网关那把能开全站的 JWT 交出去。
新增 MCP 专用令牌：user_getmcptoken 由 home 签发（uid 从网关解出的会话取，
客户端说了不算），aud=mcp、TTL 2h，用独立的 MCP_TOKEN_KEY 签。
即使泄漏，能做的也只有读这一个用户的只读数据，且两小时后失效。
⚠️ 裸 uid 参数已不再被信任：谁都能填别人的 uid。ResolveUIDWithToken 要么拿到
Authorization 里的登录态，要么拿到这张令牌，两者都没有就直接拒。
auth_mcptoken_test.go 守着这条底线（含 aud 不符、过期、换密钥三种伪造）。
⚠️ 令牌必须按工具名嵌套传：真机实测百炼**不会**把 biz_params.user_defined_params
平铺进工具参数——那次调用服务端只收到 [limit]。按 {"工具名": {"auth_token": ...}}
嵌套才生效。这个形状文档没写死，是试出来的。
检索是三级回退：全文索引(按相关度排序) → LIKE(兜单字，ngram_token_size=2 时
单字进不了索引) → 最近几条。最后一级不能省：模型常把「最近的会议纪要」整句
当关键词传，纪要正文里不会有「最近」二字，LIKE 全落空，用户看到的就是
「查不到您的会议纪要」而库里明明有。回退结果带 fallback 标记，免得模型把
「最近一次会议」当成「你问的那次会议」来答。
文件头注释里记了三个「该换向量/知识库方案」的触发条件，量大了照着判断。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
3b1c11e02b
|
echomeet 加卡死兜底扫描；转写中间态对外降级；会议纪要建 ngram 全文索引
服务端原先只有「回调」和「客户端轮询」两条推进路径，两条都没到时记录会永远
卡在 Transcribing，没有任何自愈——真机上卡了 8 分钟，直到用户杀 App 重开。
业务在服务端跑，不该由客户端在不在线决定它推不推进。
兜底做两件事（每分钟一次 cron）：
- 转写中且 60s 无人查询 → 主动 PollTranscribe；超 2h 未完成判 TranscribeFail，
否则第三方丢单的记录会被无限查下去；
- 停在待总结/总结中超 5 分钟且**不在 AI 队列里** → 重新入队。「不在队列里」
这个前提不能省，正在跑的重复入队 = 两次大模型计费且后者覆盖前者。
顺带修两处：
- getstucktranscribing 的时间条件补上 `lastquerytime IS NULL`。SQL 里 NULL 的
比较永远不为真，缺了这条，从未被查询过的记录一条都扫不到——正是最该救的那批。
- 三个拉取入口统一用 hideHalfDoneTranscribe：PollTranscribe 成功后先把 State 推到
AwaitSummarizing 落库、再异步写 Translate，于是响应里必然是「状态说转写完了、
Translate 还是空」的中间态。客户端据此 jsonDecode 会抛异常，把轮询循环整个掀掉。
只对本次真正轮询过的记录降级，否则 finishTranscribe 出错时会被永久钉住。
另加会议纪要的 ngram 全文索引（幂等、随启动自动建、失败只降级不阻断），
给 MCP 的 search_meeting_notes 用；默认解析器按空格切词，中文整段会变成一个
巨型 token 等于没索引，所以必须 WITH PARSER ngram。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
6299920145
|
点结束时自动关掉屏幕直播；拾忆页去掉手动新增的 + 号
1) 多媒体翻译点「结束」后，系统那条屏幕直播不再挂着
主 App 对「用户从系统面板发起的广播」没有任何控制权——RPBroadcastController
只管 App 内 API 起的那种。唯一能终止它的是扩展自己调
finishBroadcastWithError。所以改成让扩展感知主 App 是否还在：
- stopAll() → _teardownCallModeAudio() → stopScreenCapture() 关掉 socket
（这条链原本就有）
- 扩展侧：曾经连上过、又断开超过 3 秒连不回来 → 判定主 App 收工，结束广播。
没连上过就断开不算——那是「先开广播、还没点开始翻译」的正常情况。
宽限期不能太短，主 App 瞬断会误杀用户正在用的广播。
- 另加 1 秒心跳轮询：只靠 processSampleBuffer 里检查是不够的，视频停了或者
没有任何 App 出声时 audioApp 帧可能长时间不来，那样永远发现不了主 App
已经走了，屏幕上那条红条会一直挂着。
⚠️ finishBroadcastWithError 必须传 NSError，系统会把 localizedDescription
弹给用户，所以给的是一句正常说明而不是错误信息。
2) 拾忆页去掉右下角的 + 号
内容应当由助手/会议纪要自动落进来，手动新建不是当前需要的能力。
卡片点开编辑保留（TodoScopeList 里）——那是改助手记错的时间/内容用的，
与「手动新建」不是一回事。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
9abed0008b
|
字幕小窗：加暂停/继续、去掉快进快退、大小与透明度可调
- 暂停/继续：实现 AVPictureInPictureSampleBufferPlaybackDelegate 的
setPlaying / isPlaybackPaused。语义定成「冻结当前这条字幕」而不是
「暂停翻译」——用户在别的 App 里看视频、想把一句话定住多看两眼，这是小窗
那颗按钮唯一说得通的含义，而且完全可逆、不影响正在跑的识别与翻译。
冻结期间新文案只暂存，恢复时补上最新一条。
⚠️ setPlaying 里必须调 invalidatePlaybackState()，否则按钮图标不跟着变，
点了「暂停」它还画着暂停图标，看着像没生效。
- 快进快退：requiresLinearPlayback = true 就是这个开关（原本已设，这次补了
注释说明它的作用，免得以后被当成无关配置删掉）。
- 大小 / 透明度：翻译页新增一颗 tune 按钮，弹出设置面板，两个滑块，
GetStorage 持久化。新增 3 个 i18n key（pipSettings/pipSize/pipOpacity），
41 个语言文件全部补齐，主要语种给了本地化文案、其余回退英文。
三条平台限制已写进注释与面板说明，避免以后重复尝试：
- 小窗**实际大小由用户捏合手势决定**，App 无权直接设定。「大小」滑块改的是
画布宽高比，系统按新形状重新布局，观感上是变宽/变窄。
- 透明度**做不到透出下面的 App**。iOS 的 PiP 窗口本身不透明，系统未开放接口。
滑块只改卡片底色深浅。要少挡内容只能把小窗调小。
- 播放/暂停按钮的**尺寸不可控**，那是系统绘制的 chrome，随小窗一起缩放——
所以「按钮小一点」等价于「把小窗调小」。pip 那个 pub 包用私有 API
_setControlsStyle 去动控件，上架有被拒风险，不采用。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
56aa55773d
|
字幕小窗改成自绘：pip 包只喂了一块纯黑像素，字幕根本进不去小窗
用户反馈「悬浮弹幕上没有显示翻译内容」，根因在 pub 包 pip 0.0.4：
PipView.m: const int pixel = 0xFF000000; // BGRA 全黑
填满 pixelBuffer → enqueue 进 AVSampleBufferDisplayLayer
小窗显示的就是这一帧纯黑占位。真正的字幕卡片它是靠
insertContentViewIfNeeded 塞进 activeKeyWindow 的，而 PiP 窗口由系统进程托管、
**不在 UIApplication.connectedScenes 的窗口列表里**，那个 keyWindow 永远是
App 自己的窗口。于是字幕落在 App 身上（上一版还因此盖住整个屏幕点不动），
小窗里只可能是黑的。PipView.m 全文件 0 处引用 contentView，可以佐证。
改成自己实现：SubtitlePipController 把 PlayerView 画进 CVPixelBuffer，
逐帧喂给自己的 AVSampleBufferDisplayLayer，再用 sampleBufferDisplayLayer
这一路 content source 起 AVPictureInPictureController。小窗显示的就是它。
Dart 侧不再依赖 pip 包（import 与相关字段一并删除）。
同时回答另外两个问题：
- 大小：PiP 小窗的实际尺寸由用户捏合手势决定，App 无权直接设定。能控的是
**宽高比**（= 画布宽高比），setPipWidthScale 改的是这个，系统会按新形状
重新布局。另外卡片有内容时自动变高、没内容时收成一条，也走同一条路。
- 透明度：**做不到透过小窗看见下面的 App**。iOS 的 PiP 窗口本身不透明，
系统没有开放任何接口。setPipOpacity 只作用于卡片自己的底色（在小窗那块底
之上显得深浅不同）。真要少挡内容只能把小窗做小或拖到别处。
这一条在 Dart 与原生两侧的注释里都写明了，免得以后有人再试一遍。
几处实现要点：
- 心跳定时器每秒补一帧。只在文案变化时推帧的话，长时间没有新帧会让
AVSampleBufferDisplayLayer 被判定停滞并清空，表现是「翻译停一会儿小窗就黑」。
- start() 之前先推一帧：没有任何已入队帧时 AVPictureInPictureController
会判定内容源为空，直接回调 failed。
- 渲染上下文要做一次 y 轴翻转，否则字幕上下颠倒（UIKit 原点左上、CG 左下）。
- renderView 必须挂在真实窗口层级里且尺寸非零，脱离层级的 layer 不被 PiP 采纳。
- 时间轴返回无限区间，让系统按直播流处理，小窗上不出现进度条和快进按钮。
⚠️ 构建注意：给本地 pod 加新文件后必须重跑 pod install，否则文件不进 Pods
工程，报 "Cannot find 'SubtitlePipController' in scope"。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
a9ce8bcdef
|
广播扩展改走 127.0.0.1 环回 TCP，去掉 App Group 依赖
上一版用 App Group + Unix domain socket 传音频，结果签不出包：
- com.yimai.eaimar 的 profile 不带 App Groups capability
- com.yimai.eaimar.BroadcastExtension 没有任何 profile
而 Xcode 又登录不上账号去申请（-1200）。实测原因是网络层：
developer.apple.com 通（200），appleid.apple.com 与
developerservices2.apple.com 都连不上（000）——后两个正是登录与签发 profile
要走的域名。
改成环回 TCP 之后不需要任何 entitlement：扩展和主 App 在同一台设备上，
127.0.0.1 天然互通，而且不触发 iOS 的「本地网络」隐私弹窗（那个只针对局域网，
环回是明确豁免的）。主 App 的 entitlements 回到原样，用已有的 profile 就能签，
扩展的 profile 由自动签名就地生成。已真机安装成功。
代价：没有 App Group 就没有地方发布「主 App 这次监听在哪个端口」，只能约定
一个固定端口（52781，两边手工同步，注释里写明了）。撞端口时主 App bind 会
失败并打日志，不是静默失败。
顺带补的两个 socket 选项：
- SO_REUSEADDR：上次进程被杀后端口停留在 TIME_WAIT，不开的话几十秒内 bind
都会 EADDRINUSE，表现是「刚重启 App 就用不了」。
- TCP_NODELAY：音频要低延迟，攒包没有意义。
- 只绑 127.0.0.1 而不是 INADDR_ANY，否则这个端口对局域网可见。
另外记两个这次踩到的构建坑：
- flutter clean 会删掉 ios/Flutter/ephemeral/，其中的 swift_sdk_local 软链由
Podfile 的补丁在 pod install 时创建、**flutter 不会自己重建**，于是后续
xcodebuild 直接卡在 "Could not resolve package dependencies"。清理之后要
补跑一次 pod install。
- 跑过 --no-codesign 之后再跑签名构建，会复用 build/ 里未签名的 framework，
装机时报 objective_c.framework "invalid signature"。中间做过 no-codesign
验证的话，出正式包前要先 flutter clean。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
8377745992
|
iOS 多媒体翻译接入 ReplayKit 广播扩展，真正拿系统音频
iOS 不允许一个 App 读另一个 App 的音频，Broadcast Upload Extension 是系统
留的唯一口子。链路：
其他 App 播放 → 系统录屏广播 → BroadcastExtension(独立进程)
收 RPSampleBufferType.audioApp → 转 16k/mono/Int16
→ App Group 容器下的 Unix domain socket
→ 主 App BroadcastAudioReceiver
→ azureAsrHelper.audioStream.saveAudioDataTo() ← 已有的 external 通路
→ ASR → 翻译 → 弹幕
新增：
- ios/BroadcastExtension/{SampleHandler,BroadcastAudioSocket}.swift、Info.plist、
entitlements、Extension.xcconfig
- azure_speech 插件的 BroadcastAudioReceiver.swift + 三个 method channel
（startBroadcastAudioReceiver / stopBroadcastAudioReceiver / presentBroadcastPicker）
- Runner.entitlements 加 App Group；xcodeproj 加 BroadcastExtension target
并在 Runner 里内嵌
对上层复用已有的 requestScreenCapture/stopScreenCapture 接缝（Android 是
MediaProjection，iOS 是广播扩展），控制器里两端走同一条分支。
几处踩过的坑，都写进了注释：
- SOCK_STREAM 不保留消息边界，帧必须带 4 字节长度前缀，否则喂给 ASR 的是
错位样本。
- CMSampleBufferGetAudioBufferListWithRetainedBlockBuffer 不拷贝数据，只把
mData 指向 blockBuffer 的内存；blockBuffer 出作用域即释放，交出去就是野指针。
改成在 withExtendedLifetime 里 memcpy 出来。
- AudioBufferList 的 buffer 个数要按 interleaved 与否算，写死 1 会让非交错
立体声整帧拿不到。
- sun_path 只有 104 字节，socket 只能放在 App Group 容器根下，不能建子目录。
- 扩展侧 connect 失败要限流重试（1s），每帧重连会把扩展 CPU 打满，而它的
内存上限只有 50MB。
- SO_NOSIGPIPE：主 App 挂掉时写 socket 默认会直接杀死扩展进程。
- media 这个 ASR 模式的会话配置必须排在 audioSourceType 判断之前，且要
.mixWithOthers —— 否则我们一 setActive 就把正在播放的那个 App 掐了。
- Embed App Extensions 阶段必须插在 Thin Binary 之前。追加到最后会和
Flutter/CocoaPods 的脚本阶段构成依赖环，Xcode 报 Cycle inside Runner。
⚠️ 尚未打通签名：需要在苹果开发者后台登记 App Group group.com.yimai.eaimar、
给 com.yimai.eaimar 开 App Groups capability、并为
com.yimai.eaimar.BroadcastExtension 建 App ID。Xcode 当前还登录不上账号
（-1200）。在这之前 iOS 包签不出来。代码已用 --no-codesign 验证可编译、
appex 也正确内嵌进 PlugIns/。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
5e2b4f5431
|
修 iOS 多媒体翻译一个字都翻不出来：ASR 在等一份永远没人推的 PCM
根因是 iOS 分支还停在杰理时代的假设上。_configureAudioVideoMode 的非 Android
分支做的是 openDecoder() → 等 isCodecActive → 音频源置 external，语义是
「从耳机的 A2DP 解码器拿手机正在播放的音乐」。本项目只有恒玄耳机，没有这个
能力；而 openDecoder() 如今是个乐观桩，只把 _isCodecActive 置 true 就返回。
于是 iOS 的实际行为是：ASR 以 external 源启动，然后等一份永远不会有人推的
PCM——不报错、不提示，就是一个字都翻不出来。Android 早已整条换成
MediaProjection（isAndroidAudioVideo 分支），iOS 这条没跟着改。
iOS 平台层面也没有「抓其他 App 音频」的能力，唯一合规途径是 ReplayKit
Broadcast Upload Extension（需新建 extension target + App Group，且要用户
手动发起录屏广播）——那是产品决策，本次没做。先退化成手机麦克风外放收音，
让功能是通的：
- _configureAudioVideoMode 的 iOS 分支不再碰杰理解码器；
_audioSourceType = Platform.isAndroid（Android=external/MediaProjection，
iOS=麦克风）。
- 启动守卫里排除 iOS 音视频。那个守卫要求 isCodecActive，而它只由
openEncoder/openDecoder 这两个杰理血统的入口置位——不排除的话直接 return，
识别根本不会启动。
- iOS 音视频用新的 'media' ASR 模式，原生据此把 AVAudioSession 配成
.playAndRecord + .default + [.mixWithOthers, .defaultToSpeaker,
.allowBluetoothA2DP]：
· .mixWithOthers 是前提——不加的话我们一 setActive 就把正在播放的那个 App
掐了，点开翻译视频就哑了；
· mode 用 .default 不用 .voiceChat——后者会让 MicrophoneCapture 打开
setVoiceProcessingEnabled，而要收的恰恰是本机扬声器的声音，AEC 会把它
当回声精确消掉，结果一片安静。
iOS 侧只有两处 currentRecognitionMode 比较（phone_call / push_to_talk），
新增的 media 落到 normal 的默认分支，不影响其它模式。
- enableRecord 的音频源跟着改成 microphone。留 systemAudio 的话原生把
index>0 一律当 external，会建好文件然后等没人推的 PCM，存下来是个空录音。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
|
Rodger-Wang
|
8841e76e59
|
修 iOS 多媒体翻译开弹幕后整屏点不动
三段代码叠出来的，安卓不受影响（走的是系统悬浮窗，另一条路）：
1. pip 包（pub: pip 0.0.4）在 PiP 启动回调里，把 contentView insertSubview 进
**App 自己的 keyWindow** 并 `frame = window.frame` 铺满全屏。它的
activeKeyWindow 只按「前台活跃场景的 keyWindow」找父视图，而我们是在前台
主动 _pip.start() 的，于是必然落到 App 自己的窗口上。
2. PlayerView 是普通 UIView，isUserInteractionEnabled 默认 YES，背景还是
rgba(40,40,40,0.35)。铺满之后＝一层吃掉所有触摸的半透明黑罩子。
3. 关掉弹幕也恢复不了：插件的 restoreContentViewIfNeeded 在
originalParentView == nil 时直接 return，而 PlayerView 是 createPipContentView
里凭空 new 出来的、从来没有过 superview，那条还原分支永远走不到。
罩子会一直留到进程被杀。
改动（都在我们自己这边，没有 fork pub 包）：
- PlayerView.isUserInteractionEnabled = false。字幕卡片是纯展示，任何情况下
都不该吃触摸——这一条单独就能解掉「点不动」。
- 视觉（底色/圆角/描边/阴影）从 self 搬到内层 cardView，self 透明；
cardView 只钉 top/leading/trailing + 固定高度，不钉 bottom。真 PiP 小窗里
窗口高度就等于这个高度、看着是铺满的；万一又被铺到全屏窗口上，也只占顶部
一条，下面保持透明。
- disposePipContentView 里补 removeFromSuperview（插件不会替我们摘）。
- Dart 关闭弹幕/PiP 失败时调 _releasePipContentView()，并把 _pipContentView
清零，避免复用一个已经被搬走、再也摘不下来的 view。
⚠️ 未验证：PiP 小窗本身能不能正确显示字幕。pip 包的 PipView 只往
sampleBufferDisplayLayer 里塞自己造的 buffer，全文件没有一处引用 contentView，
所以「切出 App 后小窗里有没有字」这件事需要真机确认，本次没测。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
1 month ago |
