麦当劳营养膳食专家（McDonald's Nutrition Diet Expert）

身材管控期也想吃麦当劳？这个专家会帮你根据每日消耗搭配麦麦套餐。

一个基于 SP 矩阵理论 的个人饮食搭配可视化选型工具，基于麦当劳官方 MCP Server 打通「营养计算 → SP 选型 → 套餐推荐 → 门店点餐 → 领券下单 → 健康记录」的完整闭环。

〇、目标用户与使用示例

目标用户

使用示例

以下所有数值均为真实接口实测输出（POST /api/recommend），非示意。

示例 1 · 减脂期午餐（女 28 岁 / 165cm / 58kg / 中等活动 / 减脂）

目标：全天 1625 kcal · 蛋白 116g · 碳水 189g · 脂肪 45g · 钠上限 2000 mg
    单餐目标 552 kcal（1625 × 34%）

方案一（评分 0.8214）
  637 kcal · 蛋白 44g · 钠 1878 mg · 占全天 39.2%
  · 主餐 麦辣鸡腿汉堡                     485 kcal
  · 饮品 无糖可口可乐中杯                   0 kcal
  · 小食 蜜汁BBQ风味薄皮脆汁鸡-带骨里脊   152 kcal
  ⚠ 钠 1878 mg，已达上限 94%
  ⚠ 热量比单餐目标高 84 kcal，训练日可接受，休息日建议减一份小食

方案二（评分 0.8162）—— 本餐钠负担最低
  580 kcal · 蛋白 33g · 钠 1049 mg · 占全天 35.7%
  · 主餐 双层吉士汉堡                      429 kcal
  · 饮品 优品豆浆小杯                       151 kcal

方案三（评分 0.7963）
  642 kcal · 蛋白 39g · 钠 1474 mg · 占全天 39.5%
  · 主餐 双层吉士汉堡                      429 kcal
  · 饮品 无糖可口可乐中杯                   0 kcal
  · 小食 麦乐鸡5块                        213 kcal

💡 系统的价值不止于「给出一套餐」，更在于同时告诉你取舍在哪：方案一蛋白最足但钠到 94%，方案二钠只有一半但蛋白少 11g —— 用户可以自己权衡，而不是在「不知道热量」和「只知道热量」之间二选一。

示例 2 · 增肌日午餐（男 25 岁 / 178cm / 82kg / 高强度活动 / 增肌）

目标：全天 3502 kcal · 蛋白 148g · 碳水 535g · 脂肪 86g · 钠上限 2000 mg
    单餐目标 1191 kcal

方案一（评分 0.7392）—— 含甜点
  1341 kcal · 蛋白 55g · 钠 1838 mg · 占全天 38.3%
  · 主餐 芝士安格斯厚牛堡                 696 kcal
  · 小食 麦麦脆汁鸡-琵琶腿                328 kcal
  · 饮品 可乐大杯                        224 kcal
  · 甜点 圆筒冰淇淋                        93 kcal
  ⚠ 钠 1838 mg，已达上限 92%

方案二（评分 0.7193）—— 推荐
  1028 kcal · 蛋白 54g · 钠 1744 mg · 占全天 29.4%
  · 主餐 芝士安格斯厚牛堡                 696 kcal
  · 小食 麦麦脆汁鸡-带骨里脊              332 kcal
  · 饮品 无糖可口可乐中杯                   0 kcal

方案三（评分 0.7144）—— 系统主动标红
  1130 kcal · 蛋白 47g · 钠 2149 mg
  ⚠ 钠摄入 2149 mg，已超出 2000 mg 上限（超出 149 mg）。
     这是本方案最需要你知晓的取舍点：建议把含糖饮料换成无糖、
     并避免同一天再叠加其他高钠食物。

💡 注意方案三：系统没有藏起这个超标项。它在 warnings 里主动把超出量算给你看，而不是给一个看起来很美的组合 —— 这正是「可解释」的含义。

示例 3 · 领券点餐闭环（Web 界面）

