docs: 重写 README，重新定位为性能诊断+轻量优化工具

- 定位从'解决 LayoutInflater 瓶颈'改为'XML 布局性能诊断与优化'
- 移除 Phase 2/3 Roadmap 和 compiler 模块说明
- 诊断能力（InflateTracker/PoolStats）放在优化前面
- 补充 markAsMainThreadOnly 用法
- 版本号 0.3.0

Author: donglua

README.md

@@ -2,14 +2,12 @@
 
 [![CI](https://github.com/donglua/FastInflater/actions/workflows/ci.yml/badge.svg)](https://github.com/donglua/FastInflater/actions/workflows/ci.yml)
 
-高性能 Android 布局加载框架，通过 View 池化复用 + 智能预热 + 异步 inflate，从根本上解决 `LayoutInflater` 的性能瓶颈。
+Android XML 布局性能诊断与优化工具。通过 inflate 耗时追踪定位热点布局，通过 View 池化复用降低重复 inflate 开销。
 
-**适用场景：** 仍在维护大量 XML 布局的 Android 项目（尤其是 RecyclerView 密集列表场景）。如果你的项目已全面迁移到 Jetpack Compose，则不需要这个库。
+**适用场景：** 仍在维护 XML 布局的 Android 项目，尤其是 RecyclerView 密集列表、Tab 切换、Dialog 反复弹出等高频 inflate 场景。如果你的项目已全面迁移到 Jetpack Compose，则不需要这个库。
 
 ## 引入
 
-### 方式 1: JitPack（推荐，无需认证）
-
 ```kotlin
 // settings.gradle.kts
 dependencyResolutionManagement {
@@ -20,82 +18,32 @@ dependencyResolutionManagement {
 
 // build.gradle.kts
 dependencies {
-    implementation("com.github.donglua:FastInflater:0.2.0")
+    implementation("com.github.donglua:FastInflater:0.3.0")
 }
 ```
 
-### 方式 2: GitHub Packages（备选）
-
-需要配置 GitHub Token（[创建 Token](https://github.com/settings/tokens/new?scopes=read:packages)，勾选 `read:packages`）：
-
-```kotlin
-// settings.gradle.kts
-dependencyResolutionManagement {
-    repositories {
-        maven {
-            url = uri("https://maven.pkg.github.com/donglua/FastInflater")
-            credentials {
-                username = providers.gradleProperty("gpr.user").orNull ?: System.getenv("GITHUB_ACTOR")
-                password = providers.gradleProperty("gpr.token").orNull ?: System.getenv("GITHUB_TOKEN")
-            }
-        }
-    }
-}
-
-// build.gradle.kts
-dependencies {
-    implementation("com.github.donglua:fast-inflater:0.2.0")
-}
-```
-
-## 为什么需要 FastInflater
-
-`LayoutInflater` 是将 XML 布局转换为 View 树的核心组件，也是应用启动和页面跳转时主线程卡顿的常见元凶。
+## 它能做什么
 
-瓶颈集中在四个方面：
+**诊断：** 告诉你哪个布局慢、慢多少、被 inflate 了多少次、池命中率是多少。这些信息在 Android 现有工具链里没有现成替代品。
 
-1. **反射创建对象** — `Class.forName().getConstructor().newInstance()` 的开销远大于直接 `new`，复杂页面几十上百个 View 的反射累加非常可观。
-2. **IO + XML 解析** — 从 APK 读取二进制 XML 并逐节点深度优先遍历，低端机型上耗时明显。
-3. **TypedArray 跨层解析** — 属性需结合 Theme/Style 计算，大量 Java-Native 跨层通信。
-4. **GC 抖动** — 短时间内创建大量 LayoutParams、TypedArray 等临时对象，触发 GC 停顿。
-
-## FastInflater 的解决策略
-
-| 瓶颈 | 对策 |
-|---|---|
-| 反射 + XML 解析 | Phase 2 编译期 codegen，直接 `new View()` + `setXx()` |
-| IO 读取 | Phase 3 native mmap 二进制属性表，零拷贝 |
-| TypedArray 跨层 | codegen 预解析静态属性，运行时只处理动态值 |
-| GC 抖动 | Phase 1 View 池化复用 + 自适应池大小 |
+**优化：** 对高频重复 inflate 的布局，池命中时耗时从几十 ms 降到 0。不是所有场景都有用，但有用的场景收益是 100%。
 
 ## 核心特性
 
+- **纳秒级耗时追踪** — 精确记录每次 inflate 耗时，按布局拆分，识别热点
+- **池命中率监控** — 全局和 per-layout 的 hit/miss 统计，用数据指导调优
 - **View 池化复用** — 池命中时 inflate 耗时降至 0，避免重复创建和 GC
 - **IdleHandler 预热** — 利用主线程空闲时间预创建 View，不抢占用户交互帧
-- **异步 inflate** — 单线程后台 inflate，线程安全，池优先
+- **异步 inflate** — 后台线程 inflate，池优先；含 ComposeView 等主线程依赖的布局自动降级
 - **自适应池大小** — 根据运行时统计数据自动调整各布局池容量
-- **池命中率监控** — 全局和 per-layout 的 hit/miss 统计，指导调优
-- **纳秒级耗时追踪** — 精确记录每次 inflate 耗时，识别热点布局
-- **RecyclerView 无感集成** — 一行代码对接，无需修改 Adapter
+- **RecyclerView 集成** — 预热加速 ViewHolder 首次创建
 - **DataBinding 支持** — `FastDataBinding` 兼容池化复用
 - **自定义回收策略** — `ViewRecyclePolicy` 接口，精确控制 View 状态清理
-- **内存压力响应** — 监听 trimMemory，分级清理池；Configuration 变化时自动清池
-
-## Roadmap
-
-- **Phase 1（当前）** — 运行时 View 池 + 智能预热 + 异步 inflate + 热点追踪 + 自适应调优
-- **Phase 2** — Gradle Plugin 编译期代码生成，覆盖 Top-N 热点布局
-- **Phase 3** — Native 属性表（mmap 二进制 blob）+ JNI 共享资源缓存
-
-## Modules
-
-- `lib/` — FastInflater 核心库
-- `compiler/` — Gradle Plugin，编译期 codegen（Phase 2，实验性）
-- `demo/` — 示例应用，包含 benchmark 和热点布局报告
+- **内存压力响应** — 监听 trimMemory 分级清理；Configuration 变化自动清池
 
 ## Quick Start
 
-### 基础用法
+### 初始化 + 预热
 
 ```kotlin
 // Application.onCreate
@@ -107,42 +55,43 @@ FastInflater.get().warmUp(this, listOf(
     ViewPool.WarmUpEntry(R.layout.item_comment, count = 3),
 ))
 
-// inflate（池命中时零耗时）
+// 包含 ComposeView/WebView 的布局，标记为主线程预热
+FastInflater.get().markAsMainThreadOnly(R.layout.fragment_compose)
+```
+
+### inflate + 回收
+
+```kotlin
+// 池命中时零耗时
 val view = FastInflater.get().inflate(context, R.layout.item_feed, parent)
 
-// 回收（View 不再使用时）
+// View 不再使用时回收进池
 FastInflater.get().recycle(R.layout.item_feed, view)
 
-// 异步 inflate（池优先，未命中时后台线程 inflate）
+// 异步 inflate（池优先，未命中时后台 inflate，主线程回调）
 FastInflater.get().inflateAsync(context, R.layout.item_feed, parent) { view ->
     parent.addView(view)
 }
 ```
 
 ### RecyclerView 集成
 
-预热 + 一行代码安装：
-
 ```kotlin
+// 预热 + 安装
 FastRecycledViewPool.install(recyclerView, warmUpLayouts = listOf(
     ViewPool.WarmUpEntry(R.layout.item_feed, 4)
 ))
-```
 
-Adapter 中让 `viewType == layoutId`，`onCreateViewHolder` 通过 FastInflater 创建 View。
-预热池有缓存时直接返回，无需 inflate：
-
-```kotlin
+// Adapter 中让 viewType == layoutId
 override fun getItemViewType(position: Int) = R.layout.item_feed
 
 override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyViewHolder {
-    // 池命中时零耗时，未命中时正常 inflate
     val view = FastInflater.get().inflate(parent, viewType)
     return MyViewHolder(view)
 }
 ```
 
-设计原则：RecyclerView 自身的回收机制不变，FastInflater 只在"创建侧"加速——不会出现同一个 View 被两个池同时持有的问题。
+FastInflater 只在创建侧加速，不参与 RecyclerView 的回收流程，不会出现双池冲突。
 
 ### DataBinding
 
@@ -154,8 +103,6 @@ val binding = FastDataBinding.inflate<ItemFeedBinding>(
 
 ### 自定义回收策略
 
-对于有复杂内部状态的布局，提供自定义清理逻辑：
-
 ```kotlin
 FastInflater.get().registerPolicy(R.layout.item_feed, object : ViewRecyclePolicy {
     override fun onRecycle(view: View) {
@@ -168,22 +115,6 @@ FastInflater.get().registerPolicy(R.layout.item_feed, object : ViewRecyclePolicy
 })
 ```
 
-### 自适应池大小
-
-运行一段时间后，根据实际数据自动调优：
-
-```kotlin
-// 建议在 app 运行 3~5 分钟后调用
-FastInflater.get().autoTune()
-```
-
-也可以手动设置单个布局的池大小：
-
-```kotlin
-FastInflater.get().setMaxPoolSize(R.layout.item_feed, 8)
-FastInflater.get().setMaxPoolSize(R.layout.activity_detail, 2)
-```
-
 ## 监控与调优
 
 ### 热点布局追踪
@@ -195,7 +126,7 @@ InflateTracker.setReporter { stats ->
         .take(20)
         .forEach { (id, stat) ->
             val name = resources.getResourceEntryName(id)
-            Log.d("Inflate", "$name count=${stat.count.get()} avg=${stat.avgMs}ms avgUs=${stat.avgUs}us")
+            Log.d("Inflate", "$name count=${stat.count.get()} avg=${stat.avgMs}ms")
         }
 }
 
@@ -205,49 +136,45 @@ InflateTracker.report()
 ### 池命中率
 
 ```kotlin
-// 全局命中率
 Log.d("Pool", "hit rate: ${(PoolStats.hitRate * 100).toInt()}%")
-
-// 单个布局
-Log.d("Pool", "item_feed hit rate: ${(PoolStats.hitRateFor(R.layout.item_feed) * 100).toInt()}%")
-
-// 详细数据
-PoolStats.snapshot().forEach { (layoutId, stat) ->
-    Log.d("Pool", "layout=$layoutId hits=${stat.hits.get()} misses=${stat.misses.get()}")
-}
+Log.d("Pool", "item_feed: ${(PoolStats.hitRateFor(R.layout.item_feed) * 100).toInt()}%")
 ```
 
 **调优参考：**
-- 命中率 < 50%：预热数量不足或池太小，增加 warmUp count 或调大 maxPoolSize
+- 命中率 < 50%：预热数量不足或池太小
 - 命中率 > 90%：池化充分发挥作用
-- 命中率 100% 且池经常满：可以适当减小池大小，节省内存
+- 命中率 100% 且池经常满：可以适当减小池大小节省内存
 
-### 主线程依赖的布局
+### 自适应池大小
 
-部分 View 不能在后台线程 inflate（构造或 attach 流程会访问 LiveData/Lifecycle）：
+```kotlin
+// 运行 3~5 分钟后，根据实际数据自动调优
+FastInflater.get().autoTune()
 
-- `androidx.compose.ui.platform.ComposeView`
-- `WebView` / `SurfaceView` / `TextureView`
-- 自定义 View 在初始化时调用 `liveData.observe()` / `liveData.removeObserver()`
+// 或手动设置
+FastInflater.get().setMaxPoolSize(R.layout.item_feed, 8)
+```
 
-**自动检测**：FastInflater 后台 inflate 失败时会自动捕获异常、标记该布局，剩余预热数量降级到主线程 IdleHandler，后续 `warmUp` 和 `inflateAsync` 也会直接走主线程。
+### 主线程依赖的布局
 
-**显式标记**（推荐，避免一次后台失败的开销）：
+部分 View 不能后台 inflate（ComposeView、WebView、含 LiveData 的自定义 View）。FastInflater 会自动检测并降级到主线程 IdleHandler，也可以预先标记：
 
 ```kotlin
 FastInflater.get().markAsMainThreadOnly(R.layout.fragment_compose_view)
-```
-
-**监听降级事件**：
 
-```kotlin
+// 监听降级事件
 FastInflater.get().setWarmUpListener(object : ViewPool.WarmUpListener {
     override fun onBackgroundInflateFailed(layoutId: Int, error: Throwable) {
-        Log.w("FastInflater", "fallback to main thread: ${resources.getResourceEntryName(layoutId)}", error)
-    }
-    override fun onMarkedAsMainThreadOnly(layoutId: Int) {
-        Log.i("FastInflater", "marked main-thread-only: ${resources.getResourceEntryName(layoutId)}")
+        Log.w("FastInflater", "fallback: ${resources.getResourceEntryName(layoutId)}")
     }
 })
 ```
 
+## Modules
+
+- `lib/` — FastInflater 核心库
+- `demo/` — 示例应用，包含 benchmark 和热点布局报告
+
+## License
+
+Apache 2.0