starpivot

92 Commits

3 Branches

2 Tags

240 MiB

Tree: 3709aa6e3b

Commit Graph

Author	SHA1	Message	Date
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 编写的，此处仅做入库。	1 month ago
Rodger-Wang	66463e53f6	记忆中心客户端：拾忆页接服务端 + 写操作 UI + 本地提醒 + 每日播报 dart analyze 零错误，flutter build apk --debug 通过。零期修缮 - tabTodo 补齐 41 个语言。此前只有 11 个文件有这个 key，其中 8 个的值是 'Remin'（不是任何语言里的词，像 Reminisce 打了一半），缺 key 的 30 个经 GetX 回退到 en_US 同样显示 'Remin' —— 41 个语言里 38 个是坏的，只是不报错。 - i18n_audit.py 补「缺失 key」检查。它此前结构上无法发现缺失的 key：循环遍历的是该文件已有的 key，且对 baseline 里没有的直接 continue。这正是 tabTodo 在 30 个语言里悄悄丢掉而没人发现的原因。现以 zh_cn 为基准，实测报出 7243 处历史缺失（40 个语言只有 1 个不缺）。加了 --fail-on-missing/--allow-missing 给 CI 卡「只增不减」，默认不开——一上来就红会让人直接把检查关掉。 - pubspec 引入 timezone + flutter_timezone。zonedSchedule 只接受 tz.TZDateTime，没有这两个依赖，提醒功能一行都写不了。拾忆页从纯展示改成可写（此前最大的工作量遗漏）页面原来没有 RefreshIndicator、没有 FloatingActionButton、卡片没有 onTap，于是服务端的 add/update/del/complete 四个写接口在客户端一个调用点都没有， user_edited 那套「保护用户修改」的机制完全空转。本次补齐： - MemoryEditSheet：新增/编辑弹层，按分类分流表单（统一表存储 ≠ 统一表单） - 卡片 onTap 打开编辑、左侧勾选框标记完成（灵感不给勾选框，它没有完成一说） - 右下角 + 新增、RefreshIndicator 下拉刷新、带引导的空态页 - date_certain=false 的项单独归到「待定日期」小节。一次会抽出 8 条没写截止时间的待办全堆在会议当天，不分开那一格就没法看了。数据层 - MemoryItem / MemoryRemindSlot / MemoryReport 手写镜像服务端 pb。每个字段都经宽松解析器（memInt/memBool/memStr），不直接 as int：服务端删字段或老记录缺列时，non-nullable 会让整个 fromJson 抛 TypeError，表现是整页空白而不是少一个字段（appconfig_model 已经为此踩过坑）。单条解析失败只跳过那一条。 - 分类保留原始字符串而不是 enum 解析。服务端加分类只改常量不发包，客户端 switch 不到就抛等于服务端一加分类就打崩所有存量 App。 CalendarEventCategory 加了 other 作为未知兜底，筛选与卡片分流都改成值比较而不是穷举 switch。 - MemoryService 只缓存最近 90 天。GetStorage 是把整个 box 读进内存的 JSON，一年三千多条全量缓存会让每次启动越来越慢。 - 拉取失败保留本地缓存并标 staleFromCache，页面显示行内「当前显示的是本地缓存」，不清空、不弹红条。 - 勾选完成是乐观更新 + 失败回滚。不回滚会让用户以为已经勾上，下次进页面又变回来。 - memory_today / memory_upcoming 加进 AuthInterceptor 的红条抑制名单：它们在启动与前台恢复时自动调，用户什么都没点就吃一条英文内部状态词很差。删除 mock mockCalendarEvents() 与它引用的 44 个 demo* i18n key 一并删除（41 个文件共 484 行）。真实数据上线后混着演示数据会让人以为系统出错。本地提醒（MemoryReminderScheduler） - 通知 id 占 920000 起的固定区间，逐条 cancel，绝不 cancelAll() —— 仓库里已有两个各自 new 的 FlutterLocalNotificationsPlugin 实例，cancelAll 会顺手干掉正在录音的前台通知，表现是录音悄悄失去前台身份被系统回收。 - 单独的通知通道：录音提示是常驻低优先级通道，共用会让提醒被降级成静默。 - 只查权限不申请。申请必须走 PermissionUtil（它收敛了过审要求的 48 小时冷却），且只允许用户在权限管理页主动发起，这里主动申请等于绕过合规规则。无权限时降级为「打开 App 才提醒」，不阻塞。 - 精确排期失败（Android 14 起 SCHEDULE_EXACT_ALARM 默认不授予）自动退化成 inexact 再试一次——不精确的提醒也比没有强，日志会记下来。 - 拿不到系统时区时按本机偏移找等价区兜底，不落回 UTC（那会让国内用户全部偏 8 小时）。每日播报（MemoryDailySheet） - 不 await 在启动路径上。冷启动已串四次网络往返，仓库刚做过相反方向的优化（6a64c3d0 把会议模板拉取改成 unawaited）。这里是进主页后异步拉、拿到再弹。 - 排在隐私政策与强更弹窗之后，且必须在登录态确认之后。 - 通话翻译进行中一律不播报：两者共用同一个 AVAudioSession，在对方刚调好的会话上再设一次会把通话音频路由弄乱（iOS 那条 phone_call 分支被改坏过三次）。 - 关窗必须真停：speakStream 是队列式播放，只 stop 不清队列会「关了还在念下一句」。 - 播报文案本地拼，不调 LLM。生命周期与账号 - 切前台的刷新挂在 AppLifecycleManager（仓库已有 emai/translation/permissions 三个各自实现的 observer，本类就是收敛点），全部 unawaited。 - 登出清空记忆数据与已排提醒。不清的话换账号会看到上一个人的日程花销灵感，提醒也会继续按上一个账号的安排响。助手闹钟迁移 SET_clock 改为双写：本地 reminders 保留一个版本（上传失败时本机仍可用），同时写服务端 memory_item(category=alarm)。幂等键用指令 id —— 本类的按 id 去重只在本进程内存里，换机/重装/重启后全失效，服务端靠 (uid, client_key) 唯一索引兜住。认不出的重复规则按单次处理，宁可只响一次也不按猜的规则天天响。 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>	2 months ago

