---
name: add-recipe
description: 给 Cook（食用手册）新增菜式。当用户说「增加菜式」「加几道菜」「添几个菜谱」「补点新菜」「增加 XX 类菜」「加个 XX 做的菜」时使用。按「先摸清现有数据 → 上网找数据里没有的新菜 → 拆解成食材/做法/厨具/菜系类别 → 写入并校验」的流程执行。
metadata:
  author: YunYouJun
  repository: https://github.com/YunYouJun/cook
---

# 新增菜式

你在给 Cook（食用手册）补充菜谱数据。每次运行把**若干道新菜**写进 `packages/data/recipe.csv`，跑完校验后向用户汇报。

## 数量规则

- 用户明确说了数量（「加 10 道」「补 5 个」），就按用户说的来。
- **用户没说数量，默认加 5 道菜。**
- 用户指定了主题或范围（「加几道川菜」「补点用砂锅的菜」），数量仍按上一条判断。

## 数据落点

只有一个文件要改：`packages/data/recipe.csv`。

列为 `name,stuff,bv,difficulty,tags,methods,tools,id`，单元格内多个值用顿号「、」分隔（**不能用逗号、斜杠、分号**）。

```
name,stuff,bv,difficulty,tags,methods,tools,id
青椒炒肉,青椒、猪肉,,普通,家常菜,炒,一口大锅,637
电饭煲版广式腊肠煲饭,腊肠、米,BV1NE411Q7Jj,简单,广式,煲,电饭煲,0
```

| 列         | 规则                                                                                                          |
| ---------- | ------------------------------------------------------------------------------------------------------------- |
| name       | 必填。菜名要能让人一眼看出做法，习惯写成「厨具版+做法+主料」或「主料+做法」                                   |
| stuff      | 必填。只能填 `packages/data/food.json` 里的食材标准名，具体品种（虾仁、鲈鱼）要写成标准名（虾、鱼）           |
| bv         | B 站 BV 号或 av 号。**可以留空**——应用里点菜走的是 B 站搜索链接，不是这个视频号；填了就必须是真实可播放的视频 |
| difficulty | 简单 / 普通 / 困难，或留空                                                                                    |
| tags       | 菜系类别 + 其它标签（快手菜、下饭、汤、杂烩、辣…），见下表                                                    |
| methods    | 做法（炒、煎、蒸、煮、煲、烤、炸…），见下表                                                                   |
| tools      | 只能填 `packages/data/food.json` 里的厨具名                                                                   |
| id         | 必填，非负整数且唯一。**新菜用当前最大 id + 1**（现在是 637、638…）                                           |

**id 一旦发布就不能修改、不能复用。** 收藏、反馈、筛选信号都按 id 记录。新菜一律追加到文件末尾，id 递增。

## 取值白名单

### 食材（35 个，来自 `packages/data/food.json`）

- 蔬菜：土豆、胡萝卜、花菜、白萝卜、西葫芦、番茄、芹菜、黄瓜、洋葱、莴笋、菌菇、茄子、豆腐、包菜、白菜、青椒、韭菜、南瓜
- 肉蛋水产：午餐肉、香肠、腊肠、鸡肉、猪肉、鸡蛋、虾、牛肉、骨头、鱼、蟹
- 主食：面食、面包、米、方便面、玉米、红薯

需要列表里没有的食材时，**先在 `packages/data/food.json` 里加**，再加别名到 `packages/data/aliases.json`（如「柿子椒」→「青椒」），然后才写进菜谱。别名映射用户输入的写法到标准名。

### 厨具（6 个）

烤箱、空气炸锅、微波炉、电饭煲、一口大锅、砂锅

### 菜系类别（tags 里的菜系标签）

必须从下表里选**标签值**写进 tags，选了哪个菜系筛选就只认哪个标签：

| 菜系   | 可用标签     |
| ------ | ------------ |
| 川菜   | 川菜         |
| 湘菜   | 湘菜         |
| 粤菜   | 粤菜、广式   |
| 苏菜   | 苏菜         |
| 东北菜 | 东北菜       |
| 西北菜 | 西北特色     |
| 日式   | 日式、日式菜 |
| 意式   | 意式         |
| 法式   | 法式、法餐   |
| 西式   | 西式         |
| 国宴菜 | 国宴菜       |

**每道新菜都尽量打上菜系标签。** 应用里一旦选了菜系，只有带该标签的菜会出现——标签不全会导致选了菜系就几乎没结果。

### 做法分组（methods + tags 的组合）

用户在应用里选的「做法」是分组，按下面的规则命中：

| 做法分组 | 怎么填                                   | 备注                                 |
| -------- | ---------------------------------------- | ------------------------------------ |
| 炒菜     | methods 填「炒」                         |                                      |
| 汤羹     | **tags 填「汤」**，methods 填煮/煲/炖    | 靠标签识别，不是靠 methods           |
| 炖煮     | methods 填炖、煮、煲、卤、焖、烧、灼     |                                      |
| 蒸       | methods 填「蒸」                         |                                      |
| 炸煎     | methods 填炸、煎、烙                     |                                      |
| 烤       | methods 填烤、烘、焗                     |                                      |
| 凉拌     | methods 填拌、凉拌、腌、腌制、泡菜、油泼 |                                      |
| 微波     | methods 填「微波加热」                   |                                      |
| 火锅     | **tags 填「杂烩」**，且食材 **≥10 种**   | 靠标签识别；食材少于 10 种不算大杂烩 |

