mcd-dual-budget-coach

🍔 麦门双预算军师 (McDualBudget Coach)

减脂期还想吃麦当劳？

说个预算和卡数，三档能直接下单的组合。

例：「30 块、600 卡，中午想吃点扎实的」→ 三档方案 + 券后到手价 + 一张会闪的人设卡。

⭐ 本仓库参加麦当劳开发者大赛，名次只看 Star 数。 觉得这套思路有用，就点一下右上角那个 Star —— 这一票直接决定排名。

▶ 在线试玩（点这里就能用，不用下载、不用装）

👉 ⚡ 点我进轻量版（965KB，秒开） →

https://erikzeng2008-del.github.io/mcd-dual-budget-coach/lite.html

功能与完整版一致，体积只有 1/12——商品图是缩略图，手机流量也扛得住。三个入口按需选：

手机浏览器直接打开也行。不想用 Demo？先看落地页。

🃏 核心玩法：麦门全息人设卡（会闪、能存、能晒）

配完一顿，它不只告诉你「买什么」——还按这一顿的真实数据给你发一张会随视角流光溢彩的 3D 全息卡，鉴定你是哪种麦门人格、什么稀有度。

👉 点开直接看一张卡（317 KB，秒开，不用装不用配）

打开就是一张会闪的「传说 · 热量刺客」——而且它是真的在动：不碰也会自己轻转、镭射自己扫，鼠标划过或手指拖动时切成跟手模式，四层视差跟着走。 在完整 Demo 里配完餐，还能生成你这张卡的专属链接——发给谁，谁点开看到的就是你的结果。

• 四层视差：背景 / AI 抠图商品主体 / 金色线稿 / 文字，鼠标或手指拖动时分层错动
• 镭射彩虹：光泽相位跟着视角走，转到哪闪到哪
• 8 种人格 + 4 档稀有度：全部由预算使用率、热量达成率、蛋白、钠、品类数推导，判定规则写在源码里，可以自己复算
• 一键保存 / 复制链接 / 复制文案：存图发朋友圈，或甩一条链接给别人——卡片自带项目地址

同一顿饭，预算 ¥45 时你是「自律型选手」，预算 ¥25 时变成「精准打击手」——数字变了，卡也变。

---

🎬 先看一眼（四步跑通：设定 → 三档 → 明细 → 对话）

说「多少钱 + 多少卡」，它给你三个能直接下单的组合——商品图全是 AI 抠图的真实照片，套餐按「主角优先」重新拼好，券会算清用完到手价。

🖼 素材档案（88 张商品图，AI 抠图、逐张审过）

商品图不是从网上随便找的——全部来自麦当劳官方商品图，经 RMBG-2.0 神经网络抠图 + 暗色残留清理 去底，四模型横评选型（u2net / RMBG-1.4 / BiRefNet / RMBG-2.0，实测 BiRefNet 反而最差）。

👉 素材档案审阅台 —— 每张商品「原图 vs 抠图」左右对照，可逐张查边缘干不干净。抠图脚本 ai_cutout.py 已开源在本仓库，换模型只改一行路径。

• ❌ 仓库文件列表里的 demo.html —— 它有 11 MB（真实商品图全部内嵌在单文件里），GitHub 的网页预览扛不住，会提示文件过大。
• ✅ 想本地跑：先把 demo.html 下载下来，再双击用浏览器打开——本地打开完全没问题。
• ✅ 手机上想快点：直接用上面的 lite.html（965KB），在线秒开，不用下载。

---

钱是一个预算，热量是另一个预算。两个都不超，一顿配到位。

告诉它「30 块 600 卡，中午想吃点扎实的」，它基于麦当劳官方 MCP 实时菜单、营养数据和你的优惠券，配出三个能直接下单的组合——并诚实地告诉你：这顿等于慢跑 50 分钟。

⭐ 本仓库正在参加 2026 麦当劳程序员创意开发大赛，排名唯一依据就是 GitHub Star 数。 如果这个「预算和热量一起算」的思路对你有用，麻烦点一下页面右上角的 Star——这是支持它的唯一方式，也是决定它排名的那一票。

