（3620期）Tandoor Recipe CLI – 命令行掌控你的智能厨房

命令行掌控你的智能厨房 通过 CLI 管理 Tandoor 食谱、膳食计划和购物清单，支持读写分离权限模型，适合自托管用户自动化厨房管理。 使用说明 核心用法 tandoor-recipe-cli 是一个命令行工具，用于与自托管的 Tandoor Recipe Manager 实例交互。它提供完整的食谱生命周期管理：从创建、更新、导入外部 URL，到膳食计划安排、购物清单维护、食材分类，以及烹饪日志追踪。 典型工作流： 配置认证：tandoor configure 设置 API 令牌 查询食谱：tandoor search <关键词> 或 tandoor random 获取随机灵感 规划膳食：tandoor mealplan add --recipe ID --date YYYY-MM-DD --meal-type N 生成购物清单：基于食谱自动聚合食材，通过 tandoor shopping add 手动补充 追踪烹饪历史：cooklog add 记录份量、评分和备注，支持按食材反查（如"上次吃鸡蛋是什么时候"） 数据格式：支持 --format text|json|api 三级输出，推荐用 --file recipe.json 进行食谱的批量创建和更新。 --- 显著优点 | 特性 | 说明 ||------|------|| 权限分级明确 | 读操作免确认、写操作需单次确认、删除/批量操作需显式二次确认，降低误操作风险 || 精细化食材管理 | 支持 grocery category 分类、onhand/ignore_shopping 标记，优化购物清单生成 || 烹饪数据分析 | cooklog ingredient <食材名> 可按时间、评分筛选，实现"本月鸡肉消费统计"等场景 || 多配置源支持 | 环境变量 > 配置文件 > .env 文件，适配 CI/CD 和本地开发 || Household 多租户 | 支持家庭/用户组管理，含邀请链接机制（需 space-owner 权限） | --- 潜在缺点与局限性 依赖自托管实例：无官方托管服务，用户需自行部署 Tandoor 后端 权限门槛高：家庭管理、邀请链接创建等操作需要 space-owner 令牌，普通管理员无法执行 无内置同步机制：与第三方购物应用（如 Todoist、AnyList）无原生集成 JSON Schema 严格：创建食谱时必须包含 steps 数组，每个 step 必须有 ingredients（可为空），学习成本略高 Node.js 版本要求：≥18，旧环境需升级 --- 适合人群 自托管技术用户：已部署或计划部署 Tandoor 的开发者/极客 家庭厨房管理员：需要为多人家庭协调膳食计划、购物清单 数据驱动型厨师：希望追踪烹饪频率、评分、食材消耗统计 自动化爱好者：计划将食谱管理接入 Home Assistant、n8n 等自动化工作流 --- 常规风险 | 风险类别 | 说明 ||----------|------|| 令牌泄露 | API Token 存储在 ~/.config/tandoor-cli/config.json，需确保文件权限 600；避免使用长期有效的 owner/admin 令牌 || 数据误删 | delete、shopping clear --force、household delete 等操作不可逆，需严格执行二次确认流程 || 供应链风险 | 需验证 npm 包 tandoor-cli 来源，建议 pin 版本安装避免恶意更新 || 权限提升滥用 | 普通用户令牌无法执行 admin 操作，但 agent 若配置 owner 令牌后，需警惕自动化脚本越权调用 || 并发写入冲突 | 多用户同时修改同一食谱或购物清单时，Tandoor 后端无乐观锁，可能产生覆盖 | --- 安全建议：生产环境使用只读令牌进行日常查询，仅临时切换写令牌；定期轮换令牌并在 references/SECURITY.md 中审计权限分配。 原始说明 Manage recipes, meal plans, and shopping lists on a Tandoor Recipe Manager instance via CLI.