Paprika

核心用法

Paprika Recipe CLI 是一款非官方命令行工具，用于与 Paprika Recipe Manager 的云端数据交互。用户通过 npm install -g paprika-recipe-cli 安装后，需使用 paprika auth 完成认证或配置环境变量 PAPRIKA_EMAIL/PAPRIKA_PASSWORD。

功能模块：

• 食谱管理：paprika recipes 列出/筛选食谱，paprika recipe <名称/ID> 查看详情，paprika search 全文检索
• 膳食计划：paprika meals 按日期查看已安排的餐食
• 购物清单：paprika groceries 管理待购食材，支持区分已购/未购状态
• 分类浏览：paprika categories 查看自定义分类体系

输出格式：默认友好文本输出，--json 标志支持结构化数据导出，便于脚本集成。

显著优点

1. 高效工作流：无需打开 Paprika App 即可快速查询食谱和购物清单，适合厨房场景下的语音或快捷指令操作
2. 灵活检索：支持部分匹配（如 "Pasta" 匹配 "Pasta Carbonara"）和 ingredients-only 模式，快速提取所需信息
3. 开源透明：基于 npm 分发，代码可审计，无隐藏遥测

潜在缺点与局限性

• 非官方工具：由第三方开发，非 Paprika 官方维护，API 稳定性无保障，存在因 Paprika 服务端变更导致功能失效的风险
• 认证方式局限：仅支持邮箱+密码认证，不支持 OAuth 或 2FA，安全性取决于密码复杂度
• 功能边界：无法编辑食谱、上传图片或同步本地离线数据，仅为只读查询工具
• 平台依赖：需 Node.js 环境，对非开发者用户存在安装门槛

适合人群

• Paprika 重度用户，希望将食谱数据整合到自动化工作流（如 Home Assistant、快捷指令）
• 习惯终端操作的技术型家庭厨师
• 需要批量导出食谱数据进行二次分析的用户

常规风险

• 凭证安全：密码以明文形式存储在环境变量或交互式输入中，在多用户系统存在泄露风险
• 网络传输：依赖 Paprika 云同步 API，传输加密强度取决于 Paprika 服务端实现（未明确 TLS 版本）
• 数据隐私：通过第三方 CLI 访问个人食谱数据，工具开发者理论上可截获请求（尽管开源可降低此风险）

核心用法

Paprika Skill 是一款面向个人烹饪场景的效率工具，通过与 Paprika Recipe Manager 的本地 CLI 工具集成，让用户能够在 Agent 对话环境中直接操作自己的食谱数据库。其核心功能覆盖三大模块：食谱检索（支持按名称模糊匹配、按分类筛选、JSON 格式导出）、膳食计划管理（按日期查看当日安排）以及购物清单同步（显示未采购食材，支持全量导出）。

使用时需先通过 paprika auth 完成交互式认证，或配置环境变量（建议优先使用前者以避免凭据泄露）。所有命令均在本地执行，数据不离用户设备，依赖 Paprika 官方云端同步服务保持数据一致性。

显著优点

1. 零学习成本：纯文档型设计，直接映射 Paprika CLI 的原生命令语法，老用户无需适应即可上手。
2. 数据主权保障：仅访问用户自有的 Paprika 账户数据，无第三方数据中转，符合隐私最小化原则。
3. 轻量化架构：无可执行代码注入，完全依赖系统级 CLI 工具， Skill 本身仅作为命令模板存在，攻击面极窄。
4. 场景覆盖完整：从灵感检索（search）、精准调取（recipe）、周计划管理（meals）到采购清单生成（groceries），形成烹饪决策闭环。

潜在缺点与局限性

1. 外部依赖硬性：必须预先安装 paprika-recipe-cli NPM 包并启用 Paprika 云同步，缺失任一环节即无法工作。
2. 功能受限于官方：Paprika CLI 本身不支持食谱编辑、图片导出等高级操作，Skill 无法扩展边界能力。
3. 认证方式存隐患：文档示例包含环境变量配置方式，若用户误用可能导致密码暴露在进程列表或 shell 历史中。
4. 无跨平台适配：NPM 全局安装模式在 Windows 环境可能需要额外配置，文档未提供针对性指引。

适合的目标群体

• 已深度使用 Paprika Recipe Manager 的资深用户，希望在对话式 AI 中延续现有工作流
• 注重数据隐私、拒绝云端食谱 SaaS 的家庭烹饪爱好者
• 需要将膳食计划与购物清单快速同步至智能助手场景的效率追求者
• 技术人员背景用户（熟悉 CLI 操作和 NPM 生态）

使用风险

1. 凭据管理风险：环境变量方式配置密码时，可能被其他进程读取或意外记录到日志，建议始终优先使用交互式认证。
2. CLI 版本漂移：npm install -g 默认安装最新版本，若 Paprika CLI 引入破坏性变更，可能导致命令失效，建议生产环境锁定主版本号。
3. 网络同步延迟：功能依赖 Paprika 云端同步，离线状态或服务器异常时数据可能不同步。
4. 无权限隔离：Skill 运行时可访问 Paprika 账户的全部数据，多人共享设备场景需注意会话隔离。