Bring购物清单添加

技能简介

bring-add 是一个用于向 Bring! 购物清单添加商品的命令行工具，支持单条添加、批量添加、标准输入管道输入以及交互式模式。

业务背景

采购人员或行政专员可通过命令行快速向 Bring!共享清单录入物资需求，支持批量导入和脚本自动化。适用于餐饮后厨补货、活动筹备采买、办公耗材申领等高频场景，减少手动输入错误，实现采购指令从 ERP 或邮件直接流转至协作清单。

落地案例：某连锁咖啡店运营部将 bring-add 接入日报系统。每日闭店后，店长语音录入缺货商品生成文本文件，经管道传入 bring-add –batch 自动同步至区域采购清单；总部脚本定时拉取销量数据，用 –dry-run 预览次日原料追加量，确认后正式写入，采购员手机实时收到推送。

能做什么

• 快速添加单个商品并附带规格说明（如”牛奶 1L”）
• 批量添加多个逗号分隔的商品
• 从文件或其他命令通过管道读取商品列表
• 使用试运行模式预览添加结果而不实际修改清单
• 输出 JSON 格式便于脚本集成
• 查看可用的购物清单列表

使用说明

安装步骤：

cd skills/bring-add
npm install

环境配置（必需）：

export BRING_EMAIL="your@email.com"
export BRING_PASSWORD="yourpassword"
export BRING_DEFAULT_LIST="Shopping"  # 可选，设置默认清单

基础用法：

• 添加单个商品：node index.js "西红柿" "500g" 或 node index.js "牛奶"
• 指定目标清单：node index.js --list "聚会" "薯片" "3袋"
• 批量添加：node index.js --batch "西红柿 500g, 洋葱, 奶酪 200g"
• 从文件导入：cat shopping-list.txt | node index.js -
• 试运行预览：node index.js --dry-run --batch "苹果 1kg, 梨"
• JSON 输出：node index.js --json --batch "牛奶, 面包" 2>/dev/null
• 查看可用清单：node index.js lists

常用参数：-l/--list 指定清单，-b/--batch 批量模式，-n/--dry-run 试运行，-q/--quiet 静默模式，-v/--verbose 详细输出，--json JSON 输出，--no-input 禁止交互（脚本中使用）。

输入与输出

见下方输入与输出表格。

风险提示

• 需提前配置 BRING_EMAIL 和 BRING_PASSWORD 环境变量，否则认证失败
• 清单名称区分大小写，建议先用 bring-add lists 确认准确名称
• 规格解析规则：最后一个词若包含数字或单位（g/kg/L/ml/Stück/pck）会被识别为规格
• 脚本中务必添加 --no-input 参数，避免无输入时挂起等待
• 退出码 3 表示认证失败，需检查账号密码；退出码 4 表示清单未找到

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/darkdevelopers/bring-add/SKILL.md
来源类型：GitHub 开源项目