docs: 全面更新README，同步最新UI架构与部署状态

README.md

@@ -39,8 +39,11 @@ PregoPal 是一款面向孕期家庭的 AI 陪护工具，支持：
 | 🍽️ 今日菜品推荐（营养+家庭能力） | 基线可用 | `modules/meal_recommender.py` |
 | 📝 饮食记录储存（JSON + Markdown） | 已实现 | `modules/diet_logger.py` + `modules/diet_extractor.py` |
 | 📊 营养分析与可视化报告 | 基线可用 | `modules/nutrition_analyzer.py` + `modules/nutrition_standards.py` |
+| 🤖 多模态大模型后端（MiniCPM-o 4.5） | ✅ 已部署 Modal | `modal_deploy/deploy.py` + `modal_deploy/client.py` |
 
-**技术栈**: Python 3.13 · Gradio 6.16 · MiniCPM-o 4.5 · Matplotlib · Pandas
+**技术栈**: Python 3.13 · Gradio 6.16 · MiniCPM-o 4.5 · Modal · Matplotlib · Pandas
+
+**大模型部署状态**：✅ 已完成，详见 [第11节](#11-多模态大模型部署-modal)
 
 ---
 
@@ -48,7 +51,7 @@ PregoPal 是一款面向孕期家庭的 AI 陪护工具，支持：
 
 ```
 app.py                          ← Gradio 薄入口
-├── ui/app_builder.py           ← 前端 Tab 布局（4 Tab: 首页/家庭/总结/报告）
+├── ui/app_builder.py           ← 前端 Tab 布局（3 Tab: 首页/家庭/营养报告）
 ├── loop.py                     ← 每日自动分析循环（状态机）
 │   ├── plugins/base.py         ← 插件基类（LoopPlugin, PluginRegistry, LoopContext）
 │   ├── plugins/family_quiz.py  ← 家庭问卷插件（菜谱/体重检查）
@@ -57,7 +60,7 @@ app.py                          ← Gradio 薄入口
 │   ├── plugins/family_memory.py← 家庭记忆处理
 │   ├── plugins/dri_analysis.py ← DRIs 营养对比分析
 │   ├── plugins/briefing_generator.py ← 今日简报生成
-│   ├── plugins/three_day_summary.py  ← 每三天综合总结
+│   ├── plugins/three_day_summary.py  ← 三天深度缺失分析（数据由营养报告Tab调用）
 │   └── plugins/preset_writer.py      ← 预设/缓存写入
 ├── modules/                    ← 核心业务逻辑（纯函数/无状态）
 │   ├── voiceprint.py           ← 声纹识别
@@ -73,7 +76,10 @@ app.py                          ← Gradio 薄入口
 │       ├── vision_processor.py ← 视觉处理
 │       └── conversation_manager.py ← 对话管理
 ├── config.py                   ← 全局配置（路径/常量/数据模板）
-├── utils.py                    ← 工具函数（CSS/翻译/HTML渲染/中文字体设置）
+├── utils.py                    ← 工具函数（CSS/翻译/HTML渲染/营养报告+三天缺失分析）
+├── modal_deploy/               ← Modal 部署层
+│   ├── deploy.py               ← Modal ASGI 部署入口（llama-server → FastAPI）
+│   └── client.py               ← Python API 客户端（chat / chat_with_image / embed）
 └── data/                       ← 持久化存储
     ├── diet_logs.json          ← 结构化饮食记录 JSON
     ├── nutrition_db.json       ← 营养数据库 JSON
@@ -424,7 +430,7 @@ class LoopPlugin(ABC):
 | `FamilyMemoryPlugin` | `SUMMARIZE` | `plugins/family_memory.py` | 提取家庭记忆 |
 | `DRIAnalysisPlugin` | `ANALYZE` | `plugins/dri_analysis.py` | DRIs 营养对比 |
 | `BriefingGeneratorPlugin` | `BRIEF` | `plugins/briefing_generator.py` | 汇总生成今日简报 |
-| `ThreeDaySummaryPlugin` | `THREE_DAY` | `plugins/three_day_summary.py` | 三天综合总结 |
+| `ThreeDaySummaryPlugin` | `THREE_DAY` | `plugins/three_day_summary.py` | 三天深度缺失分析（被营养报告Tab调用） |
 | `PresetWriterPlugin` | `CONSOLIDATE` | `plugins/preset_writer.py` | 写入预设/缓存 |
 
 **插件向 `ctx.briefing` 写入的 key**（`BriefingGeneratorPlugin` 最终消费）:
@@ -440,6 +446,7 @@ ctx.briefing["dri_analysis"]           # dict {"focus_nutrients","summary"}
 ctx.briefing["recommended_foods"]      # list[str]
 ctx.briefing["family_memory"]          # dict
 ctx.briefing["thinking_keywords"]      # str
+ctx.briefing["three_day_summary"]      # dict（由报告Tab选择性地读取）
 ```
 
 ---
@@ -480,11 +487,15 @@ ctx.briefing["thinking_keywords"]      # str
 
 ```
 Cline A: Modules 强化（营养分析对接 DRIs、菜谱推荐 AI 化）
-Cline B: UI 界面优化（Gradio 前端增强、报告模板美化） ← 当前 Cline
+Cline B: UI 界面优化（Gradio 前端增强、报告模板美化）           ← 当前 Cline
 Cline C: 声纹升级（Whisper encoder 替换频谱特征）
 Cline D: 数据处理与插件增强（diet_extractor fallback、新插件）
+Cline E: 大模型集成（对接 Modal API，实现全双工语音对话）        ← 新增（部署已完成）
 ```
 
+> 注：MiniCPM-o 4.5 已在 Modal 完成部署，API 客户端 `modal_deploy/client.py` 已就绪。
+> 接下来可并行推进：A) 前端接入大模型  B) 营养分析对接 DRIs  C) 声纹升级。
+
 ### 7.2 关键约定
 
 1. **改接口前先 grep**：用 `search_files` 搜索方法名找到所有调用方
