麦味人格 · mcd-receipt-persona

对 AI 说一句话，把你最近的麦当劳订单变成一套小票风故事卡：小票、餐盘、薯条盒、终端、取餐叫号屏，最后告诉你是 16 种程序员人格里的哪一种。 只读 · 本地处理 · 不会下单 · 为 1024 程序员节 而做

_{↑ 全部由虚构的演示数据生成，不含任何真实订单}

在仓库根目录运行：

npm run demo

用浏览器打开 output/report.html 上下翻页，或直接看 output/pages/ 里的 7 张 PNG。

导出 PNG 会调用本机已安装的 Edge / Chrome / Chromium。没有浏览器时只是少了 PNG，SVG 和 HTML 照常生成。 不想用 npm 也行：node skills/mcd-receipt-persona/scripts/wrapped.mjs --demo --out output --png

对 AI 说："帮我看看我的麦当劳点餐人格"，它会：

1. 通过麦当劳 MCP 读取你最近的订单（官方接口只提供最近 10 单，工具会把每次拿到的订单合并进本地历史，越用越准）；
2. 在本机脱敏并统计下单时段、就餐方式、常点餐品（会展开套餐里的真实餐品）、用券情况、连续下单天数；
3. 从 4 个维度推导出 16 种人格之一，用程序员熟悉的概念命名，例如 NHXB「凌晨调试型」、DSLF「长期支持版」；
4. 输出 7 页 9:16 的故事卡（SVG + PNG）、一张长图、一个可翻页的 report.html 和文字摘要 summary.md。

和"一张人格卡"不同，这里每个结论都有自己的点餐场景：

订单少也不会一片空白：没有的数据（比如优惠）对应的内容会自动省略，并列第一会如实写成"并列"，不会悄悄只挑一个。

四个维度各取一个字母，组成人格代码：

每个角色都由代码自动组合而成：主体是你最常点的那类食物（汉堡、薯条盒、可乐、咖啡、圣代、鸡腿、麦满分，其他是纸袋），表情由人格决定（夜间派困倦、尝鲜派星星眼……），再贴上四枚维度贴纸（太阳 / 月亮、外送箱 / 小店、爱心 / 放大镜、优惠券 / 骰子）。全部是基础形状绘制的原创矢量图，没有金拱门，也没有任何官方形象。

判定规则全部公开，详见 MCP_INTEGRATION.md。

• 想看看自己点餐习惯的麦当劳用户；
• 想要一套有梗的程序员节分享图的开发者；
• 想参考"订单 → 画像 → 场景化渲染 → 本机导出 PNG"这条完整链路的 Skill 作者（零依赖，全部是可读的 JavaScript）。

需要：能读取 Skill 并运行 Node.js 脚本的 AI 客户端（作者在 Kiro 中开发并实测；Claude Code、WorkBuddy 等按各自的 Skill 目录安装即可），以及 Node.js 18+。脚本没有任何 npm 依赖。

在 麦当劳 MCP 开放平台 用手机号登录，点"控制台"→"激活"，同意协议后复制 Token。

然后在你自己的终端里把它放进环境变量（只在当前终端有效，不会写入任何文件）：

# Windows PowerShell
$env:MCD_MCP_TOKEN = "你的Token"

# macOS / Linux
export MCD_MCP_TOKEN="你的Token"

如果你的 AI 客户端读不到终端里的环境变量，可以在工作目录放一个 mcp-config.local.json（格式见 mcp-config.example.json）。文件名必须以 .local.json 结尾，仓库的 .gitignore 会忽略它。

不要把 Token 提交到仓库，也不要贴到聊天里。

在仓库根目录，把 skills/mcd-receipt-persona 整个目录复制到客户端的 Skill 目录：

# macOS / Linux
cp -r skills/mcd-receipt-persona ~/.kiro/skills/

# Windows PowerShell
Copy-Item -Recurse skills\mcd-receipt-persona $HOME\.kiro\skills\

懒人版：把下面这句话发给你的 AI 客户端（Token 已经放在环境变量里了，不用贴给它）：

请把当前仓库里的 skills/mcd-receipt-persona 安装为 Skill，然后读取我最近的麦当劳订单，告诉我是哪种点餐人格，并生成 7 页故事卡。我的 MCP Token 在环境变量 MCD_MCP_TOKEN 里，不要让我把它贴到聊天里。

