用途：面向 CometChat Flutter UIKit v6 的集成排障，按症状定位问题并给出修复方式。
主要能力：提供快速诊断决策树，按启动崩溃、UI 异常、通话失败、事件异常、构建失败、性能卡顿、平台差异分流到对应章节。
关键要点：初始化须 await CometChatUIKit.init() 后再登录，否则报 Authentication null；appId 必填；region 用小写 'us'/'eu'/'in'；登录前用同步的 CometChatUIKit.loggedInUser 判断会话，避免 ERR_ALREADY_LOGGED_IN 与守卫页卡加载；未设 subscriptionType 会静默禁用在线状态与输入提示等事件。UI 方面，含 CometChatMessageComposer 的 Scaffold 需设 resizeToAvoidBottomInset: false 以避免键盘双重补偿；用户/群组数据应保存在可变状态并由监听器更新；主题值应在 didChangeDependencies() 缓存，避免 build 内查询导致键盘动画卡顿。通话问题涉及 auth token null、session already started、CallManager not found、startSession 返回 null、来电未收到及登出后未重新初始化等。监听器应使用唯一 ID 并在 dispose 中移除，防止重复事件与内存泄漏。
适用场景：Flutter 应用中集成 CometChat UIKit v6 时的调试与修复。
限制：资料为排障指南，未提供完整安装步骤、版本兼容矩阵与官方支持渠道；部分问题（如 Android startSession 返回 null）属已知 SDK 层问题，仅给出超时与重试等临时方案。