冰箱管家 (Fridge Keeper)

概述

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

核心能力

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

数据模型

食物条目 (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. 询问存储方式
• "请选择数据存储方式：(1) 本地文件 (2) 远程数据库"
• 若选本地：使用默认路径 ./fridge_data.json 或询问用户指定路径
• 若选数据库：询问数据库类型、连接信息

1. 配置提醒
• "设置临期提醒天数（默认3天）"
• "设置提醒方式：每日/每周/自定义"

1. 保存配置
• 将配置写入 ~/.claude/skills/fridge-keeper/config.json

食物入库

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

1. 解析食物信息
• 名称（必填）
• 数量和单位
• 存放位置（冷藏室/冷冻室/保鲜层）
• 保质期天数（冷藏食物必填，冷冻食物可省略或设更长）

1. 计算过期时间
• 过期时间 = 当前时间 + 保质期天数
• 冷冻食品默认保质期 180 天

1. 写入存储
• 生成唯一 ID
• 追加到存储

1. 确认入库
• 汇报入库成功，包含过期时间

食物出库

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

1. 识别食物
• 匹配用户提到的食物名称
• 若有多个匹配，询问具体是哪个

1. 更新状态
• 消耗：状态改为 consumed，记录消耗时间
• 丢弃：状态改为 expired，记录丢弃时间

1. 确认出库
• 汇报出库成功

查询食物

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

1. 读取活跃食物
• 从存储读取状态为 active 的条目

1. 按位置分组
• 冷藏室 / 冷冻室 / 保鲜层

1. 格式化输出
• 列出每类食物，包含名称、数量、剩余保质期

临期检查

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

1. 计算临期阈值
• 临期 = 过期时间 - 警告天数 ≤ 当前时间

1. 筛选临期食物
• 状态为 active
• 过期时间 ≤ 当前时间 + 警告天数

1. 按紧急程度排序
• 已过期 > 今天过期 > 明天过期 > 即将临期

1. 输出警告
• 清晰标注紧急程度

烹饪建议

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

1. 获取当前食物
• 读取所有 active 状态的食材

1. 识别临期食材
• 优先考虑即将过期的食材

1. AI 自主推荐
• 利用自身的烹饪知识，根据现有食材推荐合适的菜谱
• 优先使用临期食材
• 说明每道菜使用哪些食材（含临期标注）

1. 输出建议
• 推荐 2-3 道菜
• 说明每道菜使用哪些食材（含临期标注）

存储操作

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

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