从今天吃什么，到这一年吃得怎么样

“今天训练日，保留我想吃的汉堡，看看套餐怎么搭更划算，也更接近我的目标。”

当前版本 0.10.0。提前录入已有饮食目标后，日常点餐即可沿用计划；每次下单前展示价格、组成和营养差异，由你确认。

先花一分钟，试试自己的节奏

打开在线体验，不需要 Token 或安装

1. 切换训练日、高碳日、休息日，再调一调预算，看看餐单和营养怎么变化。
2. 给某一天安排临时休息，看后面的训练如何顺延；可以连续休息，也可以撤回。
3. 打开月度、年度吃麦手账，体验章节导航与分享图导出。

体验页全部为合成数据，不查询账户、不下单。休息顺延由本地计划引擎计算全部 128 种七天组合；演示饮食目标不是个人处方。真实使用需安装技能、连接自己的官方 MCP 并提供个人计划。

套餐发现默认覆盖相关商品与限额内超值搭配。缺少相关套餐详情或可行套餐未核价时，不能进入下单预览；不能只勾“已检查”就放行。零元应付先列为待核实，不自动当成免费订单。

一分钟离线试玩

原单应付、保留同样餐品能省多少、换餐品能省多少分别展示，并保留整餐热量与三大营养素、变化及未知项。优惠候选未比完时明确返回未完成，补查后才进入下单确认；多券拆单另行确认，不自动增加订单。查看合成比价摘要。比价呈现参考 mai-suanpan，计算与校验由本项目独立实现。

Python 3.11+，仅使用标准库，不需要 Token 或安装依赖。

git clone https://github.com/tomsbin/mcd-fit-planner.git
cd mcd-fit-planner
python -X utf8 demo.py

演示使用合成餐品、价格、营养与目标，数据库在独立临时目录中，结束后清理；不会读取账户或产生真实订单。

安装到 WorkBuddy

1. 在 Releases 下载 mcd-fit-planner-workbuddy.zip。
2. WorkBuddy「专家·技能·连接器」→「技能」→「添加技能」→「上传技能」，导入并启用。
3. 在 麦当劳 MCP 平台 取得自己的 Token，在本机连接器接入 https://mcp.mcd.cn。
4. 先查询营养和菜单验证连接，再录入自己的已有计划、默认门店与预算。

配置示例只包含环境变量占位符 ${MCD_MCP_TOKEN}。由支持变量展开的宿主在本机读取；宿主不支持时，在其本机连接器界面填写。不要提交包含真实 Token 的配置。

其他宿主可使用通用包 mcd-fit-planner-skill.zip，或直接读取 SKILL.md。详细步骤见 WorkBuddy 安装说明。

Codex 与 DeepSeek Agent

完整接入与只读验收包含官方文档来源。当前已验证本地脚本和图片渲染，以及 WorkBuddy 官方 MCP 查询；DeepSeek API 端到端联调尚未验证。不会因安装技能替换宿主已有配置。

这一餐，选得明白

新增离线选餐比较页：看每份已核价餐单的预算余量、实际组成、热量与三大营养素。切换两份方案，查看增加、减少与保持的餐品及整餐差价。全部超预算时，明确展示最接近的已报价方案和超额，由你决定是否调整预算，不放宽训练营养目标。

直接打开选餐比较页，或下载合成演示网页后用浏览器打开，可改预算、切换比较和复制餐单。它使用本次快照，不联网查价或下单，过期报价标为历史参考。

python skill/mcd-fit-planner/scripts/meal_report.py --input data/recommend.local.json --output data/meal-report.local.html

操作与数据口径。预算余量与组成比较体验参考 mcd-budget-meal，脚本及页面独立实现。

月末／年末吃麦手账

生成分章节回顾网页和 1080×1780 分享长图。从封面、消费小票、常点席位，到饮食目标和保存分享，一屏讲一件事；整套采用统一米白纸色、灰褐图表、衬线排版与麦当劳中国官网商品配图。网页支持章节导航、键盘翻页、展开每日明细和 PNG／SVG 下载；模板与商品图均内嵌，可离线打开，配图来源见第三方说明。

手机版封面 · 以下是可导出的月度／年度分享长图：

上图全部为合成演示数据，不含个人账本。直接打开月度网页／年度网页，也可下载仓库中的 HTML 离线查看。

