Brew Parameter Recommender

上下文数据（系统自动获取）

处理流程

Step 1: 加载知识库
   ├── brewMethod='pourover' → 加载 04-pourover-guide.md + 09-parameter-reference.md
   ├── brewMethod='coldbrew' → 加载 05-coldbrew-guide.md + 09-parameter-reference.md
   └── 加载 06-roast-level-guide.md（始终）

Step 2: 查表获取基准参数
   ├── 从 09-parameter-reference.md 中按 brewMethod × roastLevel × brewTechnique 查表
   └── 获取: grindSize范围, waterTemp范围, coffeeDose, waterAmount, brewTime范围

Step 3: 器具修正
   ├── filterCup 修正研磨度（04 中滤杯差异表）
   │   ├── V60: ±0
   │   ├── Kalita: +1~2格（三孔限流滞留时间长，略粗防过萃）
   │   ├── Origami (V60滤纸): ±0; Origami (Wave滤纸): +1格
   │   ├── Chemex: +1~2格
   │   └── 其他: 按流速特性推断
   └── grinderModel: 如有历史成功值，以历史值为锚

Step 4: 口味偏好修正
   ├── 偏酸/偏明亮 → grindSize +1, waterTemp -1°C
   ├── 偏甜/偏均衡 → 基准值不变
   ├── 偏浓 → 粉水比调浓（coffeeDose +1g 或 waterAmount -15ml）
   └── 偏淡 → 粉水比调淡

Step 5: 历史数据个性化
   ├── 查询: 同 roastLevel + 同 brewMethod + taste='good' 的最近 5 条记录
   ├── 如有: 计算历史成功参数的中位数
   │   └── 推荐值 = 加权平均(知识库基准 × 0.4, 历史中位数 × 0.6)
   ├── 如无: 使用知识库基准值
   └── 额外检查: 同类 taste='bad' 记录的参数 → 标记为"避免区间"

Step 6: 环境修正
   ├── ambientTemp < 15°C → waterTemp +1~2°C
   ├── ambientTemp > 30°C → waterTemp -0.5~1°C; 冷萃 steepTime -1~2h
   └── humidity > 70% → grindSize +0.5~1格

Step 7: 生成输出
   └── 推荐参数组 + 每个参数的推荐理由

输出格式

{
  "recommendation": {
    "grindSize": 20,
    "coffeeDose": 15,
    "waterAmount": 240,
    "waterTemp": 93,
    "brewTime": "约 2:30",
    "brewRatio": "1:16"
  },
  "explanation": {
    "summary": "中浅烘豆手冲一刀流，推荐中细研磨、93°C水温，突出明亮酸质和甜感。",
    "grindSize": "中浅烘V60基准18格，您历史成功值集中在20格，综合推荐20格。",
    "waterTemp": "中浅烘推荐92-94°C，取中间值93°C。",
    "coffeeDose": "标准15g单杯粉量。",
    "waterAmount": "1:16粉水比，15g × 16 = 240ml。",
    "brewTime": "一刀流V60预期约2:00-3:00，中间值约2:30。"
  },
  "confidence": "high",
  "basedOn": {
    "knowledgeBase": ["04-pourover-guide", "06-roast-level-guide", "09-parameter-reference"],
    "historicalRecords": 3,
    "historicalGoodRate": "75%"
  }
}

示例场景

场景 1: 新手浅烘手冲

输入:

• roastLevel: light
• brewMethod: pourover
• brewTechnique: yidaoliu
• filterCup: V60
• 无历史记录

推荐输出:

• grindSize: 16, coffeeDose: 15g, waterAmount: 250ml, waterTemp: 94°C, brewTime: ~2:30
• 理由: "浅烘豆密度高，需要较细的研磨(16格)和较高的水温(94°C)来充分萃取。V60基准值无需修正。建议闷蒸30秒后一次注完。"

场景 2: 有历史的中度三段式

输入:

• roastLevel: medium
• brewMethod: pourover
• brewTechnique: sanduanshi
• filterCup: Kalita Wave
• grinderModel: Comandante C40
• 历史: 3条taste=good记录，grindSize中位数=22

推荐输出:

• grindSize: 22, coffeeDose: 15g, waterAmount: 240ml, waterTemp: 92°C, brewTime: ~3:00
• 理由: "中度烘焙三段式基准研磨度19-25格。Kalita修正-1格=18-24格。您历史成功值集中在22格(Comandante C40)，综合推荐22格。三段式每段约70ml。"

场景 3: 深烘冷萃

输入:

• roastLevel: dark
• brewMethod: coldbrew
• 口味偏好: 偏浓

推荐输出:

• grindSize: 36, coffeeDose: 50g, waterAmount: 300ml (1:6 浓缩), waterTemp: 4°C, steepTime: 12-14h
• 理由: "深烘冷萃溶解度高，推荐浓缩型(1:6)。粗研磨36格防止过萃。冷藏浸泡12-14小时。饮用时兑水/奶1:1稀释。"

知识库依赖