---

  见素起名：异步并行生成与体验优化手册

  本手册涵盖 阶段 4：后端异步架构重构 与 前端“分批渲染”感知优化 的核心实现步骤。

  ---

  🚀 核心逻辑：从“排队”到“赛跑”
   - 优化前：请求一次 AI $\rightarrow$ 等待 AI 吐出 5 个名字 $\rightarrow$ 后端处理 $\rightarrow$ 返回（耗时 $T     
     \times 5$）。
   - 优化后：后端同时发起 5 个 AI 请求 $\rightarrow$ 谁先跑完谁先返回 $\rightarrow$ 前端分批展示（体感耗时 $\approx 
     T$）。

  ---

  第一部分：后端 - 高并发异步生成重构 (Java)

  第一步：配置专用线程池 (Safety)
  在 backend/src/main/java/com/jiansu/naming/config/AsyncConfig.java (需新建) 中配置。
   - [ ] 定义 ThreadPoolTaskExecutor，设置核心线程数（建议 10-20）和最大线程数。
   - [ ] 为线程设置清晰的前缀 jiansu-ai-，便于监控和排查。

  第二步：重构 MiniMaxService (Service)
   - [ ] 剥离单次逻辑：将原有的 AI 调用代码封装为私有方法 callAiToGenerateSingleName，确保其只负责生成 1 个 名字。  
   - [ ] 实现并发调度：
       - 使用 CompletableFuture.supplyAsync(..., executor) 发起 5 个并行任务。
       - 使用 CompletableFuture.allOf(...) 或 join() 合并结果集。
   - [ ] 异常容错：为单个任务添加 .exceptionally() 处理，确保即便某个 AI 请求失败，也不会导致整批请求崩溃。

  ---

  第二部分：前端 - “分批加载”感知优化 (MiniProgram)

  第三步：打造“意境感”加载页 (UI/UX)
  在 pages/index/index.wxml 中实现。
   - [ ] 增加 .loading-container 遮罩，背景采用极简白或微弱水墨色。
   - [ ] 实现动态文案区 .loading-text，用于展示加载语。
   - [ ] 视觉补偿：在 index.js 中设置 loadingQuote 定时器，每 2s 随机轮换文案（如：“正在翻阅《古今集成》...”）。    

  第四步：实现分批渲染逻辑 (Logic)
  在 pages/index/index.js 中修改 fetchNames。
   - [ ] 第一波（极速）：请求后端获取前 2 个名字。
   - [ ] 渲染首屏：拿到 2 个结果后立即关闭 Loading，让用户可以开始翻阅卡片。
   - [ ] 第二波（静默）：在首屏展示后，静默请求剩余的 3 个名字。
   - [ ] 数组合并：使用 [...this.data.nameList, ...secondBatch] 将新老数据平滑合并。

  ---

  第三部分：性能深度优化 (Advanced)

  第五步：音律分析延迟计算 (Optional)
   - [ ] 如果平仄音律分析 (ToneAnalysisService) 依然耗时较长，修改接口返回结构：
     - 先返回名字、出处和解析。
     - 音律分数字段初始返回 null 或 "计算中"。
     - 前端在用户翻转卡片到背面时，再根据名字发起一个微小的音律请求（或后端在并行任务中异步填充）。

  ---

  ✅ 验收与调试清单
   1. 耗时监控：在后端日志中打印 generateNamesAsync 的执行时间，确认是否在 3s 以内。
   2. 并发压力：同时开启 5 个并发请求时，观察 MiniMax API 是否触发频率限制（Rate Limit），必要时在自定义 Executor   
      中限制最大并发。
   3. 用户体感：
      - 是否在 1.5s 左右就看到了第一张名字卡片？
      - 翻阅前两张卡片后，后续的卡片是否已经静默加载完成？
   4. 稳定性：断网或 AI 接口报错时，前端是否能友好地显示“灵感中断”并允许重试。

  ---