全面更新系統功能和文檔

- 更新 AGENTS.md 文檔說明
- 修復 app.py 中的功能問題
- 優化 services/welcome.py 的歡迎邏輯
- 改進 static/frontend/index.html 的用戶界面

AGENTS.md

@@ -42,7 +42,7 @@
 - 對話：前端以 `/ws?token=JWT` 連上；訊息先經「語音綁定 FSM」攔截（若用語音綁定流程）→ 進入 `ChatPipeline` → 視意圖走 MCP 工具或一般聊天 → 落庫 `chats/messages`。
 - 檔案分析：`/api/upload-file` 或 `/api/analyze-file-base64`，文字/PDF/圖片分流到對應分析邏輯，底層仍透過 OpenAI。
 - 健康資料：建議透過 MCP `healthkit_tool` 查 Firestore（iOS 端直寫 `health_data`）。
-- 位置快照：前端成功取得瀏覽器定位時會透過 `env_snapshot` 送到 WebSocket；後端會自動寫入 Firestore 並呼叫 MCP `reverse_geocode` 反查地點，AI Prompt 只會顯示地點名稱（有 label）或地址（無 label），不再硬編碼地標。
+- 位置快照：前端成功取得瀏覽器定位時會透過 `env_snapshot` 送到 WebSocket；後端會自動寫入 Firestore 並呼叫 MCP `reverse_geocode` 反查地點，AI Prompt 只會顯示地點名稱（有 label）或地址（無 label），不再硬編碼地標。連線歡迎詞也會優先使用最近的 `tz`，避免問候時間錯亂。
 
 —
 

app.py

@@ -48,6 +48,7 @@ from core.database import (
     update_chat_title,
     delete_chat,
     save_chat_message,  # 寫入保持原樣
+    get_user_env_current,
 )
 # 使用優化版數據庫函數（帶快取）
 from core.database.optimized import (
@@ -701,9 +702,22 @@ async def websocket_endpoint_with_jwt(websocket: WebSocket, token: str = Query(N
         # 發送個性化歡迎消息（語音登入模式跳過）
         if not is_voice_login_mode:
             try:
+                tz_hint = None
+                try:
+                    env_res = await get_user_env_current(user_id)
+                    if env_res.get("success"):
+                        tz_hint = (env_res.get("context") or {}).get("tz")
+                except Exception as tz_err:
+                    logger.debug(f"讀取使用者時區失敗: {tz_err}")
+
                 td = app.state.feature_router.get_current_time_data()
                 # WebSocket 連線時沒有語音情緒，使用空字串
-                welcome_msg = compose_welcome(user_name=user_info.get('name'), time_data=td, emotion_label="")
+                welcome_msg = compose_welcome(
+                    user_name=user_info.get('name'),
+                    time_data=td,
+                    emotion_label="",
+                    timezone=tz_hint,
+                )
             except Exception as e:
                 logger.warning(f"生成歡迎訊息失敗: {e}")
                 welcome_msg = f"歡迎回來，{user_info['name']}！"
@@ -1087,7 +1101,19 @@ async def websocket_endpoint_with_jwt(websocket: WebSocket, token: str = Query(N
                                     name = user.get("name") or "用戶"
                                     emo = result.get("emotion") or {}
                                     emo_label = str(emo.get("label") or "")
-                                    welcome = compose_welcome(user_name=name, time_data=td, emotion_label=emo_label)
+                                    tz_hint = None
+                                    try:
+                                        env_res = await get_user_env_current(user_id)
+                                        if env_res.get("success"):
+                                            tz_hint = (env_res.get("context") or {}).get("tz")
+                                    except Exception as tz_err:
+                                        logger.debug(f"讀取使用者時區失敗: {tz_err}")
+                                    welcome = compose_welcome(
+                                        user_name=name,
+                                        time_data=td,
+                                        emotion_label=emo_label,
+                                        timezone=tz_hint,
+                                    )
                                 except Exception:
                                     welcome = None
 

services/welcome.py

@@ -1,6 +1,12 @@
 from __future__ import annotations
 
-from typing import Dict
+from datetime import datetime
+from typing import Dict, Optional
+
+try:
+    from zoneinfo import ZoneInfo  # Python 3.9+
+except Exception:  # pragma: no cover - zoneinfo may不可用
+    ZoneInfo = None  # type: ignore
 
 
 def _greet_from_period(period: str) -> str:
@@ -17,6 +23,24 @@ def _greet_from_period(period: str) -> str:
     return mapping.get(period, "您好")
 
 
+def _derive_period_from_hour(hour: int) -> str:
+    if 5 <= hour < 9:
+        return "早晨"
+    if 9 <= hour < 12:
+        return "上午"
+    if 12 <= hour < 14:
+        return "中午"
+    if 14 <= hour < 18:
+        return "下午"
+    if 18 <= hour < 20:
+        return "傍晚"
+    if 20 <= hour < 23:
+        return "晚上"
+    if 23 <= hour or hour < 2:
+        return "深夜"
+    return "凌晨"
+
+
 def _mood_from_emotion_label(emo_label: str) -> str:
     if not emo_label:
         return "很高興再次見到你！"
@@ -35,14 +59,33 @@ def _mood_from_emotion_label(emo_label: str) -> str:
     return "很高興再次見到你！"
 
 
-def compose_welcome(user_name: str, time_data: Dict, emotion_label: str) -> str:
+def compose_welcome(
+    user_name: str,
+    time_data: Dict,
+    emotion_label: str,
+    timezone: Optional[str] = None,
+) -> str:
     name = user_name or "用戶"
-    greet = _greet_from_period(str(time_data.get("day_period", "")))
-    month = time_data.get("month")
-    day = time_data.get("day")
-    weekday = time_data.get("weekday_full_chinese", "")
+    dt: Optional[datetime] = None
+
+    if timezone and ZoneInfo:
+        try:
+            dt = datetime.now(ZoneInfo(timezone))
+        except Exception:
+            dt = None
+
+    if dt is None:
+        dt = datetime.now()
+
+    day_period = _derive_period_from_hour(dt.hour)
+    greet = _greet_from_period(day_period)
+
+    month = dt.month
+    day = dt.day
+    weekday_list = ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期日"]
+    weekday = weekday_list[dt.weekday()]
+
     date_str = f"{month}月{day}號{weekday}"
     mood = _mood_from_emotion_label(str(emotion_label or ""))
     return f"{name}{greet}！今天是{date_str}，{mood}有什麼要與我分享呢？"
 
-

static/frontend/index.html

@@ -927,7 +927,8 @@
 
     /* === Agent 文字輸出區域（打字機效果）=== */
     .voice-agent-output {
-      width: min(100%, 520px);
+      width: 100%;
+      max-width: 600px;
       padding: 20px 28px;
       background: rgba(255, 255, 255, 0.98);
       border: 1px solid rgba(0, 0, 0, 0.1);