diff --git a/docs/readme-optimization-analysis.md b/docs/readme-optimization-analysis.md
index a4c5be72b..8fa23ec33 100644
--- a/docs/readme-optimization-analysis.md
+++ b/docs/readme-optimization-analysis.md
@@ -1,107 +1,168 @@
-# README.md 优化分析（内容与展示）
+# README.md 改版方案（可直接对比）
 
-本文基于仓库根目录 `README.md` 当前内容，从信息架构、可读性、转化路径、维护成本等角度给出优化建议。
+> 目标：不是只做问题分析，而是给出可落地、可对比、可直接执行的 README 改版方案。
 
-## 一、现状亮点
+## 0. 现状简述（基于当前 README）
 
-1. **权威性强**：徽章、版本、构建状态、社区奖项、案例、贡献者信息完整。
-2. **覆盖面广**：对模块、版本策略、HTTP 客户端选择都做了说明。
-3. **社区导向明显**：有交流群、问题反馈路径、贡献指南入口。
+当前 README 信息很全（徽章、版本、模块、交流群、案例、贡献者等），但新用户首屏的“上手路径”不够聚焦。核心问题是：**信息完整 > 任务导向**，导致首次访问者很难在 3 分钟内完成“选模块 + 引依赖 + 跑通最小功能”。
 
-## 二、主要可优化点
+---
 
-## 1) 信息架构：入口信息被“长内容”稀释
+## 方案 A：轻量优化（最小改动，低风险）
 
-- 当前前半段有大量“重要信息/其他说明/赞助展示”，但新用户最关心的“我该怎么 3 分钟跑起来”入口不够靠前。
-- 建议把首页改成“漏斗结构”：
-  1. 你是什么（项目定位）
-  2. 我该选哪个模块（模块选择矩阵）
-  3. 我如何快速接入（3 步示例）
-  4. 常见坑（FAQ Top 5）
-  5. 深入链接（Wiki、Demo、Javadoc）
+### 适用场景
+- 希望**尽量不改原有内容**；
+- 希望一周内快速上线；
+- 对现有社区内容、赞助区块位置不做大调整。
 
-## 2) 首屏展示：品牌信息强，但任务导向弱
+### 核心动作
+1. 在 README 顶部新增目录（TOC）。
+2. 在首屏徽章后新增“3 分钟快速开始”。
+3. 新增“我该选哪个模块”表格（场景 -> artifactId）。
+4. 保留原“重要信息/其他说明”，仅做分组和精简。
 
-- 徽章、推荐卡、赞助内容占据首屏较大区域。
-- 建议在首屏增加 `快速开始` 区块（最多 10 行），例如：
-  - 选择模块（支付 / 小程序 / 公众号 / 企业微信 / 开放平台 / 视频号）
-  - Maven 坐标
-  - 最小代码片段
-  - 文档入口
+### 优点
+- 改动小、合并风险低；
+- 不打破老用户阅读习惯；
+- 快速提升新手转化。
 
-## 3) 新手路径：缺少“场景→模块”决策表
+### 缺点
+- 结构层面的历史包袱仍在；
+- 文档总体长度依旧偏长。
 
-- README 已解释 `weixin-java-open` 与移动端 SDK 的边界，但分散在 Maven 章节里。
-- 建议新增“**我该用哪个模块？**”表格，按业务场景列出：
-  - 登录授权
-  - 支付
-  - 公众号消息
-  - 企业微信通讯录
-  - 小程序 API
-  - 第三方平台代理
+### 预计工作量
+- 0.5 ~ 1 天。
 
-## 4) 示例策略：有依赖配置，但缺“端到端最小可运行样例”
+---
 
-- 当前有依赖与 HTTP 客户端配置说明，但缺 1 个完整最小示例（如公众号获取 access token）。
-- 建议每个核心模块给 8~20 行最小示例，并统一放在折叠块中。
+## 方案 B：中度重构（推荐）
 
-## 5) 可维护性：时间敏感信息硬编码较多
+### 适用场景
+- 希望兼顾新手体验与历史信息保留；
+- 愿意做一次有节奏的 README 重排；
+- 接受“内容分层+折叠”的结构变化。
 
-- 如“2026-01-03 发布 4.8.0 正式版”。
-- 建议把动态信息尽量改为自动徽章或外链，减少手动维护。
+### 核心动作
+1. 重排为“任务漏斗结构”：
+   - 项目简介
+   - 快速开始
+   - 模块选择
+   - 安装与版本
+   - 最小示例
+   - FAQ
+   - 社区与贡献
+   - 赞助与案例（折叠）
+2. 将“重要信息 / 其他说明”合并为：
+   - 新手必读
+   - 提问前检查
+   - 参与贡献
+3. 增加每个核心模块 8~20 行最小示例（先放 2 个代表模块也可）。
+4. 时间敏感内容改为动态链接/徽章（减少手工维护）。
 
-## 6) 可读性：段落信息密度高，扫描成本偏高
+### 优点
+- 新手上手路径明显改善；
+- 老信息依然可查（通过折叠和分层保留）；
+- 维护成本下降。
 
-- “重要信息/其他说明”有很多长句，且包含多重括号。
-- 建议：
-  - 单条不超过 2 行
-  - 每条只保留一个动作（阅读 Wiki / 提 Issue / 入群方式）
-  - 使用小标题分组：`新手必读`、`提问前检查`、`参与贡献`
+### 缺点
+- 需要一次性重排，评审成本中等；
+- 对旧版阅读习惯有轻微影响。
 
