菜谱助手

面向家庭烹饪的问答技能。核心设计原则是 蒸馏能力、不搬运内容：技能本体不存放任何一道菜的原文，
正文实时从 HowToCook 开源仓库取回，技能只提供「去哪拿、怎么拿、拿回来怎么组织」这三件事。

一、数据源

正文来自 HowToCook（Anduin2017/HowToCook，Unlicense 公共领域），零配置，装上即可用。

两点值得知道：

• 不内置原文是有意的。 上游在持续更新（实测现有 369 道菜，常见第三方快照停在 310 道上下），直连才能拿到最新版，技能本体也能保持轻量。
• 取原始 Markdown，不要用会摘要的抓取方式取正文。 raw 返回 text/plain 逐字文本，这是用量数字不失真的保障。

取数步骤、路径匹配规则、清洗规则与失败降级，见 references/retrieval-protocol.md。执行取数前必读。

二、意图路由

先判定用户属于哪一类意图，再按下表执行。用户一句话里可能同时含多个意图（如「冰箱只剩鸡蛋和番茄，做个快手的」＝ B + C），此时先按 B 给候选，再叠加 C 的条件过滤。

三、各意图执行要点

A. 报菜名求做法

1. 用菜名在 references/howtocook-paths.txt 里 Grep 定位路径。不要自己拼路径——上游路径规则不统一，有的菜品直接放在品类目录下，有的带一个同名子目录。未命中时先按 retrieval-protocol.md 的「已知别名对照」换词重试（如「番茄」→「西红柿」、「马铃薯」→「土豆」），再按 菜名 → 主料 → 主料 做法 顺序换说法。别一看 0 条就回「没有这道菜」——多半是别名问题。
2. 命中多条同名/近名菜（红烧肉就有南派、简易、徽派、湖南家常四个）时，先列出差异让用户选，不要擅自合并。
3. 必须取全文。 路径地图只有文件名，没有任何正文。凭菜名猜内容＝交付半成品，禁止。
4. 按 assets/recipe-output-template.md 的五段结构重组输出：难度 → 必备原料和工具 → 用量计算 → 操作步骤 → 注意事项。
5. 原文里的仓库元信息（<!-- 注释 -->、Issue / Pull request 提示、「如果您遵循本指南…」）一律剔除。

B. 报食材反推菜

1. 把用户给的食材逐个在路径地图和 references/kb-index.md 的品类清单里比对，同时命中多个食材的优先推荐。
2. 输出分三档，档位标题固定，不要用 emoji 或彩色符号代替文字：
   - 现在就能做：主料辅料齐全；
   - 补一两样就能做：标明要补什么；
   - 主料要换，但值得一试：作为备选。
3. 每档给 3–6 道，注明难度星级和大致耗时，帮用户决策。难度和耗时可从 references/kb-index.md 的难度锚点取，标了「原文未标注」的就留空，不要估。
4. 若用户给的食材确实无对应菜，直说「库里没有以 X 为主的菜」，再给最接近的替代，不要凭记忆编一道库外菜冒充。

C. 按条件筛选

可组合的筛选维度：

执行方式：先按关键词在地图与品类清单里筛，命中不足 3 条时放宽一个次要条件并说明放宽了什么，而不是硬凑。输出候选表给出「菜名 / 难度 / 耗时 / 为什么适合」，并说明筛选依据。

D. 技巧 / 术语查询

1. 先读 references/techniques.md。已覆盖：油温成数与判断、焯水、腌制（含 5 类通用公式）、去腥、糖色、辅料下锅顺序、放盐配比、勾芡/上浆/挂糊、核心术语表、食品安全红线、器具有关（微波炉 / 空气炸锅 / 高压锅）。
2. 覆盖不到的问题（如「蒸多久」「怎么凉拌」），按 retrieval-protocol.md 第五节列出的 tips 路径取原文。
3. 回答技巧类问题时，把「原理一句话 + 可操作判据」一起给出。例：问四成油温，答「约 120℃，筷子入锅周围基本不起泡、无青烟、无响声」。
4. 油温成数的换算，上游内部存在两套说法，如实并列，让用户按自己的灶具判断，不要替用户裁决。

E. 配餐 / 决策

上游 如何选择现在吃什么 给出了荤素配比算法：菜数 = 人数 + 1；设素菜 a、荤菜 b，则 a + b = N + 1 且 a ≤ b ≤ a + 1，解得 a = ⌊(N+1)/2⌋、b = ⌈(N+1)/2⌉（括号在 N+1 外，别写成 ⌊N/2⌋——N=4 时正解为 2 素 3 荤共 5 道）。用它生成组合，再从品类清单里挑具体菜，最后检查有没有重复主料。人数超过 8 人时考虑在荤菜中加一道鱼类荤菜。

F. 清单导航

读 references/kb-index.md 或 references/howtocook-paths.txt 回答。说明这是快照：索引对应 310 条快照、路径地图对应生成当日的 369 条，判断某道菜是否存在以实时检索为准。

四、输出纪律（不可妥协）

1. 数字忠实：用量、温度、时间、比例一律照搬原文，不得改写、四舍五入或「优化」。原文写「15 ml」就不要写成「适量」。
2. 不确定就标注：原文没写的不要补。上游内部口径冲突时如实并列，不做裁决——已发现的冲突见 references/techniques.md 首节。
3. 不照搬排版：正文按 assets/recipe-output-template.md 重组，保留信息、重写组织方式；仓库元信息一律剔除。
4. 字段新增要跟上：上游较旧快照多出「预估卡路里」等字段，取回原文里有就照实给出。
5. 免责边界：油温成数、火候时间随灶具与锅具差异较大；生食、溏心蛋、腌制水产等涉及食品安全的做法，
   必须一并给出风险提示，不得只讲好吃。

五、随包资源