你：帮我看看我的麦当劳点餐人格
AI：（拉取最近的订单，脱敏后在本地生成，以下为演示数据）
    你是 NHXB「凌晨调试型」
    夜间派 53% · 外送派 63% · 尝鲜派 76% · 精打细算派 45%
    共 62 单，32% 的订单发生在 21 点之后，28 单用了优惠、累计省下 ¥288。
    7 页故事卡已生成：output/pages/*.png，翻页版在 output/report.html。
    把第 7 页发给同事，看看谁和你同型。

其他说法也行："我是哪种麦当劳点餐人格"、"给我一张麦当劳 Wrapped 卡片"。

也可以不经过 AI，直接在终端里运行：

node skills/mcd-receipt-persona/scripts/fetch-orders.mjs --out output/history.json
node skills/mcd-receipt-persona/scripts/wrapped.mjs --input output/history.json --out output --name 你的昵称 --png

wrapped.mjs 的常用参数：

输出目录里有：

• 只读： 只调用 order-list 和 query-order，不会下单、取消订单、领券或抽奖；
• 先脱敏再落盘： query-order 的返回里有收件人手机号、地址和骑手电话，拉取脚本只取优惠金额，其余立即丢弃；本地历史里订单号和门店编码只存哈希；
• 本地统计： 统计和渲染都在你的电脑上完成。wrapped.mjs 不联网，只有 fetch-orders.mjs 会连接 mcp.mcd.cn；
• 分享前看一眼： 卡片里不会出现门店、地址、手机号和订单号，但会出现你点过的餐品名、下单日期时间（第 5 页的 git log）和金额汇总。不想露的页面就别发；
• output/ 已被 .gitignore 忽略；要分享时只发卡片截图，不要发 history.json；
• 仓库内不含任何真实 Token，Token 只通过环境变量或本地被忽略的文件提供。

麦当劳 MCP 的 order-list 固定只返回最近 10 单，没有分页，也没有时间参数（实测过多种参数组合）。商城订单、积分等其他只读接口也拿不到更长的点餐记录。所以这个工具如实叫"近期点餐人格"，并且：

• 每次运行都会把新订单合并进本地 output/history.json（按订单去重）。隔几天再跑一次，样本会越积越多，人格也越来越准；
• 不足 5 单时，人格揭晓页会标注"样本较少，仅供参考"；
• 你也可以把自己整理的订单按 input-schema.md 的格式喂给脚本。

├── README.md
├── CONTEST_DECLARATION.md          # 官方参赛声明（原文，未修改）
├── MCP_INTEGRATION.md              # 用了哪些 MCP 工具、调用流程、业务价值
├── LICENSE                         # MIT
├── package.json                    # npm run demo / atlas / fetch / report / assets
├── mcp-config.example.json         # 脱敏的 MCP 配置示例
├── assets/                         # README 预览图（只用虚构演示数据）
├── examples/demo-orders.json       # 虚构的演示订单
├── scripts/build-assets.mjs        # 重新生成 assets/*.png
└── skills/mcd-receipt-persona/     # ← 要安装到 AI 客户端的 Skill
    ├── SKILL.md                    # 给 AI 看的工作流程和规则
    ├── references/input-schema.md  # 输入格式说明
    └── scripts/
        ├── fetch-orders.mjs        # 经 MCP 拉订单 → 脱敏 → 合并到本地历史
        ├── wrapped.mjs             # 统计 + 人格推导 + 输出（入口）
        └── lib/
            ├── cards.mjs           # 7 页故事卡
            ├── icons.mjs           # 原创矢量食物与人格角色
            ├── personas.mjs        # 16 种人格
            ├── atlas.mjs           # 16 型图鉴
            ├── report.mjs          # 翻页报告与长图页
            ├── export.mjs          # 用本机浏览器导出 PNG
            ├── svgkit.mjs          # SVG 工具（点阵字体、条形码等）
            └── brand.mjs           # 项目名（改名只改这里）

开发时常用：npm run demo、npm run atlas，以及 npm run assets（重新生成 README 里的三张预览图）。

我的订单字段脚本认不出来怎么办？ 按 input-schema.md 的标准格式整理后再运行，或提交 Issue（请附上脱敏后的字段结构，不要贴真实订单）。

订单很少，人格准吗？ 不足 5 单时会标注"仅供参考"。这只是一个好玩的习惯画像，不是任何形式的评价。

没有 Edge / Chrome 能用吗？ 能。只是不会生成 PNG，SVG、report.html 和 summary.md 都照常生成；也可以用任意浏览器打开 report.html，用页面上的"保存本页 PNG"按钮。

让 AI 看生成的图片，结果对话报错 image dimensions exceed max allowed size？ 多图对话里模型接口要求每张图的宽高都不超过 2000px，而这里单页是 1080×1920、长图是 1080×13440。请让 AI 读 summary.md 来转述结果，不要用图片读取工具打开 PNG。SKILL.md 里已经写了这条规则。

会不会泄露我的 Token 或下单？ 不会下单：脚本只调用两个只读工具。Token 只从环境变量或被 .gitignore 忽略的本地文件读取，不会被打印，也不会写入任何输出文件。

本项目为麦当劳程序员创意开发大赛参赛作品，由参赛者独立开发，非麦当劳官方产品。输出仅供娱乐和参考，不构成医疗、营养或其他专业建议；餐品信息、价格及供应状态以麦当劳官方渠道的实时结果为准。卡片中的食物与角色均为原创矢量绘制，不含金拱门等官方商标。使用麦当劳 MCP 须遵守其《使用条款》和《麦当劳 MCP 服务规则》。

代码以 MIT 协议开源。如果它让你笑了一下，欢迎点个 ⭐，也欢迎把你的人格卡晒出来（#麦味人格）。