🎮 五屏都能玩（在线版）

数据是 2026-10-12 的实测快照（83 个可配单品、11 张真实优惠券、88,788 个可组合），五屏随便玩：

手机也能开。

它长什么样

这就是它的全部「界面」——一段对话。你说「多少钱 + 多少卡 + 想吃啥」，它回你三个能直接下单的组合。 在线 demo 的第 5 屏就是这个对话界面，可以亲手打字体验。 图中顶部那排工具调用链是真实调用麦当劳 MCP 的 5 步（时间→菜单→营养→套餐默认档→逐个核价），价格由 calculate-price 实付核验——不是模型编的。这是本项目与「菜单静态表 + 拍脑袋推荐」类工具的根本区别。

⚙️ 数据流：从一句话到三档方案

flowchart TD
    U["你说：30 块 600 卡，中午想吃点扎实的"] --> P["对话解析<br/>金额 / 热量上限 / 蛋白下限 / 换一批"]
    P --> M["麦当劳 MCP 实时接口"]
    M --> M1["now-time-info<br/>门店与时段"]
    M --> M2["query-meals<br/>菜单与价格"]
    M --> M3["list-nutrition-foods<br/>营养表"]
    M --> M4["auto-bind-coupons + 三路券池<br/>可领券 / 我的券 / 门店券"]
    M1 & M2 & M3 & M4 --> S["本地快照 DATA + COMBOS<br/>83 单品 · 88,788 组合"]
    S --> G1{"① 金额闸门<br/>合计 ≤ 预算"}
    G1 -->|超限| X["淘汰"]
    G1 -->|通过| G2{"② 热量闸门<br/>合计 ≤ 上限"}
    G2 -->|超限| X
    G2 -->|通过| G3{"③ 蛋白闸门（可选）"}
    G3 -->|不足| X
    G3 -->|通过| T["三档评分<br/>最划算 / 最扎实 / 最均衡"]
    T --> C["券匹配 + 运动等价换算<br/>calculate-price 逐个核价"]
    C --> R["战报 + 全息人设卡<br/>8 人格 × 4 稀有度"]

关键设计：取数交给 MCP，算术交给代码，表达交给 Agent。菜单、营养、券都是 MCP 实时返回；组合枚举、双闸门过滤、三档评分全在本地算——不让大模型口算价格（点餐场景价格错一位就是事故）。

为什么做这个

想吃麦当劳的人心里都有两杆秤：

• 💸 钱包秤：「这个月得省着点」
• 🔥 热量秤：「今天热量余额只够 600 卡了」

市面上的点餐工具只管「点得快」，没人管「配得对」。本 Skill 把两杆秤做成双闸门：金额与热量任何一个超限的组合直接淘汰，剩下的按「最划算 / 最扎实 / 最均衡」给你三个答案，选哪个都不用做数学题。

快速开始

1. 获取麦当劳 MCP Token

访问 麦当劳 MCP 开放平台 → 手机号登录 → 右上角「控制台」→「激活」→ 复制 Token。

2. 在 WorkBuddy 中配置 MCP 连接器

左侧边栏【专家·技能·连接器】→【连接器】→ 右上角【自定义连接器】→【配置 MCP】→ 粘贴 mcp-config.example.json 的内容并将 ${MCD_MCP_TOKEN} 替换为你的实际 Token → 保存并启用 mcd-mcp。

3. 装载本 Skill

将本仓库的 SKILL.md 放入 WorkBuddy 技能目录（或在对话中直接粘贴给 AI 加载）。详细步骤参考 WorkBuddy 官方文档。

不想装？先玩一下

直接用浏览器打开仓库里的 demo.html（零外链、不含任何凭证），三屏玩转：

1. 拖滑块或点预设场景（如「30 块 600 卡 · 正餐」）→「配一顿」
2. 战报屏：三个过双闸门的组合（最划算 / 最扎实 / 最均衡），附预算执行、运动等价物、省钱心情，底部有「🔄 换一批」——同一预算再给你三个完全不同的组合（实测 30 元/600 卡有 40 个过闸组合，50 元不限卡 1280 个，三档只是入口不是上限）
3. 点任意方案 → 明细屏：每个餐品的真实商品图（麦当劳接口返回）、单价、热量、单项营养素；套餐还展开默认构成（哪几件、各多少卡）；底部是这一单的营养拆解——能量、蛋白质、脂肪、碳水化合物、钠、钙六项合计及占参考值百分比

