
Allergen Menu Forge:英国14种·美国9种 过敏原矩阵
Allergen Menu Forge
把一份菜单变成能贴在前台的过敏原矩阵:英国法定 14 种过敏原,或美国 FDA 9 大过敏原,A4 / US Letter 双纸型,附厨房用的 CSV。
英国自 2014 年 12 月起,任何售卖非预包装食品的餐饮店,都必须能就每道菜回答 14 种法定过敏原。美国 FDA 执行 9 大过敏原(FASTER Act 后加上芝麻)。大多数小店还在用一张永远没打印出来的 Excel。
这个 Agent 从一份 JSON 菜单直接出三样东西:菜单、前台的横向过敏原矩阵、厨房文件夹里的 CSV。
你会拿到什么
| 文件 | 内容 |
|---|---|
out/menu-a4.pdf / menu-letter.pdf |
菜单,带 V / VG / GF / 辣度标记 |
out/allergens-a4.pdf / allergens-letter.pdf |
横向矩阵:一行一道菜,一列一种过敏原 |
out/allergens.csv |
与矩阵同数据,UTF-8,Excel 直接打开 |
out/report.json |
菜品数、方案、纸型、文件清单 |
两套法定清单
scheme: "uk" → 14 列,严格按 FIC 2014:
| 代码 | 过敏原 |
|---|---|
| CE | 芹菜 Celery |
| GL | 含麸质谷物 Cereals containing gluten |
| CR | 甲壳类 Crustaceans |
| EG | 蛋 Eggs |
| FI | 鱼 Fish |
| LU | 羽扇豆 Lupin |
| MI | 乳 Milk |
| MO | 软体动物 Molluscs |
| MU | 芥末 Mustard |
| PN | 花生 Peanuts |
| SE | 芝麻 Sesame |
| SO | 大豆 Soybeans |
| SU | 二氧化硫 / 亚硫酸盐 Sulphites |
| TN | 树坚果 Tree nuts |
scheme: "us" → 9 列:Milk、Eggs、Fish、Crustacean shellfish、Tree nuts、Peanuts、Wheat、Soybeans、Sesame。
矩阵表头用两字母代码,表格下方逐条拼出全称——A4 横向放 14 列时,这是唯一能看清的排法。
怎么用
第一步,说清楚四件事:
餐厅名 / 地址 / 电话 / 网址
菜单分节与菜品(名称、一句描述、价格)
方案:uk 14 或 us 9(英国地址默认 uk)
纸型:A4 或 US Letter
第二步,生成:
pip install -r requirements.txt
python3 scripts/make_allergen.py --spec brief.json --out out/
第三步,校验:
python3 scripts/verify_allergen.py out/ --spec brief.json
校验会打开 PDF 检查:每道菜名是否真的印在菜单上、纸张尺寸对不对、矩阵是不是横向、14(或 9)个过敏原全称是否都在图例里、CSV 是否一行一道菜且列序一致。任一项不过直接退出码 1。
示例:伦敦小酒馆
一份真实跑通的样例(references/sample-spec.json):
- The Copper Spoon,18 Exmouth Market, London
- 3 个分节、10 道菜
- 英国 14 种方案,A4
- 输出菜单 A4、横向矩阵 A4、CSV、report
- 校验:42 项全过
几条硬规则
- 不猜过敏原。用户没给的菜品,矩阵就是空格,不会自动填「乳」或「麸质」。
- 别名会归一:
wheat→ gluten、soy→ soybeans、nuts→ tree_nuts、shellfish→ crustaceans、sulfites→ sulphites。 - 分节标题横跨整行,不会挤进第一个过敏原列。
- 菜单页脚自带法定提示和标记图例,不用另附一张纸。
- 同一份 spec 重跑,金额、列宽、排序完全一致。
常见问题
这算法律合规吗?
它把 FIC 2014 / FDA 要求的信息排成标准格式,但合规责任仍在店主:过敏原数据必须由店里核对供应商标签后确认。这不是法律建议。
能给网站用吗?
能。矩阵 PDF 可直接放网站,CSV 可导入网页表格。
能加营养成分吗?
不能。热量、宏量营养素不在范围内,需要独立的配方与称重数据。
菜品很多会溢出吗?
矩阵会自动分页并重复表头。菜单超过一页会自然续页。
支持欧元区吗?
支持 EUR,符号跟着 currency 走。欧盟同样适用 14 种清单。
English
UK food businesses have had to declare 14 regulated allergens since December 2014; US businesses answer to the FDA's 9 major allergens, now including sesame. This agent turns one JSON menu into a print-ready menu, a landscape allergen matrix for the counter, and a CSV for the kitchen.
Table headers use two-letter codes with a full legend underneath, so 14 columns stay legible on A4 landscape. Empty cells mean "not declared", never a guess. Same spec, same output — no network, no API key, no AI model.
版本
v1.0.0 · 中文(简体)为主语言


