refactor: 合并三天总结到营养报告，移除独立Tab

app.py

@@ -29,7 +29,7 @@ if __name__ == "__main__":
     demo = create_app(loop)
     demo.launch(
         server_name="127.0.0.1",
-        server_port=7860,
+        server_port=7880,
         share=False,
         debug=False,
         css=CUSTOM_CSS,

docs/UI改进规划_用户反馈.md

@@ -0,0 +1,159 @@
+# PregoPal UI 改进规划 — 用户反馈汇总
+
+> 日期：2026-06-09
+> 负责：UI 设计 Cline
+
+---
+
+## 用户原始反馈（逐字保留）
+
+> 现在改成卡片式的确实好看一些了，但是卡片的布局不均匀。存在以下问题：
+
+### 1. 首页 — 语音提示文案
+> "全双工语音交互，边说边听"请改为直接到提示，用户不是工程师，没必要提示全双工这样的词语
+
+- **问题**：`tap_hint` 字段中使用了「全双工语音交互」这种工程师术语
+- **位置**：`utils.py` `_home_texts()` 第 52 行
+- **修改**：改为用户友好的提示，如「点击开始对话」/「Tap to talk」
+
+### 2. 首页 — 红色大按钮功能
+> 上面的红色大按钮怎么样才算是启动呢，这部分逻辑有设计吗？
+
+- **问题**：红色圆形按钮（`.voice-main-btn`）目前只是一个装饰性 HTML `<button>`，没有任何 `click` 事件绑定
+- **位置**：`ui/app_builder.py` 第 180-187 行
+- **现状**：纯 CSS 样式，没有实际的语音启动逻辑
+- **✅ 已决策**：用户要求真实语音对话启动，先用 `pass` 占位避免报错，设计好函数接口便于后续接入 Llama 大模型
+- **接口设计**：
+  ```python
+  async def start_voice_session(audio_data: bytes, lang: str = "zh") -> dict:
+      """
+      语音会话入口（当前 pass 占位，待接入 Llama 模型）
+      
+      Args:
+          audio_data: 原始音频数据（bytes）
+          lang: 语言标识 "zh" / "en"
+      
+      Returns:
+          dict: {
+              "text": str,           # ASR 转写文本
+              "response": str,       # AI 回复文本
+              "speaker": str,        # 识别出的说话人
+              "audio_response": bytes | None  # TTS 音频（可选）
+          }
+      """
+      pass
+  ```
+
+### 3. 首页 — AI 思考框 UI 问题
+> 下面的"🤔 AI 思考中... 等待对话中..."UI设计也有问题，外面还有个方框写着textbox，下方的所有内容都是两个框包着，是不是哪里逻辑不对；并且文字框内部是灰色，这明显不对
+
+- **问题 3a**：`gr.Textbox` 外层有 Gradio 默认的 "textbox" 标签边框
+- **问题 3b**：文本框内部背景是灰色（默认 textarea 样式）
+- **问题 3c**：下方内容区域被两层框包裹（可能是 `.home-card` + `.glass-card` 嵌套）
+- **位置**：`ui/app_builder.py` 第 189-196 行，以及 CSS `.thinking-box` 样式
+- **修改**：
+  - 将 `gr.Textbox` 改为 `gr.HTML` 或 `gr.Markdown` 来展示思考状态（去掉 textarea 外壳）
+  - 或者通过 CSS 彻底隐藏 textarea 的边框和灰色背景
+
+### 4. 顶部标题 — 缺乏英文和趣味字体
+> 页面最顶上的"孕期陪护AI助手 — 温馨的家庭式伴侣"请同时提供英文，并且尝试使用更有趣的字体
+
+- **问题**：顶部标题只有中文，没有英文副标题
+- **位置**：`ui/app_builder.py` 第 360-365 行（硬编码 HTML 字符串）
+- **修改**：
+  - 添加英文副标题：`Pregnancy Companion AI — Your Cozy Family Partner`
+  - 引入趣味字体（Google Fonts 圆体/手写体，如 `Nunito`、`Quicksand`、`Comic Neue` 或中文字体如站酷快乐体）
+
+### 5. 家庭饮食习惯 — 子页面默认状态
+> 请默认打开家庭菜谱这样子页面，而不是在最开始的时候三个都不打开，看起来像是卡住了一样
+
+- **问题**：三个子 Tab（菜谱/偏好/记忆）进入时全部折叠，看起来像页面卡住了
+- **位置**：`ui/app_builder.py` 第 240-263 行，`gr.Tabs()` 没有设置默认选中
+- **修改**：首次加载时默认显示「🍳 家庭菜谱」Tab
+
+### 6. 孕期阶段 — 嵌套边框问题
+> 孕期阶段也是显示不太对，黑色的文本框边缘外面还是黑色的文本框边缘
+
+- **问题**：嵌套的 Group 导致双层边框
+- **位置**：`ui/app_builder.py` 第 201-207 行，首页卡片行中的 `card-trimester`
+- **可能原因**：`gr.Group(elem_classes=["home-card", "card-trimester"])` 嵌套在 `gr.Column()` 内，Gradio 给每个 Grroup 都加了边框
+
+### 7. 营养报告 — Slider 无法拖动
+> 营养报告中，分析天数的进度条完全没法拖动
+
+- **问题**：`gr.Slider` 在 Gradio 中有时渲染为不可拖动的进度条
+- **位置**：`ui/app_builder.py` 第 321-325 行
+- **修改**：改为 `gr.Number` 输入框 + 手动输入天数，或使用 `gr.Slider` 的 `interactive=True`（需确认）
+
+### 8. 营养报告 — 右上角"刷新为7天"按钮多余
+> 右上角那个刷新为7天的可以去掉，没啥意义
+
+- **问题**：哪里来的"刷新为7天"按钮？可能在 `render_nutrition_report_html` 或 Slider 旁边
+- **待确认**：需要再查看报告 HTML 渲染代码
+
+### 9. 营养报告 — 布局问题
+> 此外这个页面UI布局也有问题，生成报告按钮占了页面的一半，下面全是空的，右边则是报告挤在一起
+
+- **问题**：`gr.Row()` 中 `scale=1`（左侧按钮+Slider）和 `scale=3`��右侧报告）比例不合理
+- **位置**：`ui/app_builder.py` 第 320-332 行
+- **修改**：
+  - 左侧：将 Slider 和按钮上下排列，占用更少宽度（scale=1）
+  - 右侧：报告占主导（scale=4 或 5）
+  - 或者改为上下布局：上方是 Slider，下方是全宽报告
+
+### 10. 营养报告 — 自动生成
+> 此外，没有必要"生成报告"这个按钮，每次分析天数被用户拉动的时候，等待用户不拉动之后就生成报告就是了
+
+- **问题**：需要点击「生成报告」按钮才能看到报告
+- **修改**：使用 `gr.Slider` 的 `.change()` 事件（带 debounce 防抖）自动触发报告生成，去掉「生成报告」按钮
+
+---
+
+## 待实施修改清单
+
+- [ ] **P0** 写规划 md 文档（本文档）— 防止上下文压缩丢失用户原话
+- [ ] **P1** 第 1 项：修改首页语音提示文案（去技术术语）
+- [ ] **P1** 第 3 项：修复 AI 思考框 UI（去掉 textarea 外壳+灰色背景）
+- [ ] **P1** 第 5 项：家庭饮食习惯默认打开「家庭菜谱」
+- [ ] **P1** 第 9 项 + 第 10 项：营养报告布局重构 + 自动生成
+- [ ] **P2** 第 4 项：顶部标题添加英文 + 趣味字体
+- [ ] **P2** 第 6 项：修复孕期阶段嵌套边框
+- [ ] **P2** 第 7 项：修复 Slider 拖动问题
+- [ ] **P2** 第 8 项：移除多余的"刷新为7天"
+- [ ] **P3** 第 2 项：红色按钮功能设计（需与用户讨论）
+
+---
+
+## 技术要点
+
+### 关于 gradio Slider 防抖自动生成
+```python
+# 使用 gradio 的 change 事件 + 手动防抖
+import time
+
+_last_change = [0]
+
+def on_slider_change(days):
+    _last_change[0] = time.time()
+    # 等待 0.8 秒后执行生成
+    ...
+```
+
+### 关于默认选中 Tab
+```python
+with gr.Tabs(selected=0):  # 或 selected="🍳 家庭菜谱"
+```
+
+### 关于改用 gr.HTML 代替 gr.Textbox 展示思考状态
+- 去掉 textarea 原生外壳
+- 保留渐变背景色由 HTML inline style 控制
+
+---
+
+## 文件修改范围
+
+| 文件 | 修改内容 |
+|------|----------|
+| `docs/UI改进规划_用户反馈.md` | 本文档（新建） |
+| `ui/app_builder.py` | 主要 UI 逻辑修改 |
+| `utils.py` | 文案修改（`_home_texts`、`CUSTOM_CSS`） |

ui/app_builder.py

@@ -1,20 +1,20 @@
 """
 PregoPal - Gradio 界面构建（现代UI版）
 ======================================
-4 个子页面 + 中英文切换：
+3 个子页面 + 中英文切换：
   1. 🏠 首页（语音启动按钮 + AI 思考 + 简报卡片 + 最近记录）
   2. 👨‍👩‍👧‍👦 家庭饮食习惯（纯展示卡片）
-  3. 📊 三天总结
-  4. 📈 营养报告（纯 HTML Dashboard）
+  3.  营养报告（含三天缺失深度分析，纯 HTML Dashboard）
 
 语言切换设计：
-  用唯一一个 @gr.render(inputs=[lang_state]) 包裹全部 4 个 Tab，
+  用唯一一个 @gr.render(inputs=[lang_state]) 包裹全部 3 个 Tab，
   避免多个 @gr.render 并发触发导致 Gradio 内部字典迭代崩溃。
 """
 
 import datetime
 import gradio as gr
 import time
+import asyncio
 
 from modules.voiceprint import VoiceprintManager
 from modules.meal_recommender import MealRecommender
@@ -23,12 +23,15 @@ from modules.nutrition_analyzer import NutritionAnalyzer
 from modules.family_manager import RecipeManager, PreferenceManager, MemoryManager
 from modules.diet_extractor import DietExtractor
 from modules.nutrition_standards import DRIsParser
+from plugins.three_day_summary import ThreeDaySummaryPlugin
+from plugins.base import LoopContext
 from utils import (
     t, ZH, EN, get_home_cards, CUSTOM_CSS,
     render_family_recipes_html,
     render_family_preferences_html,
     render_family_memories_html,
     render_nutrition_report_html,
+    render_three_day_deficit_section,
 )
 
 # ============================================================
@@ -301,94 +304,73 @@ def _family_content(lang):
 
 
 # ============================================================
-# Tab 3: 📊 三天总结
-# ============================================================
-def _summary_content(lang):
-    """三天总结组件"""
-    with gr.Row():
-        with gr.Column(scale=1):
-            trimester_select = gr.Radio(
-                label=t("trimester_label", lang),
-                choices=ZH["trimester_choices"] if lang == "zh" else EN["trimester_choices"],
-                value=ZH["trimester_choices"][1] if lang == "zh" else EN["trimester_choices"][1],
-            )
-            run_3day_btn = gr.Button(t("btn_analyze", lang), variant="primary")
-
-        with gr.Column(scale=2):
-            three_day_result = gr.Textbox(label=t("analysis_result", lang), interactive=False, lines=15)
-            menu_suggestion = gr.Textbox(label=t("menu_suggestion", lang), interactive=False, lines=4)
-
-    def run_three_day_summary(trimester):
-        from plugins.three_day_summary import ThreeDaySummaryPlugin
-        from plugins.base import LoopContext
-        import asyncio
-
-        ctx = LoopContext()
-        ctx.briefing["trimester"] = trimester
-        asyncio.run(ThreeDaySummaryPlugin().run(ctx))
-
-        report = ctx.briefing.get("three_day_summary", {}).get("report", "暂无数据")
-        deficits = ctx.briefing.get("three_day_summary", {}).get("persistent_deficits", [])
-
-        suggestions = []
-        if deficits:
-            suggestions.append("建议增加以下食材到家庭菜单：")
-            for n in deficits[:3]:
-                foods = DRIsParser.RICH_FOODS.get(n, [])
-                if foods:
-                    suggestions.append(f"  * {n} -> {'、'.join(foods[:4])}")
-        else:
-            suggestions.append("近三天营养状况良好！")
-
-        return report, "\n".join(suggestions)
-
-    run_3day_btn.click(
-        fn=run_three_day_summary,
-        inputs=[trimester_select],
-        outputs=[three_day_result, menu_suggestion],
-    )
-
-
-# ============================================================
-# Tab 4: 📈 营养报告（纯 HTML Dashboard，自动生成）
+# Tab 3: � 营养报告（含三天缺失深度分析，纯 HTML Dashboard）
 # ============================================================
 def _report_content(lang):
-    """营养报告组件 — 纯 HTML 可视化，Slider 防抖自动生成"""
+    """营养报告组件 — 纯 HTML 可视化 + 三天缺失分析，Slider 防抖自动生成"""
     # 防抖时间戳
     _last_change = [0.0]
 
     with gr.Column():
-        # Slider 全宽
-        analysis_days = gr.Slider(
-            label=t("analysis_days", lang),
-            minimum=1, maximum=30, value=7, step=1,
-            interactive=True,
-        )
+        # 控制栏：天数 + 孕期阶段（紧凑行）
+        with gr.Row():
+            with gr.Column(scale=2, min_width=200):
+                analysis_days = gr.Slider(
+                    label=t("analysis_days", lang),
+                    minimum=1, maximum=30, value=7, step=1,
+                    interactive=True,
+                )
+            with gr.Column(scale=1, min_width=160):
+                trimester_select = gr.Radio(
+                    label=t("trimester_label", lang),
+                    choices=ZH["trimester_choices"] if lang == "zh" else EN["trimester_choices"],
+                    value=ZH["trimester_choices"][1] if lang == "zh" else EN["trimester_choices"][1],
+                )
 
         # 报告全宽
         report_dashboard = gr.HTML(
             f'<div style="padding:40px;text-align:center;color:#bbb;font-size:16px;">'
-            f'调整上方天数自动生成报告</div>'
+            f'调整上方参数自动生成报告</div>'
         )
 
-    def generate_report(days):
+    def generate_full_report(days, trimester):
+        """生成营养报告 + 三天缺失深度分析，合并为同一份 HTML"""
+        # — 基础营养报告 —
         records = diet_logger.get_recent_records(days=int(days))
         analysis = nutrition_analyzer.analyze_diet(records)
-        return render_nutrition_report_html(analysis, days=int(days), lang=lang)
+        main_html = render_nutrition_report_html(analysis, days=int(days), lang=lang)
+
+        # — 三天缺失深度分析（调用插件） —
+        try:
+            ctx = LoopContext()
+            ctx.briefing["trimester"] = trimester
+            asyncio.run(ThreeDaySummaryPlugin().run(ctx))
+            deficit_data = ctx.briefing.get("three_day_summary", {})
+        except Exception:
+            deficit_data = {}
+
+        # 添加深度分析板块
+        three_day_html = render_three_day_deficit_section(deficit_data, lang=lang)
 
-    def on_slider_change(days):
-        """Slider 变化时防抖 0.8s 后生成报告"""
+        return main_html + three_day_html
+
+    def on_slider_change(days, trimester):
+        """Slider/Radio 变化时防抖 0.8s 后生成报告"""
         _last_change[0] = time.time()
-        # wait for debounce window
         time.sleep(0.8)
-        # if another change happened during sleep, skip
         if time.time() - _last_change[0] < 0.9:
-            return generate_report(days)
+            return generate_full_report(days, trimester)
         return gr.skip()
 
+    # 两个输入都触发重新生成
     analysis_days.change(
         fn=on_slider_change,
-        inputs=[analysis_days],
+        inputs=[analysis_days, trimester_select],
+        outputs=[report_dashboard],
+    )
+    trimester_select.change(
+        fn=on_slider_change,
+        inputs=[analysis_days, trimester_select],
         outputs=[report_dashboard],
     )
 
@@ -399,7 +381,7 @@ def _report_content(lang):
 
 def create_app(loop=None):
     """
-    创建主应用（4 Tab + 中英文切换 + 自定义 CSS）。
+    创建主应用（3 Tab + 中英文切换 + 自定义 CSS）。
     """
     with gr.Blocks(
         title="PregoPal - 孕期陪护AI助手",
@@ -450,12 +432,6 @@ def create_app(loop=None):
                 ):
                     _family_content(lang)
 
-                with gr.Tab(
-                    f"📊 {t('tab_summary_suffix', lang)}",
-                    id="tab_summary"
-                ):
-                    _summary_content(lang)
-
                 with gr.Tab(
                     f"📈 {t('tab_report_suffix', lang)}",
                     id="tab_report"