用途：帮助 AI 智能体在客户端 Flutter 应用中集成或升级 Contentsquare SDK，涵盖会话回放、屏幕追踪、交易、分析、遮罩与隐私同意管理。
强制首步：每次对话开始前必须执行一次 Contentsquare 项目健康检查，先向用户说明，再分别解析 Android 的 applicationId 与 iOS 的 PRODUCT_BUNDLE_IDENTIFIER（两者常不同），按平台调用 healthcheck 端点（平台段只能为 ios 或 android，无 Flutter 值），并汇报项目 ID、追踪开关、会话回放配置与已启用功能标志。403 表示路径错误，非 200 表示该 bundle id 未配置项目，健康检查仅作参考，不得阻塞用户任务。
安装：在 pubspec.yaml 添加 contentsquare: ^4.5.1，然后运行 flutter pub get。从 4.1.x 或 3.x 升级前需阅读迁移说明，因存在破坏性变更。
主要能力：生命周期管理（start、stop、pauseTracking、resumeTracking）；三种 StartConfig（withDatasourceId、withEnvironmentId、dxa）；隐私 optIn/optOut；身份 identify、resetIdentity、sendUserIdentifier；屏幕追踪 trackScreenview 与 CSQNavigatorObserver；交易 trackTransaction；自定义事件与属性；会话回放触发与按需启停；会话元数据与回放链接；错误上报；调试日志。
使用方式：初始化需在 runZonedGuarded 中调用 CSQ().start()，屏幕必须被追踪否则会话回放不工作，推荐使用 CSQNavigatorObserver 自动追踪。GoRouter 通过 observers 传入，AutoRoute 需使用 csq_navigator_auto_route_observer 包。PageView 与 TabBar 需手动调用 trackScreenview。WebView 必须用 CSQWebViewWrapper 包裹并建立 JS 桥接。
限制：EU 托管的 Product Analytics 环境必须设置 baseUrl 为 https://mh.ba.contentsquare.net，否则收不到数据；不得编造 ID 或默认 DXA；属性值仅支持 String、num、bool；stopSessionReplay 为终止操作，同一 SDK 生命周期内无法重启；4.2.0 移除了多个 AnalyticsOptions 字段。具体平台支持与版本兼容性以官方资料为准。