🏠 Household Grocery — 家庭菜库管理

Overview

帮你管理家里有什么菜、还剩多少、哪些快吃完了该补货。

用户只需要在微信上随口说一句"我买了5个苹果"或"土豆吃完了"，剩下的记录、统计、缺货提醒全自动完成。

When to Use

• 用户说"我买了……"、"家里有……"、"还剩……"
• 用户说"看看家里还有啥菜"
• 用户说"该买什么了"
• 每次去菜市场/超市前，看一眼缺啥
• 每周做购物计划时

How It Works

数据存储在 ~/.hermes/scripts/grocery_tracker.json，通过脚本管理。

常用命令

# 查看全部库存（按水果/蔬菜/肉蛋分类）
python3 ~/.hermes/skills/life/household-grocery/scripts/tracker.py list

# 添加食材
python3 ~/.hermes/skills/life/household-grocery/scripts/tracker.py add 鸡蛋 10 个 肉蛋
python3 ~/.hermes/skills/life/household-grocery/scripts/tracker.py add 白菜 1 颗 蔬菜

# 吃掉/用完
python3 ~/.hermes/skills/life/household-grocery/scripts/tracker.py remove 土豆 1
python3 ~/.hermes/skills/life/household-grocery/scripts/tracker.py remove 鸡蛋    # 不加数量=全部清除

# 查看库存报告（品种统计）
python3 ~/.hermes/skills/life/household-grocery/scripts/tracker.py report

# 查看该买什么（少于2个的自动提醒）
python3 ~/.hermes/skills/life/household-grocery/scripts/tracker.py shopping

用户交互流程（微信端）

用户说 → 我自动记录 → 更新库存文件

示例：

用户：我今天买了5个苹果、2根黄瓜
→ 我：好！已更新 ✅ 苹果: +5个 / 黄瓜: +2根

用户：土豆吃完了
→ 我：好的，土豆已移除 🗑️

用户：家里还有啥菜？
→ 我：🍎 水果: 桃子5个 苹果3个 梨3个 香瓜1个
       🥬 蔬菜: 黄瓜2根 番茄若干 玉米1根
       📊 缺货提醒: 玉米只剩1根了！

分类体系

与购物清单联动

当 shopping 命令输出显示某样东西只剩1-2个时，建议自动加入618购物清单。

Common Pitfalls

1. 数量单位不统一 → 尽量用"个、根、颗、斤、袋"等常见单位，脚本支持任意文本
2. 忘记更新 → 每次买菜回来就说一声"我买了……"，几秒钟的事
3. 同类不同名 → "土豆"和"马铃薯"会被当成两个东西，统一叫法

Verification Checklist

• [ ] tracker.py list 能正确分组显示库存
• [ ] tracker.py add 能添加新物品和更新已有数量
• [ ] tracker.py remove 能吃光或部分消耗
• [ ] tracker.py shopping 能提示缺货物品
• [ ] 数据文件 ~/.hermes/scripts/grocery_tracker.json 每次操作后自动更新

脚本路径

~/.hermes/skills/life/household-grocery/scripts/tracker.py
~/.hermes/scripts/grocery_tracker.json  ← 你的库存数据

参考文档

• references/usage-notes.md — 使用备忘与分类体系