grocery-list

Grocery List & Meal Planner 是一个自包含的购物清单、菜谱和膳食计划工具，数据以本地 JSON 格式存储，无需订阅或外部服务。

用途

该工具旨在帮助用户在本地管理购物清单、保存菜谱并进行膳食规划，适合希望在没有云服务依赖的情况下整理日常采购与饮食安排的个人或家庭。

多清单管理：支持创建和管理多个清单，例如 Grocery、Costco、Target 等。
智能分类：内置分类并自动检测，包括 produce（水果、蔬菜）、dairy（牛奶、奶酪、鸡蛋、酸奶）、meat（鸡肉、牛肉、猪肉、鱼）、bakery（面包、卷饼、百吉饼）、frozen（冰淇淋、冷冻餐）、pantry（罐头、意面、大米）、beverages（饮料、汽水、果汁）、snacks（薯片、饼干）、household（清洁用品、纸制品）、personal（洗漱用品、药品）、other（未分类）。
数量解析：可解析数量描述，例如 "2 gallons milk" 会转换为 quantity: 2, unit: "gallon"。
菜谱存储：保存菜谱及其配料，支持按分类和份数添加。
膳食计划：按日期和餐次类型（早餐/午餐/晚餐）规划膳食。
菜谱转清单：通过一条命令将菜谱配料添加到任意清单。
家庭分配：可将条目分配给家庭成员。
通知：提供 notify 命令，用于心跳或 cron 集成。
JSON 输出：所有命令支持 --json，便于程序化访问。

该工具通过命令行脚本调用，主要命令包括：

uv run {baseDir}/scripts/grocery.py add "Grocery" "Milk" 添加条目
uv run {baseDir}/scripts/grocery.py add "Grocery" "Milk" --category dairy --qty "2 gallons" 带分类和数量添加
uv run {baseDir}/scripts/grocery.py add "Grocery" "Chicken" --assignee "Erin" 分配给指定成员
uv run {baseDir}/scripts/grocery.py check "Grocery" "Milk" 勾选条目
uv run {baseDir}/scripts/grocery.py uncheck "Grocery" "Milk" 取消勾选
uv run {baseDir}/scripts/grocery.py remove "Grocery" "Milk" 移除条目
uv run {baseDir}/scripts/grocery.py clear "Grocery" 清除已勾选条目

uv run {baseDir}/scripts/grocery.py recipes 列出所有菜谱
uv run {baseDir}/scripts/grocery.py recipe "Tacos" 查看菜谱
uv run {baseDir}/scripts/grocery.py recipe add "Tacos" --ingredients "ground beef,tortillas,cheese,lettuce,tomatoes" 添加菜谱
uv run {baseDir}/scripts/grocery.py recipe add "Tacos" --category "Mexican" --servings 4 带分类和份数添加
uv run {baseDir}/scripts/grocery.py recipe delete "Tacos" 删除菜谱
uv run {baseDir}/scripts/grocery.py recipe search "chicken" 搜索菜谱

uv run {baseDir}/scripts/grocery.py meals 显示本周膳食
uv run {baseDir}/scripts/grocery.py meals --date 2026-01-15 显示指定日期膳食
uv run {baseDir}/scripts/grocery.py meal add --date 2026-01-15 --type dinner --recipe "Tacos" 添加膳食
uv run {baseDir}/scripts/grocery.py meal add-to-list --date 2026-01-15 --list "Grocery" 将膳食配料添加到清单
uv run {baseDir}/scripts/grocery.py meal remove --date 2026-01-15 --type dinner 移除膳食

所有命令均支持 --json，例如：