冰箱管家 (Fridge Keeper)

概述

管理冰箱食物的入库、出库、保质期追踪与烹饪建议。支持本地文件存储和远程数据库两种模式。

核心能力

食物入库 - 记录食物名称、数量、入库时间、保质期
食物出库 - 记录食物被消耗或丢弃
查询食物 - 查看当前冰箱中的所有食物
临期检查 - 识别将在指定天数内过期的食物
烹饪建议 - 根据现有食材和临期情况推荐菜谱

数据模型

食物条目 (FoodItem)

{
  "id": "uuid",
  "name": "食物名称",
  "quantity": 数量,
  "unit": "单位(克/个/颗等)",
  "storage_location": "冷藏室/冷冻室/保鲜层",
  "入库时间": "2024-01-15T10:30:00Z",
  "保质期天数": 7,
  "过期时间": "2024-01-22T10:30:00Z",
  "状态": "active|consumed|expired"
}

配置 (Config)

{
  "storage_type": "local|database",
  "local_path": "./fridge_data.json",
  "database": {
    "type": "mysql|postgres|mongodb",
    "host": "localhost",
    "port": 3306,
    "database": "fridge",
    "username": "user",
    "password": "pass"
  },
  "expiry_warning_days": 3,
  "reminder_schedule": "daily|weekly|custom"
}

工作流程

首次初始化

当用户首次使用或说"初始化配置"、"设置冰箱"时：

询问存储方式
- "请选择数据存储方式：(1) 本地文件 (2) 远程数据库"
- 若选本地：使用默认路径 ./fridge_data.json 或询问用户指定路径
- 若选数据库：询问数据库类型、连接信息
配置提醒
- "设置临期提醒天数（默认3天）"
- "设置提醒方式：每日/每周/自定义"
保存配置
- 将配置写入 ~/.claude/skills/fridge-keeper/config.json

食物入库

当用户说"入库"、"放进冰箱"、"添加食物"时：

解析食物信息
- 名称（必填）
- 数量和单位
- 存放位置（冷藏室/冷冻室/保鲜层）
- 保质期天数（冷藏食物必填，冷冻食物可省略或设更长）
计算过期时间
- 过期时间 = 当前时间 + 保质期天数
- 冷冻食品默认保质期 180 天
写入存储
- 生成唯一 ID
- 追加到存储
确认入库
- 汇报入库成功，包含过期时间

食物出库

当用户说"出库"、"吃掉"、"拿出冰箱"、"消耗"时：

识别食物
- 匹配用户提到的食物名称
- 若有多个匹配，询问具体是哪个
更新状态
- 消耗：状态改为 consumed，记录消耗时间
- 丢弃：状态改为 expired，记录丢弃时间
确认出库
- 汇报出库成功

查询食物

当用户说"有什么"、"查看冰箱"、"当前食物"时：

读取活跃食物
- 从存储读取状态为 active 的条目
按位置分组
- 冷藏室 / 冷冻室 / 保鲜层
格式化输出
- 列出每类食物，包含名称、数量、剩余保质期

临期检查

当用户说"临期"、"快过期"、"检查过期"时：

计算临期阈值
- 临期 = 过期时间 - 警告天数 ≤ 当前时间
筛选临期食物
- 状态为 active
- 过期时间 ≤ 当前时间 + 警告天数
按紧急程度排序
- 已过期 > 今天过期 > 明天过期 > 即将临期
输出警告
- 清晰标注紧急程度

烹饪建议

当用户说"推荐菜谱"、"做什么菜"、"建议"时：

获取当前食物
- 读取所有 active 状态的食材
识别临期食材
- 优先考虑即将过期的食材
AI 自主推荐
- 利用自身的烹饪知识，根据现有食材推荐合适的菜谱
- 优先使用临期食材
- 说明每道菜使用哪些食材（含临期标注）
输出建议
- 推荐 2-3 道菜
- 说明每道菜使用哪些食材（含临期标注）

存储操作

核心存储操作由 scripts/storage.py 实现，支持本地文件和数据库两种模式。Claude 调用相应方法：

load_config() - 读取配置
save_config(config) - 保存配置
load_items() - 读取所有食物条目
save_item(item) - 添加新条目
update_item(id, updates) - 更新条目
delete_item(id) - 删除条目

fridge-keeper

Safety Notice

Copy this and send it to your AI assistant to learn