用途:为编写正确、性能良好的 Compose 代码提供非主观的实用指导,覆盖 Jetpack Compose 与 Compose Multiplatform(Android、Desktop、iOS、Web)。内容基于对 androidx/androidx 与 JetBrains/compose-multiplatform-core 实际源码的分析。
主要能力:按主题提供参考文件,包括状态管理(状态提升边界、derivedStateOf 陷阱、@ReadOnlyComposable)、视图组合(插槽与内容 API、XxxDefaults)、屏幕结构、Modifier 作为 API 契约与链式顺序、副作用(LaunchedEffect/DisposableEffect/SideEffect、生命周期副作用)、CompositionLocal、列表与滚动性能陷阱、Navigation 3 与类型安全路由、动画(AnimatedContent、M3 动效令牌、共享元素、预测式返回)、主题扩展、性能(重组跳过、稳定性、基准测试)、无障碍、焦点与键盘导航、废弃 API 迁移、实验性 Styles API、设计稿转 Compose、生产崩溃模式、CMP 注意事项与平台差异。
使用方式:先理解请求涉及的 Compose 层与问题类型(状态、布局、性能或架构),判断是否仅 Android 或 CMP;若有设计稿则先分解为 composable 树并映射设计令牌;再查阅对应参考文件;随后按参考模式写代码、指出反模式并给出最小正确方案;引用内部实现时指向具体源码文件。验证源码优先使用 android-sources MCP 工具(如 lookup_class、lookup_method、search_in_source),不可用时回退到 GitHub 原始 URL 或 AOSP 源码;权威文档可查询 Google Android Knowledge Base。
适用场景:Compose UI 开发、状态与副作用设计、性能优化、动画与导航实现、设计稿还原、跨平台迁移与平台特定 API 处理。
限制:资料未提供收费、价格或平台支持范围等商业信息;部分内容(如 Styles API)标注为实验性;平台特定 API 需 expect/actual 或条件源集,不能直接在 commonMain 使用。