📦 冰箱守护者

冰箱管家 (Fridge Keeper) 概述 管理冰箱入库、出库、保质期追踪与烹饪建议。支持本地文件与远程 database 两种模式。

核心能力 食物入库 – 记录名称、数量、入库时间、保质期 食物出库 – 记录消耗或丢弃 查询食物 – 查看当前冰箱全部食物 临期检查 – 识别指定天数内过期食物 烹饪建议 – 按现有食材与临期情况推荐菜谱

数据模型 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) 远程 database”

• 配置提醒：临期天数（默认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)