import 'dart:async'; import 'package:get/get.dart'; import 'package:get_storage/get_storage.dart'; import '../../core/utils/logger.dart'; import '../models/assistant_directive.dart'; import '../models/user_Info.dart'; import 'memory_reminder_scheduler.dart'; import 'memory_service.dart'; /// 助手指令的落地层:**解析 → 分发 → 落本地记录**。 /// /// 指令由 [BailianMultimodalService] 从 `RespondingContent.extra_info.tool_calls` /// 解出来,App 内对话页(EmaiController)和耳机唤醒(BesAiSessionService)两条 /// 链路都会往这里送,这里是唯一的汇合点。 /// /// 目前只有 `SET_clock` 真正落地:**双写**——本地 reminders(迁移期保留一个版本) /// 加服务端 memory_item(category=alarm),于是它会出现在拾忆页并跨设备可见。 /// 其余指令一律 /// 记一条 `unsupported` 流水——**不是丢掉**:将来要按这份流水看用户到底在用 /// 哪些能力、以及百炼后台配了但客户端没实现的有哪些。 /// /// 两份数据分开存: /// - [directives] 是流水日志(含不支持、失败的),只增不改,用于回溯与将来上传; /// - [reminders] 是业务实体(用户会看会勾会删),代办页读它。 /// /// ⚠️ 目前只在**本地**存。服务端同步接口尚未开发,两个模型的 `synced` 字段和 /// `toJson()` 已按可直接上传的形状设计好,接口就绪后补上传即可,不用改结构。 /// /// ⚠️ 另一个已知边界:指令是从 EMAI 的 WebSocket 会话里回来的,而会话只在 /// 对话页打开(或耳机唤醒)时才建立。要做到「App 没打开也能定闹钟」,得先有 /// 常驻的会话持有者,光把执行代码挪到原生层不解决这个问题。 class AssistantDirectiveService extends GetxService { static AssistantDirectiveService get to => Get.find(); static const String _tag = 'AssistantDirective'; static const String _kDirectives = 'assistant_directives'; static const String _kReminders = 'assistant_reminders'; /// 流水最多留这么多条,超了丢最旧的——它只是排查/上传用的日志,不是账本 static const int _maxDirectives = 300; final GetStorage _storage = GetStorage(); /// 各能力模块注册的指令处理器(`ModuleRegistry.directiveHandlers`)。 /// 查不到的指令走 [_dispatch] 里的内置处理(SET_clock)或记 unsupported。 final Map _handlers = {}; void registerHandlers(Map handlers) { _handlers.addAll(handlers); } /// 指令流水,新的在前 final RxList directives = [].obs; /// 提醒(代办页的数据源),按时间正序 final RxList reminders = [].obs; /// 本版明确不做的指令:上一轮已经把电话/联系人能力整个删掉了 /// (权限、清单声明、原生实现都删了),这两条即使接上也执行不了。 static const Map _declined = { 'SEND_message': '本版已移除短信与联系人能力', 'MAKE_A_PHONE_CALL_phone_call': '本版已移除拨号与联系人能力', }; @override void onInit() { super.onInit(); _restore(); } /// 收到一批指令:逐条分发并落记录。 /// /// 同一 `round_id` 重复送达时按 id 去重——耳机与对话页可能同时在监听同一个 /// 会话,重复执行会把同一个闹钟定两遍。 void handle(List incoming) { if (incoming.isEmpty) return; var changed = false; for (final d in incoming) { if (directives.any((e) => e.id == d.id)) { Logger.w(_tag, '忽略重复指令 ${d.id}(耳机与对话页可能都在听同一会话)'); continue; } _dispatch(d); directives.insert(0, d); changed = true; // warn 级:这是「闹钟到底有没有落地」的唯一端侧证据, // release 的级别门槛是 warning,写 info 等于真机上查不到。 Logger.w(_tag, '指令落地 $d'); } if (!changed) return; if (directives.length > _maxDirectives) { directives.removeRange(_maxDirectives, directives.length); } _persist(); } void _dispatch(AssistantDirective d) { final declined = _declined[d.name]; if (declined != null) { d.status = DirectiveStatus.unsupported; d.note = declined; return; } final h = _handlers[d.name]; if (h != null) { try { h(d); } catch (e) { d.status = DirectiveStatus.failed; d.note = '模块处理失败: $e'; Logger.e(_tag, '指令 ${d.name} 处理失败: $e'); } return; } switch (d.name) { case 'SET_clock': _handleSetClock(d); break; default: // 已知但本版没接的:ROUTE_map(导航)、INCREASE_DEFAULT_volume(音量)… // 以及百炼后台后加的任何新指令。留一条流水,不报错。 d.status = DirectiveStatus.unsupported; d.note = '尚未实现的指令'; // 打出来:百炼后台加了新工具时,这行是唯一能发现「模型在下发一个 // 我们没接的指令」的地方——否则表现成「助手说做了、实际什么都没发生」, // 和「压根没下发」长得一模一样。 Logger.w(_tag, '收到未实现的指令 ${d.name} args=${d.rawArguments}'); } } void _handleSetClock(AssistantDirective d) { final reminder = AssistantReminder.fromSetClock(d); if (reminder == null) { d.status = DirectiveStatus.failed; d.note = 'time 缺失或格式无法解析: ${d.rawArguments}'; Logger.w(_tag, 'SET_clock 解析失败: ${d.rawArguments}'); return; } reminders.add(reminder); _sortReminders(); d.status = DirectiveStatus.done; d.note = reminder.repeat == RepeatRule.unknown && reminder.repeatRaw.isNotEmpty ? '重复规则「${reminder.repeatRaw}」未识别,按单次处理' : null; // 同时写服务端,让它出现在拾忆页并跨设备可见。 // // 迁移期**双写**:本地 reminders 保留一个版本,等确认服务端链路稳了再摘。 // 这样即使上传失败,用户至少还能在本机看到自己刚定的闹钟。 // ⚠️ 上传成不成功**都要**重排一次系统通知: // - 成功 → 服务端 loadUpcoming 会给出这条 // - 失败 → 它留在本地 unsynced,走 scheduler 的 _localSlots 兜底 // 不在这里排的话,新定的闹钟要等到下一次 App 切前台 //(AppLifecycleManager 里那个 reschedule)才会真正进系统排期—— // 「5 分钟后提醒我」这种当场就废了,而用户以为已经定好了。 unawaited(_uploadReminder(reminder).whenComplete(_rescheduleNotifications)); } /// 让排期服务按最新的本地/服务端数据重排系统通知。 /// /// 只在这里单向调用 scheduler;scheduler 反过来读本类的 reminders 做兜底。 /// 两个文件互相 import 是有意的:注册顺序上 scheduler 先于本类, /// 由 scheduler 挂 ever(reminders) 监听会在启动时找不到本类。 void _rescheduleNotifications() { if (!Get.isRegistered()) return; unawaited(MemoryReminderScheduler.to.reschedule()); } /// 把所有**还没同步**的本地闹钟补传一遍。 /// /// 由拾忆页的刷新(进页面 / 下拉 / 切前台)驱动。存在的意义是自愈: /// 服务端没部署、断网、或恰好那一下超时,闹钟都会先落在本地 `synced=false`, /// 等下一次能连上时自动补上去,不需要用户做任何事、也不该反复弹提示催他。 /// /// 并发保护:多个入口可能同时触发刷新,重入会把同一条传两遍(服务端有 /// (uid, client_key) 唯一索引兜底不会插重,但白跑一趟)。 bool _syncing = false; Future syncPending() async { if (_syncing) return 0; if (!Get.isRegistered() || !User.isLoggedIn()) return 0; final pending = reminders.where((e) => !e.synced).toList(); if (pending.isEmpty) return 0; _syncing = true; var ok = 0; try { for (final r in pending) { try { final saved = await MemoryService.to.add(r.toMemoryItem()); if (saved != null) { r.synced = true; ok++; } else { // 服务端明确拒绝(业务错误)——多半是还没部署 memory 模块。 // 后面的也一样会失败,早点收手,别把整串请求都打一遍。 break; } } catch (_) { break; // 网络层出问题,同上 } } if (ok > 0) { _persist(); reminders.refresh(); Logger.w(_tag, '补传了 $ok 条本地闹钟到服务端'); // 补传之后这些条目的来源从「本地兜底」变成了「服务端」,重排一次, // 否则同一个闹钟会同时出现在两边、响两遍。 _rescheduleNotifications(); } } finally { _syncing = false; } return ok; } /// 把一条助手落下来的闹钟写进记忆中心。 /// /// ⚠️ **幂等键用指令 id**:端侧指令会重试,而本类的按 id 去重只在**本进程内存**里 /// ([_seen]),换手机、重装、进程重启后全部失效。服务端靠 (uid, client_key) /// 唯一索引兜住,重复提交返回既有记录而不是插第二条。 Future _uploadReminder(AssistantReminder r) async { if (!Get.isRegistered()) return; if (!User.isLoggedIn()) return; try { // 换算收敛在 AssistantReminderToMemory 扩展里,与拾忆页的本地投影共用同一份 final item = r.toMemoryItem(); final saved = await MemoryService.to.add(item); if (saved != null) { r.synced = true; _persist(); // ⚠️ 必须 refresh:改的是 RxList **元素内部**的字段,列表本身没变, // 不通知就没人知道。拾忆页的 ever(reminders) 因此不会触发,而 // ever(items) 那一次在 add() 返回前就已经跑完了(那时 synced 还是 // false)——于是服务端那条已经上屏、本地这条也还在,同一个闹钟两张卡, // 一直挂到下次因为别的原因重投影为止(2026-09-19 真机实测)。 // syncPending() 那条补传路径本来就 refresh 了,这里是漏的。 reminders.refresh(); } } catch (e) { // 上传失败不影响本地闹钟——迁移期本地那份仍然是可用的 Logger.w(_tag, '闹钟上传服务端失败(本地仍可用): $e'); } } /// 用户在代办页勾选完成 void toggleReminderDone(String id, bool done) { final r = reminders.firstWhereOrNull((e) => e.id == id); if (r == null) return; r.done = done; reminders.refresh(); _persist(); } void removeReminder(String id) { reminders.removeWhere((e) => e.id == id); _persist(); } /// 排查用:清空本地记录 void clearAll() { directives.clear(); reminders.clear(); _persist(); } void _sortReminders() { reminders.sort((a, b) { final ad = a.date ?? ''; final bd = b.date ?? ''; final byDate = ad.compareTo(bd); return byDate != 0 ? byDate : a.time.compareTo(b.time); }); } void _restore() { try { final rawD = _storage.read(_kDirectives) ?? const []; directives.assignAll(rawD .whereType() .map((e) => AssistantDirective.fromJson(e.cast()))); final rawR = _storage.read(_kReminders) ?? const []; reminders.assignAll(rawR .whereType() .map((e) => AssistantReminder.fromJson(e.cast()))); _sortReminders(); Logger.i(_tag, '恢复本地记录: ${directives.length} 条指令 / ${reminders.length} 条提醒'); } catch (e) { // 存档格式对不上(比如改过模型字段)不该让服务起不来,丢掉重来即可 Logger.e(_tag, '恢复本地记录失败,已重置: $e'); directives.clear(); reminders.clear(); } } void _persist() { try { _storage.write(_kDirectives, directives.map((e) => e.toJson()).toList()); _storage.write(_kReminders, reminders.map((e) => e.toJson()).toList()); } catch (e) { Logger.e(_tag, '写本地记录失败: $e'); } } }