@@ -539,28 +550,37 @@ chore: 配置/依赖/路径调整
 
 ### 8.1 页面结构
 
-4 Tab 布局，使用 **唯一一个 `@gr.render`** 包裹全部 Tab（避免 Gradio 内部字典迭代崩溃）：
+3 Tab 布局，使用 **唯一一个 `@gr.render`** 包裹全部 Tab（避免 Gradio 内部字典迭代崩溃）：
 
 | Tab | ID | 功能 |
 |-----|----|------|
 | 🏠 首页 | `tab_home` | 语音按钮 + AI 思考 + 信息卡片 + 最近记录 |
 | 👨‍👩‍👧‍👦 家庭 | `tab_family` | 家庭菜谱/偏好/记事 HTML 卡片展示 |
-| 📊 总结 | `tab_summary` | 三天营养分析 + 菜单建议 |
-| 📈 报告 | `tab_report` | 纯 HTML 营养仪表盘（无需 matplotlib） |
+| 📈 营养报告 | `tab_report` | 纯 HTML 营养仪表盘 + 三天缺失深度分析（已合并） |
+
+> **架构变更说明**（v2.0）：
+> - 原「三天总结」Tab **已合并到营养报告 Tab** 中，作为一个统一下沉展示区块
+> - 营养报告使用 Slider 防抖自动生成（0.8s），包含基础营养评分 + 三天缺失深度分析
+> - 三天缺失分析页面使用与营养报告一致的设计语言（渐变 Header + 紧凑标签 + 结构化 Summary）
 
 ### 8.2 设计风格
 
 - **Glassmorphism 毛玻璃**：`backdrop-filter: blur(20px)` 半透明卡片
 - **粉色暖调主题**：主色 `#E91E63`、渐变 `#FF6B9D → #FFD6E0`
-- **纯 HTML 渲染**：家庭信息卡、营养报告均使用 HTML + CSS，无需生成图片
+- **纯 HTML 渲染**：家庭信息卡、营养报告、三天缺失分析均使用 HTML + CSS，无需生成图片
 - **中英文切换**：`lang_state` 驱动唯一 `@gr.render`