1. 建档 →  身高体重年龄 → 自动出全天目标与 SP 目标点
2. SP 矩阵 → 156 个餐品按四象限散点分布，金色十字 = 我的目标点
3. 套餐推荐 → 三套方案，含每样餐品的贴合度百分比
4. 门店点餐 → 点击门店 → 进店菜单，每个条目带象限角标 + 贴合度
             → 套餐自动展开内含单品
5. 领券 →  「我的卡包」显示已持有的券（显示券码）+ 可领取券
6. 下单 →  购物车实时计价 → 提交订单
7. 健康记录 → 吃完记一笔 → 体重趋势 + 热量缺口 + 象限分布回看

示例 4 · 独立 Web 应用运行

git clone https://github.com/ChinaOpenClaw/mcd-nutrition-expert.git
cd mcd-nutrition-expert/skills/mcd-nutrition-expert
cp .env.example .env          # 填入你的 MCP Token
pip install -r requirements.txt
python scripts/server.py       # → http://127.0.0.1:8899

示例 5 · 作为 WorkBuddy Skill 调用

见 workbuddy.md。核心触发语：

「帮我按 SP 矩阵推荐一套麦当劳套餐」
「我今天想吃麦当劳，算一下该怎么点」
「看看我的热量缺口够不够吃这一套」

一、核心洞察：为什么需要它

控卡期吃麦当劳，真正的痛点不是「不知道吃什么」，而是：

二、SP 矩阵理论的应用

2.1 从战略定位到饮食定位

经典 SP（Sweet Point）矩阵用「竞争强度」与「市场地位」划分战略象限。迁移到饮食选型，映射为两个营养密度维度：

2.2 四象限

                    钠负担高
                       │
         ┌─────────────┼─────────────┐
         │             │             │
         │   解馋区     │   双刃区     │
         │  (低密度高钠) │ (高密度高钠) │
营养密度低┼─────────────┼────────── 营养密度高
         │             │             │
         │   填充区     │  主力区 ★   │
         │ (低密度低钠) │ (高密度低钠) │
         └─────────────┼─────────────┘
                       │
                    钠负担低

上图方位与 docs/screenshots/03-sp-matrix.png 实际界面一致（X 轴向右为营养密度递增，Y 轴向上为钠负担递增）。 实测 156 个有效样本的分布：主力区 47 / 解馋区 46 / 填充区 53 / 双刃区 10。

2.3 贴合度 fit

每个餐品相对「你的目标点」计算归一化欧氏距离，映射到 0–100% 的贴合度：

fit = 1 - dist / 1.4

目标点由用户档案推导（蛋白+碳水密度、钠密度），因此同一个餐品对不同人的贴合度完全不同——这正是 SP 矩阵作为「个人化选型工具」的价值。

2.4 界面实录

② SP 矩阵选型	③ 个性化套餐推荐

散点图每个点是一个餐品，金色十字是你的目标点；右侧按贴合度排序，直接给出「最该点的那一个」。

④ 门店点餐	⑤ 健康可视化

菜单里每个条目都带 SP 象限角标与贴合度百分比；健康页把每日摄入与目标画在同一张图上，缺口一目了然。

三、功能全景

① 建档 · 营养目标计算

• BMR：Mifflin-St Jeor 公式；若用户填写体脂率则切换到 Katch-McArdle（瘦体重法）修正
• TDEE：BMR × FAO/WHO 活动系数（sedentary 1.2 / light 1.375 / moderate 1.55 / active 1.725 / athlete 1.9）
• 四种目标模式：

② SP 矩阵可视化选型

• 原生 Canvas 绘制散点矩阵（零第三方依赖，离线可用）
• 象限底色 + 动态分界线（P50×0.6 + P75×0.4）
• 散点半径随贴合度变化，金色十字为你的目标点
• 四象限直方图统计

③ 套餐推荐求解器

结构角色模型（取代朴素分类笛卡尔积）：

主餐（唯一） → 小食（≤1） → 饮品（唯一） → 甜点（≤1）

硬约束组合：

• 主餐占本餐热量 40%–85%
• 角色级热量上限（比例 ∪ 真实规格绝对上限的较大值）
• 配菜必须带蛋白（≥6g）或足量主食（≥120 kcal）——防止「玉米杯」挤掉真正的蛋白源
• 减脂/塑形模式禁止甜点
• 钠 ≤ 全日上限 × 1.25

