📦 Feast — 智能膳食规划

将每周烹饪转变为文化体验的一键式 meal planning skill。

快速开始

• 新用户？ 运行 onboarding：“我们来设置 Feast” 或 “帮我开启 meal planning”
• 老用户？ 查看状态：“meal plan 状态如何？”
• 计划日？ 开始规划：“我们来计划下周的餐食”
• 烹饪日？ 获取揭晓：“今晚吃什么？”

核心文件

用户数据保存在其 workspace 中：

workspace/meals/
├── profile.yaml # 用户偏好（onboarding 时创建）
├── history.yaml # 已吃记录
├── favourites.yaml # 喜爱的食谱
├── failures.yaml # 再也不想做的
└── weeks/
    └── YYYY-MM-DD.md # 每周计划（自包含）

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

每周节奏

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

星期	活动	触发语
周四	研究与草案	“我们来计划下周”
周五	确认计划	“确认 meal plan”
周六	购物清单	“生成 shopping list”
周日	购物	用户自行购物
整周	每日揭晓	“今晚吃什么？”
周末	回顾	“回顾本周的餐食”

通知

Feast 在关键节点发送提醒：计划日、确认日、购物清单、每日揭晓、周末回顾。这些通过 cron jobs 生成独立 agent 来推送。

通知渠道

用户在 profile.yaml 的 schedule.notifications.channel 配置偏好渠道：

渠道	投递方式
auto	投递至当前会话或首个可用渠道
telegram	通过 Telegram 发送（需在 OpenClaw 中配置 Telegram 通道）
discord	通过 Discord 发送（需在 OpenClaw 中配置 Discord 通道）
signal	通过 Signal 发送（需在 OpenClaw 中配置 Signal 通道）
webchat	输出至聊天会话

推送通知（可选）

若想在独立于聊天渠道的手机端接收通知，用户可启用 push：

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

支持方式：

• Pushbullet — 需另行安装 pushbullet-notify skill 并配置 API 密钥
• ntfy — 使用 ntfy.sh（或自托管）；在 profile 中配置 topic

推送通知额外发送，不替代主渠道。若推送失败，通知仍走主渠道。

时间

通知通过 OpenClaw 的 cron 系统，以 wakeMode: "next-heartbeat" 投递。这意味着通知会在计划时间后的心跳间隔内（通常至多 1 小时）到达。对 meal planning 而言，此轻微延迟可接受。

管理通知

用户可随时调整偏好：

• “把我的 Feast 通知改为 Telegram”
• “关闭早上提示”
• “启用 Pushbullet 通知”

更新时，使用存储的 ID 移除旧 cron jobs，并用新设置创建新任务。

工作流

Onboarding

阅读 references/onboarding.md 了解完整流程。必问问题：

• 所在地（季节、单位、商店）
• 家庭人数与份量需求
• 周结构（起始日、烹饪日、放纵日）
• 饮食限制与阶段
• 设备与烹饪信心
• 偏好（菜系、辣度、预算）

保存至 workspace/meals/profile.yaml。

计划（周四）

• 检查用户 profile
• 回顾历史（避免近期重复）
• 查看即将到来的文化活动（见 references/events.md）
• 检查所在地季节性
• 选 6-7 餐，兼顾：

- 菜系多样性 - 食材复用 - 营养均衡 - 快手/耗时搭配

• 为每餐研究并嵌入：

- 地点： 确定具体原产地（精确到省、市或地区）。研究区域背景、历史、时事。撰写生动描述。 - 菜品： 从母语来源搜寻正宗食谱（用原语言搜索）。包含起源故事、文化意义、完整食材与做法。 - 原声： 策划 1-2 小时歌单，含当代热门 + 经典/传统音乐（见 references/theme-research.md）。附完整曲目与链接。 - 氛围营造： 如何摆盘、配饮、气氛小贴士。

• 草案写入 workspace/meals/weeks/YYYY-MM-DD.md（所有内容嵌入单文件）
• 呈现摘要（仅主题，非完整揭晓）

确认（周五）

• 展示草案与主题
• 允许修改
• 标记为已确认
• 设置每日揭晓提醒

购物清单（周六）

• 根据已确认计划生成
• 优化：

- 按类别分组 - 合并重叠食材 - 核对包装规格与需求 - 标注时令品

• 关键食材比价（见 references/price-checking.md）：

- 锁定前 3-5 最贵项（多为蛋白质、特色食材） - 在用户可用商店间比价 - 记录当前优惠、多买折扣、会员价 - 将价格建议写入购物清单 - 建议购物策略（单店 or 分店若节省显著）

• 带价格指导呈现清单供审阅
• 允许修改
• 标记为已批准

每日揭晓

• 确认当天为烹饪日
• 揭晓：

- 完整食谱（按用户单位） - 主题档案亮点： - 地点：区域背景、历史与特色 - 当下动态（计划时的新闻/事件） - 菜品：起源故事、文化意义、当地吃法 - 精选歌单： - 当地当代热门（当地人当下在听的歌） - 区域经典/传统音乐 - 附完整曲目与链接（Spotify/YouTube） - 歌单氛围与旅程 - 氛围营造：摆盘建议、饮品搭配、气氛小贴士

• 可选早晨提示，制造期待

回顾（周末）

• 为每餐打分（1-5）并写备注
• 更新历史
• 识别喜爱 → 加入 favourites
• 识别踩雷 → 加入 failures
• 记录改进点
• 将回顾保存至 week 文件

食谱区域化

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

• 温度：摄氏度 / 华氏度 / Gas Mark
• 重量：公制（g/kg）/ 英制（oz/lb）
• 体积：公制（ml/L）/ 杯量

见 references/conversions.md。

真实性指南

研究菜系时：

• 尽可能用原语言搜索
• 寻找母语来源食谱，而非仅英文美食博客
• 明确具体原产地——不是泛泛“泰菜”，而是“泰北，清迈风格”
• 研究真正来自该地区的音乐：

- 找当代热门（当地当前榜单） - 找经典/传统音乐（该地区传奇艺人） - 策划 1-2 小时歌单——而非通用 Spotify 搜索 - 见 references/theme-research.md 获取指导

• 研究该地区本身——历史、时事、社会背景、知名之处
• 记录文化背景与相关事件
• 尊重饮食传统（如中东主题无猪肉）
• 全部嵌入周计划——食谱、主题、音乐、背景全写进单一周文件

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

模板

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

参考资料

• references/onboarding.md — 用户 onboarding 指南
• 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 "Thai Green Curry" \
  --cuisine "Thai" \
  --region "Central Thailand" \
  --week-file "2026-02-02.md" \
  --rating 4 \
  --notes "Great, maybe more chilli next time"

该脚本更新 history.yaml 并自动重算统计。做每日揭晓时，用户确认已烹饪并可选打分后运行，以保持历史最新。

健康与营养

• 若用户有目标，则追踪每餐热量
• 确保每周食物群多样化
• 尊重饮食阶段（减重 = 热量赤字等）
• 标记任何营养警示

见 references/nutrition.md。

季节意识

在建议食材前，检查用户所在地的季节性。时令农产品：

• 品质更佳
• 往往更便宜
• 更环保

无需全部食材当季，但尽可能优先时令。见 references/seasonality/ 获取地区指南。