麦当劳积分体检教程：mcd-coupon-strategist 如何识破15个仍标「上架」的过期兑换商品

mcd-coupon-strategist 是一款基于麦当劳中国 MCP 的「麦麦省钱助手」Skill，它的积分体检功能帮你回答两个新手最常问的问题：我手里到底有多少积分，哪些商品真的还能换。真实数据实测发现了一个坑：积分商城接口返回的 24 个商品里，有 15 个状态仍标着「上架」，但兑换截止日早已过去——只看状态，会误以为有 24 个可换，实际只有 9 个。

为什么「上架」状态不能信？

麦当劳积分商城里，每个商品有两个和「能不能换」相关的字段：

真实响应录制在 fixtures/points_products.json（2026-10-14 采集）：24 个商品status全是「上架」，其中 15 个的downTime已经过去，最早的甚至 2026 年 3 月就截止了。

💡 结论：status≠ 可兑换。能自己按截止日校验，就不要把判断权交给一个可能过期的字段。

30秒上手：零配置跑一次积分体检

项目把真实 MCP 响应都录在fixtures/里，demo 不需要 Token、不装任何第三方库、不联网：

git clone https://gitcode.com/gh_mirrors/mc/mcd-coupon-strategist cd mcd-coupon-strategist python demo.py

在输出中找到「积分体检」部分，这个账户的体检结果长这样：

• 可用376.3积分 · 累计 581.3 · 已用 188
• ⚠️ 已过期17积分 —— 已经发生的真实损失
• 积分商城 24 个商品：9 个仍在兑换期内（其中 6 个换得起），15 个已过兑换期
• 现在就能换：6.9元可乐（50 积分）、3.9元圆筒冰淇淋（100 积分）、16.9元2份麦辣鸡翅（200 积分）……

体检是怎么做的：按downTime判断，而不是status

核心逻辑在 src/points.py，思路很直接：

1. 可兑换性只看截止日：RedeemableItem.is_open()只比较downTime剩余天数——≥ 0 算仍可兑换（截止日当天也算），< 0 归入「已过兑换期」；
2. 解析只读结构化字段：src/mcd_adapter.py 的parse_points_products只取spuName / spuId / point / downTime / status；注意积分是字符串且可以是小数（如"376.3"），不能按整数解析；
3. 自测锁死关键行为：src/test_points.py 明确要求过滤后剩 9 个在期、15 个过期，且被过滤的 15 个状态全部仍是「上架」——这正是不能只看状态的证据。

体检顺带发现的 2 个隐藏损失

① 17 个已过期积分是看不见丢的钱。fixtures/points_account.json 里expiredPoint字段直接显示该账户已经过期过 17 积分。和券一样，积分也是有保质期的钱，只是大多数人毫无察觉。

② 同款商品、不同积分价。真实数据里「10.9元指定小食任选」有两个 SPU：一个要 200 积分，一个只要 100。体检会自动识别并提示换便宜的那个——换贵的等于白扔 100 积分。

一件体检故意不做的事：不告诉你「积分值多少钱」

积分没有固定汇率——它值多少，取决于你换的那张券能省多少，而这要靠带券计价实测。所以本工具只给事实（余额、截止日、够不够），不给「约等于 ¥X」。宁可少报，不可编造。

关键文件速查

📌 一句话总结：看积分商城，别看状态，看截止日。mcd-coupon-strategist 的麦当劳积分体检，把「哪些真的还能换」变成了可验证的数字，顺手还能揪出已经悄悄过期的损失。