79 lines
3.8 KiB
Markdown
79 lines
3.8 KiB
Markdown
---
|
||
name: recipe-sourcing
|
||
description: 按主题从 B 站、小红书等平台搜罗菜谱，补充进 Cook 的 recipe.csv 并开 PR。维护者说"补充 XX 类菜谱""去 B 站/小红书找菜谱""某个食材没菜可做"时使用。
|
||
metadata:
|
||
author: YunYouJun
|
||
repository: https://github.com/YunYouJun/cook
|
||
---
|
||
|
||
# 菜谱搜罗
|
||
|
||
你在给 Cook（食用手册）按主题（某种食材、某种厨具、某个菜系）补充菜谱。每次运行产出**一个** PR，由维护者审核合并。你从不直接推送到 main，也从不合并 PR。
|
||
|
||
数据规则以 `docs/dev/data.md` 为准，开始前先读一遍。
|
||
|
||
## 硬性规则
|
||
|
||
- 每道菜必须有一个**可播放的 B 站视频**（`bv` 列）。小红书、下厨房等只能作为找菜名、核对食材的参考，不进 csv。
|
||
- **不编造视频号。** 每个 BV 号都要打开视频页（`https://www.bilibili.com/video/<BV号>/`）或调 `https://api.bilibili.com/x/web-interface/view?bvid=<BV号>`（`code` 为 0）确认：视频没失效，标题和菜名对得上。只在搜索结果里见过、没打开确认的不要用。
|
||
- 食材、厨具只能用 `packages/data/food.json` 里的名称。具体品种写成标准名（鲈鱼 → 鱼、虾仁 → 虾），对应别名加进 `packages/data/aliases.json`。
|
||
- `stuff` 只填视频标题、简介或标签里能看出来的主料，看不出来的配菜不填。`difficulty` 拿不准就留空。
|
||
- **id 不能修改、不能复用。** 新菜谱追加到末尾，id 用当前最大 id + 1。
|
||
- 不和已有菜重复：同一个视频、或同名同做法的菜不加。
|
||
- 需要新食材或新厨具时，写进 PR 描述的「需要维护者决定」，不要自己加进 `packages/data/food.json`（维护者明确要求的除外）。
|
||
|
||
## 步骤
|
||
|
||
1. **准备分支**
|
||
|
||
```bash
|
||
git fetch origin main && git checkout -B data/sourcing-<主题> origin/main
|
||
pnpm install --frozen-lockfile
|
||
```
|
||
|
||
2. **看现状**：在 `packages/data/recipe.csv` 里搜主题相关的菜，看已有哪些、缺哪些常见做法和厨具（一口大锅、电饭煲、空气炸锅、微波炉、烤箱都尽量覆盖）。
|
||
|
||
3. **找候选视频**
|
||
- B 站搜索页（search.bilibili.com）和小红书一般禁止抓取，直接访问多半失败。可行的做法是用网页搜索，关键词带上 `bilibili.com/video` 和菜名，例如 `bilibili.com/video 红烧鱼 家常做法`、`bilibili.com/video 空气炸锅 秋刀鱼`，从结果里拿 BV 号。
|
||
- 小红书能访问时，用来确认哪些菜做的人多，再去 B 站找对应视频。
|
||
- 同一道菜优先选播放量高、做法清楚的家常视频（如「美食作家王刚R」「小高姐的魔法调料」这类长期更新的 UP 主）。
|
||
- 每个主题 10～20 道就够，宁缺毋滥。
|
||
|
||
4. **逐个核对**：打开每个候选视频页，记下标题、UP 主、播放量、简介和标签里的食材与厨具，确认没有失效提示。对不上的丢掉。
|
||
|
||
5. **写入数据**：按 `name,stuff,bv,difficulty,tags,methods,tools,id` 追加到 `packages/data/recipe.csv`，单元格内多个值用顿号「、」分隔。
|
||
|
||
6. **验证**
|
||
|
||
```bash
|
||
pnpm validate --base origin/main
|
||
pnpm fixtures
|
||
pnpm test -- --run
|
||
pnpm lint
|
||
```
|
||
|
||
`test/recommendations.test.ts` 里的数量断言会随数据变化，只在变化是你新增的菜直接造成时才更新。`pnpm fixtures` 重新生成的 `packages/data/fixtures/recommend.json` 一起提交。
|
||
|
||
7. **提交并开 PR**：PR 描述列出每道新菜的 id、菜名、BV 号、UP 主和视频标题，方便维护者抽查；说明哪些平台没能访问。
|
||
|
||
## PR 描述模板
|
||
|
||
```markdown
|
||
## 新增菜谱
|
||
|
||
| id | 菜名 | 视频 | UP 主 | 视频标题 |
|
||
| --- | ---- | ---- | ----- | -------- |
|
||
|
||
## 别名 / 词典
|
||
|
||
- ……
|
||
|
||
## 来源说明
|
||
|
||
- 能访问的平台、找不到视频的菜
|
||
|
||
## 需要维护者决定
|
||
|
||
- ……
|
||
```
|