Skip to content
Back to search

mcd-fit-planner

今天练什么,这一餐就怎么选。按训练计划比较麦当劳套餐实价和营养,临时休息顺延,生成月年吃麦手账。免安装在线体验 · 官方 MCP · WorkBuddy / Codex / DeepSeek Agent

Safety scan

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

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tomsbin--mcd-fit-planner/badge.svg)](/listings/tomsbin--mcd-fit-planner)

HTML

<a href="/listings/tomsbin--mcd-fit-planner"><img src="/api/listings/tomsbin--mcd-fit-planner/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.

README.md · README · 205 lines
  1. <div align="center">
  2. **MCD FIT PLANNER · 吃麦,也有自己的节奏**
  3. # 今天吃麦,刚好合拍。
  4. 提前记住你的训练计划,点餐时比较套餐,月末把吃过的日子整理成手账。
  5. [![Release](https://img.shields.io/github/v/release/tomsbin/mcd-fit-planner?style=flat-square&color=786451&label=release)](https://github.com/tomsbin/mcd-fit-planner/releases/latest)
  6. [![Python](https://img.shields.io/badge/Python-3.11%2B-786451?style=flat-square)](#一分钟离线试玩)
  7. [![License](https://img.shields.io/badge/code-MIT-786451?style=flat-square)](LICENSE)
  8. **[免安装在线体验 ↗](https://tomsbin.github.io/mcd-fit-planner/) · [下载技能](https://github.com/tomsbin/mcd-fit-planner/releases/latest) · [开始使用](#安装到-workbuddy) · [接入其他-agent](#codex-与-deepseek-agent)**
  9. WorkBuddy / Codex / 支持 MCP 与本地 Python 的 DeepSeek Agent
  10. <a href="https://tomsbin.github.io/mcd-fit-planner/"><img src="examples/showcase/desktop.png" width="960" alt="训练计划、选餐与吃麦回顾的在线体验,合成数据演示"></a>
  11. <sub>麦当劳饮食计划助手 · 基于麦当劳中国官方 MCP 的非官方 Agent Skill · 预览均为合成数据</sub>
  12. </div>
  13. ## 从今天吃什么,到这一年吃得怎么样
  14. | 先记住你 | 帮你选一餐 | 留下吃麦手账 |
  15. | :--- | :--- | :--- |
  16. | 保存训练、高碳与休息日目标,临时休息顺延计划。 | 默认优先比较套餐,同时看实际应付与整餐营养。 | 记录实际摄入和消费,生成月度、年度网页与分享长图。 |
  17. > “今天训练日,保留我想吃的汉堡,看看套餐怎么搭更划算,也更接近我的目标。”
  18. 当前版本 **0.10.1**。提前录入已有饮食目标后,日常点餐即可沿用计划;每次下单前展示价格、组成和营养差异,由你确认。
  19. ## 先花一分钟,试试自己的节奏
  20. **[打开在线体验,不需要 Token 或安装](https://tomsbin.github.io/mcd-fit-planner/)**
  21. 1. 切换训练日、高碳日、休息日,再调一调预算,看看餐单和营养怎么变化。
  22. 2. 给某一天安排临时休息,看后面的训练如何顺延;可以连续休息,也可以撤回。
  23. 3. 打开月度、年度吃麦手账,体验章节导航与分享图导出。
  24. 体验页全部为合成数据,不查询账户、不下单。休息顺延由本地计划引擎计算全部 128 种七天组合;演示饮食目标不是个人处方。真实使用需安装技能、连接自己的官方 MCP 并提供个人计划。
  25. <details>
  26. <summary><strong>展开完整功能:套餐、营养、计划与账本</strong></summary>
  27. | 场景 | 行为 |
  28. |---|---|
  29. | 预先安排训练日、高碳日和休息日 | 循环长度自定义,每种日类型保存每日和早中晚目标、预算 |
  30. | 临时休息一天 | 暂停循环并顺延后续安排;计划内休息正常推进 |
  31. | 点汉堡、薯条和饮料 | 从当店菜单自动发现相关套餐,核对真实组件,再查询应付总价 |
  32. | 已指定主食或份数 | 保留要求;替换主食、改变份量须展示差异并取得确认 |
  33. | 换更省或更适合目标的搭配 | 同时展示价格、热量及三大营养素变化;同价改善也可推荐 |
  34. | 官方营养缺失 | Agent 主动查对应中国规格的公开来源,保留证据或估算区间;未知不当零 |
  35. | 薯条只吃半份 | 按实际摄入记录,订单购买份数与食用份数分开 |
  36. | 查询吃麦支出 | 合并本地账单,区分待支付、已支付和退款,支持月年统计及 CSV |
  37. | 月末/年末吃货总结 | 生成漂亮的离线网页、SVG 和 PNG 长图:净支出、常点榜、消费节奏与实际营养 |
  38. | 回看健身饮食目标 | 按历史训练/高碳/休息目标,区分达标、估算、超出、不足与未知;全天录全后单独核对 |
  39. 套餐发现默认覆盖相关商品与限额内超值搭配。缺少相关套餐详情或可行套餐未核价时,不能进入下单预览;不能只勾“已检查”就放行。零元应付先列为待核实,不自动当成免费订单。
  40. </details>
  41. ## 一分钟离线试玩
  42. 原单应付、保留同样餐品能省多少、换餐品能省多少分别展示,并保留整餐热量与三大营养素、变化及未知项。优惠候选未比完时明确返回未完成,补查后才进入下单确认;多券拆单另行确认,不自动增加订单。[查看合成比价摘要](examples/comparison-summary.demo.json)。比价呈现参考 [mai-suanpan](https://github.com/W313997791/mai-suanpan),计算与校验由本项目独立实现。
  43. Python **3.11+**,仅使用标准库,不需要 Token 或安装依赖。
  44. ```bash
  45. git clone https://github.com/tomsbin/mcd-fit-planner.git
  46. cd mcd-fit-planner
  47. python -X utf8 demo.py
  48. ```
  49. 演示使用合成餐品、价格、营养与目标,数据库在独立临时目录中,结束后清理;不会读取账户或产生真实订单。
  50. ## 安装到 WorkBuddy
  51. 1. 在 [Releases](https://github.com/tomsbin/mcd-fit-planner/releases) 下载 `mcd-fit-planner-workbuddy.zip`。
  52. 2. WorkBuddy「专家·技能·连接器」→「技能」→「添加技能」→「上传技能」,导入并启用。
  53. 3. 在 [麦当劳 MCP 平台](https://open.mcd.cn/mcp) 取得自己的 Token,在本机连接器接入 `https://mcp.mcd.cn`。
  54. 4. 先查询营养和菜单验证连接,再录入自己的已有计划、默认门店与预算。
  55. [配置示例](mcp-config.example.json)只包含环境变量占位符 `${MCD_MCP_TOKEN}`。由支持变量展开的宿主在本机读取;宿主不支持时,在其本机连接器界面填写。不要提交包含真实 Token 的配置。
  56. 其他宿主可使用通用包 `mcd-fit-planner-skill.zip`,或直接读取 [SKILL.md](skill/mcd-fit-planner/SKILL.md)。详细步骤见 [WorkBuddy 安装说明](skill/mcd-fit-planner/references/workbuddy-setup.md)。
  57. ## Codex 与 DeepSeek Agent
  58. | 环境 | 接入方式 |
  59. |---|---|
  60. | Codex app/CLI/IDE | 将通用包的技能文件夹放入个人 `~/.agents/skills/` 或项目 `.agents/skills/`,合并 [MCP TOML 示例](examples/codex-config.example.toml) |
  61. | DeepSeek 模型的 Agent | 由宿主加载 SKILL.md、桥接官方 MCP、执行本地 Python;普通聊天窗口需先具备这些能力 |
  62. | 不接模型,仅做统计 | 直接运行本地脚本生成总结,无需模型 API Key 或 MCP Token |
  63. [完整接入与只读验收](skill/mcd-fit-planner/references/hosts.md)包含官方文档来源。当前已验证本地脚本和图片渲染,以及 WorkBuddy 官方 MCP 查询;DeepSeek API 端到端联调尚未验证。不会因安装技能替换宿主已有配置。
  64. ## 这一餐,选得明白
  65. 新增离线选餐比较页:看每份已核价餐单的预算余量、实际组成、热量与三大营养素。切换两份方案,查看增加、减少与保持的餐品及整餐差价。全部超预算时,明确展示最接近的已报价方案和超额,由你决定是否调整预算,不放宽训练营养目标。
  66. [直接打开选餐比较页](https://tomsbin.github.io/mcd-fit-planner/compare.html),或[下载合成演示网页](examples/meals/compare.html)后用浏览器打开,可改预算、切换比较和复制餐单。它使用本次快照,不联网查价或下单,过期报价标为历史参考。
  67. ![离线选餐比较页:合成数据](examples/meals/preview.png)
  68. ```powershell
  69. python skill/mcd-fit-planner/scripts/meal_report.py --input data/recommend.local.json --output data/meal-report.local.html
  70. ```
  71. [操作与数据口径](skill/mcd-fit-planner/references/meal-report.md)。预算余量与组成比较体验参考 [mcd-budget-meal](https://github.com/Sam-Hui-dot/mcd-budget-meal),脚本及页面独立实现。
  72. ## 月末/年末吃麦手账
  73. 回顾页现在带有轻浮动商品图、随章节进入的数字、逐根展开的消费柱线与阅读进度;柱线支持触控和键盘查询金额。小票、收藏卡、圈注与分享卡采用柔和纸面层次,月报/年报使用不同封面文案。设备开启“减少动态效果”时自动关闭动效;导出的长图保留完整静态数值。
  74. 生成分章节回顾网页和 **1080×1780 分享长图**。从封面、消费小票、常点席位,到饮食目标和保存分享,一屏讲一件事;整套采用统一米白纸色、灰褐图表、衬线排版与麦当劳中国官网商品配图。网页支持章节导航、键盘翻页、展开每日明细和 PNG/SVG 下载;模板与商品图均内嵌,可离线打开,配图来源见[第三方说明](skill/mcd-fit-planner/references/third-party-notices.md)。
  75. ![消费、常点、目标与分享四章:合成示例](examples/recaps/chapters-preview.png)
  76. [手机版封面](examples/recaps/mobile-cover.png) · 以下是可导出的月度/年度分享长图:
  77. <details>
  78. <summary>查看月度与年度分享长图</summary>
  79. <a href="examples/recaps/month.png"><img src="examples/recaps/month.png" width="360" alt="月度吃麦手账合成示例"></a>
  80. <a href="examples/recaps/year.png"><img src="examples/recaps/year.png" width="360" alt="年度吃麦手账合成示例"></a>
  81. </details>
  82. 上图**全部为合成演示数据**,不含个人账本。直接打开[月度网页](https://tomsbin.github.io/mcd-fit-planner/month.html)/[年度网页](https://tomsbin.github.io/mcd-fit-planner/year.html),也可下载仓库中的 HTML 离线查看。
  83. ```powershell
  84. # 离线演示:不读取真实账户或账本
  85. python skill/mcd-fit-planner/scripts/period_recap.py --demo --period 2026-09 --output data/month.html --png data/month.png
  86. # 真实统计:只读现有账本,路径换成自己的固定位置
  87. 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"
  88. ```
  89. Python 仅使用标准库;命令行 PNG 需要本机 Edge/Chrome,没有时可打开 HTML 下载图片。真实统计按实际食用份数计算,购买不等于摄入;目标使用录入时的快照,修改计划不追溯改判。估算和缺失不算可核实达标,一餐结果不等于全天结果,全天需用户确认吃喝已录全。高碳日检查碳水目标,不把低热量统一当作最好。详见 [总结图与统计口径](skill/mcd-fit-planner/references/period-recap.md)。
  90. ## 使用示例
  91. 以下是功能示例,不是个人饮食处方;实际目标由使用者已有计划提供。
  92. > 保存我的训练 A、高碳训练 B、休息、训练 C 循环;每天和各餐按我提供的目标与预算执行。
  93. > 推荐今天午餐,保留指定汉堡,优先比较套餐。这次先不下单。
  94. > 今天临时休息,后续训练顺延。
  95. > 这个搭配换饮料能省多少?热量、蛋白质、碳水和脂肪怎么变?
  96. > 薯条只吃了一半,记录实际摄入。这个月和今年吃麦当劳花了多少?
  97. > 生成上个月的吃麦手账,给我网页和分享长图。按我当时的训练计划看看哪些餐达标、哪些超了或蛋白质没吃够。
  98. 整餐报告列出营养点值、估算区间或已知下限,注明来源;对照已录入的当日训练模板,说明符合、超出或不确定。成年男女群体参考会注明年龄、活动水平和标准版本,不替代个人目标。
  99. 账本保存在**技能目录之外的固定本机目录**,每次操作统一传 `--db`。订单未付款不记为已支出,生成订单不记为已经食用;近期订单接口不代表完整年度历史。
  100. ## 工作流程
  101. ```mermaid
  102. flowchart LR
  103. A[读取当日计划] --> B[菜单与套餐发现]
  104. B --> C[详情组件与营养]
  105. C --> D[官方计价与优惠比较]
  106. D --> E[整餐报告与预览]
  107. E --> F[用户确认后重新计价]
  108. F --> G[单次创建订单]
  109. G --> H[用户付款与本地账本]
  110. ```
  111. 本地 Python 负责计算与校验,官方 MCP 调用由宿主 Agent 完成。付款由用户在官方渠道完成。完整工具和字段流程见 [MCP_INTEGRATION.md](MCP_INTEGRATION.md)。
  112. ## 验证与构建
  113. ```bash
  114. python -X utf8 -m unittest discover -s tests
  115. python -X utf8 build.py
  116. ```
  117. 当前 **251 项离线测试**覆盖循环顺延、营养区间、套餐自动发现及优先级、排除套餐变体、用券参数、零元报价隔离、预览确认、账本和导出,以及月年总结、历史目标、全天确认、半份/估算/漏记、退款和只读输出保护。另已用真实浏览器验证网页筛选与 SVG/PNG 下载,图片尺寸为 1080×1780。测试中的优惠价格与券码为合成数据;公开食品捕获样例不含账户信息,不能代表当前库存或价格。
  118. 已使用官方 MCP 完成真实营养、门店菜单、详情和计价查询。真实付款、券核销,以及外送、团餐和预约的线上交易未作为完成验证;相关参数链路有离线测试。价格结论只覆盖实际查询的候选,不保证全菜单、全渠道最低;小程序可见活动可能与 MCP 不同。
  119. 构建输出:
  120. - `dist/mcd-fit-planner-workbuddy.zip`:WorkBuddy 导入包。
  121. - `dist/mcd-fit-planner-skill.zip`:通用技能包。
  122. ## 文档与许可
  123. - [本地数据和命令](skill/mcd-fit-planner/references/local-data.md)
  124. - [菜单、套餐与组件](skill/mcd-fit-planner/references/catalog-builder.md)
  125. - [营养来源与报告](skill/mcd-fit-planner/references/nutrition-report.md)
  126. - [MCP 编排及订单确认](skill/mcd-fit-planner/references/mcp-flow.md)
  127. - [Codex 与 DeepSeek Agent 接入](skill/mcd-fit-planner/references/hosts.md)
  128. - [月年总结图与统计口径](skill/mcd-fit-planner/references/period-recap.md)
  129. 项目代码采用 [MIT 许可](LICENSE)。商品图片版权归原权利人所有,不包含在代码 MIT 许可中。优惠门槛解析改编自 MIT 授权的 `mcd-coupon-strategist`,配图来源、修改说明及完整许可见 [第三方声明](skill/mcd-fit-planner/references/third-party-notices.md)。
  130. 本项目为非官方参赛作品,与麦当劳不存在官方产品或背书关系。规则见 [官方活动仓库](https://github.com/M-China/mcd-developer-innovation-challenge),参赛声明使用官方原文。

Ratings and comments

Sign in to rate this skill.

Sign in

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