Author

SHA1

Message

Date

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 编写的，此处仅做入库。

1 month ago

Rodger-Wang

66463e53f6

记忆中心客户端：拾忆页接服务端 + 写操作 UI + 本地提醒 + 每日播报

dart analyze 零错误，flutter build apk --debug 通过。

零期修缮
- tabTodo 补齐 41 个语言。此前只有 11 个文件有这个 key，其中 8 个的值是
  'Remin'（不是任何语言里的词，像 Reminisce 打了一半），缺 key 的 30 个经 GetX
  回退到 en_US 同样显示 'Remin' —— 41 个语言里 38 个是坏的，只是不报错。
- i18n_audit.py 补「缺失 key」检查。它此前**结构上无法发现缺失的 key**：循环遍历
  的是该文件已有的 key，且对 baseline 里没有的直接 continue。这正是 tabTodo 在 30
  个语言里悄悄丢掉而没人发现的原因。现以 zh_cn 为基准，实测报出 7243 处历史缺失
  （40 个语言只有 1 个不缺）。加了 --fail-on-missing/--allow-missing 给 CI 卡「只增
  不减」，默认不开——一上来就红会让人直接把检查关掉。
- pubspec 引入 timezone + flutter_timezone。zonedSchedule 只接受 tz.TZDateTime，
  没有这两个依赖，提醒功能一行都写不了。

拾忆页从纯展示改成可写（此前最大的工作量遗漏）
页面原来没有 RefreshIndicator、没有 FloatingActionButton、卡片没有 onTap，
于是服务端的 add/update/del/complete 四个写接口在客户端一个调用点都没有，
user_edited 那套「保护用户修改」的机制完全空转。本次补齐：
- MemoryEditSheet：新增/编辑弹层，按分类分流表单（统一表存储 ≠ 统一表单）
- 卡片 onTap 打开编辑、左侧勾选框标记完成（灵感不给勾选框，它没有完成一说）
- 右下角 + 新增、RefreshIndicator 下拉刷新、带引导的空态页
- date_certain=false 的项单独归到「待定日期」小节。一次会抽出 8 条没写截止时间的
  待办全堆在会议当天，不分开那一格就没法看了。

