merge: 解决合并冲突

README.md

@@ -39,14 +39,14 @@ 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 · Modal · Matplotlib · Pandas
+
+**大模型部署状态**：✅ 已完成，详见 [第11节](#11-多模态大模型部署-modal)
+
 
-**技术栈**: Python 3.13 · Gradio 6.16 · MiniCPM-o 4.5 · llama-cpp-python (CUDA) · Modal T4 · Matplotlib · Pandas
 
-**模型部署**: MiniCPM-o-4_5 GGUF (Q4_K_M) on Modal (T4 GPU, $0.50/hr)
-- API 端点: `https://andrew-jiabin--prego-pal-minicpm-serve.modal.run`
-- 集成方式: `core/model_loader.py` ←HTTP→ Modal API (OpenAI 兼容)
-- 模型数据: Modal Volume `minicpm-o-4_5-models`（持久化，仅需上传一次）
-- 详见: `modal_deploy/README.md`
 
 ---
 
@@ -54,7 +54,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  ← 家庭问卷插件（菜谱/体重检查）
@@ -63,7 +63,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           ← 声纹识别
@@ -79,7 +79,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
@@ -430,7 +433,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` 最终消费）:
@@ -446,6 +449,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选择性地读取）
 ```
 
 ---
@@ -486,11 +490,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` 搜索方法名找到所有调用方
@@ -545,28 +553,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 异步调用） |
 
 ---
 
@@ -594,8 +611,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 | T4 (16GB) |
+| 模型 | 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 在修改代码后，若涉及接口、数据格式、配置的变更，必须同步更新本文件。不得随意简化、删除结构性内容。

ui/app_builder.py

@@ -31,7 +31,6 @@ from utils import (
     render_family_preferences_html,
     render_family_memories_html,
     render_nutrition_report_html,
-    render_three_day_deficit_section,
 )
 
 # ============================================================
@@ -334,13 +333,12 @@ def _report_content(lang):
         )
 
     def generate_full_report(days, trimester):
-        """生成营养报告 + 三天缺失深度分析，合并为同一份 HTML"""
+        """生成营养报告（含三天缺失深度分析，框架层面合并）"""
         # — 基础营养报告 —
         records = diet_logger.get_recent_records(days=int(days))
         analysis = nutrition_analyzer.analyze_diet(records)
-        main_html = render_nutrition_report_html(analysis, days=int(days), lang=lang)
 
-        # — 三天缺失深度分析（调用插件） —
+        # — 三天缺失深度分析（调用插件，数据传入 render_nutrition_report_html 统一渲染） —
         try:
             ctx = LoopContext()
             ctx.briefing["trimester"] = trimester
@@ -349,10 +347,8 @@ def _report_content(lang):
         except Exception:
             deficit_data = {}
 
-        # 添加深度分析板块
-        three_day_html = render_three_day_deficit_section(deficit_data, lang=lang)
-
-        return main_html + three_day_html
+        # 所有内容由 render_nutrition_report_html 统一渲染（框架层面合并）
+        return render_nutrition_report_html(analysis, days=int(days), lang=lang, deficit_data=deficit_data)
 
     def on_slider_change(days, trimester):
         """Slider/Radio 变化时防抖 0.8s 后生成报告"""

utils.py

@@ -57,7 +57,6 @@ ZH = {
     "app_subtitle": "一个温馨的家庭式孕期AI伴侣",
     "tab_home_suffix": "首页",
     "tab_family_suffix": "家庭饮食习惯",
-    "tab_summary_suffix": "三天总结",
     "tab_report_suffix": "营养报告",
     "chat_label": "💬 对话",
     "msg_placeholder": "例如：我今天中午吃了番茄牛腩",
@@ -102,20 +101,15 @@ ZH = {
     "report_diversity": "饮食多样性",
     "report_suggestions": "饮食建议",
     "report_days": "近{days}天",
-    "three_day_title": "📊 三天深度营养分析",
-    "three_day_subtitle": "基于近三日饮食趋势的持续缺失追踪",
+    # 三天深度分析（已合并到营养报告中）
+    "three_day_title": "📊 三天深度营养趋势",
+    "three_day_subtitle": "基于近三日饮食数据的持续缺失追踪",
     "three_day_days": "分析了 {days} 天数据",
     "three_day_duration": "持续不足的营养素",
-    "three_day_deficit": "缺失风险",
-    "three_day_attention": "需关注",
-    "three_day_good": "摄入达标",
     "three_day_suggestions": "🍽️ 食材补充建议",
-    "three_day_summary": "📋 总结",
+    "three_day_summary": "📋 趋势总结",
     "three_day_no_data": "近三天无饮食记录，跳过深度分析",
     "three_day_all_good": "✅ 各营养素摄入基本达标，继续保持！",
-    "three_day_def_critical": "❌",
-    "three_day_def_warning": "⚠️",
-    "three_day_def_ok": "✅",
 }
 
 EN = {
@@ -123,7 +117,6 @@ EN = {
     "app_subtitle": "A cozy home-oriented AI companion for expectant mothers",
     "tab_home_suffix": "Home",
     "tab_family_suffix": "Family Diet",
-    "tab_summary_suffix": "3-Day Summary",
     "tab_report_suffix": "Nutrition Report",
     "chat_label": "💬 Chat",
     "msg_placeholder": "e.g. I had tomato beef brisket for lunch today",
@@ -168,20 +161,15 @@ EN = {
     "report_diversity": "Diet Diversity",
     "report_suggestions": "Dietary Suggestions",
     "report_days": "Last {days} days",
-    "three_day_title": "📊 3-Day Deep Analysis",
-    "three_day_subtitle": "Continuous deficiency tracking based on recent diet trends",
+    # 三天深度分析（合并到营养报告中）
+    "three_day_title": "📊 3-Day Nutrient Trends",
+    "three_day_subtitle": "Continuous deficiency tracking based on recent diet data",
     "three_day_days": "Analyzed {days} days of data",
     "three_day_duration": "Persistent Deficits",
-    "three_day_deficit": "Deficit Risk",
-    "three_day_attention": "Needs Attention",
-    "three_day_good": "Adequate Intake",
     "three_day_suggestions": "🍽️ Food Suggestions",
-    "three_day_summary": "📋 Summary",
+    "three_day_summary": "📋 Trend Summary",
     "three_day_no_data": "No diet records in the last 3 days, skipping deep analysis",
     "three_day_all_good": "✅ All nutrients adequate, keep it up!",
-    "three_day_def_critical": "❌",
-    "three_day_def_warning": "⚠️",
-    "three_day_def_ok": "✅",
 }
 
 
@@ -335,11 +323,17 @@ def render_family_memories_html(lang="zh") -> str:
 
 
 # ============================================================
-# 营养报告 HTML
+# 营养报告 HTML（含三天深度分析）
+# ============================================================
+# 统一的设计令牌（Design Tokens）
+# Header: 粉色渐变 background:linear-gradient(135deg,#FCE4EC,#FFF0F2)
+# 卡片: background:#fff; border-radius:14px; box-shadow + border
+# 建议: background:linear-gradient(135deg,#FFF8E1,#FFFDE7); border:1px solid #FFE082
+# 强调色: #880E4F (深粉红), #E91E63 (粉红), #E65100 (橙)
 # ============================================================
 
-def render_nutrition_report_html(analysis: dict, days: int, lang="zh") -> str:
-    """渲染营养报告为现代 Dashboard HTML"""
+def render_nutrition_report_html(analysis: dict, days: int, lang="zh", deficit_data: dict = None) -> str:
+    """渲染营养报告为现代 Dashboard HTML（含三天深度趋势分析）"""
     if not analysis or "error" in analysis:
         return f'<div style="padding:40px;text-align:center;color:#aaa;font-size:16px;">{analysis.get("error","暂无数据")}</div>'
 
@@ -405,6 +399,11 @@ def render_nutrition_report_html(analysis: dict, days: int, lang="zh") -> str:
 
     days_str = t("report_days", lang).format(days=days)
 
+    # ============================================================
+    # 三天深度趋势分析（合并到营养报告内）
+    # ============================================================
+    three_day_html = _render_deficit_section(deficit_data, lang)
+
     return f"""
     <div style="font-family:system-ui,-apple-system,sans-serif;max-width:100%;">
         <!-- Header -->
@@ -459,49 +458,14 @@ def render_nutrition_report_html(analysis: dict, days: int, lang="zh") -> str:
             <div style="font-weight:600;font-size:14px;margin-bottom:6px;color:#E65100;">💡 {t("report_suggestions", lang)}</div>
             {sug_items if sug_items else '<div style="font-size:13px;color:#888;">暂无建议</div>'}
         </div>
-    </div>"""
 
+        <!-- ★ 三天深度趋势分析 — 使用与营养报告统一的UI设计 -->
+        {three_day_html}
 
-# ============================================================
-# 营养素中英文对照表（用于三天总结双语展示）
-# ============================================================
-
-NUTRIENT_EN_NAMES = {
-    "能量(MJ)": "Energy",
-    "蛋白质(g)": "Protein",
-    "钙(mg)": "Calcium",
-    "铁(mg)": "Iron",
-    "锌(mg)": "Zinc",
-    "维生素A(μg RAE)": "Vitamin A",
-    "维生素D(μg)": "Vitamin D",
-    "维生素E(mg α-TE)": "Vitamin E",
-    "维生素B1(mg)": "Vitamin B1",
-    "维生素B2(mg)": "Vitamin B2",
-    "叶酸(μg DFE)": "Folate",
-    "碘(μg)": "Iodine",
-    "镁(mg)": "Magnesium",
-    "硒(μg)": "Selenium",
-    "钾(mg)": "Potassium",
-    "钠(mg)": "Sodium",
-    "磷(mg)": "Phosphorus",
-    "维生素C(mg)": "Vitamin C",
-    "膳食纤维(g)": "Dietary Fiber",
-}
-
-
-def _nutrient_display(name_cn: str, lang: str) -> str:
-    """返回营养素名的展示文本（中文模式显示中文+英文，英文模式显示英文）"""
-    en_name = NUTRIENT_EN_NAMES.get(name_cn, name_cn)
-    if lang == "zh":
-        return f"{name_cn} / {en_name}"
-    return en_name
-
+    </div>"""
 
-# ============================================================
-# 三天缺失深度分析 HTML（与营养报告统一视觉风格）
-# ============================================================
 
-def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
+def _render_deficit_section(deficit_data: dict, lang="zh") -> str:
     """
     渲染三天缺失深度分析板块，与营养报告使用同一套现代UI视觉语言。
 
@@ -513,7 +477,7 @@ def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
         lang: 语言标识 "zh" / "en"
 
     Returns:
-        str: 纯 HTML 字符串，可直接拼接到营养报告之后
+        str: 纯 HTML 字符串，使用与营养报告统一的风格
     """
     if not deficit_data:
         return ""
@@ -532,7 +496,7 @@ def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
             {no_data_msg}
         </div>"""
 
-    # ——— Persistent Deficits: 紧凑标签式展示（取代大卡片） ———
+    # ——— Persistent Deficits: 紧凑标签式展示 ———
     deficit_tags = ""
     for nutrient in persistent_deficits:
         nd = _nutrient_display(nutrient, lang)
@@ -554,7 +518,7 @@ def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
             🎉 {all_good}
         </span>"""
 
-    # ——— Food Suggestions: 扩大展示（使用2/3宽度，每行2个食物标签） ———
+    # ——— Food Suggestions ———
     from modules.nutrition_standards import DRIsParser
     suggestion_rows = ""
     for nutrient in persistent_deficits[:3]:
@@ -583,11 +547,10 @@ def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
             🎉 {t("three_day_all_good", lang)}
         </div>"""
 
-    # ——— Summary: 覆盖折叠纯文本，解析后用结构化UI展示 ———
+    # ——— Summary: 结构化UI展示 ———
     summary_sections_html = ""
     if report_text:
         lines = report_text.strip().split("\n")
-        # 分类行
         critical_items = []
         warning_items = []
         ok_items = []
@@ -662,31 +625,30 @@ def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
 
     days_label = t("three_day_days", lang).format(days=days_analyzed)
 
-    # ——— 拼装最终 HTML ———
-    # 布局: 左右比例 1:2 (deficit : suggestions)
-    # summary 在下方单独一行，结构化展示
+    # ——— 拼装最终 HTML（使用与营养报告统一的设计语言） ———
     return f"""
-    <div style="margin-top:20px;font-family:system-ui,-apple-system,sans-serif;max-width:100%;">
+    <!-- 三天深度趋势分析 — 使用与营养报告一致的粉色渐变主题 -->
+    <div style="margin-top:20px;">
 
-        <!-- ★ Header: 与营养报告统一的渐变风格 -->
-        <div style="background:linear-gradient(135deg,#E8F5E9,#F1F8E9);border-radius:18px;padding:20px 24px;margin-bottom:16px;">
+        <!-- 头部：与营养报告Header统一的粉色渐变 -->
+        <div style="background:linear-gradient(135deg,#FCE4EC,#FFF0F2);border-radius:18px;padding:20px 24px;margin-bottom:16px;">
             <div style="display:flex;justify-content:space-between;align-items:center;">
                 <div>
-                    <div style="font-size:20px;font-weight:700;color:#1B5E20;">{t("three_day_title", lang)}</div>
+                    <div style="font-size:20px;font-weight:700;color:#880E4F;">{t("three_day_title", lang)}</div>
                     <div style="color:#888;font-size:13px;margin-top:4px;">{t("three_day_subtitle", lang)}</div>
                 </div>
                 <div style="text-align:right;">
-                    <div style="font-size:32px;font-weight:800;color:#4CAF50;">{days_analyzed}</div>
-                    <div style="font-size:12px;color:#888;">天</div>
+                    <div style="font-size:32px;font-weight:800;color:#E91E63;">{days_analyzed}</div>
+                    <div style="font-size:12px;color:#888;">{'天' if lang == 'zh' else 'days'}</div>
                 </div>
             </div>
             <div style="margin-top:8px;font-size:13px;color:#555;">{days_label}</div>
         </div>
 
-        <!-- 双列布局 1:2 → 左侧:紧凑标签式缺失营养素 | 右侧:放大的食材建议 -->
+        <!-- 双列布局 1:2 → 左侧:缺失营养素标签 | 右侧:食材建议 -->
         <div style="display:grid;grid-template-columns:1fr 2fr;gap:12px;margin-bottom:16px;">
 
-            <!-- 左侧：持续不足的营养素 — 紧凑标签风格 -->
+            <!-- 左侧：持续不足的营养素 — 与报告一致的白色卡片 -->
             <div style="background:#fff;border-radius:14px;padding:16px;
                         box-shadow:0 1px 6px rgba(0,0,0,0.04);border:1px solid #f0f0f0;">
                 <div style="font-weight:600;font-size:14px;margin-bottom:12px;color:#333;">
@@ -697,7 +659,7 @@ def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
                 </div>
             </div>
 
-            <!-- 右侧：食材补充建议 — 放大展示 -->
+            <!-- 右侧：食材补充建议 — 与报告建议区一致的金色渐变 -->
             <div style="background:linear-gradient(135deg,#FFF8E1,#FFFDE7);border-radius:14px;padding:16px 20px;
                         border:1px solid #FFE082;">
                 <div style="font-weight:600;font-size:15px;margin-bottom:12px;color:#E65100;">
@@ -708,7 +670,7 @@ def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
 
         </div>
 
-        <!-- 总结部分：结构化UI展示（替代纯文本折叠） -->
+        <!-- 总结部分：结构化UI展示 -->
         {f'''
         <div style="background:#fff;border-radius:14px;padding:16px 20px;
                     box-shadow:0 1px 6px rgba(0,0,0,0.04);border:1px solid #f0f0f0;">
@@ -722,6 +684,47 @@ def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
     </div>"""
 
 
+# 保留旧函数名作为代理（兼容外部调用），标记为 deprecated
+def render_three_day_deficit_section(deficit_data: dict, lang="zh") -> str:
+    """已弃用：三天分析已合并到 render_nutrition_report_html 中。保留此函数保持兼容。"""
+    return _render_deficit_section(deficit_data, lang)
+
+
+# ============================================================
+# 营养素中英文对照表
+# ============================================================
+
+NUTRIENT_EN_NAMES = {
+    "能量(MJ)": "Energy",
+    "蛋白质(g)": "Protein",
+    "钙(mg)": "Calcium",
+    "铁(mg)": "Iron",
+    "锌(mg)": "Zinc",
+    "维生素A(μg RAE)": "Vitamin A",
+    "维生素D(μg)": "Vitamin D",
+    "维生素E(mg α-TE)": "Vitamin E",
+    "维生素B1(mg)": "Vitamin B1",
+    "维生素B2(mg)": "Vitamin B2",
+    "叶酸(μg DFE)": "Folate",
+    "碘(μg)": "Iodine",
+    "镁(mg)": "Magnesium",
+    "硒(μg)": "Selenium",
+    "钾(mg)": "Potassium",
+    "钠(mg)": "Sodium",
+    "磷(mg)": "Phosphorus",
+    "维生素C(mg)": "Vitamin C",
+    "膳食纤维(g)": "Dietary Fiber",
+}
+
+
+def _nutrient_display(name_cn: str, lang: str) -> str:
+    """返回营养素名的展示文本（中文模式显示中文+英文，英文模式显示英文）"""
+    en_name = NUTRIENT_EN_NAMES.get(name_cn, name_cn)
+    if lang == "zh":
+        return f"{name_cn} / {en_name}"
+    return en_name
+
+
 # ============================================================
 # 自定义 CSS 样式
 # ============================================================