名称： feast
描述： |
全面的膳食规划系统，包含文化主题、地道食谱、智能购物和惊喜揭晓。适用于以下场景：
- 规划每周餐食或菜单
- 生成购物清单
- 寻求食谱灵感或烹饪帮助
- 回顾过往餐食或提前规划
- 为新用户引导膳食系统
- 寻找美食灵感或文化饮食活动
- 追踪饮食目标或营养摄入
- 管理收藏、失败案例或餐食历史

Feast

一款将每周烹饪转变为文化体验的膳食规划技能。

快速开始

1. 新用户？ 运行引导流程："我们来设置 Feast" 或 "为我引导膳食规划"
2. 老用户？ 查看状态："膳食计划状态如何？"
3. 规划日？ 开始规划："我们来规划下周的餐食"
4. 烹饪日？ 获取揭晓："晚餐吃什么？"

核心文件

用户数据存储在其工作区中：

workspace/meals/
├── profile.yaml          # 用户偏好（引导期间创建）
├── history.yaml          # 已食用餐食记录
├── favourites.yaml       # 喜爱的食谱
├── failures.yaml         # 永不重做的食谱
└── weeks/
    └── YYYY-MM-DD.md     # 每周计划（自包含）

注意： 每周计划是完全自包含的——每天的食谱、主题研究、音乐播放列表和文化背景都直接嵌入在周计划文件中。没有单独的食谱或主题文件。

每周节奏

默认日程（用户可配置）：

通知

Feast 在关键时间点发送提醒：规划日、确认日、购物清单生成日、每日揭晓日和周回顾日。这些通知通过 cron 作业发送，该作业会启动独立的代理来发送通知。

通知渠道

用户在 profile.yaml 文件的 schedule.notifications.channel 下配置首选渠道：

推送通知（可选）

为了向移动设备发送独立于聊天渠道的通知，用户可以启用推送通知：

schedule:
  notifications:
    push:
      enabled: true
      method: "pushbullet"    # 或 "ntfy"

支持的方法：

• Pushbullet — 需要单独安装 pushbullet-notify 技能并配置 API 密钥
• ntfy — 使用 ntfy.sh（或自托管）；在配置文件中配置主题

推送通知是附加到主渠道发送的，而不是替代它。如果推送失败，通知仍会发送到主渠道。

时间安排

通知通过 OpenClaw 的 cron 系统发送，使用 wakeMode: "next-heartbeat"。这意味着通知会在预定时间后的心跳间隔内（通常最多 1 小时）到达。对于大多数膳食规划目的，这种轻微延迟是可接受的。

管理通知

用户可以随时调整通知偏好：

• "将我的 Feast 通知改为 Telegram"
• "关闭早间提示"
• "启用 Pushbullet 通知"

更新时，使用存储的 ID 删除旧的 cron 作业，并使用更新的设置创建新的作业。

工作流程

用户引导

完整流程请阅读 references/onboarding.md。

基本问题：
1. 位置（用于季节性、单位、商店）
2. 家庭人数与分量需求
3. 周结构（起始日、烹饪日、放纵日）
4. 饮食要求与阶段
5. 设备与烹饪信心
6. 偏好（菜系、辣度、预算）

保存至 workspace/meals/profile.yaml。

规划（周四）

1. 检查用户配置文件
2. 回顾历史（避免近期重复）
3. 检查即将到来的文化活动（见 references/events.md）
4. 检查用户所在位置的季节性
5. 选择 6-7 餐，要求：
   • 菜系多样
   • 食材有重叠
   • 营养均衡
   • 快速与耗时菜肴搭配
6. 为每餐进行研究并嵌入：
   • 地点： 确定具体的原产地（精确到省份、城市或地区）。研究区域背景、历史、时事。撰写生动的描述。
   • 菜肴： 研究来自本土来源的地道食谱（使用原语言搜索）。包括起源故事、文化意义、完整配料和制作方法。
   • 配乐： 策划一个 1-2 小时的播放列表，包含该地区的当代热门歌曲 + 经典/传统音乐（见 references/theme-research.md）。包含完整的曲目列表和链接。
   • 场景布置： 如何上菜、搭配什么饮品、氛围营造技巧。
7. 将草稿计划保存到 workspace/meals/weeks/YYYY-MM-DD.md（所有内容都嵌入此单一文件）
8. 呈现摘要（仅主题，非完整揭晓）

确认（周五）

1. 呈现包含主题的草稿计划
2. 允许修改
3. 标记为已确认
4. 设置每日揭晓提醒

购物清单（周六）

