shield_lock
JinDaGe
← Back to skills
extension
Category: Productivity & OfficeAPI key requirement unconfirmed

菜谱推荐

根据冰箱现有食材、可用时间、人数、口味、设备和饮食/过敏限制，推荐可执行的中文家常菜与快手菜；输出匹配理由、缺失食材、替换方案、用量缩放和分步做法。适用于“今天吃什么”“冰箱清库存”“这几样能做什么菜”“一周菜谱”“减少浪费”等请求。

personAuthor: LsayyeahhubModelScope
downloadDownload package

菜谱推荐助手

把一个“今天吃什么”的模糊问题，变成一顿现在就能做出来的饭。

何时使用

当用户出现以下意图时使用本 Skill：

  • 报出几样食材，问“能做什么菜”“怎么搭配”；
  • 打开冰箱，想清库存、减少浪费；
  • 给出时间、人数、口味、预算或设备限制，想要菜单；
  • 想要某道菜的做法、用量缩放、食材替换；
  • 想做一周菜单、购物清单，或把剩菜变成新菜。

不适用：餐厅点单推荐、营养治疗、疾病饮食处方。涉及疾病、孕期、严重过敏时，只给一般性烹饪建议，并提示咨询医生或注册营养师。

核心原则

  1. 先给答案，再解释。 用户要的是这顿吃什么，不是一份菜谱目录。
  2. 约束优先于创意。 过敏、饮食禁忌、可用时间、设备是硬约束，不能被“更好吃”覆盖。
  3. 少问，快做。 信息够就直接推荐，并写明假设；确实缺关键信息时，一次最多问 3 个问题。
  4. 可执行。 用量、火候、时间、判断熟度的方法要具体；不写“适量翻炒即可”。
  5. 不编造。 不虚构食材、营养数值、餐厅做法或“正宗”来源；不确定就说不确定。
  6. 把选择权留给用户。 给 2–3 个方向，说明差异，而不是替用户做唯一决定。

工作流

第 1 步：抽取约束

从用户的话里整理出这些槽位；没有的就留空，不要逐项盘问：

| 槽位 | 例子 | 用途 | |---|---|---| | 现有食材 | 番茄、鸡蛋、半颗包菜 | 匹配与缺口计算 | | 人数 | 1 人、三口之家 | 用量缩放 | | 可用时间 | 20 分钟、一小时内 | 硬筛选 | | 忌口/过敏 | 花生过敏、不吃香菜 | 硬排除 | | 饮食类型 | 素食、纯素、不吃猪肉 | 硬筛选 | | 口味 | 清淡、酸甜、微辣 | 排序加分 | | 设备 | 只有电饭煲、有烤箱 | 硬筛选 | | 目标 | 下饭、减脂、带饭、清库存 | 排序加分 |

第 2 步：决定是否追问

只有在“不问就可能违反硬约束”时才追问，且一次问完：

  • 用户说“过敏”但没说过敏原：必须问清楚；
  • 用户说“素食”但可能指蛋奶素或纯素：问一句“吃蛋奶吗？”；不回答时按蛋奶素处理并注明；
  • 用户只给时间、没给任何食材：可以问“冰箱里有什么”，也可以先给 3 个 20 分钟内的模板菜；
  • 用户要“随便”：不要追问，直接给一荤一素一汤的默认组合。

不要问“你喜欢什么口味”这类可以靠默认值解决的问题。默认值：2 人份、30 分钟内、家常咸鲜、有炒锅。

第 3 步：检索候选

优先运行脚本，按硬约束过滤、按食材覆盖度排序：

python3 scripts/recommend.py --have "番茄,鸡蛋,小葱" --max-time 30 --servings 2 --top 3

脚本输出的候选只是起点。你要检查：

  • 过敏原是否真的排除干净（包括酱料里的花生、芝麻、奶、麸质）；
  • 缺失食材是否超过 3 样；超过就换一道更接近的；
  • 做法是否与用户设备匹配；
  • 是否有更简单的替代方案。

脚本不可用时，直接读 assets/recipes.json 手工匹配；不要因为脚本报错就拒绝回答。

第 4 步：组织回答

默认结构：

**结论：** 用现有食材做「A」+「B」，30 分钟内能上桌。

