用途：诊断并修复 CometChat Android UIKit v6 在 Kotlin Views 与 Jetpack Compose 两套栈中的常见问题，包括 SDK 初始化/登录错误、组件不渲染或显示异常、推送不工作、通话失效、构建或依赖冲突。
主要能力：提供症状—可能原因—修复方式对照的诊断表；覆盖初始化问题（用 isSDKInitialized()、getLoggedInUser() 校验状态，init 应放在 Application 或 splash 而非每个 Activity）；Compose 问题（组件必须包裹在 CometChatTheme {} 中，避免嵌套包裹，深色模式用 isSystemInDarkTheme() 选择配色，样式用 StyleClass.default(param = value)）；Views 问题（主题缓存过期调用 CometChatTheme.clearCache()，颜色透明可调用 CometChatTheme.setPrimaryColor(...)，列表用 layout_weight 保证可滚动）；推送问题（FCM 服务中需先检查 isSDKInitialized()，VoIP 需 READ_PHONE_STATE、MANAGE_OWN_CALLS、ANSWER_PHONE_CALLS 三项权限，启用通话需 setEnableCalling(true)，依赖 com.cometchat:calls-sdk-android）；依赖冲突（排除 org.jetbrains:annotations-java5，添加 Cloudsmith Maven 仓库）；发布构建（ProGuard 保留 com.cometchat.** 与 io.dyte.**，CI 中通过 Gradle 属性或环境变量提供凭证，避免依赖 local.properties）。
硬性规则：后台服务调用 SDK 前必须检查 isSDKInitialized()；Compose 组件必须包裹 CometChatTheme {}；Views 动态换主题时调用 clearCache()；minSdk 不得低于 28，compileSdk 不得低于 36；报 bug 需附 SDK 版本、技术栈、Android API 级别与完整堆栈。
限制：不适用于新建项目（用 cometchat-android-v6-core）或查询组件 API（用 cometchat-*-components）；具体版本兼容性与最新配置以官方资料为准，本文未提供的细节暂未提供。