「辣」标签同样靠 tags 识别，选了「不吃辣」时会排除带此标签的菜。

## 步骤

### 1. 摸清现有数据

先搞清楚「已经有什么、缺什么」，不要凭印象加菜。

```bash
# 全部菜谱（638 行，含表头）
cat packages/data/recipe.csv

# 菜谱总数
wc -l packages/data/recipe.csv

# 现有菜系分布：每种菜系各有多少道
node -e "const fs=require('fs');const l=fs.readFileSync('packages/data/recipe.csv','utf8').trim().split(/\r?\n/).slice(1);const c={};l.forEach(r=>{const t=r.split(',')[4]||'';t.split('、').filter(Boolean).forEach(x=>{if(/菜|式|广式|法餐/.test(x))c[x]=(c[x]||0)+1})});console.log(c)"

# 某个食材出现在多少道菜里（找出只有 1-2 道菜的冷门食材）
node -e "const fs=require('fs');const l=fs.readFileSync('packages/data/recipe.csv','utf8').trim().split(/\r?\n/).slice(1);const c={};l.forEach(r=>r.split(',')[1].split('、').filter(Boolean).forEach(x=>c[x]=(c[x]||0)+1));console.log(Object.entries(c).sort((a,b)=>a[1]-b[1]))"

# 某个厨具下有多少道菜
node -e "const fs=require('fs');const l=fs.readFileSync('packages/data/recipe.csv','utf8').trim().split(/\r?\n/).slice(1);const c={};l.forEach(r=>r.split(',')[6].split('、').filter(Boolean).forEach(x=>c[x]=(c[x]||0)+1));console.log(c)"
```

同时读 `packages/data/food.json`（食材/厨具词典）和 `packages/data/aliases.json`（别名）。

重点找这几类空洞，补菜时优先填：

- **菜系空洞**：某个菜系只有 1-2 道菜，用户一选就几乎没结果。
- **冷门食材**：某个食材只出现在 1-2 道菜里，选它必然匹配不到。
- **厨具 × 食材交叉**：某个食材配某个厨具一道菜都没有（比如砂锅只有十来道菜，覆盖的食材很窄）。
- **做法 × 菜系交叉**：某菜系里缺某类做法（比如粤菜没有凉拌、日式没有汤）。

### 2. 上网找新菜

- 围绕要补的空洞找菜：「XX 家常做法」「XX 砂锅」「XX 快手菜」这类关键词。
- 优先选**常见、做法明确、食材在词典里**的家常菜。冷门菜、分子料理、需要特殊设备的不要。
- **判重**：菜名和已有菜重复的、或同名同做法的，不加。先用步骤 1 的命令或直接搜 CSV 确认。
- **不要编造**菜谱或视频号。找不到真实信息就换一道菜，别硬凑。
- 找视频（可选）：搜索时带上 `bilibili.com/video` 关键词，从结果里拿 BV 号。

### 3. 拆解并写入

对每一道新菜，逐列拆开：

1. **菜名**：`青椒炒肉`
2. **食材**：拆成词典里的标准名 —— 青椒、猪肉
3. **厨具**：这道菜实际用什么锅做 —— 一口大锅
4. **做法**：methods 填具体动作 —— 炒
5. **菜系类别**：tags 填菜系标签 —— 川菜、家常菜
6. **难度**：简单 / 普通 / 困难，拿不准留空
7. **id**：从当前最大 id + 1 开始，逐个递增

然后**追加到 `packages/data/recipe.csv` 末尾**（不要改已有行）。

### 4. 校验

按顺序跑完，全绿才算完成：

```bash
pnpm convert      # CSV → JSON，必须先跑
pnpm validate     # 有错误时退出码为 1
pnpm fixtures     # 重新生成 recommend.json（改了数据必须重跑）
pnpm test -- --run
pnpm lint
```

常见问题：

- **`pnpm validate` 报「食材/厨具不在词典中」** —— 名称不对，改成标准名；词典里确实没有就先加进 `food.json`。
- **`pnpm test` 失败且是 `test/recommendations.test.ts` 里的 `counts` 断言** —— 新菜改变了推荐结果的分组数量，属于预期变化，更新这些数字即可。
- **`pnpm test` 报 fixtures 不一致** —— `pnpm fixtures` 没跑或跑漏了。
- **`pnpm lint` 报 md 文件格式错** —— 文档类改动注意行尾和代码块内不要留多余空行。

### 5. 汇报

告诉用户：

- 加了几道菜，每道的：菜名、食材、厨具、做法、菜系、难度、id
- 补的是哪些空洞（比如「补了砂锅 + 香菇 3 道」「粤菜凉拌 2 道」）
- 校验结果（`pnpm validate` 错误数、`pnpm test` 通过情况）
- 哪些地方拿不准、需要用户定夺（比如新加的食材名、没找到合适视频的菜）

## 注意事项

- 不要删除或修改已有行。发现已有数据有问题（重复、失效视频）时，在汇报里指出，让用户决定。
- 不要改 `packages/cook/src/utils/recommend.ts` 里的筛选逻辑，也不要改 `test/` 下的断言来「凑」结果——断言变化只允许是数据量自然变化导致。
- `packages/data/recipe.json` 和 `packages/data/fixtures/recommend.json` 是生成物，不要手写，改 CSV 和用例输入后用 `pnpm convert` / `pnpm fixtures` 重新生成。