-## 7) 展示一致性：Markdown 与 HTML 混用较重
+### 预计工作量
+- 1 ~ 2 天。
 
-- 赞助区大量 HTML table 在移动端展示兼容性一般。
-- 建议改为 Markdown 图片网格或简单列表，降低渲染差异。
+---
 
-## 8) 社区治理信息：可进一步产品化
+## 方案 C：深度改版（产品化文档首页）
 
-- 目前已有“提问的智慧”“Issue 入口”等。
-- 可新增“提问模板快捷链接”和“最小复现模板”入口，降低低质量问题处理成本。
+### 适用场景
+- 希望 README 充当“文档门户”；
+- 后续愿意持续维护文档指标与模板；
+- 可以接受较大改动与多次迭代。
 
-## 三、推荐改版结构（建议目录）
+### 核心动作
+1. README 只保留“导航型内容 + 最小样例”，把长文本拆到 `docs/`。
+2. 增加角色化入口：
+   - 新手接入
+   - 生产稳定性
+   - 多模块集成
+   - 贡献开发
+3. 增加 FAQ Top5 + 提问模板 + 最小复现模板。
+4. 建立“文档更新准则”（版本升级时检查清单）。
 
-1. 项目简介（1 段）
-2. 快速开始（3 分钟）
-3. 模块选择指南（表格）
-4. 安装与版本（Maven/Gradle）
-5. 最小示例（按模块折叠）
-6. 常见问题（Top 5）
-7. 社区与支持（Issue / Wiki / 群）
-8. 贡献方式
-9. 版本策略与变更日志入口
-10. 赞助与致谢（折叠）
+### 优点
+- 长期体验最佳；
+- 结构清晰、扩展性强；
+- 降低重复提问。
 
-## 四、优先级建议（按投入产出比）
+### 缺点
+- 改动最大；
+- 对维护协作要求更高。
 
-- **P0（本周可做）**
-  - 增加目录（TOC）
-  - 添加“快速开始”区块
-  - 添加“模块选择矩阵”
-- **P1（下个迭代）**
-  - 为核心模块补最小代码样例
-  - 精简“重要信息/其他说明”并分组
-- **P2（持续优化）**
-  - 收敛 HTML table，优化移动端阅读
-  - 维护自动化（版本信息徽章化）
+### 预计工作量
+- 3 ~ 5 天（按分阶段）。
 
-## 五、度量指标（建议）
+---
 
-- README 到 Wiki 点击率
-- README 到 Demo 点击率
-- 首次 Issue 中“已读文档”占比
-- 新手重复问题占比（优化前后对比）
-- Star / Fork 转化趋势
+## 对比结论（建议选择）
 
-## 六、一句话总结
+| 维度 | 方案 A 轻量优化 | 方案 B 中度重构（推荐） | 方案 C 深度改版 |
+|---|---|---|---|
+| 改动风险 | 低 | 中 | 高 |
+| 上手体验提升 | 中 | 高 | 很高 |
+| 历史兼容性 | 很高 | 高 | 中 |
+| 维护成本优化 | 低 | 中高 | 高 |
+| 落地速度 | 快 | 中 | 慢 |
 
-当前 README 已具备“信息全面”的优势，下一步应重点提升“新用户 3 分钟上手”能力与移动端扫描体验，使其从“资料汇总页”升级为“任务导向首页”。
+**建议优先选 B**：投入产出比最好，既能显著提升新用户体验，也不会过度扰动现有社区信息。
+
+---
+
+## 你可以直接拍板的执行版本（推荐：B1/B2）
+
+### B1（两步走，稳妥）
+- 第一步：只做结构重排 + 模块选择表 + 快速开始。
+- 第二步：补最小示例 + FAQ + 模板链接。
+
+### B2（一次到位）
+- 一次 PR 完成 B 方案全部动作，评审后合并。
+
+---
+
+## 可直接复用的 README 新目录模板
+
+```markdown
+## WxJava - 微信开发 Java SDK
+
+### 快速开始（3分钟）
+- 1) 选择模块
+- 2) 引入依赖
+- 3) 跑最小示例
+
+### 我该选哪个模块？
+| 场景 | 模块 |
+|---|---|
+| 公众号开发 | weixin-java-mp |
+| 小程序 | weixin-java-miniapp |
+| 微信支付 | weixin-java-pay |
+| 企业微信 | weixin-java-cp |
+| 开放平台/第三方平台 | weixin-java-open |
+| 视频号/微信小店 | weixin-java-channel |
+
+### 安装与版本
+### 最小示例
+### FAQ（提问前必读）
+### 社区与支持
+### 贡献指南
+### 赞助与致谢（可折叠）
+```
+
+---
+
+## 建议你现在怎么选
+
+- 如果你要**今天就改并发版**：选 **方案 A**。
+- 如果你要**本周改完且效果明显**：选 **方案 B（推荐）**。
+- 如果你要**把 README 变成长期文档门户**：选 **方案 C**。
+
+如果你确认方案（A/B/C 或 B1/B2），我下一步可以直接按你选的方案改 `README.md` 正文（不是分析文档），并给你一个可直接合并的版本。