bring-add

Bring! Add Items CLI 是一款专为 Bring! 购物清单设计的命令行工具，旨在通过灵活的输入方式和安全的操作机制，帮助用户高效管理购物清单。该工具基于 Bring! 官方 API 构建，支持多种物品添加模式，从简单的单条添加到复杂的批量导入，满足不同场景下的自动化需求。

核心用法方面，用户通过设置 BRING_EMAIL 和 BRING_PASSWORD 环境变量完成身份验证后，即可通过命令行向指定购物清单添加物品。工具支持四种主要操作模式：单物品模式允许指定物品名称和规格（如 "Milk 1L"）；批量模式通过逗号分隔一次性添加多个物品；管道模式可从文件或其他命令接收物品列表；交互模式则在 TTY 环境下提供引导式输入。此外，--dry-run 标志允许在实际修改前预览操作，--json 标志支持脚本集成。

显著优点体现在其高度的灵活性和自动化能力。首先，输入解析智能且人性化，能自动识别物品规格（如数量、单位）。其次，完善的错误处理机制提供了清晰的退出码（0-4 及 130），便于脚本判断执行状态。工具还支持指定目标清单、静默模式、详细日志等选项，满足从日常手动使用到 CI/CD 集成的广泛需求。特别值得一提的是其安全设计：敏感信息通过环境变量管理，避免硬编码风险；交互模式仅在检测到 TTY 时启动，防止脚本意外挂起。

潜在缺点与局限性不容忽视。作为社区来源（T3）项目，其长期维护稳定性相对官方工具较弱。技术层面，bring-shopping 依赖采用通配符版本（*），存在引入未预期更新的风险。功能上，该工具仅支持添加物品，无法删除、修改或查看清单内容，需配合其他工具使用。此外，要求 Node.js 18.0+ 环境可能对部分旧系统造成兼容性问题。

适合的目标群体主要包括：追求效率的技术用户和开发者，需要将购物清单管理集成到自动化工作流的家庭或团队，以及习惯使用命令行工具的 Bring! 重度用户。对于需要通过脚本定期同步库存、从食谱自动生成购物清单、或在多台设备间批量导入清单数据的场景，该工具尤为适用。

使用风险主要集中在依赖管理和凭证安全方面。通配符版本的依赖可能导致构建不一致或引入破坏性更新，建议用户通过 package-lock.json 锁定版本。凭证通过环境变量传递虽避免了硬编码，但用户需确保环境变量不被意外记录到日志或历史记录中。此外，部分错误场景可能向 stderr 输出堆栈跟踪信息，在生产环境日志中可能暴露内部路径信息。建议在生产使用前进行充分的 dry-run 测试，并定期审查依赖安全状态。