meal-suggester

🍽️ 智能餐桌管家,25分钟出餐

本地化双人晚餐助手,基于Markdown管理食材库存与口味偏好,25分钟智能推荐且自动维护购物清单,全程离线零隐私风险。

收藏
1.6k
安装
555
版本
v1.1.0
CLS 安全性认证2026-07-07
点击查看完整报告 >

使用说明

核心用法

Meal Suggester 是一款面向双人家庭的本地化晚餐规划助手。其核心工作流围绕每日19:00的定时食谱推送展开,系统通过读取本地Markdown格式的食材库存(inventory/stock.md)与双人口味档案(preferences/user1.md与user2.md),智能匹配15种以上预设食谱,筛选出烹饪时间≤25分钟且符合双方饮食偏好的建议。用户烹饪后通过自然语言反馈(如"使用了培根、鹰嘴豆和一根胡萝卜"),系统自动更新库存并记录历史,基于反馈数据持续优化后续推荐。购物清单(shopping-list.md)根据消耗模式自动生成,形成"建议-烹饪-反馈-补货"的完整闭环。

显著优点

该技能的最大优势在于极致的隐私保护与透明度。所有数据以Markdown文件形式本地存储,零网络传输、零云端依赖,用户拥有数据的完全控制权。双人偏好支持使其特别适合同居伴侣或夫妻使用,能平衡不同饮食需求。基于bash脚本的轻量级架构无外部依赖,仅使用系统标准工具(awk、cut、date),执行效率高且代码完全可审计。学习机制通过简单的历史追加操作实现,虽轻量但有效避免了推荐单调化,同时cron定时任务确保每日准时推送,减少决策疲劳。

潜在缺点与局限性

作为T3来源的个人开发者作品,其代码长期维护稳定性存在不确定性。功能受限于bash脚本能力,无法实现复杂的营养学计算或图像识别食材。缺乏多设备同步机制,无法在平板、手机与电脑间共享库存数据。严格的双人架构设计可能不完全适合单身用户或三人以上家庭。食谱库固定为15+种,虽强调多样性但扩展性有限,且高度依赖用户手动维护库存准确性,若忘记记录食材消耗会导致后续推荐失效,存在"垃圾进垃圾出"的风险。

适合的目标群体

该技能最适合注重隐私的同居情侣或夫妻,特别是居住在单一场所、烹饪习惯规律且偏好简单快手的用户。对于不信任云端食谱应用、希望完全掌控个人饮食数据的技术敏感型用户尤为合适。同样适合烹饪新手,通过结构化库存管理减少"今晚吃什么"的决策焦虑。不适用于需要跨设备同步的频繁出差人士,或需要严格营养计算的特殊饮食需求者(如糖尿病患者精确控糖),也不适合追求丰富菜系库的美食爱好者。

使用风险

主要风险在于数据备份责任完全由用户承担,若未定期备份inventory与preferences目录,设备损坏将导致口味偏好与历史记录永久丢失。手动维护库存的准确性直接影响推荐质量,输入错误会导致食材冲突或浪费。虽然脚本本身无危险操作,但作为T3来源技能,建议用户定期审查脚本内容变更。此外,bash脚本的RANDOM函数在统计随机性上较弱,长期可能导致食谱选择分布不均。无网络功能意味着无法获取实时食材价格、季节性食谱更新或在线食材配送集成。

安全解读

核心用法

meal-suggester 是一款专为双人 household 设计的本地化智能晚餐推荐工具。核心交互围绕三条命令展开:

1. 获取推荐:运行 clawdbot skill run meal-suggester 立即获得一份≤25分钟的晚餐建议
2. 更新库存:自然语言告知消耗食材(如"on a utilisé lardons, pois chiches"),系统自动扣减库存

3. 反馈学习:在 inventory/history.md 标注喜好(liked/disliked/would-repeat),算法据此优化未来推荐

系统每日 19:00 通过 cron 主动推送建议,无需手动触发。

---

显著优点

| 维度 | 亮点 |
|------|------|

隐私优先 | 纯本地 Markdown 存储,零网络传输,偏好数据完全私有
双人适配 | 独立维护 user1/user2 两份口味档案,自动求交集避冲突

闭环学习 | 历史反馈 → 食谱权重调整 → 越用越懂你和伴侣的口味

零配置负担 | 自然语言库存更新,无需 rigid 表单或 App 录入

购物自动化 | 根据消耗模式自动生成购物清单,补货提醒

防重复厌倦 | 15+ 食谱池轮换机制,避免"今晚又吃意面"

---

潜在缺点与局限性

  • 食谱池有限:15+ 选项对重度用户可能仍显单调,需手动扩展食谱数组
  • 无营养计算:不提供卡路里、宏量营养素追踪
  • 无图片/步骤:纯文本输出,烹饪新手可能需要配合外部食谱网站
  • 双人上限:当前架构仅支持两人家庭,多人 household 需改造数据模型
  • 无实时库存:依赖用户主动告知消耗,非智能冰箱/IoT 自动同步
  • Cron 依赖:19:00 推送需宿主机持续运行,笔记本用户可能错过定时建议

---

适合人群

  • 同居情侣/夫妻:需协调双方口味冲突,追求"都不委屈"的晚餐方案
  • 效率优先的上班族:拒绝"今晚吃什么"决策疲劳,要 25 分钟内出锅
  • 隐私敏感用户:拒绝将饮食偏好上传至云端美食 App
  • 极简主义者:厌倦 Notion/Excel 管理食材,偏好自然语言交互
  • 技术爱好者:愿意维护本地 Markdown 文件,享受可审计的透明系统

---

常规风险

| 风险类型 | 说明 | 缓解措施 |
|----------|------|----------|

数据丢失 | 本地 Markdown 无云备份,磁盘故障导致偏好/历史丢失 | 定期 git commit 或使用 Syncthing 同步 |
反馈循环偏见 | 初期样本少,算法可能过早收敛到狭窄口味 | 主动尝试标注多样化反馈,打破路径依赖 |

过敏源误配 | 系统依赖用户准确维护 dislikes,漏标可能导致推荐含过敏食材 | 双人复核偏好文件,关键过敏信息加粗标注 |

伴侣冲突 | 算法求交集可能产生"两边都不满意"的保守推荐 | 定期人工干预,在历史中标记"破例尝试"的惊喜餐 |

---

架构透明性

代码完全可审计:9 个文件 / 417 行 / 纯 Bash 实现,无黑盒模型。用户可打开 scripts/suggest-meal.sh 查看食谱选择逻辑,甚至手动微调权重函数。

meal-suggester 内容

inventory文件夹
preferences文件夹
scripts文件夹
手动下载zip · 7.8 kB
history.mdtext/markdown
请选择文件