每日餐點規劃
在五個時段安排每一餐。追蹤飽腹感、標記日期類型，並以流暢動畫切換日期。每張卡片內嵌營養數據。
5 個時段
早餐 (6-9)、早午餐 (9-11)、午餐 (11-14)、下午茶 (14-17)、晚餐 (17-21)。時段範圍完全可自訂。
內嵌營養條
每張餐點卡片顯示卡路里、蛋白質、脂肪和碳水。計劃餐點欄位為空時會回退到範本值。
飽腹追蹤
點擊圓圈圖標記錄：1/4 飽、1/2 飽、3/4 飽或非常飽。數據隨餐點保存。
日期類型
將每天標記為一般、工作、假日或旅行。按情境追蹤飲食模式。
動畫新增/刪除
新餐點以彈性彈簧動畫進入。刪除時先淡出再由 SwiftData 持久化，保持介面流暢。
餐點照片
為計劃餐點附加照片。以壓縮格式同步儲存，本地快取，跨 iCloud 裝置同步。
智慧餐點庫
建立可重複使用的餐點範本集，包含完整營養數據、食材標籤、自訂圖示和智慧分類。預置數百道三語餐點。
7 種內建分類 + 自訂
中式、西式、日式、健康、甜點、飲品、其他。可用表情符號前綴建立自訂分類。
搜尋與篩選
FlowLayout 分類標籤、按名稱搜尋、按名稱/最新/最舊排序。所有條件組合使用，精準篩選結果。
7 種食材標籤欄位
成分、過敏原、添加劑、份量資訊、儲存方式、日期/批次、製造商。標籤式輸入。
10 項營養成分
卡路里、總脂肪、飽和脂肪、反式脂肪、膽固醇、鈉、碳水、纖維、糖、蛋白質。
自訂圖示
從精選食物表情中選擇，或從相簿選擇照片。圖示在所有位置顯示。
多語言預置名稱
預置餐點儲存英文、繁體中文和簡體中文名稱。自動顯示對應語言。
行事曆與儀表板
用月曆、色彩編碼的鈉指標、互動式卡路里圖表和全面的營養分析，視覺化你的飲食模式。
鈉含量色彩指標
綠色（≤1500mg）、黃色（1500-2300mg）、紅色（>2300mg）圓點顯示在每個日曆格上。
卡路里趨勢圖
帶漸層填充的動畫折線圖。滑動高亮單日，點擊查看詳細營養分析。
時間範圍選擇
今天、7 天或 30 天。摘要統計、分類分佈和趨勢圖隨選擇自動調整。
日期詳情面板
點擊日期查看按時段分組的餐點及卡路里。支援滑動編輯/刪除。
AI 營養目標
帶每日目標的卡路里進度環。根據實際活動量動態調整 HealthKit 數據。
體重記錄
每日體重記錄，含 BMI 計算、單位轉換（公斤/磅）和視覺趨勢圖表。
AI 照片餐點辨識
拍一張食物照片，AI 辨識菜餚、估算所有營養值，並記錄為計劃餐點。支援離線背景處理和自動重試。
相機或相簿
拍攝新照片或從相簿選擇。圖片壓縮為 JPEG 後由先進 AI 視覺 API 分析。
背景處理
分析在伺服器端透過 asyncio 執行。關閉應用程式仍繼續。PendingMealAnalysis 在 SwiftData 中持久化任務。
離線模式
NWPathMonitor 偵測網路連線。離線提交自動排隊，每 4 秒重試一次直到連線。
靈動島
Live Activity 在鎖定畫面和靈動島上顯示分析進度。失敗時立即結束。
煙火慶祝
成功時播放粒子爆發慶祝動畫。餐點自動建立，包含完整營養和食材數據。
編輯 AI 結果
辨識後，點擊鉛筆圖示請求修改：「改為素食」或「減少卡路里」。AI 重新生成。
AI 餐點建議與菜單掃描
根據 13 種健康狀況、7 種中醫體質、口味偏好和位置，取得個人化餐點推薦。或掃描餐廳菜單找到最適合你的菜餚。
健康狀況
13 種狀況：糖尿病、高血壓、心臟病、痛風、貧血、乳糖不耐症等。
中醫體質
7 種中醫體質類型：脾胃虛弱、氣血不足、陰虛火旺、濕熱等。
餐廳菜單掃描
上傳 1-5 張菜單照片。AI 回傳最佳配對 + 5 個替代方案，附理由、來源和健康備註。
位置感知
透過 CLGeocoder 自動偵測位置。AI 考慮當地料理和季節性食材。
食物適合性檢查
輸入食物名稱或上傳照片。AI 為你的健康評分 1-5。不適合時建議 5 個替代品。
Google 搜尋佐證
AI 透過即時網路搜尋驗證營養聲明。來源以可點擊連結和網站圖示顯示。
AI 營養對話
與 AI 營養師的完整對話介面。提問、分享食物照片，取得個人化餐點建議並直接「加入計劃」。
串流回應
對話文字以 Markdown 格式逐步串流。自動捲動跟隨生成。由先進 AI 驅動。
照片上傳
透過相簿或相機附加照片。圖片在本地檢查 10MB 限制、降低解析度並快取。
美食推薦卡片
當 AI 推薦食物時，內嵌搖擺風格卡片出現。點擊「加入計劃」直接進入餐點規劃。
個人資料脈絡
你的健康狀況、中醫體質、體重目標、位置和 5 天飲食歷史會自動注入。
Token 用量追蹤
透過 ChatTokenUsageManager 追蹤每月 Token 額度。與後端同步確保準確限制。
互動示範
未訂閱者可看到動畫模擬對話體驗，展示完整流程後顯示付費牆。
文字輸入與語音輸入
輸入食物名稱即時獲取卡路里估算（含 Google 搜尋佐證），或透過 Whisper 語音轉文字口述餐點。附近餐廳搜尋功能找到供應該食物的地方。
防抖卡路里估算
每次按鍵後 0.7 秒防抖。即時顯示食物名稱、卡路里、份量和信心度。
Google 搜尋來源
可摺疊的來源區塊，附網站圖示。點擊展開以驗證營養聲明。
語音輸入
點擊麥克風圖示錄音（最長 15 秒）。OpenAI Whisper 將語音轉文字。自動觸發估算。
餐廳探索
Google Maps 定位找到附近供應該食物的餐廳。顯示名稱、評分、營業時間、電話和導航。
位置感知精準度
在台北搜尋「蛋餅」和在紐約搜尋會得到不同結果。針對當地料理的區域精準度。
小工具、Siri、同步及更多
主畫面小工具、Siri 語音指令、iCloud 同步、週期性餐點、兩種設計主題、Live Activities 和推播通知，全方位體驗。
主畫面小工具
小型（卡路里環 + 餐點徽章）、中型（2 餐）、大型（3 餐）。手繪紙張風格美學。
Siri 整合
5 個 App Intent 語音指令。「新增一餐」、「我今天吃了什麼」等，透過 Siri 捷徑操作。
iCloud 同步
自動 CloudKit 同步至所有 Apple 裝置。無需帳號 - 使用你的 Apple ID。
週期性餐點
設定餐點每天或特定天（週一/三/五）自動填入。可個別啟用/停用。
兩種設計主題
手繪紙張風格（Kalam + Patrick Hand 字體）或毛玻璃風格（霧面玻璃搭配系統字體）。
每日提醒
早上（9:00）：記錄餐點。晚上（20:00）：為明天做計劃。可在設定中自訂。
隱私優先
核心功能無需帳號。資料儲存在本地。Apple/Google 登入僅用於 AI 和訂閱功能。
AI 餐點評分
每個用餐時段結束時，MenuMeld 的 AI 會自動為你吃的食物評分 — 從 0 到 100 分 — 並提供各項標準回饋、改善建議與激勵訊息。完全自動，無需動手。
0–100 品質分數
整體品質評估，非星級。分數對應色彩環：紅 (0-29) → 橙 (30-49) → 金 (50-69) → 綠 (70-84) → 皇冠 (85-100)。
最多 5 項評分標準
蛋白質、複合碳水、健康脂肪、蔬果、水分。每項都有獨立的 0–100 分與動畫進度條。
改善建議
AI 建議下次應該加入的具體食物 — 依你的健康資料、中醫體質和語言量身打造。
激勵訊息
「出色的早餐！你正像冠軍一樣為自己加油。」支援英文、繁體中文、簡體中文。
隨處可見的評分徽章
評分徽章顯示於每日計劃、小工具、行事曆的每張餐點卡。點擊即可開啟完整解析視窗。
自動提交與輪詢
用餐時段結束時，MealRatingManager 自動提交至後端、輪詢完成狀態、透過 Redis 快取並觸發通知。
即時動態與動態島
三種由 ActivityKit 驅動的即時動態將 MenuMeld 帶到鎖定畫面和動態島：AI 照片分析進度、餐點評分結果和 AI 排序用餐順序。全部支援動畫轉場與推送更新。
餐點分析進度
由 MealAnalysisAttributes 驅動。AI 處理時星光閃爍、進度條填滿，再切換為綠色勾選顯示辨識結果 — 餐點名稱、卡路里與蛋白質。
餐點評分就緒
MealRatingAttributes 動畫呈現從 0 到 100 的評分環與最多 5 項標準條，附本地化激勵訊息。點擊開啟完整解析視窗。
用餐順序建議
EatingOrderAttributes 列出編號步驟 1 → 2 → 3 → 4，為你盤中食物排出最佳用餐順序，每項附簡短理由。
極簡 · 精簡 · 展開
極簡僅顯示 App Logo（18×18）。精簡顯示星星 + 分數（依分數顏色）。展開呈現完整標準網格與激勵訊息，橫跨 Leading/Trailing/Center/Bottom 四個區域。
倒數與自動關閉
使用者開啟 App 後，monospacedDigit 計時器會替換進度環，倒數至自動關閉。APNS 推送保持內容即時更新。
毛玻璃效果
iOS 26+ 使用 .ultraThinMaterial 作為鎖定畫面橫幅，舊版 iOS 回退至 .thinMaterial。自訂字型（MenuMeld 名稱使用 Kalam-Bold）全程保留。