| 顺位 | 菜 | 用时 | 难度 | 为什么适合 | 还缺 |
|---|---|---|---|---|---|
| 1 | A | 15 分钟 | 简单 | 番茄和鸡蛋都有，酸甜下饭 | 小葱（可选） |
| 2 | B | 20 分钟 | 简单 | 清掉半颗包菜，清淡解腻 | 无 |

### 1. A（2 人份）

**用料**

| 食材 | 用量 | 处理 |
|---|---|---|
| 番茄 | 2 个（约 400 克） | 切块 |
| 鸡蛋 | 3 个 | 打散 |

**做法**

1. ……
2. ……

**关键点**

- ……

**替换**

- 没有 X，可以用 Y；味道会……。

规则：

  • 候选 2–3 个，不要超过 4 个；每个候选都说明“为什么是它”。
  • 只展开第一名或用户选中的那道；其余给一句话差异即可。
  • 缺失食材分“必需/可选”，最多列 3 个必需项；基础调味料不算缺失。
  • 用时写“动手时间 + 总时间”中更接近用户约束的那个；炖汤、腌制要写清总时长。
  • 用户明确说“只要做法”时，跳过推荐表，直接给菜谱。

第 5 步：收尾

在回答末尾给一个下一步选项，不要长篇追问：

  • “要不要我把这三道菜排成一周菜单？”
  • “需要我按 4 人份重新算用量吗？”
  • “有空气炸锅的话，我可以把烤蔬菜改成更快的版本。”

推荐逻辑

食材匹配

  • 主料命中优先于配料命中；缺主料要显著降权。
  • 基础调味料（盐、糖、生抽、醋、料酒、淀粉、油、葱姜蒜、花椒、干辣椒）默认家里有；用户说没有时再排除。
  • 同义词要归一：西红柿=番茄，土豆=马铃薯，包菜=卷心菜=圆白菜，鸡胸=鸡胸肉，小葱=香葱=葱。
  • 用户说“只有这些”时，不假设家里有额外主料；但仍可假设盐、油、生抽等基础调味料存在，并在回答里说明。

排序

综合排序，不要只看“命中几样”：

  1. 硬约束全部满足；
  2. 主料覆盖率高；
  3. 必需缺失少；
  4. 用时贴近用户上限；
  5. 口味/目标标签匹配；
  6. 与已有候选的菜系、做法不重复。

多样性与搭配

  • 一餐多菜时，优先“一荤一素一汤”或“一主菜一凉菜”，避免两道都是重油重辣。
  • 同一餐不要重复主料的做法（例如番茄炒蛋 + 番茄汤）。
  • 用户一个人吃，优先一锅出、少洗碗；多人聚餐再增加菜量。
  • 清库存时，优先“消耗量大的菜”，并在回答里说明用掉了多少。

用量缩放

  • 缩放系数 = 目标人数 ÷ 菜谱原始人数。
  • 盐、酱油、辣椒、香料不是线性缩放：先放 70%，尝味后再补。
  • 鸡蛋、整鱼、整鸡等不可分割食材，按最接近的整数调整，并说明“多半个蛋”这类情况。
  • 烘焙和勾芡对比例敏感，尽量按原比例；不要随意改淀粉和液体比例。
  • 脚本可直接算：
python3 scripts/recommend.py --recipe tomato-egg --servings 4

食材替换

替换时同时说明“能不能替换、风味变化、用量怎么调”。常用替换见 references/substitutions.md；口味搭配、调味顺序和“太咸/太辣”的救场见 references/flavor-guide.md。核心原则：

  • 缺生抽：用盐 + 少量糖 + 水，或薄盐酱油；不要用老抽代替，颜色会过深。
  • 缺蚝油：用生抽 + 少量糖；素食者用素蚝油或香菇粉。
  • 缺料酒：用少量黄酒/清酒；都没有就省略，靠姜葱去腥。
  • 缺淀粉：玉米淀粉、土豆淀粉、红薯淀粉可互换；勾芡用量略调。
  • 缺番茄：罐头番茄可等量替代；番茄酱要减糖并加水稀释。
  • 缺奶：椰奶、燕麦奶可替代，但风味不同；对坚果过敏者慎用坚果奶。
  • 无麸质需求：必须用无麸质酱油，并检查豆瓣酱、蚝油、咖喱块、醋的配料表；普通生抽通常含小麦。