1. 根据已确认的计划生成
2. 优化：
   • 按类别分组
   • 合并重叠的食材
   • 检查包装尺寸与需求
   • 标记季节性物品
3. 价格检查关键食材（见 references/price-checking.md）：
   • 识别前 3-5 种最昂贵的物品（通常是蛋白质、特色食材）
   • 检查用户可用商店的价格
   • 注明当前优惠、多件优惠、会员卡价格
   • 将价格建议添加到购物清单
   • 建议购物策略（如果节省显著，可选择单店或分店购买）
4. 呈现购物清单及价格指导以供审阅
5. 允许修改
6. 标记为已批准

每日揭晓

1. 检查是否为烹饪日
2. 揭晓内容：
   • 完整食谱（使用用户单位）
   • 主题档案亮点：
     • 地点：区域背景、历史和特色
     • 当地当前动态（规划时的最新新闻/事件）
     • 菜肴：起源故事、文化意义、当地食用方式
   • 策划的播放列表：
     • 来自该地区的当代热门歌曲（当地人现在听什么）
     • 来自该地区的经典/传统音乐
     • 完整的曲目列表和链接（Spotify/YouTube）
     • 播放列表营造的氛围和旅程感
   • 场景布置：上菜建议、饮品搭配、氛围营造技巧
3. 可选的早间提示，增加期待感

回顾（周末）

1. 对每餐进行评分（1-5 分）并记录备注
2. 更新历史记录
3. 识别收藏 → 添加到收藏夹
4. 识别失败案例 → 添加到失败列表
5. 捕获系统改进点
6. 将回顾保存到周计划文件

食谱本地化

所有食谱均以标准化的内部单位存储。输出时，转换为用户偏好的单位：

• 温度：摄氏度 / 华氏度 / 燃气标记
• 重量：公制（克/千克） / 英制（盎司/磅）
• 体积：公制（毫升/升） / 杯

参见 references/conversions.md。

地道性指南

研究菜系时：
1. 尽可能使用原语言搜索
2. 寻找来自本土来源的食谱，而非仅限英文美食博客
3. 确定具体的原产地——不仅是"泰国菜"，而是"泰国北部，清迈风格"
4. 研究真正来自该地区的音乐：
- 寻找当代热门歌曲（当地当前流行什么）
- 寻找经典/传统音乐（来自该地区的传奇艺术家）
- 策划一个 1-2 小时的播放列表——而非泛泛的 Spotify 搜索
- 参见 references/theme-research.md 获取指导
5. 研究该地区本身——历史、时事、社会背景、著名之处
6. 注意文化背景和任何相关活动
7. 尊重饮食传统（例如，中东主题中不含猪肉）
8. 将所有内容嵌入周计划——食谱、主题、音乐和背景都放在单一的周计划文件中

参见 references/cuisines/ 获取各菜系指南。

模板

• templates/profile.yaml — 用户配置文件
• templates/week.md — 包含嵌入食谱、主题、音乐和购物清单的周计划
• templates/shopping-list.md — 独立的购物清单格式（供参考；通常嵌入在周计划中）

参考文档

• references/onboarding.md — 用户引导指南
• references/theme-research.md — 如何研究文化主题和策划音乐
• references/price-checking.md — 智能购物和价格比较指南
• references/events.md — 用于主题规划的文化活动日历
• references/nutrition.md — 饮食阶段和均衡膳食指南
• references/conversions.md — 单位换算表
• references/cuisines/ — 各菜系研究指南
• references/seasonality/ — 区域季节性农产品

脚本

历史记录追踪

餐食揭晓并烹饪后，更新历史记录：

python scripts/update-history.py \
    --meals-dir ~/.openclaw/workspace/meals \
    --date 2026-02-03 \
    --name "泰式绿咖喱" \
    --cuisine "泰国菜" \
    --region "泰国中部" \
    --week-file "2026-02-02.md" \
    --rating 4 \
    --notes "很棒，下次可以多放点辣椒"

这将更新 history.yaml 并自动重新计算统计数据。

在进行每日揭晓后，当用户确认已烹饪并可选地评分后，运行此脚本以保持历史记录最新。

健康与营养

• 如果用户有目标，则追踪每餐卡路里
• 确保每周食物种类多样
• 尊重饮食阶段（例如，减重期 = 热量赤字）
• 标记任何营养问题

参见 references/nutrition.md。

季节性意识

在建议食材前，检查用户所在位置的季节性。时令农产品通常：
- 品质更好
- 价格更便宜
- 更环保

并非每种食材都必须是时令的，但尽可能优先选择时令食材。

参见 references/seasonality/ 获取区域指南。