核心用法
tandoor-recipe-cli 是一款面向 Tandoor Recipe Manager 的命令行工具技能，允许 AI 代理通过结构化 CLI 接口完成食谱管理、膳食规划、购物清单维护及家庭成员协作。核心工作流程包括：
- 食谱管理：列出、搜索、获取、创建、更新、删除食谱，支持从 URL 导入
- 膳食规划：按日期范围管理每日三餐安排
- 购物清单：添加食材、标记完成状态、批量清理
- 家庭组织：创建家庭空间、管理成员邀请（需空间所有者权限）
- 食材配置：标记忽略购物的常备食材、设置库存状态
工具支持 JSON 输出便于管道化处理，配置方式灵活（环境变量、配置文件、.env 文件）。
显著优点
- 功能全面：覆盖 Tandoor 核心 API 能力，无需直接操作 REST 接口
- 自动化友好：
--json标志支持程序化解析，适合 Agent 工作流集成 - 权限分层清晰：明确区分普通用户、管理员、空间所有者三级权限需求
- 批量操作：支持购物清单全选标记、食谱批量导入等高效操作
潜在局限
- 自托管依赖：必须拥有 Tandoor 实例，无托管服务版本
- 权限门槛高：家庭邀请创建仅限空间所有者，误操作会导致 403 错误
- 无审批流程：删除操作
--force标志直接执行，缺乏二次确认机制 - 配置分散：三种配置源优先级逻辑可能引发调试困扰
适合人群
- 自托管 Tandoor 的技术用户
- 需要将食谱管理接入自动化工作流的效率爱好者
- 家庭/小团队共享食谱管理的组织者
常规风险
- Token 泄露：API 令牌存储于明文配置文件或环境变量，多用户系统需加强访问控制
- 误删风险：
delete与clear命令的--force参数绕过确认，脚本中需谨慎使用 - 权限混淆：家庭管理命令的权限要求复杂，非所有者尝试邀请操作会遭遇静默失败