mcd-git
用本地命令行 mcd-git(git mcd --json)帮用户点麦当劳:选门店、看菜单、加购物车(去酸黄瓜、少冰、套餐换搭)、自动凑套餐挑最省的券、核价、下单拿支付链接、查取餐码、再来一单、取消订单、领券(pull,先确认),以及生成 1024 吃麦贡献图(card)。用户提到点麦当劳、麦当劳到店 / 得来速 / 麦乐送、取餐码、再来一单、取消麦当劳订单、领麦当劳的券、吃麦贡献图时使用。下单、取消和领券都必须先把确认摘要给用户看,用户明确同意后才能带 --confirm 执行。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/zhutoumeme--mcd-git)HTML
<a href="/listings/zhutoumeme--mcd-git"><img src="/api/listings/zhutoumeme--mcd-git/badge.svg" alt="findsafeskills safety rating" /></a>Install
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 · 90 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: mcd-git
- description: 用本地命令行 mcd-git(git mcd --json)帮用户点麦当劳:选门店、看菜单、加购物车(去酸黄瓜、少冰、套餐换搭)、自动凑套餐挑最省的券、核价、下单拿支付链接、查取餐码、再来一单、取消订单、领券(pull,先确认),以及生成 1024 吃麦贡献图(card)。用户提到点麦当劳、麦当劳到店 / 得来速 / 麦乐送、取餐码、再来一单、取消麦当劳订单、领麦当劳的券、吃麦贡献图时使用。下单、取消和领券都必须先把确认摘要给用户看,用户明确同意后才能带 --confirm 执行。
- ---
- # mcd-git:用 git 命令点麦当劳
- mcd-git 把麦当劳中国 MCP Server 包装成 git 风格的命令:`add` 放进购物车,`rebase` 凑最省,`commit` 锁单,`push` 才真正下单。你通过 `git mcd … --json` 操作它,读 JSON 结果,再用自然语言告诉用户。
- ## 前提
- - **需要能在用户本机执行命令。** 只能对话、不能跑命令的环境用不了这个 Skill。
- - **安装**(没装时):
- ```bash
- uv tool install git+https://github.com/zhutoumeme/mcd-git
- # 没有 uv:
- pip install "git+https://github.com/zhutoumeme/mcd-git"
- ```
- 装好后运行 `git mcd help` 确认(也可以用等价的 `mcd-git help`)。看命令对照表一律用 `git mcd help`;不要在 `mcd` 后面直接跟 `--help`,那样会被 git 拦截去找 man 手册。单个子命令的帮助用 `git mcd <命令> -h`。**人工在终端操作和补全时优先用 `mcd-git`;Agent 自动化仍走 `git mcd --json`。**真人用户需要 TAB 补全时,按 README 的平台说明运行 `mcd-git completion powershell` / `bash` / `zsh` / `fish`,再重载对应 shell;Agent 不需要安装或调用补全脚本。
- - **跨平台补全边界**:本 Skill 的 Agent 不按 TAB、不解析 shell 补全候选,也不把 `completion` 当作业务流程;始终只执行 `git mcd --json`,再根据 JSON 结果继续。人工在终端操作和补全时优先用 `mcd-git`;`git-mcd` 是等价兼容入口,`git mcd` 只是可选兼容,依赖 Git 自带的 bash/zsh/fish 补全转发,Windows PowerShell 不保证 Git 转发。菜单补全只读最近的本机缓存,缓存缺失或过期时不联网;需要最新菜单时才按业务流程调用 `git mcd ls-remote --json`。
- - **Token 由用户自己配置**:环境变量 `MCD_MCP_TOKEN`(所有平台首选),或配置文件(macOS / Linux 用 `~/.config/mcd-mcp/token`,Windows 用 `%APPDATA%\mcd-mcp\token`,也支持 `XDG_CONFIG_HOME`)。不要让用户把 Token 发进对话,不要读取、打印或改写 Token 文件。命令报「没有找到麦当劳 MCP Token」时,告诉用户去 open.mcd.cn 控制台申请并自己写进上面的位置(命令的报错 hint 会按平台给出具体命令和路径)。
- - **没有 Token 时**可以加 `--demo` 演示全流程(合成数据,不会真的下单),并明确告诉用户这是演示。
- ## 必须遵守的规则
- 1. **只通过 `git mcd … --json` 操作。** 一律带 `--json`:输出稳定好解析,而且不会弹出 y/N 交互提示(交互提示是留给真人的,不要替用户回答)。不要直接调用 MCP 的写操作 tool(`create-order`、`cancel-order`、`auto-bind-coupons`、`mall-create-order`、`draw-lottery`、`party-order-create`、`delivery-create-address`),即使你的环境里配了麦当劳 MCP 连接器。
- 2. **下单前必须确认。** 先不带 `--confirm` 运行 `git mcd push … --json`,把返回的确认摘要(门店、取餐方式、时间、餐具、每样商品、券、应付金额)如实告诉用户,并说明「会生成一笔待支付订单,付款要你自己完成」。只有用户明确说「确认 / 下单 / 可以」之后,才运行 JSON 里 `data.next` 给出的那条命令(带 `--confirm <commit 哈希>`)。用户没明确同意、或改了任何条件(时间、取餐方式、餐品),都要重新预览、重新确认;改餐品要先并进这一单,见常用流程「下单前改餐品」。`push` 返回 `error.detail.code == "uncommitted_changes"`,说明购物车里还有没并进这一单的餐品(列在 `error.detail.uncommitted`),这次什么都没下单:**先问用户**这些要不要加进这一单,要就运行 `error.detail.amend`(`commit --amend`),不要就运行 `error.detail.discard`(`reset` 清空购物车)。`error.detail.amend` 是 null 时,HEAD 是另一家店(或另一种取餐方式)的单,购物车没法并进去:**先问用户**是放弃购物车(`error.detail.discard`),还是撤回那一单(`error.detail.withdraw`,即 `reset --soft HEAD~1`:那一单的餐品放回购物车,再按现在的门店重新 commit)。两种情况都不要替用户选,处理完都要重新预览、重新确认。
- 3. **取消订单同理。** `git mcd revert --reason <编号> --json` 先预览,用户同意后运行 `data.next`(带 `--confirm <订单号>`)。取消原因要让用户选:1 改主意了、2 重复下单、3 点错了/点多了/点少了、4 地址/电话填错了、5 送达时间选错了、-1 其它原因。
- 4. **领券也一样先确认。** 只用 `git mcd pull`,不要直接调 `auto-bind-coupons`。先运行 `git mcd pull --json` 预览,把 `data.summary` 如实告诉用户:一共 `count` 张、每张叫什么(`coupons[].name`),以及「会一次全部领进你的账户,接口不支持只领其中几张」。用户明确同意后才运行 `data.next`(带 `--confirm <指纹>`);用户只想要其中几张、或者没表态,就不要领。预览时 `data.status == "up-to-date"` 说明现在没有可领的券;执行 `data.next` 之后返回 `up-to-date`(带 `note`)表示服务端这次一张都没发,先 `git mcd fetch --json` 核对,不要重试。`--confirm` 报「可领券列表变了」时什么都没领,要重新预览、重新确认。报「不确定券有没有领到」时先 `git mcd fetch --json` 核对还剩哪些可领,不要重试。不要定时、循环或者批量领券,每次都由用户发起。
- 5. **不代付、不轮询。** 只把 `payH5Url` 和付款截止时间交给用户;用户说付好了,再运行一次 `git mcd show --json` 查取餐码。不要循环查询订单状态。
- 6. **出错不盲目重试。** `push` 报「不确定订单有没有建成」时,先 `git mcd log --json` 核对最新订单,再和用户商量,绝不直接再 push 一次。
- 7. **不替用户多点。** 份数、餐品都以用户说的为准;`rebase` 只会在不加东西的前提下省钱,你也不要主动加购。
- 8. **金额单位是「分」。** JSON 里的金额(`payable`、`price`、`subtotal`、`unitPrice` 等)都是整数分,告诉用户时除以 100,写成 ¥33.50。
- ## 常用流程
- | 步骤 | 命令 | 看 JSON 的哪里 |
- |---|---|---|
- | 选门店 | `git mcd init [--limit N] --json` | `data.status == "choose"` 时把 `data.candidates` 给用户选,再 `git mcd init --pick <序号> --json`;`--limit N` 只在本地截取前 N 家(接口一次大约只给 5 家,不会多调) |
- | 按地标找店 | `git mcd init --city 上海 --keyword 人民广场 [--limit N] --json` | 同上;`--city` 和 `--keyword` 必须一起给(只给其中一个会报错,接口不认);得来速加 `--mode drive`;麦乐送 `--mode delivery`(再用 `--address <序号>` 选地址) |
- | 现状 | `git mcd status --json` | `data.remote`、`data.index`(购物车)、`data.coupons`、`data.pendingPayment` |
- | 看菜单 | `git mcd ls-remote <关键词> --json` | `data.meals[]`:`code`、`name`、`type`、`price`(真实可得价);有 `offerNote` 的是条件优惠(如「¥37.00 需随单购麦金卡」,`offerPrice` 是条件价),要同时买会员卡才成立,不要当成用户能拿到的价格 |
- | 加购 | `git mcd add 巨无霸 中薯条 --no-pickle --json` | 名字有歧义时 `ok == false`,候选在 `error.detail.candidates`,问用户要哪个,或直接用 code |
- | 特制 / 换搭 | `--no <配料>`、`--with 少冰`、`--with 加一份浓缩`、`--choose 大薯条`、`-n 2` | `data.warnings` 里是没生效的定制 |
- | 移出 / 清空 | `git mcd restore --staged <餐品> --json`、`git mcd reset --json` | `data.index` |
- | 省钱 | `git mcd rebase --json` | `data.before` → `data.after`、`data.saved`、`data.todo`;不满意 `git mcd reset ORIG_HEAD` |
- | 看明细 | `git mcd diff --json` | `data.rows[]`:`a`(原价 / 不用券)、`b`(应付 / 用券后) |
- | 锁单 | `git mcd commit -m "午饭" --json` | `data.short`(commit 哈希)、`data.payable` |
- | 下单前改餐品 | `add` / `restore --staged` 改购物车 → `git mcd commit --amend --json` 并进这一单 → 重新预览 `git mcd push … --json` | `data.short` 会变,之前的预览作废,要重新给用户确认。`restore` 只动购物车;要去掉已经 commit 的餐品,先 `git mcd reset --soft HEAD~1 --json` 放回购物车,改完再 `git mcd commit -m … --json` |
- | 下单预览 | `git mcd push [--at 12:20] [--locker / --eat-in / --take-out] [--no-tableware] [--remark 备注] --json` | `data.status == "confirmation_required"`、`data.summary`、`data.next` |
- | 用户同意后 | 原样运行 `data.next` 里的命令(已经带好 `--confirm <哈希>` 和 `--json`) | `data.status == "pushed"`、`data.payH5Url`、`data.expirePayTime` |
- | 查取餐码 | `git mcd show --json` | `data.order.statusLabel`、`pickupCode`、`lockerCode`、`delivery` |
- | 历史 | `git mcd log --oneline --json` | `data.entries[]`(最多最近 10 单) |
- | 吃麦统计 | `git mcd log --stat [-n 10] [--since YYYY-MM-DD] [--until YYYY-MM-DD] --json` | `data.summary`(`orders`、`cancelled`、`pending`、`lines`、`paid`、`saved`、`savedUnknown`、`slots`、`top`;金额是分,只算吃了的单,已取消和待支付不计入)、`data.entries[]`(`counted` 表示是否计入)。数据来自本机账本,`savedUnknown` 是没有优惠明细的单数,省下的钱是下限 |
- | 再来一单 | `git mcd cherry-pick HEAD --json`,再 `git mcd commit -m 再来一单 --json`,然后按「下单预览」走 | `data.index`、`data.conflicts`(本店买不到的会列出来)。cherry-pick 只放回购物车,不 commit 就 push 会报「购物车还没 commit」。只用于已经 push 过的单:HEAD 还没 push 时它本来就是这一单,`cherry-pick HEAD` 会被拒绝(`error.detail.code == "empty_cherry_pick"`,购物车不动),直接按「下单预览」走;用户要多点就 `add` 后 `commit --amend` |
- | 取消 | `git mcd revert --reason 3 --json` | 预览后用户同意,再运行 `data.next` |
- | 活动和可领券 | `git mcd fetch --json` | `data.events`、`data.claimable`(只读;要领就按下面「领券」走) |
- | 领券预览 | `git mcd pull --json` | `data.status == "confirmation_required"`、`data.summary`(`count`、`coupons[]`、`note`)、`data.next`;`"up-to-date"` 表示没有可领的券 |
- | 用户同意领券后 | 原样运行 `data.next` 里的命令(已经带好 `--confirm <指纹>` 和 `--json`) | `data.status == "pulled"`、`data.successCount`、`data.failedCount`、`data.claimed[]`、`data.failed[]`(`reason`);领到之后下单前照常 `git mcd rebase` 挑最省的券 |
- | 吃麦贡献图 | `git mcd card -o <路径> --json`;`--style skyline`(默认,麦门天际线,贴 GitHub 主页)/ `receipt`(年度吃麦小票,发朋友圈)/ `grid`(平面格子),用户没说就用默认 | `data.style`、`data.path`(写好的 SVG)、`data.stats`(`total`、`topItem`、`topSlot`、`earliest`);`data.status == "empty"` 说明还没有记录,没写文件。不给 `-o` 时默认文件名按样式区分(`mcd-contributions-<样式>.svg`,互不覆盖)。只在本机写文件:不要替用户把图提交或上传到 GitHub,也不要设置定时任务;默认不加 `--with-savings`,用户想看省了多少钱再加 |
- - `--remark` 只用于麦乐送;`--locker` 要门店有取餐柜,没有会报错,把可选的取餐方式告诉用户。
- - `--at` 写 `HH:MM`(今天)或 `"YYYY-MM-DD HH:MM"`;预览和确认时要用完全相同的参数。
- - `push` 返回 `data.status == "up-to-date"` 说明 HEAD 早就下过单,这次**没有新下单**,不要告诉用户「已下单」。只有 `data.status == "pushed"` 才是新下了一单。
- - `--qr` 默认 `full`(整格,各终端都扫得出);`half` 更紧凑,但部分终端(如 macOS Terminal.app)可能扫不出;`fancy`(麦当劳主题码:金色 + 正中像素麦当劳元素 Logo,6 个图案随机出一个,可用 `fancy=名字` 指定汉堡/薯条/麦乐鸡/甜筒/派/金拱门)是给人看 / 扫的。Agent 走 `--json` 时不用特意加。
- - 命令补全(`git mcd completion`)是给真人在终端里按 TAB 用的,Agent 不需要,照常用 `--json`。
- - 每条命令的结果都在 `ok` 字段:`false` 时读 `error.message` 和 `error.hints` 转告用户,退出码非 0。
- ## 一个完整例子
- ```text
- 用户:中午想吃巨无霸,不要酸黄瓜,加中薯条和中可乐,12:20 取餐柜取,不要餐具。
- 你:git mcd add 巨无霸 中薯条 中可乐 --no-pickle --json
- git mcd rebase --json → before 4550,after 3350(凑成套餐 + 一张立减券)
- git mcd commit -m 午饭 --json → short: bfc651c
- git mcd push --at 12:20 --locker --no-tableware --json
- → status: confirmation_required,summary.payable: 3350
- 你对用户:门店 演示·代码港店,外带·店外取餐柜,预约 12:20,不要餐具;
- 巨无霸套餐 [巨无霸 · 中薯条 · 中可乐] 去酸黄瓜,用券后应付 ¥33.50。
- 确认的话我就下单,生成待支付订单后需要你自己付款。
- 用户:确认。
- 你:git mcd push --at 12:20 --locker --no-tableware --confirm bfc651c --json
- → status: pushed,payH5Url、expirePayTime
- 你对用户:下好了,请在 12:05 前打开支付链接付款;付完告诉我,我帮你查取餐码。
- ```
- (例子是 `--demo` 合成数据,门店、价格、哈希都是编的。)
README.md · README · 459 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # mcd-git · 用 git 命令点麦当劳
- <p>
- <img src="assets/badges/python.svg" alt="python 3.9+">
- <img src="assets/badges/license.svg" alt="license MIT">
- <img src="assets/badges/mcp.svg" alt="MCP streamable http">
- <img src="assets/badges/demo.svg" alt="try --demo 无需 Token">
- <img src="assets/badges/unofficial.svg" alt="非官方 参赛作品">
- </p>
- `mcd-git add` 放进购物车,`mcd-git rebase` 自动凑套餐、挑最省的券,`mcd-git push` 才真正下单,终端里直接出支付二维码;需要 Git 子命令语义时也可使用 `git mcd`。基于麦当劳中国 MCP Server(`mcp.mcd.cn`)。
- 
- > 动图和下面所有截图都是 `--demo` 合成数据:门店、价格、订单号、券都是编的,支付链接指向 `example.com`。
- ## 一套引擎,两个入口
- - **开发者**:在终端里优先敲 `mcd-git`,人工操作和命令补全都以它为推荐入口。`git-mcd` 在 PATH 里时,也可以使用 Git 的 `git mcd …` 子命令语义;它不会碰你代码仓库的 `.git`。
- - **普通用户**:把 [SKILL.md](SKILL.md) 装进 WorkBuddy / Claude Code / Kiro,用大白话点餐,Agent 在后台跑 `git mcd --json`。
- 一段 Agent 对话(demo 数据):
- ```text
- 你: 中午想吃巨无霸,不要酸黄瓜,再来中薯条和中可乐。12:20 去店外取餐柜拿,不要餐具,看看怎么最省。
- Agent:(git mcd add 巨无霸 中薯条 中可乐 --no-pickle --json → git mcd rebase --json → git mcd diff --json)
- 三样正好凑成巨无霸套餐,再用一张「示例·巨无霸套餐立减 5 元」:¥45.50 → ¥33.50。
- (git mcd commit -m 午饭 --json → git mcd push --at 12:20 --locker --no-tableware --json)
- 门店 演示·代码港店 · 外带·店外取餐柜 · 预约 12:20 · 不要餐具
- 巨无霸套餐 [巨无霸 · 中薯条 · 中可乐] 去酸黄瓜,应付 ¥33.50。要下单吗?付款需要你自己完成。
- 你: 确认。
- Agent:(git mcd push --at 12:20 --locker --no-tableware --confirm bfc651c --json)
- 下好了,请在 12:05 前打开这个链接付款:https://example.com/mcd-git-demo/pay?orderId=1024…
- 付完跟我说一声,我帮你查取餐码。
- ```
- **和普通 Skill 的区别:确认由代码强制执行。** 普通 Skill 只是一段提示词,Agent 手里有 MCP 连接器就能随时直接调 `create-order`。mcd-git 的 Skill 不需要给 Agent 配 MCP 连接器,Token 只给 mcd-git 用,Agent 手里只有 `git mcd` 这一套命令:下单必须先出确认摘要,再用 `--confirm <commit 哈希>` 执行;哈希、参数、重新算出的应付金额,任何一项和预览时对不上,代码都会拒绝。代码保证的是这三件事:一定先出预览,确认时不能换参数,价格会复核。至于 Agent 有没有先把摘要拿给你看、等你点头,代码分辨不出来,这一步靠 SKILL.md 的规则约束 Agent。
- ## 1024 特别版:生成你的吃麦贡献图
- 
- 把吃麦记录(最多过去一年)画成一张卡片,有三种样式,用 `--style` 选:
- - **麦门天际线**(`skyline`,默认):等距 3D,最多 53 周 × 7 天,每天吃了几次就叠几层汉堡(底面包、肉饼、芝士、生菜、顶面包),超过 4 层只画 4 层、顶上标一个「+」;10-24 那格插一面「0x400」小旗。打开时汉堡按周从左到右落下叠好,只播一次、3 秒内停在完整状态,系统开了「减弱动态效果」就直接显示完成状态。默认深色夜景,浅色模式下换成奶油底。宽版,适合贴在 GitHub 个人主页。
- - **年度吃麦小票**(`receipt`):竖版热敏小票,最常点 TOP 5 当商品行,中间一块点阵热力图(红圈是 10-24),下面是时段分布、TOTAL 和一根装饰条形码。适合发朋友圈、小红书。
- - **平面格子**(`grid`):GitHub 风格的 7 行 × 53 周格子,颜色深浅表示那天吃了几单,10-24 那格单独描边。最朴素,放进文档里也不扎眼。
- <p align="center"><img src="assets/card-receipt-demo.svg" width="360" alt="年度吃麦小票(demo 合成数据)"></p>
- <details>
- <summary>平面格子(--style grid)</summary>
- 
- </details>
- 真实卡片从你最早一单开始画(最少 12 周,最多 53 周),随使用越来越满:麦当劳接口只给最近 10 单,更早的要靠本机账本慢慢攒;10-24 不在画出来的这几周里时,天际线不插小旗、小票不画红圈(天际线底部那格「10-24 / Happy 0x400 Day」是 1024 特别版的固定标语,一直都在)。上面三张是 demo 一年的合成数据,所以是满的;平面格子固定画 53 周。
- 终端里先出预览(终端画不出 3D,天际线和格子都用格子预览;小票直接打印文字版),同时在本机写一个 SVG:自包含(不引用外部字体、图片和脚本,重复的图形用 `<defs>` + `<use>` 复用),跟着系统切换浅色 / 深色,二三十 KB。同样的数据每次生成的文件都一样。
- ```bash
- mcd-git --demo card # 先用合成数据看看效果(上面这张就是),写到当前目录的 mcd-contributions-skyline.svg
- mcd-git card # 用你自己的记录,默认麦门天际线,从你最早一单画起
- mcd-git card --style receipt # 年度吃麦小票,默认写到 mcd-contributions-receipt.svg
- mcd-git card --style grid # 平面格子,默认写到 mcd-contributions-grid.svg
- mcd-git card -o ~/Desktop/mcd.svg # 换个地方写
- mcd-git card --with-savings # 卡片上多一项「用券省下 ¥X」(默认不出现任何金额)
- ```
- 默认文件名按样式区分(`mcd-contributions-skyline.svg` / `-receipt.svg` / `-grid.svg`),三种样式各写各的、连跑两种不会互相覆盖;用 `-o` 指定路径时完全听你的。节前(今天还没到 10-24)卡片会把右边界提前延伸到 10-24 那一周,提前标出「即将到来的程序员节」(天际线插旗、小票红圈、格子描边),不用等到当天才看得到。
- `--with-savings` 的数是下限:`order-list` 不返回优惠明细,只有 push 过或 `show` 过的单才知道省了多少。天际线和小票上有单缺明细时会写「只算有优惠明细的 N 单,是下限」,终端里也会提示。
- **贴到 GitHub 个人主页**(全程在本机手动完成):
- 1. 建一个和用户名同名的仓库 `<用户名>/<用户名>`,GitHub 会把它的 README 显示在你的个人主页上;
- 2. 在本机运行 `mcd-git card -o <那个仓库的目录>/mcd-contributions.svg`;
- 3. 在那个仓库的 README.md 里加一行 `<img src="mcd-contributions.svg" alt="过去一年吃麦贡献图">`;
- 4. 自己 `git add`、`git commit`、`git push`。
- **不要用 GitHub Actions 定时生成。** MCP Token 不能放进 CI(服务规则不允许把凭证托管到第三方平台),也不允许自动化调用。想更新就在本机再跑一次 `mcd-git card`。
- **卡片上有什么**:日期级的格子(或汉堡、点阵)、总单数、最常点(小票是 TOP 5 和次数)、最常时段,以及数据范围(比如「数据:麦当劳最近 10 单 + 本机记录,最早到 2026-10-21」)。没有门店、地址、订单号、手机号、具体下单时刻和总消费;只有加了 `--with-savings` 才显示省下的钱。公开之前自己再看一眼。
- **数据从哪来**:`order-list` 只返回最近 10 单,所以刚开始用时格子会比较空。mcd-git 会把看到的订单记进本机账本,用得越久越全;取消的和没付款的单不算。
- **本机订单账本**:`~/.config/mcd-git/ledger.json`(demo 用的是另一份 `~/.config/mcd-git/demo/ledger.json`),文件权限 600,只给吃麦贡献图当数据。`log`、`cherry-pick`、`card` 查 `order-list` 时顺手合并最近 10 单,`show` 顺手补上那一单的原价和优惠(同一单按订单号合并,新状态覆盖旧状态),`push` 下单成功时记一笔,并和那个本地 commit 关联起来。每单只存下单时间、状态、餐品名和份数、原价 / 优惠 / 实付、取餐方式;不存订单号原文(只存它的哈希)、门店、手机号、地址、取餐码、支付链接。删掉这个文件就清空了,不影响购物车和订单。
- ## git 命令 ↔ 点餐动作
- | mcd-git / git mcd | 点餐动作 | 会改动你的账户吗 |
- |---|---|---|
- | `init` | 选门店和取餐方式(到店 / 得来速 / 麦乐送),相当于设置远端 | 否 |
- | `status` | 当前分支(按时段:breakfast / lunch / tea / dinner)、购物车、可用券、待支付订单 | 否 |
- | `ls-remote [关键词]` | 看本店菜单:不带关键词按分类分组,超过一屏用分页器;价格是真实可得价,要随单购会员卡才有的优惠价另外注明 | 否 |
- | `add <餐品>` | 放进购物车;`--no-pickle` 去酸黄瓜,`--with 少冰`,`--choose 大薯条` | 否 |
- | `restore --staged <餐品>` | 从购物车拿出来 | 否 |
- | `reset` | 清空购物车;`reset ORIG_HEAD` 撤销 rebase;`reset --soft HEAD~1` 撤回没 push 的 commit | 否 |
- | `diff` | 像 unified diff 一样逐行看差价:菜单价 vs 应付,或用券前 vs 用券后 | 否 |
- | `rebase` | 单品凑成套餐(squash)、换上最省的一张券(coupon),每个方案都真实算价 | 否 |
- | `commit -m <说明>` | 锁定这一单:本地快照 + 核价,哈希由内容决定 | 否 |
- | `push` | **真正下单**,出支付链接和二维码;支持 `--at 12:20` 预约、`--locker` 取餐柜、`--no-tableware`、`--remark`、`--qr full/half/fancy[=名字]` | ✎ 会,先确认 |
- | `log --graph` | 吃麦提交历史,按时段画分支图 | 否 |
- | `log --stat` | 吃麦统计:每单列出餐品、实付和省下的钱,最后汇总单数、金额、时段分布和最常点;支持 `-n`、`--since`、`--until` | 否 |
- | `show [HEAD]` | 订单状态、取餐码、取餐柜、外送进度(只在你运行时查一次) | 否 |
- | `cherry-pick HEAD` | 再来一单:把上一单拣回购物车,换了门店也会按新菜单重新对齐 | 否 |
- | `revert` | 取消订单,必须选原因 | ✎ 会,先确认 |
- | `fetch` | 今日活动、可领的券(只读) | 否 |
- | `pull` | 领券:先列出可领券,确认后一次领取全部(接口不支持只领几张) | ✎ 会,先确认 |
- | `card` | 1024 吃麦贡献图:终端预览 + 本机 SVG,`--style skyline / receipt / grid` 选天际线、小票或格子(见上面「1024 特别版」) | 否 |
- | `completion <shell>` | 打印命令补全脚本(bash / zsh / fish / powershell),见下面「命令补全」 | 否 |
- 所有命令都支持 `--demo`(合成数据,不需要 Token)和 `--json`(给 Agent 和脚本用)。人工对照表随时看:`mcd-git help`;`git mcd help` 仍保留为 Git 子命令兼容写法。
- ## 30 秒试玩,无需 Token
- 装了 uv 的话,一行就能跑:
- ```bash
- uvx --from git+https://github.com/zhutoumeme/mcd-git mcd-git --demo status
- ```
- 想多玩几步,就装上它(需要 Python 3.9+):
- ```bash
- pip install "git+https://github.com/zhutoumeme/mcd-git" # 或 uv tool install git+https://github.com/zhutoumeme/mcd-git
- mcd-git --demo status
- mcd-git --demo add 巨无霸 中薯条 中可乐 --no-pickle
- mcd-git --demo diff
- mcd-git --demo rebase
- mcd-git --demo commit -m "发版前的午饭"
- mcd-git --demo push --at 12:20 --locker --no-tableware # 终端里会问 y/N
- mcd-git --demo log --graph
- mcd-git --demo log --stat # 吃麦统计:每单餐品、实付、省了多少,按时段汇总
- mcd-git --demo show
- mcd-git --demo cherry-pick HEAD
- mcd-git --demo pull # 领券,终端里会问 y/N
- mcd-git --demo card # 吃麦贡献图(麦门天际线),写到当前目录的 mcd-contributions-skyline.svg
- mcd-git --demo card --style receipt # 年度吃麦小票,终端里也会打印一张
- ```
- 装完会有两个等价的命令:`mcd-git`(人工直接操作和补全的推荐入口)和 `git-mcd`(Git 会把 `git mcd` 分发给它)。demo 的状态单独放在 `~/.config/mcd-git/demo/`,想从头再来就 `mcd-git --demo init --pick 1`。嫌每条都敲 `--demo` 麻烦,可以先 `export MCD_GIT_DEMO=1`(首屏动图就是这么录的)。
- ## 命令一览
- ### init:选门店,相当于设置远端
- 不带参数列收藏门店;按地标搜要同时给城市和关键词:`mcd-git init --city 南京 --keyword 新街口`(只给其中一个,麦当劳接口都不认)。门店列表按终端宽度显示全名。接口一次大约只给 5 家,`--limit 3` 只列前 3 家(只在本地截取,不会多调接口);想看别的店就换个更具体的地标。
- 
- ### status:看看现在什么情况
- 
- ### add:放进购物车,顺手去掉酸黄瓜
- 
- ### diff:每一分钱花在哪儿
- 
- ### rebase:凑套餐 + 挑券,省下来的才是真的
- `rebase` 只在购物车里的单品正好能凑满套餐(主食、小食、饮料都在)时才 squash,绝不为了便宜往购物车里多塞东西。一单只能用一张券,而且券和账户自带的折扣可能互斥,所以每个方案都会真实调一次 `calculate-price`,每条命令最多 20 次。不满意就 `mcd-git reset ORIG_HEAD`。
- 
- ### commit:锁定这一单
- 
- ### push:确认后才下单,出支付二维码
- 终端里先给确认摘要再问 y/N。Agent、管道或 `--json` 等非交互环境只出摘要,用户同意后用 `--confirm <commit 哈希>` 执行。mcd-git 只生成待支付订单,**不会替你付款**。二维码扫了直接拉起麦当劳 App 付款(和收银页里的码一样),默认用整格画法(每个模块两个带背景色的空格),各终端都扫得出;`--qr half` 用半块字符画,高度减半更紧凑,但部分终端(如 macOS Terminal.app)可能扫不出;终端太窄放不下整格时会自动退回半块并提示,拉宽窗口后运行 `mcd-git show` 可以重新出码。想要点花样可以 `--qr fancy` 画麦当劳主题码(麦门金配色 + 正中像素麦当劳元素 Logo,机器照样识别,终端太窄会自动退回普通码)——`fancy` 每次从汉堡、薯条、麦乐鸡、甜筒、派、金拱门 6 个图案里随机出一个,想固定某一个就写 `--qr fancy=burger`(也支持 fries / nuggets / cone / pie / arch)。扫不出来就直接打开下面的支付链接,或到麦当劳 App 订单页付款。
- 
- ### log --graph:吃麦提交历史
- 
- ### log --stat:吃麦统计
- 像 `git log --stat` 一样,每单下面列出餐品行和一行小结(几样、实付、用券省了多少),最后像 `diff --stat` 一样汇总:几单(其中几单已取消、几单待支付)、几样、实付、省下的钱,再按早餐 / 午饭 / 下午茶 / 晚饭 / 夜宵画分布,列出最常点的前 3 名。已取消的单照常显示但不计入金额,待支付的单单独标出、也不计入。数据来自本机账本,运行时先调一次 `order-list` 刷新最近 10 单;`-n 20` 看更多,`--since 2026-10-01 --until 2026-10-31` 按日期筛(含当天)。`order-list` 不返回原价和优惠,没 push 或 show 过的单省了多少不知道,汇总里会提示有几单没算进去。不显示热量。
- 
- ### show:取餐码在这里
- 
- ### cherry-pick HEAD:再来一单
- 
- ### pull:领券,同样先确认
- 像 `git pull` 一样 fetch + merge:先列出麦麦省里可领的券,你确认后调一次 `auto-bind-coupons` 把它们领进账户。这个接口没有参数,只能一次领全部、不能只挑其中几张,所以摘要里会把要领的每一张都列出来。终端里回答 y 就立即领取,领的是那一刻的全部可领券,摘要放了很久的话先回答 N 再重新运行一次。非交互环境只出摘要,用户同意后再用 `--confirm <指纹>` 执行;确认时会重新拉一次列表,和预览时不一样就拒绝。没有可领的券时输出 `Already up to date.`。领到之后,下单前跑一次 `mcd-git rebase` 就会自动挑最省的那张。
- 
- ### card:1024 吃麦贡献图
- 终端里一周一列:有颜色时一格一个小方块,管道和 `NO_COLOR` 下用 `· ░ ▒ ▓ █` 分档。终端画不出 3D,默认的麦门天际线也用这份格子预览;卡片本身写成 SVG,见上面「1024 特别版」。
- 
- `--style receipt` 在终端里直接打印一张文字小票:
- 
- ### help:对照表
- 对照表优先用 `mcd-git help` 看;Git 子命令兼容写法是 `git mcd help`、`git mcd -h` 和不带参数的 `git mcd`。注意不要写 `git mcd --help`:git 会把它拦截成 `git help mcd` 去找 man 手册。子命令的帮助优先写成 `mcd-git push -h`,`git mcd push -h` 仍可用。
- 
- ## 命令补全
- `mcd-git completion <shell>` 会生成补全脚本,子命令、选项、`--qr` / `card --style` 的取值以及餐品名都能按 TAB 补。**人工在终端操作和补全时,`mcd-git <TAB>` 是保证支持、推荐的入口**;`git-mcd <TAB>` 是等价兼容入口。`git mcd <TAB>` 只作为可选兼容:它依赖平台是否加载并转发 Git 自带补全脚本,不是 mcd-git 能保证的入口;PowerShell 尤其不保证 Git 转发。以下命令均只安装本机脚本,不访问 MCP。
- ### macOS:Zsh(默认 shell)
- ```bash
- # 安装:写入 ~/.zshrc;已有同一行时不要重复追加
- printf '\n# mcd-git completion\neval "$(mcd-git completion zsh)"\n' >> ~/.zshrc
- # 重载
- source ~/.zshrc
- # 测试(输入命令后按 TAB;--demo 不需要 Token)
- mcd-git --demo <TAB>
- mcd-git --demo add 巨<TAB>
- # 可选:检查脚本能否生成
- mcd-git completion zsh >/tmp/mcd-git.zsh
- ```
- ### macOS:Bash 3.2
- ```bash
- # 安装:macOS 自带 bash 3.2 也支持
- printf '\n# mcd-git completion\neval "$(mcd-git completion bash)"\n' >> ~/.bash_profile
- # 可选兼容:若要让 git mcd 也补,先加载 Git 自带补全(mcd-git 入口不依赖这一行)
- source /Library/Developer/CommandLineTools/usr/share/git-core/git-completion.bash 2>/dev/null || true
- # 重载
- source ~/.bash_profile
- # 测试
- a=$(mcd-git completion bash); test -n "$a" && echo 'bash completion script: OK'
- mcd-git --demo <TAB>
- ```
- ### Linux:Bash
- ```bash
- # 安装并写入 ~/.bashrc
- printf '\n# mcd-git completion\neval "$(mcd-git completion bash)"\n' >> ~/.bashrc
- # Git 自带补全通常由 bash-completion 提供;路径因发行版而异
- if [ -f /usr/share/bash-completion/completions/git ]; then source /usr/share/bash-completion/completions/git; fi
- # 重载
- source ~/.bashrc
- # 测试
- mcd-git --demo <TAB>
- mcd-git --demo add 巨<TAB>
- ```
- 若 Linux 没有 Git 补全,安装发行版的 `bash-completion` 后再 source 它;这只影响可选兼容入口 `git mcd <TAB>`,不影响保证可用的 `mcd-git <TAB>`。
- ### Fish
- ```fish
- # 安装
- mkdir -p ~/.config/fish/completions
- mcd-git completion fish > ~/.config/fish/completions/mcd-git.fish
- # 重载当前 shell(或退出后重新打开 fish)
- source ~/.config/fish/completions/mcd-git.fish
- # 测试
- mcd-git --demo add 巨<TAB>
- ```
- `git-mcd <TAB>` 也会复用 mcd-git 脚本;若要尝试兼容入口 `git mcd <TAB>`,是否生效取决于 Fish 自带的 Git 补全是否转发它。
- ### Windows:Git Bash
- ```bash
- # 安装:写入 Git Bash 的 ~/.bashrc
- printf '\n# mcd-git completion\neval "$(mcd-git completion bash)"\n' >> ~/.bashrc
- # Git Bash 的 git-completion.bash 路径随安装位置变化,常见路径如下
- [ -f /usr/share/bash-completion/completions/git ] && source /usr/share/bash-completion/completions/git
- # 重载
- source ~/.bashrc
- # 测试:首选入口是 mcd-git;兼容入口 git mcd 需要 Git 自带补全已加载
- mcd-git --demo <TAB>
- mcd-git --demo add 巨<TAB>
- ```
- ### Windows:WSL Bash
- ```bash
- # 在 WSL 内执行,写入 WSL 用户自己的 ~/.bashrc
- printf '\n# mcd-git completion\neval "$(mcd-git completion bash)"\n' >> ~/.bashrc
- sudo apt-get update && sudo apt-get install -y bash-completion # 只需安装一次
- source /usr/share/bash-completion/bash_completion 2>/dev/null || true
- # 重载
- source ~/.bashrc
- # 测试
- mcd-git --demo <TAB>
- mcd-git --demo add 巨<TAB>
- ```
- WSL 与 Windows Git Bash 是两个独立的 shell 环境,各自安装、各自重载;`mcd-git` 必须在当前环境的 PATH 中。
- ### Windows:PowerShell 5.1 / PowerShell 7
- ```powershell
- # 安装:先创建 profile 父目录和文件;带标记时重复执行不会重复追加
- $profileDirectory = Split-Path -Parent $PROFILE
- if ($profileDirectory) { New-Item -ItemType Directory -Path $profileDirectory -Force | Out-Null }
- if (-not (Test-Path -LiteralPath $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force | Out-Null }
- $marker = '# mcd-git PowerShell completion'
- if (-not (Select-String -LiteralPath $PROFILE -SimpleMatch $marker -Quiet -ErrorAction SilentlyContinue)) {
- Add-Content -LiteralPath $PROFILE -Value $marker
- mcd-git completion powershell | Add-Content -LiteralPath $PROFILE -Encoding UTF8
- }
- # 重载当前 PowerShell
- . $PROFILE
- # 测试:输入后按 TAB
- mcd-git --demo <TAB>
- mcd-git --demo add 巨<TAB>
- ```
- 关闭 PowerShell 窗口并重新打开后 profile 会自动加载。若脚本因执行策略被阻止,可仅为当前用户允许本地脚本(可选排障):
- ```powershell
- Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
- . $PROFILE
- ```
- PowerShell 补全注册给 `mcd-git` 和 `git-mcd`;不保证 `git mcd` 的 Git 转发补全。PowerShell 里二维码取值会列出 `fancy:burger` 这种冒号形式;命令本身也接受与其他 shell 一致的 `--qr fancy=burger`,不要把补全显示的冒号误当成餐品名。
- **餐品名与离线边界**:`add`、`ls-remote` 补本店菜单,`restore --staged` 补购物车。前缀匹配优先,包含匹配随后(输入「鸡腿」可列出麦辣鸡腿堡、板烧鸡腿堡);多候选时只列出,不吞掉已输入文字。候选只读 `~/.config/mcd-git/menu-cache.json`(Windows 默认 `%APPDATA%\\mcd-git\\menu-cache.json`),缓存 24 小时有效,换店需重新运行 `mcd-git ls-remote`。按 TAB 不联网;缓存缺失或过期时不调用 MCP,zsh 会提示先刷新菜单,bash / Fish / PowerShell 静默没有餐品候选。`--demo` 可先生成演示缓存。
- 二维码 `fancy` 的名字可写成 `--qr fancy=burger`;PowerShell 的候选列表也提供 `fancy:burger`,这是补全脚本为避免等号解析而显示的等价分隔形式。
- `git mcd` 的补全仅是可选兼容,不是 mcd-git 自己能保证的:Zsh 通常由系统 `_git` 转调,Bash / Git Bash / WSL 需要先加载 Git 自带的 `git-completion.bash`,Fish 依赖其 Git 补全实现;没有这些配置时请使用保证支持的 `mcd-git <TAB>`。
- ## 接入真实账户(3 步)
- 1. **申请 Token**:在 [麦当劳 MCP 开放平台](https://open.mcd.cn/mcp) 登录控制台,激活并复制 MCP Token。
- 2. **放在本机**:所有平台都首推环境变量 `MCD_MCP_TOKEN`;也可以写进配置文件。查找顺序是环境变量 `MCD_MCP_TOKEN` 优先,其次按平台找配置文件(`$XDG_CONFIG_HOME/mcd-mcp/token` → Windows 的 `%APPDATA%\mcd-mcp\token` → `~/.config/mcd-mcp/token`,取第一个存在且非空的)。Token 只放在本机、只进请求头,不会被打印、写日志或写进仓库,也不会上传到别处。
- **macOS**
- ```bash
- # 长期使用:从剪贴板写进文件(Token 不会留在 shell 历史里)
- mkdir -p ~/.config/mcd-mcp && pbpaste > ~/.config/mcd-mcp/token && chmod 600 ~/.config/mcd-mcp/token
- # 临时使用:只在当前终端有效
- export MCD_MCP_TOKEN=你的Token
- ```
- **Linux**
- ```bash
- # 长期使用:把 Token 写进文件(也可以从剪贴板,用 xclip -o 之类)
- mkdir -p ~/.config/mcd-mcp && printf '%s' "你的Token" > ~/.config/mcd-mcp/token && chmod 600 ~/.config/mcd-mcp/token
- # 临时使用:只在当前终端有效
- export MCD_MCP_TOKEN=你的Token
- ```
- **Windows(PowerShell)**
- ```powershell
- # 长期使用:写进用户环境变量,新开的终端生效
- setx MCD_MCP_TOKEN "你的Token"
- # 临时使用:只在当前终端有效
- $env:MCD_MCP_TOKEN = "你的Token"
- # 或者存成配置文件
- New-Item -ItemType Directory -Force "$env:APPDATA\mcd-mcp" | Out-Null
- Set-Content -NoNewline "$env:APPDATA\mcd-mcp\token" "你的Token"
- ```
- 也支持用 `XDG_CONFIG_HOME` 指定配置根目录(会在它下面找 `mcd-mcp/token`)。
- 3. **选门店开点**:`mcd-git init` 列收藏门店,或 `mcd-git init --city 上海 --keyword 人民广场` 按地标搜;得来速加 `--mode drive`,麦乐送用 `--mode delivery`。之后的用法和 demo 一模一样。
- [mcp-config.example.json](mcp-config.example.json) 是比赛要求的脱敏配置示例,只有 `${MCD_MCP_TOKEN}` 占位符。mcd-git 自己不需要它,想让其他 MCP 客户端直连时可以照着配。
- **只有 `push`、`revert` 和 `pull` 会改动你的账户,每次都会先出确认摘要;不会自动付款;没有后台任务、定时或轮询,每一次调用都由你的命令触发。**
- ## 交给你的 Agent
- 把下面这段话原样发给 WorkBuddy / Claude Code / Kiro(Agent 需要能在本机执行命令):
- ```text
- 请帮我安装 mcd-git 这个点麦当劳的 Skill:
- 1. 运行 uv tool install git+https://github.com/zhutoumeme/mcd-git(没有 uv 就用 pip install "git+https://github.com/zhutoumeme/mcd-git"),然后运行 `mcd-git help` 确认装好了;
- 2. 把 https://github.com/zhutoumeme/mcd-git 仓库根目录的 SKILL.md 装进你的 Skill 目录(Claude Code 是 ~/.claude/skills/mcd-git/SKILL.md,Kiro 是 ~/.kiro/skills/mcd-git/SKILL.md,WorkBuddy 在「技能」里导入);
- 3. 以后我说要点麦当劳,就按 SKILL.md 用 git mcd --json 操作。下单、取消和领券前必须把确认摘要给我看,我明确同意后才能加 --confirm。
- Token 我会自己配置(环境变量 MCD_MCP_TOKEN,或配置文件;macOS/Linux 在 ~/.config/mcd-mcp/token,Windows 在 %APPDATA%\mcd-mcp\token),不用在对话里发给你。没有 Token 时先用 --demo 给我演示。
- ```
- ## 安全边界
- - **写操作只有三个**:`create-order`(push)、`cancel-order`(revert)、`auto-bind-coupons`(pull),都要经过确认闸:预览 → 用户同意 → `--confirm`。积分兑换、抽奖、派对订单、新建地址这些写操作,代码里一律拦截,不调用;确认闸签发的许可也只对它对应的那一个 tool 有效。
- - **确认闸由代码执行**:`--confirm` 必须对得上 10 分钟内的预览(同一个 commit、同样的参数);真正下单前重新算价,应付金额和下单参数的指纹都要和预览时一致;`pull --confirm` 要对得上可领券列表的指纹,领之前重新拉一次列表,变了就拒绝;同一份确认只能用一次;`push --force`、`pull --force` 一律拒绝。
- - **结果未知不重试**:网络超时、响应不完整、返回看不懂、按了 Ctrl+C,这些情况都不会自动重发 `create-order`,会提示先 `mcd-git log` 核对,避免重复下单;`pull` 同样不会重发 `auto-bind-coupons`,会提示先 `mcd-git status` 或 `mcd-git fetch` 核对。
- - **低频、手动**:每条命令由你触发;领券每次都由你手动触发,只领你自己账户的券,不做定时或循环领取;`calculate-price` 每条命令最多 20 次,带缓存;遇到 429 只对只读请求退避重试。
- - **隐私**:Token 只在请求头里,只发给 `https://mcp.mcd.cn`(地址写死在代码里,不能用环境变量改);收货地址只保留 addressId 和打码提示;状态文件在 `~/.config/mcd-git/`(目录 700、文件 600),本机订单账本 `ledger.json` 也在这里,只存贡献图要用的字段(见「1024 特别版」);给命令补全用的菜单缓存 `menu-cache.json` 也在这里,只有餐品 code、名称、类型和门店,按 TAB 只读它、不联网;`card` 生成的 SVG 只写在你的电脑上,mcd-git 不会替你上传。
- ## 目标用户
- - **天天开终端的开发者**:不想切到手机上凑券、比价,`mcd-git status && mcd-git rebase` 一气呵成。
- - **想让 Agent 代点餐、但每一步都要看得见管得住的人**:Agent 只能用带确认闸的命令,下单前一定会先出确认摘要,参数或价格一变就作废;先问你这一步由 SKILL.md 约束 Agent。
- - **常点固定几样的人**:`mcd-git cherry-pick HEAD && mcd-git commit -m 再来一单 && mcd-git push` 就是再来一单;预约、取餐柜、不要餐具一条命令说清楚。
- 它解决两件事:自己算「单点还是套餐、用哪张券」太费劲;把下单交给 Agent 又怕它自作主张。
- ## FAQ
- **真的会下单吗?** 只有 `push` 并且你确认之后才会。生成的是待支付订单,付款要你自己在支付页或麦当劳 App 里完成。付款窗口是下单后 15 分钟(用真实账户实测过),不想要了就 `mcd-git revert` 取消。
- **会读写我的代码仓库吗?** 不会。mcd-git 不碰任何 `.git` 目录,状态只放在 `~/.config/mcd-git/`。唯一会往别处写文件的是 `card`:只在你指定的位置写一个 SVG(默认当前目录的 `mcd-contributions-<样式>.svg`,比如天际线是 `mcd-contributions-skyline.svg`、小票是 `mcd-contributions-receipt.svg`),写完会显示完整路径(比如 `已写入 ~/mcd-contributions-skyline.svg`),`--json` 的 `data.path` 是绝对路径。
- **rebase 会不会为了省钱让我多吃?** 不会。只有购物车里的东西正好凑满一个套餐时才换,不会额外加任何餐品。
- **价格准吗?** 一切以 `calculate-price` 的实时结果为准。`commit` 时核一次价,`push` 预览和确认时各核一次,价格变了会拦下来让你重新确认。
- **去酸黄瓜、少冰这类特制一定生效吗?** mcd-git 只接受 `query-meal-detail` 里真实存在的选项,按 MCP 的参数格式传过去。但算价接口既不校验也不回显特制,真实订单里会不会照做还没实测过。下单后用 `mcd-git show` 核对子项名称,以门店实际出餐为准。
- **为什么一单只能用一张券?** 这是 MCP 的规则:两张券会返回「暂不支持多张券使用」(600022)。
- **`log` 为什么最多只有 10 单?** `order-list` 没有分页参数,只返回最近 10 单。`log --stat` 和 `card` 会再加上本机账本里记下的订单,用得越久越全。
- **`show` 会一直刷新订单状态吗?** 不会。只在你运行时查一次,不轮询。
- **没有 Token 能用吗?** 加 `--demo` 就行,全套命令都能离线体验。
- ## 路线图
- - **P1**:`stash` / `stash pop` 暂存购物车;`rebase -i` 手动挑方案;预约时段在本地先校验;餐品名拼音首字母补全(比如 `jwb` → 巨无霸)。
- - **P2**:`ship --team` 发版庆功的团餐方案(下单仍走 push);`push --at next-gap` 读本地 .ics 找会议空档。
- 欢迎提 Issue 和 PR,新命令请保持「只读命令零副作用、写操作必须过确认闸」这条规矩。
- ## 更多文档
- - [MCP_INTEGRATION.md](MCP_INTEGRATION.md):用到的 MCP tool、命令和 tool 的对应关系、调用时序图、业务价值和写操作边界
- - [SKILL.md](SKILL.md):给 Agent 的使用说明
- - [CHANGELOG.md](CHANGELOG.md):版本更新记录
- - [CONTEST_DECLARATION.md](CONTEST_DECLARATION.md):参赛声明
- - 截图和动图可以复现:`python scripts/make_screenshots.py`、`vhs scripts/demo.tape`
- ## 声明
- - 本项目是麦当劳程序员节创意开发大赛的参赛作品,由参赛者独立开发,非麦当劳官方产品。
- - 项目输出仅供参考,不构成医疗、营养或其他专业建议。
- - 餐品信息、价格及供应状态以麦当劳官方渠道的实时结果为准。
- 仓库里不使用麦当劳的 Logo、IP 形象或官方图片;终端截图和 `--demo` 夹具全部是合成数据。代码以 [MIT](LICENSE) 协议开源。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.