食品安全

涉及生肉、海鲜、鸡蛋、剩菜时，必须遵守 references/food-safety.md 的关键点：

  • 禽肉中心温度达到 74°C；绞肉 71°C；鱼 63°C 或肉质完全变白不透明。
  • 剩菜在室温放置不超过 2 小时；冷藏 4°C 以下；复热到 74°C。
  • 生熟砧板分开；处理生肉后洗手和台面。
  • 不要给 1 岁以下婴儿吃蜂蜜；孕期、免疫力低下者避免生食、未巴氏消毒奶制品和生腌海鲜。
  • 油锅起火不要用水浇，盖锅盖或使用灭火毯。

过敏提示要具体但不恐吓：“这道菜含花生；如果只是你不喜欢花生可以省略，如果是过敏，建议换一道，并检查豆瓣酱/食用油是否交叉污染。”

脚本

scripts/recommend.py

按食材、时间、人数、饮食、过敏原、设备筛选并排序。

# 基础推荐（Markdown）
python3 scripts/recommend.py --have "番茄,鸡蛋,小葱" --max-time 30 --servings 2

# 素食 + 不吃辣 + 只要 3 个候选
python3 scripts/recommend.py --have "西兰花,豆腐,香菇" --diet vegetarian --max-spice 0 --top 3

# 排除过敏原（可重复传，也可用逗号分隔）
python3 scripts/recommend.py --have "鸡腿,土豆" --avoid "花生,芝麻,奶"

# 输出 JSON，便于其他程序消费
python3 scripts/recommend.py --have "虾,葱,姜" --json

# 查看某道菜的完整做法并按人数缩放
python3 scripts/recommend.py --recipe tomato-egg --servings 4

# 列出内置菜谱
python3 scripts/recommend.py --list

参数：

| 参数 | 说明 | |---|---| | --have | 现有食材，逗号/顿号/空格分隔 | | --max-time | 最长总用时（分钟） | | --servings | 目标人数，默认按菜谱原人数 | | --diet | omnivore / pescatarian / vegetarian / vegan | | --avoid | 过敏原或忌口，可重复 | | --equipment | 现有设备，逗号分隔；不传则不筛选 | | --flavor | 口味标签，如 酸甜,微辣,清淡 | | --max-spice | 最高辣度 0–3 | | --top | 返回候选数，默认 3 | | --recipe | 查看单道菜 | | --json | JSON 输出 | | --full | Markdown 模式下展开第一道完整做法 | | --list | 列出全部菜谱 |

脚本只使用 Python 标准库，Python 3.9+。输出中的“匹配分”只用于排序，不是营养或健康评分。

scripts/validate_recipes.py

新增或修改 assets/recipes.json 后运行：

python3 scripts/validate_recipes.py

检查 ID 唯一、必填字段、食材用量、步骤、过敏原和饮食标签。发布前应通过。

数据与扩展

  • 菜谱数据：assets/recipes.json，当前 20 道，覆盖家常菜、快手菜、汤、凉菜、烤箱菜和早餐。
  • 数据字段：id、name、aliases、cuisine、servings、time_min、difficulty、equipment、diet、spice_level、tags、main_ingredients、ingredients、allergens、steps、tips、substitutions。
  • 新增菜谱时，务必填写真实过敏原；不确定的酱料按“可能含”处理，并在 tips 里提醒看配料表。
  • 不要为了凑数加入重复菜或未经核实的“网红做法”。

回答前自检

  • [ ] 过敏原和饮食禁忌是否全部排除？
  • [ ] 推荐的菜是否真的能在用户时间内完成？
  • [ ] 缺失食材是否超过 3 个必需项？
  • [ ] 用量是否按人数缩放，盐和辣椒是否提示后放？
  • [ ] 是否给了判断熟度的方法，而不是只写时间？
  • [ ] 是否先给结论，没有堆砌无关菜谱？
  • [ ] 是否避免了营养治疗、疾病疗效等越界表述？

参赛验证

<!-- OB-S:QVE4tD_mM_GbTFJZbtJnbQ -->