Skip to content
Back to search

mcd-agent-gourmet

麦门点餐议事会。用户想按预算和口味比较完整的麦当劳餐单,或问“我的券快过期了吗”“这顿能用哪张券”时使用。先确认门店与到店/配送,保留有糖无糖和冰量偏好;分清券包、时段和门店适用性,再使用官方 MCP 核价。只查询核价,不领券不下单。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/polaris-smart--mcd-agent-gourmet/badge.svg)](/listings/polaris-smart--mcd-agent-gourmet)

HTML

<a href="/listings/polaris-smart--mcd-agent-gourmet"><img src="/api/listings/polaris-smart--mcd-agent-gourmet/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 130 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: mcd-agent-gourmet
  3. description: 麦门点餐议事会。用户想按预算和口味比较完整的麦当劳餐单,或问“我的券快过期了吗”“这顿能用哪张券”时使用。先确认门店与到店/配送,保留有糖无糖和冰量偏好;分清券包、时段和门店适用性,再使用官方 MCP 核价。只查询核价,不领券不下单。
  4. description_zh: 按预算、糖和冰量偏好比较完整麦当劳餐单,区分到店、外带、得来速和配送,查询适用券与积分;使用官方 MCP 核价,不下单。
  5. description_en: Compare complete McDonald’s China meals by budget and preferences, verify customization and channel-specific coupons, and inspect points through the official MCP. Read-only, no ordering.
  6. version: 0.3.2
  7. author: Polaris-Smart LAB
  8. display_name: 麦门点餐议事会
  9. agent_created: true
  10. ---
  11. # 点餐议事会
  12. 先帮用户选一顿完整的饭,再讨论省钱、口味和营养数据。不要要求用户说出“多 Agent”这样的实现术语。
  13. ## 执行边界
  14. - 只调用查询与核价工具;本 Skill 不执行 `create-order`、领券、积分兑换、支付。
  15. - Token 仅在客户端私有配置或本机环境;不让用户粘贴到公开网页、Issue 或日志。
  16. - 不自动使用仓库示例门店代替用户选择;先确认到店、得来速或麦乐送;到店先问城市/位置,再通过 `query-nearby-stores` 列出门店供选择。
  17. - 用户明确预算、主食/小食/饮料份数、排除项。“不吃辣”是硬约束,“想吃辣”可作为软偏好。
  18. - 营养指标上限须来自用户;不要把固定阈值描述为普遍健康标准。
  19. ## 先理解一句话,再少问必要的问题
  20. 例如“35 元,不辣,有糖可乐去冰,带走”或“35 元,不辣,无糖可乐去冰,带走”:提取预算、不辣硬约束、用户指定的可乐糖类和去冰、到店外带意图。只补问缺失的城市/地标和门店,不要求用户填写长表或复制商品 ID。可记住普通饮食偏好,但先征得用户同意;不要存 Token、地址、券码或会员原始数据。
  21. 有糖可乐、无糖可乐是平等的口味选项,向用户并列展示。用户未指定时不默认无糖;明确指定有糖时不得因为营养排序自行换成无糖,反之亦然。用户只说“可乐”而当前有多个选项时,展示可选项供选择;当前门店缺少指定选项时说明缺货或未确认,不能擅自替换。宣传与示例应同时体现两种选择,不将无糖描述成更高级的口味。
  22. 推荐顺序:先给最多三份值得比较的方案和一句取舍,再允许展开全部候选。没有合适方案时说清阻碍;只提出调整建议,不能替用户增加预算、换店、换饮料或放宽排除项。能量、蛋白质、钠用于连续比较,未知不归零,不打无依据的健康分。
  23. 零输入入口:「随便来一份」在用户没有说预算时**不得默默套一个预算**,要明确说"未设预算,只按其他硬性条件筛";「跟上次一样」只复用历史订单的**门店与商品编码**,必须按当次价重新核价——售罄或套餐内部的构成件要逐条剔除并告诉用户,不替换、不静默;上次那家店不在营业时间就直接说明并退回默认方案,不要换店顶替。
  24. 企业团餐(`query-meal-assistance`)与主题派对(`party-*`)**不是个人点餐的渠道**,属于独立场景,数据面与流程都不同;不得用个人点餐参数去套企业或活动规则。
  25. 菜单展示价不是价格依据:官方菜单的 `currentPrice` 可能附带 `discountType`(如「随单购麦金卡优惠」)或 `canWithOrder` 条件,直接念出来会误导用户(同一商品的菜单价与核价可能不同)。因此提到菜单价时必须同时说明它的条件,并与 `calculate-price` 的核价并列;`display_price_note` 有值时要如实转述,不得只报菜单价。
  26. 省钱数字必须来自真实核价并能复算:基线只能取「本店候选 ID」或「外部真实核价 + 同一门店编码」,跨店或来源不明一律不报。**基线篮子里的每个商品必须能独立核价且大于 0**——套餐内部的构成编码单独核价会返回 0 分(实测:可乐中杯 3050 为 0 分),用它拼基线会算出偏小的假省钱数字。报出的「省 ¥X(Y%)」必须能由 Total 与基线金额直接对账。
  27. 解释「为什么不是它」时只引用程序给出的依据:`tradeoff_reasons` 会指出该候选**被哪一份、在哪个维度**比下去(例如「被 cheese-corn 比下去——价格更低 ¥32.00 vs ¥33.50;钠更低 1053 mg vs 1182 mg」)。同值并列仍属于候选;数据不完整的候选只说「因数据不完整未参与比较」。预算不足时引用 `budget_ladder` 的阶梯(例如「预算 ¥32.00 → 可选 2 份」),并明确**只调整预算**:不得暗示、催促或替用户提高预算,也不得放宽口味、小食、饮料或营养条件。
  28. ## 履约场景必须先确定
  29. - 到店(`pickup`):`beType=1, orderType=1`,不得带 `beCode`。堂食和外带都在到店链路;具体可选取餐方式从核价的 `takeWayList` 展示,不能自造 `takeWayCode`。本 Skill 不下单,只把用户选择带到餐单。
  30. - 得来速(`drive`):`beType=5, orderType=1`,用相应门店查询返回的 `storeCode + beCode`。
  31. - 麦乐送(`delivery`):先按用户意图查询 `delivery-query-addresses`,只在当前私有对话展示选择所需信息,避免重复完整门牌和电话;用户选地址后用 `delivery-query-stores(beType=2, addressId=...)` 获取成对编码。菜单、券、详情、核价全程使用 `beType=2, orderType=2, storeCode, beCode`。
  32. - 地址为空时引导用户在官方应用添加。本版本不写地址、不下单。切换渠道/门店/地址后,旧券适用结论、旧报价和旧选择均失效。外卖应展示配送、包装、餐具费用,缺失为未知,不能拿到店餐价冒充送到家总价。
  33. - 企业团餐有独立的 `beType=6`、助餐服务和活动规则,本程序尚未接通,不能套用个人点餐流程。
  34. ## 事实采集:协调器负责
  35. 1. 按上面的履约场景查询门店;到店/得来速位置搜索使用 `searchType=2`,同时提供 city 与 keyword。展示店名、地址、营业状态;支持预约时完整展示服务端预约选项,不省略日期时段。本程序只核价即时餐单。
  36. 2. `query-meals`:使用当前履约上下文,读取这家店当次菜单。原样例套餐缺失时停止并让用户选其他套餐,不能暗中替代。
  37. 3. `query-meal-detail`:确认套餐每一轮的实际商品与数量。仅从可选项中替换。`supportModify=true` 时标注“可特调”;只有用户问特调或已经提出冰量/配料要求时,才展开对应选项。
  38. - 无糖/含糖是餐品选择;冰量通过当前饮料的 `modification` 映射。支持标准、少冰、去冰、多冰取决于该饮料当次选项。
  39. - 使用当次 `selectedKey`;未选项若有 `unselectedKey` 也须提交。不把同 code 的不同冰量误当成同一选项。
  40. - 去酱/去菜按官方完整配料名称匹配,不凭“不要酱”猜测多种酱中的哪一个。特调后重新核价;去除配料后原标准营养值不再适用,标未知。
  41. - 小/中/大杯、辣度分级、额外酱、玩具:只有当前菜单或特调提供明确选项时才能确认;否则明确未支持。不能把无糖等同于无甜味、把“不辣”当作过敏安全判断。
  42. 4. `list-nutrition-foods`:按具体餐品名称和份量匹配。缺失为未知。标准份量相加不是实际制作的精确测量。
  43. 5. 用户需要用券时才调用 `query-store-coupons`:仅查看当前可用券,不自动领取。用券要拿到有效且成对的 couponId/couponCode,且该券要由官方核价验证;不要凭券名减钱。只向用户展示券名称及适配候选,协调器在内存中解析标识;不要求普通用户提供券 ID。默认不带券。
  44. 6. `calculate-price`:每份完整候选独立核价,用 `items[].productCode`、`roundList[].round` 和 `comboItemList` 传套餐选择;应付来自返回的整数分 `price`。替换任何餐品后重新核价,不能手算差价。
  45. 最多比较少量有意义的候选;说清比较范围。接口错误立即停止当前链路,标明此前结果是否完整,绝不拿 fixture 充当实时结果。
  46. ## 三个比较角度
  47. 对同一份已核验事实包,按以下标准比较。事实包包含用户需求、门店、核价时间、完整明细、整数分总价、营养值与缺失项,不含凭证或券 ID。
  48. - **价格较低**:首先排除不满足完整餐单和硬性条件的方案,再选价格较低的候选。优惠券只有在原本要买的餐单上真的减少支出才有价值。
  49. - **钠含量较少**:程序在已知钠数据中排序,另展示能量与蛋白质供比较。不得把钠少或低热量说成“均衡”,不得把未知说成零。
  50. - **更贴近口味**:在硬性条件内优先用户偏好;偏好满足不了时说明,不偷偷放宽“不吃辣”等排除项。
  51. 这些是确定性的比较标准,不是三个独立模型。不要制造角色对话或争论;多个标准选中同一餐单时合并说明,不重复展示三份相同方案。
  52. ## 汇总与用户选择
  53. 用表格展示每份餐单:完整明细、当次整单价格、预算余量或超额、已知营养、未满足条件、比较理由。没有满足条件的候选时明确说明。
  54. 需要展开时给出“价格与钠”“口味与钠”的取舍候选:只有另一份在每个所选维度都不差且至少一个更好时才淘汰当前餐单。同值并列保留,另提供价格、钠、能量、蛋白质四维取舍,所有对应指标须完整。四维可能留下全部候选,不称其为唯一均衡最优。不编造健康评分,不声称穷举全部菜单。
  55. 用户选择前,复述门店、餐品、份数与价格。用户改变预算/偏好/餐单后,旧选择作废。记录选择不等于创建订单;后续购买由用户在官方渠道完成。
  56. ## 积分、券包与渠道核验
  57. 只有用户询问积分/券包时,才调用相应个人接口。`query-my-account` 返回积分数据,不是完整会员档案;没有会员等级字段就不能猜测等级。
  58. ### “我的券快过期了吗”
  59. 只清点券时不查询积分或订单。使用 `query-my-coupons`,每页最多 200 条,最多 5 页;核对页码、总数与分页期间的一致性。不完整时明确标记,不能当作全部券。可运行 `python3 demo.py --my-coupons` 复用确定性分析;`--json` 提供全部脱敏明细。
  60. 分别说明四件事:官方 `enable` 当前状态、有效日期、从 `datetimeText` 本地解析的时间窗口、门店/渠道是否核验。`enable=1` 也不等于特定订单可用。日期与时段原文保留;无法完整解释星期或特殊限制时标待核验。用北京时间,明确午夜不改成当天结束,纯日期不编造精确截止;“24 小时内”不说成“今天”,距离关闭时长不说成连续可用时长。
  61. 早餐开窗前可以说“05:00 开始,目前尚未进入窗口”;今天窗口关闭但明天仍有窗口时,不能说券已过期。显示本地解析依据与官方原文,字段冲突不猜测。分钟末点按包含该分钟解释,遇到边界时仍以官方渠道为准。
  62. 同名券仅分组浏览,每张分别保留日期与规则,不称可叠加;已结束的券单列,不催促用户处理。先突出最多三张相关的临期券,并提供其余明细。提醒“本来不需要买就不必为了用券消费”。公开演示使用 `python3 demo.py --coupon-demo` 的构造数据,不分享用户真实余额或券包截图。
  63. ### “这顿能用哪张”
  64. 先确认本次餐品需求、门店与到店/外带/配送意图。可运行 `--my-coupons --store-code 门店编码`,配送/得来速同时携带正确的 `--channel` 与 `--business-code`。程序仅在内存中用成对券标识匹配门店返回;同名不作身份匹配。未出现在该店返回中不能说整张券作废。到店查询尚不能单独证明外带资格,取餐方式仍看核价的 `takeWayList`。
  65. 之后复用原有 `--list-coupons` 与按名称核价流程:只给原本想买且适配的餐单用券,保留糖、冰量和预算条件;名称有歧义时停止,不让普通用户查券码。只有 `calculate-price` 才能确认应付与实际优惠;没有成功核价时不得报告节省金额。券包清点不会自动核价或下单。
  66. 1. `query-my-coupons` 展示拥有的券;分页不完整要说明。它不校验门店/渠道。
  67. 2. `available-coupons` 只是可领取券目录,不表示已经领取。
  68. 3. `mall-points-products` 按用户兴趣查餐品券、实物或活动;不同类目不混用。CLI 当前只查询餐品券。
  69. 4. 用户选择商品后 `mall-product-detail` 展示 SKU、积分、兑换现金、核销时额外现金、有效期;购买须知 `note` 原文展示,不拆成自动价格/资格校验规则。
  70. 5. 必须区分“积分换券”与“券能在这次订单用”。积分不按固定比例直接当现金。不得承诺所有积分券都支持外带或配送:拥有券后,按目标 `storeCode + beType + orderType + beCode(如需)` 重新 `query-store-coupons`,商品匹配后才 `calculate-price`。未兑换商品的渠道资格标“尚未核验”,不能为了验证先花掉积分。
  71. 6. 本版本不领取、不兑换、不支付、不抽奖。用户要购买时转到官方渠道;不要报告没有执行的交易成功。
  72. 详见 `references/mcp-capabilities.md` 的完整能力与实现状态。订单复购、活动等可作为后续扩展,不冒充本版本已接入。
  73. ## 本地程序
  74. - `python3 demo.py`:历史快照演示,零 Token,不联网。
  75. - `python3 demo.py --list-coupons --plan fixtures/plan.json`:只查询券名称与匹配候选,不领券、不输出券 ID。
  76. - `python3 demo.py --live --plan local/my-plan.json`:用户选定门店和候选后真实核价。
  77. - `python3 demo.py --budget 35 --taste spicy --side fries --json`:结构化比较结果。
  78. - `python3 demo.py --search-stores --city 南京 --keyword 新街口`:按地点搜索到店门店;`--channel drive` 查询得来速。
  79. - `python3 demo.py --list-meals --store-code 门店编码`:当前菜单;`--meal-code 编码` 选择最多三种套餐,不再限定原样例。
  80. - `python3 demo.py --live --store-code 门店编码 --meal-code 套餐编码 --expand --sugar zero --ice none`:枚举已识别小食×饮料组合,最多 12 份;每份重新官方核价。用当前官方特调 key 处理去冰。数字编码由协调器从工具结果带入,不让普通用户查 ID。
  81. - `python3 demo.py --live --plan local/my-plan.json --omit 麦香鸡酱`:只对实际存在该配料的套餐执行去除特调,不沿用标准营养总数。
  82. - `python3 demo.py --member`、`--points-products`、`--points-detail SPU_ID`:分别查询积分券包、餐品券目录、商品详情;互斥,不保存结果。
  83. - `python3 demo.py --addresses` → `--delivery-stores --address-ref 引用`:显式查询脱敏地址再选择配送店;地址引用与具体地址绑定,地址变动后拒绝继续。
  84. - `python3 demo.py --list-coupons --store-code 门店编码 --channel delivery --business-code 成对业务编码`:按配送场景查券;实时核价使用同样上下文。
  85. - `--energy-limit`、`--protein-min`、`--freshness-minutes` 和 `--max-response-mb` 提供显式边界。
  86. - `gourmet/core.py`:完整餐单与硬性条件校验。
  87. - `gourmet/mcp.py`:协议与只读工具白名单。
  88. - `gourmet/live.py`:套餐构造、官方核价、精确名称营养匹配。
  89. 限制与实测范围见 `docs/validation.md`。不保证最低价,不构成营养或医疗建议。
