用途：帮助诊断并修复在 iOS 项目集成 CometChat UI Kit 时遇到的常见问题，涵盖构建错误、运行时错误与调试技巧。
主要能力：
- 构建错误处理：如“No such module 'CometChatUIKitSwift'”时用 CocoaPods 清理重装（rm -rf Pods Podfile.lock；pod install --repo-update；打开 .xcworkspace），Swift Package Manager 则重置缓存与解析版本并 Clean Build Folder；缺失 CometChatSDK 或 CometChatCallsSDK 时按需添加依赖或用 #if canImport 包裹。另有定位重复符号、部署目标低于 iOS 13、沙盒 rsync.samba denied（将 ENABLE_USER_SCRIPT_SANDBOXING 设为 No）以及归档时 Framework not found 的处理办法。
- 运行时错误：初始化未完成即使用、App ID/Auth Key/UID 无效、重复登录、会话列表为空、消息发送失败、推送通知与通话不可用等，均给出检查清单与示例。注意 CometChatException 不遵循 Swift Error 协议，应使用 errorDescription、errorCode、details，回调不要套用 Result<T, Error>。
- 调试技巧：通过 CometChat.setLogLevel(.debug) 开启日志，添加连接与消息监听器，使用 Charles Proxy/Proxyman 抓包 *.cometchat.io，并结合 Xcode 断点与控制台打印状态。
- 性能与常见错误码：限制会话与消息初始加载数量、按需隐藏回执与头像、清理缓存与监听器；并列出 ERR_UID_NOT_FOUND、ERR_ALREADY_LOGGED_IN、AUTH_ERR_AUTH_TOKEN_NOT_FOUND、ERR_RATE_LIMIT_EXCEEDED 等错误码及对应解决方向。
- SwiftUI 专项：用 UIViewControllerRepresentable 封装 CometChatConversations，并用 @State 与 onChange 处理选择与导航。
使用方式：按报错信息定位对应章节，先校验依赖安装、凭据与登录状态，再开启日志与监听器复现问题；需要推送或通话时确认已装对应 SDK、Info.plist 权限及真机测试。
限制：文档内容在此处截断，SwiftUI 部分未完整；具体版本兼容性、收费与支持范围以官方资料为准，未提供的信息暂无法确认。