# 离线演示：不读取真实账户或账本
python skill/mcd-fit-planner/scripts/period_recap.py --demo --period 2026-09 --output data/month.html --png data/month.png

# 真实统计：只读现有账本，路径换成自己的固定位置
python skill/mcd-fit-planner/scripts/period_recap.py --db "D:/my-mcd-data/planner.sqlite3" --period 2025 --output "D:/my-mcd-data/year.html" --svg "D:/my-mcd-data/year.svg" --png "D:/my-mcd-data/year.png"

Python 仅使用标准库；命令行 PNG 需要本机 Edge／Chrome，没有时可打开 HTML 下载图片。真实统计按实际食用份数计算，购买不等于摄入；目标使用录入时的快照，修改计划不追溯改判。估算和缺失不算可核实达标，一餐结果不等于全天结果，全天需用户确认吃喝已录全。高碳日检查碳水目标，不把低热量统一当作最好。详见 总结图与统计口径。

使用示例

以下是功能示例，不是个人饮食处方；实际目标由使用者已有计划提供。

保存我的训练 A、高碳训练 B、休息、训练 C 循环；每天和各餐按我提供的目标与预算执行。

推荐今天午餐，保留指定汉堡，优先比较套餐。这次先不下单。

今天临时休息，后续训练顺延。

这个搭配换饮料能省多少？热量、蛋白质、碳水和脂肪怎么变？

薯条只吃了一半，记录实际摄入。这个月和今年吃麦当劳花了多少？

生成上个月的吃麦手账，给我网页和分享长图。按我当时的训练计划看看哪些餐达标、哪些超了或蛋白质没吃够。

整餐报告列出营养点值、估算区间或已知下限，注明来源；对照已录入的当日训练模板，说明符合、超出或不确定。成年男女群体参考会注明年龄、活动水平和标准版本，不替代个人目标。

账本保存在技能目录之外的固定本机目录，每次操作统一传 --db。订单未付款不记为已支出，生成订单不记为已经食用；近期订单接口不代表完整年度历史。

工作流程

flowchart LR
    A[读取当日计划] --> B[菜单与套餐发现]
    B --> C[详情组件与营养]
    C --> D[官方计价与优惠比较]
    D --> E[整餐报告与预览]
    E --> F[用户确认后重新计价]
    F --> G[单次创建订单]
    G --> H[用户付款与本地账本]

本地 Python 负责计算与校验，官方 MCP 调用由宿主 Agent 完成。付款由用户在官方渠道完成。完整工具和字段流程见 MCP_INTEGRATION.md。

验证与构建

python -X utf8 -m unittest discover -s tests
python -X utf8 build.py

当前 251 项离线测试覆盖循环顺延、营养区间、套餐自动发现及优先级、排除套餐变体、用券参数、零元报价隔离、预览确认、账本和导出，以及月年总结、历史目标、全天确认、半份／估算／漏记、退款和只读输出保护。另已用真实浏览器验证网页筛选与 SVG／PNG 下载，图片尺寸为 1080×1780。测试中的优惠价格与券码为合成数据；公开食品捕获样例不含账户信息，不能代表当前库存或价格。

已使用官方 MCP 完成真实营养、门店菜单、详情和计价查询。真实付款、券核销，以及外送、团餐和预约的线上交易未作为完成验证；相关参数链路有离线测试。价格结论只覆盖实际查询的候选，不保证全菜单、全渠道最低；小程序可见活动可能与 MCP 不同。

构建输出：

• dist/mcd-fit-planner-workbuddy.zip：WorkBuddy 导入包。
• dist/mcd-fit-planner-skill.zip：通用技能包。

文档与许可

• 本地数据和命令
• 菜单、套餐与组件
• 营养来源与报告
• MCP 编排及订单确认
• Codex 与 DeepSeek Agent 接入
• 月年总结图与统计口径

项目代码采用 MIT 许可。商品图片版权归原权利人所有，不包含在代码 MIT 许可中。优惠门槛解析改编自 MIT 授权的 mcd-coupon-strategist，配图来源、修改说明及完整许可见 第三方声明。

本项目为非官方参赛作品，与麦当劳不存在官方产品或背书关系。规则见 官方活动仓库，参赛声明使用官方原文。