README.md · README · 256 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # 麦门点餐议事会 · mcd-agent-gourmet
  2. [![Offline checks](https://github.com/polaris-smart/mcd-agent-gourmet/actions/workflows/ci.yml/badge.svg)](https://github.com/polaris-smart/mcd-agent-gourmet/actions/workflows/ci.yml)
  3. [![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-3776AB)](https://github.com/polaris-smart/mcd-agent-gourmet)
  4. [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
  5. **同样一份餐,两条点法差 ¥12.00(24.7%)。** 同店同时刻:单品直选 ¥48.50,三件套 ¥36.50。
  6. **一句话 → 一个答案 → 一张点单卡。** 说「35 元,不辣,有糖可乐去冰,带走」,它把这一餐真正要付的钱算出来,给你一张能照着点的清单;没有方案就直说没有,不拿不完整的餐单凑数。
  7. **菜单写 ¥32.00,核价 ¥58.50 —— 它只认后者。** 实测遇到过展示价要求随单购买麦金卡;这时它会同时给出条件与核价。金额一律取官方 `calculate-price` 返回的整数分。
  8. **不领券、不兑换、不下单、不支付,也不收集你的 Token。** 网页打开就是答案:不用账号、不用 Token、不用安装;要实时核价时,Token 只留在你本机的环境变量里。
  9. [打开在线体验(免登录)](https://polaris-smart.github.io/mcd-agent-gourmet/) · [安装 Skill](#在-workbuddy-里使用) · [真实联调记录](docs/validation.md) · [English](README_EN.md)
  10. > **English TL;DR** — A read-only McDonald's China MCP client + agent skill. Say *"35 yuan, not spicy, regular cola, no ice, takeaway"* and it compares **complete** meals (main + side + drink) using official per-order pricing, tells you **why each rejected meal lost** (dominated by which candidate, on which axis), and when nothing fits it says so — plus how much budget would actually be needed. An explicit regular-cola choice is never silently swapped for zero sugar. It never orders, pays, or collects your token. [English README](README_EN.md) · [30-second demo](https://polaris-smart.github.io/mcd-agent-gourmet/)
  11. ![首屏:右侧同店同时刻的核价对比(单品直选 ¥48.50 vs 三件套 ¥36.50),下方一个答案 + 可复制点单卡](docs/assets/hero.png)
  12. ## 先试 30 秒
  13. 不用账号、Token 或安装:
  14. - **打开就是答案**:默认直接给出这一餐(巨无霸三件套 ¥36.50)和一句可核对的理由——「比单品直选省 ¥12.00(24.7%)」。
  15. - 点 **「就这个」**:出现可复制的点单卡(门店 / 取餐方式 / 每样官方名称 / 合计)。
  16. - 把预算改成 **30 元**:它说没有方案,并告诉你最低需要多少(¥36.50)——不硬凑。
  17. - 想看别的,点 **「我想比较」**:才展开全部候选与「为什么不是它」。默认不给表格。
  18. - 想看得更深,展开 **「更细的比较」**:切换比较角度(价格与钠 / 口味与钠 / 四维营养),并看三种推荐角度各自选了什么。
  19. 点单卡就是最终产出物——门店、取餐方式、每样官方名称、合计,照着它就能在 App 或柜台点单:
  20. ![点单卡:门店、取餐方式、每样官方名称、合计、省钱行,可一键复制](docs/assets/order-card.png)
  21. ![点「我想比较」才展开全部候选与「为什么不是它」](docs/assets/results.png)
  22. 网页使用历史快照,所有比较在你的浏览器内完成,不收集凭证、不调用下单、不加入追踪器;本项目为独立参赛作品,非麦当劳官方产品。也可看 [30 秒录屏演示](https://polaris-smart.github.io/mcd-agent-gourmet/assets/demo.mp4)(当前界面,静音)。
  23. ## 首屏长这样(一个答案,不用你挑)
  24. 网页默认门店(`fixtures/hongwu-single-vs-combo.json`,2026-10-17 真实核价)上的实际输出:
  25. ```
  26. 这顿就它了 👇
  27. 巨无霸三件套 · 套餐(巨无霸 + 中薯条 + 可乐中杯)
  28. ¥36.50 南京某门店(名称与地址已脱敏) · 到店自取
  29. 比「单品直选」省 ¥12.00(24.7%)
  30. 点单卡(可复制)
  31. 门店:南京某门店(名称与地址已脱敏) · 到店自取
  32. 1. 巨无霸
  33. 2. 中薯条
  34. 3. 可乐中杯
  35. 合计:¥36.50
  36. 比「单品直选」省 ¥12.00(24.7%)
  37. 以上只是记录你的选择;没有下单、没有支付。
  38. ```
  39. 想在 CLI 复现同一段输出(默认快照是老的那组,省 ¥12.00 这组要显式指定):
  40. ```bash
  41. python3 demo.py --input fixtures/hongwu-single-vs-combo.json \
  42. --budget 40 --baseline-plan single-pick
  43. ```
  44. - **默认只给一个答案**,不让你在 3 份表格里做多目标权衡;理由必须是可核对的事实(省了多少钱 / 价格最低 / 钠最低),不是说服文案。
  45. - **点单卡**是最终产出物:门店、取餐方式、每样官方名称、合计——照着在 App 或柜台点即可。
  46. - 想看别的:`--compare` 才展开全部候选与「为什么不是它」。
  47. ## 目标用户
  48. - **一个人或两个人吃饭**、预算有限、对口味有明确偏好的人;
  49. - 以**到店自取 / 外带**为主,想在下单前把「这一顿多少钱、怎么点更划算」算清的人;
  50. - 需要把**钠 / 能量 / 蛋白质**当筛选条件的人(条件由你自己设,不是健康建议);
  51. - 用 **WorkBuddy 等 AI 客户端**、希望"说一句话就得到可核价餐单"的人;
  52. - **开发者**:想看一个只读 MCP 客户端 + 确定性比较 + 可复算省钱数字的实现样板。
  53. ## 三件我们做死的事
  54. 1. **钱必须是真数**:金额只认官方 `calculate-price` 返回的整数分;菜单展示价附带的条件(例如「随单购麦金卡」)会一并说清。例:巨无霸三件套菜单价 ¥36.50、官方核价也是 ¥36.50;带「随单购卡」条件的商品两者会不同,此时它会同时显示条件与核价。
  55. 2. **你的硬约束只说一次**:不辣、去冰、有糖……记住你的条件,不反复问,也**不因为"营养更优"替你改**。
  56. 3. **两个人也能算**:份数完备性按人数(主食与饮料各 ≥ 人数),比较用人均价,而不是拿"两人总价"去比"一人总价"。
  57. 再加上一条:不领券、不兑换、不下单、不支付,也没有购物车。
  58. ## 它做什么
  59. “35 元,不辣,有糖可乐去冰,带走。帮我看看附近哪家店合适。”这是我们希望用户直接表达的需求。Skill 会先补齐地点、让你确认门店,再比较完整餐单,不要求普通用户复制门店、商品或券的编码。**这条路径由安装了 Skill 的 AI 客户端执行;网页是免登录的历史数据体验,CLI 是开发者入口。**
  60. 比较程序按价格、已知钠含量、口味匹配三个明确标准给出结果。同一餐单可能符合多个标准;这不代表三个独立模型进行了讨论,也不承诺全菜单最优。
  61. <details>
  62. <summary>查看历史核价示例:预算 35 元、想吃辣,三个比较角度为什么选不同餐单</summary>
  63. | 比较角度 | 本次选择 | 理由 |
  64. |---|---|---|
  65. | 价格较低 | 双层吉士汉堡 + 小杯玉米杯 + 无糖可口可乐中杯 | 当次整单核价 **¥32.00**,在候选中价格较低 |
  66. | 钠含量较少 | 麦香鱼 + 小杯玉米杯 + 无糖可口可乐中杯 | 当次 **¥32.50**;官方标准份量单品合计钠 **592 mg**,在候选中较少 |
  67. | 更贴近辣味偏好 | 麦辣鸡腿汉堡 + 小杯玉米杯 + 无糖可口可乐中杯 | 当次 **¥32.00**,保留辣味偏好 |
  68. 上表是 **2026-10-13 演示门店的真实核价快照**,不是当前报价,也不是营养搭配建议。实际购买须重新核价。我们比较六份候选,不保证全菜单最低价。
  69. </details>
  70. ## 和下单渠道是什么关系
  71. App 是**下单**的地方;这里是**打开 App 之前**把「这顿怎么点」算清楚的地方。
  72. - **下单仍在麦当劳 App 或门店完成**;本工具不提供购物车、不代下单。
  73. - 它只做「打开下单渠道之前」的那一步:把你的条件变成**可核价的完整餐单**,并说明取舍。
  74. - 没有符合条件时会直说,并给出**保持其他条件的预算阶梯**(差多少钱、加多少后有几份可选)。
  75. 两者不冲突:用它决定点什么,用 App 完成购买。
  76. ## 在 WorkBuddy 里使用
  77. 先按官方文档配置麦当劳 MCP 连接器。`mcp-config.example.json` 只含环境变量占位符;若客户端不支持变量展开,请只在该客户端的私有配置中设置实际凭证。
  78. 可以把下面这段发给 WorkBuddy:
  79. ```text
  80. 请安装这个技能:https://github.com/polaris-smart/mcd-agent-gourmet
  81. 保留 SKILL.md、gourmet/、demo.py、fixtures/ 的相对位置。
  82. 使用我已配置的麦当劳 MCP 连接器。
  83. 35 元,不辣,有糖可乐去冰,主食、小食、饮料各一份,带走。
  84. 我在南京江宁区。先显示门店名称和地址,让我选店。
  85. 再查当次菜单,给我最多三份符合要求的方案,说明价格和取舍。
  86. 没有满足条件的方案时说明原因,先别替我改饮料或加预算。
  87. 只查询和核价,不领券、不兑换、不下单、不支付。
  88. ```
  89. 偏好可按自己的习惯改成无糖或其他可选饮料。门店编码由客户端从查询结果中传递;不能在没有位置依据时声称自动选中了“离你最近”的店。
  90. **实现说明:** Python 和网页使用确定性筛选、排序与非支配集合比较。`SKILL.md` 引导 AI 客户端理解需求、查询并解释结果,不制造三个独立模型的角色对话。新版在 WorkBuddy 客户端中的完整对话路径仍需验收,详见 [验证记录](docs/validation.md)。
  91. ## 两个零输入入口(不用你描述需求)
  92. | 入口 | 行为 |
  93. |---|---|
  94. | **随便来一份**(`--any`) | 不设预算时**明说"未设预算"**,只按其他硬性条件给一个默认答案;不会偷偷替你假定一个预算 |
  95. | **跟上次一样**(`--last`,需 `--live`) | 读最近一次订单,**只复用门店与商品编码**,按当次价重新核价(不复用历史金额);上次的商品若已售罄会逐条告诉你并去掉,**不替换**;上次那家店不在营业时间就明说,退回默认方案 |
  96. | **企业团餐 / 主题派对** | **不是个人点餐的渠道**,属于独立场景(`query-meal-assistance` / `party-*`),本工具不把它们混进来 |
  97. ## 先说清楚它查不到什么(免得你白等)
  98. 官方 MCP 覆盖的是麦当劳自有渠道的只读数据。下面三类**现在拿不到**,遇到时它会直说,而不是猜:
  99. 1. **券/卡的完整条款原文**:「不与其他优惠同享」的具体边界没有对应工具,只有券名、官方状态与时间字段。
  100. 2. **麦金卡 / 早餐卡的实时权益**(剩余次数、适用门店):35 个工具里没有对应入口。
  101. 3. **份量 / 克重 / 尺寸**:没有数据源,所以它不会回答「是不是缩水了」,只会给同价位的替代方案。
  102. 另外,MCP **不含美团、饿了么、京东、抖音、淘宝闪购等第三方渠道**——第三方价格与券以各渠道自己的页面为准。以上三类之外的实时价格、门店供应、营业状态、券的可用性判定,都走官方接口。
  103. ## 更多取舍细节
  104. 前沿解释(其他候选被谁、差在哪个维度比下去)与预算阶梯(差 ¥2 能多几份)的完整说明见 [功能细节](docs/features.md)。
  105. 网页收录的独立历史样例由 `fixtures/demo-snapshots.json` 管理,当前包括三组南京门店样例;**其中一组的门店名与地址已脱敏**,因为该门店位于作者住所附近,公开它等于公开个人位置。其余两组均包含实测“薯条+有糖可乐”和“薯条+无糖可乐”的去冰组合。各组独立标明门店、公开地址与核价时间,不跨店混比;脱敏只作用于门店标识,核价与营养数据未做修改。网页不实时核价、不接受 Token。
  106. 以下命令供开发者调试;日常使用可直接采用上面的 WorkBuddy 对话入口。
  107. ```bash
  108. python3 demo.py --sugar zero --energy-limit 700 --protein-min 20
  109. python3 demo.py --search-stores --city 南京 --keyword 新街口
  110. # 用返回的真实门店和套餐编码替换下列占位文本
  111. python3 demo.py --list-meals --store-code 门店编码
  112. python3 demo.py --live --store-code 门店编码 --meal-code 套餐编码 --expand --sugar zero --ice none
  113. ```
  114. 没有核验冰量的历史样例不能被改成去冰报价。CLI 当前只自动构造三轮完整套餐;全部杯型、儿童玩具、辣度分级及过敏原尚未完整支持。
  115. ## 积分、优惠券与到店/配送
  116. 券包的时间窗口判定、积分兑换、会员积分、配送地址、以及到店/得来速/麦乐送的编码对应关系,见 [功能细节 · 券与会员](docs/features.md)。
  117. ### WorkBuddy Skill 市场
  118. 已按官方格式补齐元数据与资源目录,可构建 ZIP 分发包:
  119. ```bash
  120. python3 scripts/build_skill_package.py --output /tmp/mcd-agent-gourmet-1.0.0-rc.zip
  121. ```
  122. 包可用于开放平台投稿,**目前未提交审核、未上架**。安装与上架文案见 [市场发布说明](docs/workbuddy-market.md)。Skill 优先使用客户端已配置的麦当劳 MCP;脚本只需 Python 标准库。
  123. ## 本地运行
  124. Python **3.9+**,仅标准库,零第三方依赖。
  125. ```bash
  126. git clone https://github.com/polaris-smart/mcd-agent-gourmet.git
  127. cd mcd-agent-gourmet
  128. python3 demo.py
  129. python3 demo.py --budget 35 --taste no-spicy --sodium-limit 800
  130. python3 demo.py --budget 35 --taste spicy --side fries --json
  131. ```
  132. 默认读取 `fixtures/snapshot.json`。即使本机有 Token,也不会自动联网。
  133. ### 实时核价
  134. 1. 在 [麦当劳开放平台 MCP 登录页](https://open.mcd.cn/mcp/login) 用手机号登录后申请自己的 MCP Token;工具清单、限额与字段说明见 [官方文档](https://open.mcd.cn/mcp/doc)。
  135. 2. 在本机私有环境中设置 `MCD_MCP_TOKEN`。不要提交到 Git,也不要粘贴到公共对话或网页。
  136. 3. 先搜索并选择门店。实时模式必须明确传入 `--store-code` 或已确认的 `--plan`,不会自动沿用南京样例店。再用 `--list-meals` 查看该店当次菜单,用 `--meal-code` 选择套餐。只传门店编码不会载入演示套餐;覆盖计划的旧门店时,必须重新选择餐品及适用的渠道业务编码。
  137. 4. 显式运行:
  138. ```bash
  139. python3 demo.py --list-tools
  140. python3 demo.py --live --plan fixtures/plan.json --budget 35 --taste spicy
  141. ```
  142. 程序读取当次菜单、官方营养数据,对候选逐份 `calculate-price`。真实查询失败会停止,**不拿历史快照伪装成实时结果**。自动构造支持即时三轮套餐;到店已实测,配送/得来速参数已接入但未完成真实核价联调。默认不使用优惠券。
  143. ## 券查询与多维比较
  144. 按名称查可用券、`--save-snapshot` 保存脱敏快照、以及“价格与钠 / 口味与钠 / 四维营养”的非支配比较规则,见 [功能细节 · 券查询与多维比较](docs/features.md)。
  145. ## 取舍原则
  146. - **先完整,再便宜。** 只有满足主食、小食、饮料和份数要求的餐单才进入候选。
  147. - **硬性条件与偏好分开。** “不吃辣”严格排除;“想吃辣”作为偏好,无法满足时解释替代。
  148. - **比较标准透明。** 分别按价格、已知钠含量、口味匹配筛选;多个标准可能选中同一餐单,不制造虚假的“争论”。
  149. - **未知就是未知。** 营养表按餐品完整名称精确匹配。无法匹配则保留 `null`;不能把缺失变成 0,也不输出“营养均衡”标签。
  150. - **选择不是下单。** `--select` 和网页按钮只记录餐单决定,不创建订单或支付。
  151. 适合预算有限、想看清取舍的个人用户,以及学习真实业务 MCP、Agent 角色审阅和失败处理的开发者。当前不处理多人分摊、过敏原判断、医学饮食建议、自动下单或全菜单最优搜索。
  152. ## 验证与开发
  153. ```bash
  154. python3 -B -m unittest discover -s tests -v
  155. node tests/parity.cjs # 可选开发检查,需要 Node.js
  156. python3 -B scripts/build_demo.py # 从同一快照生成网页数据
  157. ```
  158. [验证记录](docs/validation.md) 区分真实接口运行、离线测试、浏览器检查和未验证内容。[改进记录](CHANGELOG.md) 说明从原演示修正了什么。
  159. ```text
  160. gourmet/core.py 完整餐单检查、三角色意见、选择记录
  161. gourmet/mcp.py 标准 Streamable HTTP、只读白名单、错误处理
  162. gourmet/live.py 套餐选项、官方核价、营养表解析
  163. demo.py 本地演示与显式实时入口
  164. fixtures/plan.json 六份候选模板,不含凭证
  165. fixtures/snapshot.json 脱敏真实历史快照
  166. docs/ 免 Token 网页体验与说明
  167. tests/ Python 回归与 Python/JS 决策一致性
  168. ```
  169. ## 参赛与贡献
  170. M-CODE 2026 独立参赛作品,非麦当劳官方产品。[官方报名记录](https://github.com/M-China/mcd-developer-innovation-challenge/issues/565)。本次修订使用 Codex 辅助,WorkBuddy 历史材料与证据状态单独说明,不将本次工作冒充 WorkBuddy 对话。
  171. 欢迎提 Issue,描述“我输入了什么、期望什么、实际出现什么”;**不要附 Token、账号或原始优惠券数据**。提 PR 前请先看 [CONTRIBUTING.md](CONTRIBUTING.md)(本地四步检查:测试 / parity / CLI 冒烟 / `data.js` 无 drift)。如果这个透明决策的思路对你有帮助,欢迎点一颗 Star。
  172. 原创代码采用 [MIT License](LICENSE)。官方参赛声明按官方原文保留,相关商标与服务条款归权利人所有。输出仅供参考,餐品信息、价格和供应状态以官方当前结果为准,不构成医疗、营养或其他专业建议。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.