冰箱管家 (Fridge Keeper)#

概述#

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

核心能力#

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

数据模型#

食物条目 (FoodItem)#

json

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

配置 (Config)#

json

{
  "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 或询问用户指定路径
   • 若选数据库：询问数据库类型、连接信息
2. 配置提醒
   • "设置临期提醒天数（默认3天）"
   • "设置提醒方式：每日/每周/自定义"
3. 保存配置
   • 将配置写入 ~/.claude/skills/fridge-keeper/config.json

食物入库#

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

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

食物出库#

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

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

查询食物#

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

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

临期检查#

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

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

烹饪建议#

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

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

存储操作#

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

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