数据为 2026-10-12 的实测快照（83 个可配单品、88,788 个可组合），商品图与营养素均来自麦当劳 MCP 接口；真实版走实时接口，菜单随时段/门店变化。热量数据缺失的当季新品（约 35 个）会在「不设卡」场景参选并明确标注「未知」，不拿未知数字凑闸门。

使用示例

以下战报为 2026-10-09 在「麦当劳福州金洲南路餐厅」的真实 MCP 实测输出（非演示数据）：

你：30 块 600 卡，中午想吃点扎实的

🍔 麦门双预算战报
─────────────────────
方案一 · 最划算
  精选超值随心配 1+1（麦香鸡 + 小玉米杯）
  实付 ¥14.9｜总热量 422 kcal
方案二 · 最扎实
  「堡」你欢乐套餐（官方 500 大卡档）
  实付 ¥28.0｜总热量 500 kcal 档
方案三 · 最均衡
  麦辣鸡腿堡单点
  实付 ¥22.5｜总热量 485 kcal
─────────────────────
💰 预算执行：¥14.9 / ¥30，剩余 ¥15.1
🔥 热量执行：422 / 600 kcal，剩余 178 kcal
🏃 运动等价物：这顿 = 慢跑 42 分钟 = 游泳 53 分钟
🧧 省钱心情：你有张 ¥9.9 薯薯券今天到期，用上等于白赚一顿小食

其他玩法：

你：健身完只敢吃 500 卡，麦门还有救吗
你：25 块，早餐，要喝咖啡
你：帮我领下今天的券再配一顿 35 块的

⚠️ 菜单随时段/门店变化，每次输出都基于麦当劳 MCP 实时返回（query-meals / list-nutrition-foods / calculate-price），早餐和正餐配出来的组合不一样。

实测案例

全部案例来自真机实测（2026-10-10，麦当劳福州金洲南路餐厅），每个案例包含完整调用链、每个数字的来源、复现说明：

目标用户

两个只有真数据才能得出的结论

这两条不是设计出来的，是跑完 88,788 个组合后才发现的——也是「静态菜单表 + 拍脑袋推荐」永远给不出的答案：

① 「随心配 1+1」是麦当劳藏得最深的省钱漏洞。 同样吃「堡 + 可乐」，单买 ¥23.0 + ¥10.0 = ¥33.0，走随心配 1+1 只要 ¥13.9——省 ¥19.1，够再买一个圆筒还剩。但菜单里它藏在「随心配」分类下，不枚举根本发现不了这个价差。

② 「500 大卡套餐」比你自己拼更便宜、还更饱。 官方 500 卡档套餐（如「酥脆无双套餐」¥20，434 kcal）vs 自拼「麦麦脆汁鸡 + 迷你薯条 + 无糖可乐」——同构成下套餐便宜 ¥2.5 且不用自己做算术。控卡的人最该买的恰恰是官方热量档，这与「套餐=不健康」的直觉相反。

已知限制（如实说明）

不藏短板，以下都是当前版本的真实边界：

1. 优惠券匹配是关键词规则，不是官方适用规则。 券名含「薯条」→ 找含薯条的组合；官方接口不返回券的完整适用范围，因此可能存在误判。demo 中的券为 2026-10-12 快照。
2. 营养表与门店菜单是两套数据源。 营养表约 160 条常见品，门店菜单前列是当季新品，实测零同名命中——需归一化对齐，已对齐 83 条，仍有约 35 个当季新品查不到热量，这些品在「设了热量预算」时不参选。
3. 套餐热量按官方默认档构成求和，不模拟用户自选替换项后的热量变化。
4. 门店固定为实测门店（福州金洲南路店），demo 不支持切店；真实版每次按地址重新定位。 5