+- **三天缺失分析**：
+  - 持续不足营养素采用**紧凑标签式**显示（pill 标签，一行多个）
+  - 食材补充建议区域采用 **1:2 扩大布局**（右侧占 2/3 宽度，每行 6 个食物标签）
+  - 总结部分采用**结构化 UI 卡片**（红色/橙色/绿色 左侧边框，按严重程度分类显示）
 
 ### 8.3 关键文件
 
 | 文件 | 职责 |
 |------|------|
-| `ui/app_builder.py` | Gradio 界面构建（4 Tab + 语言切换） |
-| `utils.py` | CSS 定义 + 翻译字典 + HTML 渲染函数（家庭卡片 + 营养仪表盘） |
+| `ui/app_builder.py` | Gradio 界面构建（3 Tab + 语言切换 + 报告自动生成） |
+| `utils.py` | CSS 定义 + 翻译字典 + HTML 渲染函数（家庭卡片 + 营养仪表盘 + 三天缺失分析） |
+| `plugins/three_day_summary.py` | 三天缺失分析插件（数据层，被报告 Tab 异步调用） |
 
 ---
 
@@ -588,8 +608,64 @@ Model to be Used: MiniCPM-o 4.5
 
 核心能力层（`core/` 目录）提供模型加载、语音处理、视觉处理、对话管理的底层能力封装。详见各文件 docstring。
 
+**部署状态**: ✅ 已完成 Modal 部署（见第11节）
+
+---
+
+## 11. 多模态大模型部署 (Modal)
+
+### 11.1 部署状态
+
+| 项目 | 状态 |
+|------|------|
+| API URL | `https://andrew-jiabin--prego-pal-minicpm-serve.modal.run` |
+| Modal App | `prego-pal-minicpm` |
+| GPU | A100 (40GB) |
+| 模型 | MiniCPM-o 4.5 Q4_K_M (~12GB) + vision/audio/TTS 投影层 |
+| 冷启动 | ~2-8 分钟（首次请求触发容器启动 + 模型加载） |
+| 闲置缩容 | 300s 无请求自动缩容 |
+| 并发 | `max_inputs=10` |
+
+### 11.2 API 端点
+
+| 端点 | 方法 | 功能 |
+|------|------|------|
+| `/v1/chat/completions` | POST | OpenAI 兼容聊天（文本） |
+| `/v1/embeddings` | POST | 文本嵌入 |
+| `/v1/models` | GET | 模型列表 |
+| `/v1/multimodal/chat` | POST | 多模态（图片+文本） |
+| `/health` | GET | 健康检查 |
+| `/` | GET | 服务信息 |
+
+### 11.3 Python 客户端
+
+```python
+from modal_deploy.client import MiniCPMClient
+
+client = MiniCPMClient(base_url="https://andrew-jiabin--prego-pal-minicpm-serve.modal.run")
+
+# 文本对话
+response = client.ask("今天孕妇可以吃什么？")
+
+# 多模态（图片理解）
+response = client.describe_image(image_base64_str)
+
+# 嵌入向量
+embeddings = client.embed(["孕期饮食建议", "番茄牛腩"])
+```
+
+详见 `modal_deploy/client.py` 完整文档。
+
+### 11.4 部署文件
+
+| 文件 | 说明 |
+|------|------|
+| `modal_deploy/deploy.py` | Modal ASGI 部署入口（llama-server → FastAPI 包装） |
+| `modal_deploy/client.py` | Python API 客户端（chat / chat_with_image / embed） |
+| `docs/部署经验_Modal_MiniCPM-o.md` | 详细部署经验文档（踩坑记录、成本估算、后续优化） |
+
 ---
 
-*最后更新: 2026-06-09 | 由 PregoPal Cline 团队维护*
+*最后更新: 2026-06-10 | 由 PregoPal Cline 团队维护*
 
 > **⚠️ 重要提醒**：本 README 是所有并行 Cline 的协作基础，任何 Cline 在修改代码后，若涉及接口、数据格式、配置的变更，必须同步更新本文件。不得随意简化、删除结构性内容。