多目标加权打分：

局部搜索改进：加一份 / 减一份 / 换一份三邻域迭代 + 多样性去重。

实测输出（25 岁男性 / 175cm / 70kg / 轻度活动 / 减脂，全天目标 1841 kcal、单餐目标 626 kcal）：

方案 1  719 kcal（占全天 39%）· 蛋白 44g · 钠 1981mg
   板烧鸡腿堡 + 麦麦脆汁鸡-琵琶腿 + 无糖可口可乐中杯
方案 2  611 kcal（占全天 33%）· 蛋白 43g · 钠 1993mg
   麦辣鸡腿汉堡 + 无糖可口可乐中杯 + 蒜了吧黄油风味薄皮脆汁鸡-带骨里脊
方案 3  555 kcal（占全天 30%）· 蛋白 46g · 钠 1802mg
   双层吉士汉堡 + 蒜了吧黄油风味薄皮脆汁鸡-带骨里脊 + 无糖可口可乐中杯

三套方案都满足「主餐唯一 + 饮品唯一 + 小食 ≤1 + 甜点 ≤1」的结构约束， 且饮品位固定落在零卡选项上——这是控卡期的关键：热量与钠的波动全部来自主餐与小食的选择。

④ 门店点餐（点击门店进入店内）

• 门店列表 → 点击进店 → 分类 tab → 菜单网格
• 每个菜单条目都带 SP 象限标签 + 贴合度 + 营养四宫格（热量/蛋白/脂肪/钠）
• 套餐条目自动展开内含单品（「含：龙焰鸡腿堡 / 中薯条 / 可乐中杯」）
• 新品未收录营养表时按品类关键词近似估算，并显式标注「新品估算」
• 购物车 sticky bar → 实时计价（分/元双口径换算）→ 下单 → 自动记入健康档案

⑤ 优惠券与下单

• 可领取 / 我的卡包 / 本店可用三段式
• 一键领券（auto-bind-coupons）
• 计价与下单走 calculate-price / create-order，正确处理 productCode + quantity 契约与「分」单位

⑥ 健康可视化记录

• SQLite 三表分离：daily_log（日汇总）/ meal_log（明细）/ profile（档案）
• KPI 卡 + 体重折线 + 热量收支双线 + 象限分布条形图
• 自动补齐空日期，连续性趋势不断裂

四、技术架构

┌─────────────────────────────────────────────┐
│  web/index.html  （单文件前端 · 原生 Canvas）  │
│  ①建档 ②SP矩阵 ③套餐推荐 ④门店点餐 ⑤健康可视化 │
└──────────────────┬──────────────────────────┘
                   │ HTTP / JSON
┌──────────────────▼──────────────────────────┐
│  scripts/server.py   FastAPI + uvicorn        │
│  /api/health /api/target /api/matrix          │
│  /api/recommend /api/stores /api/menu        │
│  /api/coupons /api/cart /api/order            │
│  /api/records /api/records/weight /api/account│
└──────────────────┬──────────────────────────┘
                   │
   ┌───────────────┼────────────────┐
   │               │                │
┌──▼──────────┐ ┌──▼─────────┐ ┌────▼──────────┐
│nutrition_   │ │combo_      │ │sp_matrix.py   │
│engine.py    │ │solver.py   │ │  SP 四象限     │
│ BMR/TDEE    │ │ 约束求解   │ │  贴合度       │
│ 目标计算    │ │ 局部搜索   │ └───────────────┘
└─────────────┘ └────┬───────┘
                     │
┌──────────────┐ ┌───▼─────────┐ ┌──────────────┐
│mcp_client.py │ │health_store │ │              │
│ MCP 客户端   │ │  SQLite     │ │              │
└──────┬───────┘ └───┬─────────┘ └──────────────┘
       │             │
┌──────▼─────────────▼──────────┐
│  麦当劳官方 MCP Server           │
│  https://mcp.mcd.cn （35 个工具） │
└──────────────────────────────────┘

模块职责