数据层
- MemoryItem / MemoryRemindSlot / MemoryReport 手写镜像服务端 pb。
  **每个字段都经宽松解析器**（memInt/memBool/memStr），不直接 as int：
  服务端删字段或老记录缺列时，non-nullable 会让整个 fromJson 抛 TypeError，
  表现是整页空白而不是少一个字段（appconfig_model 已经为此踩过坑）。
  单条解析失败只跳过那一条。
- 分类保留原始字符串而不是 enum 解析。服务端加分类只改常量不发包，
  客户端 switch 不到就抛等于服务端一加分类就打崩所有存量 App。
  CalendarEventCategory 加了 other 作为未知兜底，筛选与卡片分流都改成值比较
  而不是穷举 switch。
- MemoryService 只缓存最近 90 天。GetStorage 是把整个 box 读进内存的 JSON，
  一年三千多条全量缓存会让每次启动越来越慢。
- 拉取失败保留本地缓存并标 staleFromCache，页面显示行内「当前显示的是本地缓存」，
  不清空、不弹红条。
- 勾选完成是乐观更新 + 失败回滚。不回滚会让用户以为已经勾上，下次进页面又变回来。
- memory_today / memory_upcoming 加进 AuthInterceptor 的红条抑制名单：
  它们在启动与前台恢复时自动调，用户什么都没点就吃一条英文内部状态词很差。

删除 mock
mockCalendarEvents() 与它引用的 44 个 demo* i18n key 一并删除（41 个文件共 484 行）。
真实数据上线后混着演示数据会让人以为系统出错。

本地提醒（MemoryReminderScheduler）
- 通知 id 占 920000 起的固定区间，**逐条 cancel，绝不 cancelAll()** —— 仓库里已有
  两个各自 new 的 FlutterLocalNotificationsPlugin 实例，cancelAll 会顺手干掉正在
  录音的前台通知，表现是录音悄悄失去前台身份被系统回收。
- 单独的通知通道：录音提示是常驻低优先级通道，共用会让提醒被降级成静默。
- **只查权限不申请**。申请必须走 PermissionUtil（它收敛了过审要求的 48 小时冷却），
  且只允许用户在权限管理页主动发起，这里主动申请等于绕过合规规则。
  无权限时降级为「打开 App 才提醒」，不阻塞。
- 精确排期失败（Android 14 起 SCHEDULE_EXACT_ALARM 默认不授予）自动退化成
  inexact 再试一次——不精确的提醒也比没有强，日志会记下来。
- 拿不到系统时区时按本机偏移找等价区兜底，不落回 UTC（那会让国内用户全部偏 8 小时）。

每日播报（MemoryDailySheet）
- **不 await 在启动路径上**。冷启动已串四次网络往返，仓库刚做过相反方向的优化
  （6a64c3d0 把会议模板拉取改成 unawaited）。这里是进主页后异步拉、拿到再弹。
- 排在隐私政策与强更弹窗之后，且必须在登录态确认之后。
- 通话翻译进行中一律不播报：两者共用同一个 AVAudioSession，在对方刚调好的会话上
  再设一次会把通话音频路由弄乱（iOS 那条 phone_call 分支被改坏过三次）。
- 关窗必须真停：speakStream 是队列式播放，只 stop 不清队列会「关了还在念下一句」。
- 播报文案本地拼，不调 LLM。

生命周期与账号
- 切前台的刷新挂在 AppLifecycleManager（仓库已有 emai/translation/permissions
  三个各自实现的 observer，本类就是收敛点），全部 unawaited。
- 登出清空记忆数据与已排提醒。不清的话换账号会看到上一个人的日程花销灵感，
  提醒也会继续按上一个账号的安排响。

助手闹钟迁移
SET_clock 改为双写：本地 reminders 保留一个版本（上传失败时本机仍可用），
同时写服务端 memory_item(category=alarm)。**幂等键用指令 id** —— 本类的按 id
去重只在本进程内存里，换机/重装/重启后全失效，服务端靠 (uid, client_key)
唯一索引兜住。认不出的重复规则按单次处理，宁可只响一次也不按猜的规则天天响。

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>

2 months ago

3 Commits (3709aa6e3b25e91f70b3813fb4e1624d6ac0cc39)