技能介绍

解决的问题

社区团购的商品库和营销规则更新频繁，团长与运营在蛋卷 SAAS 后台查找特定商品、确认某会员等级的折扣时往往效率很低。频繁切换页面和手动计算积分系数不仅打断了服务流程，也容易因为记忆偏差出现报价错误。这个技能的目标，是把查询和收银动作直接映射到自然语言指令里，让 query_goods.py 作为后端与 1card1 开放平台之间的代理。

工作原理与关键步骤

核心脚本采用签名鉴权，将 OpenId、Secret、Timestamp 与请求数据组合成 32 位大写的 MD5 签名。针对自然语言输入，它会将意图分为四类并分配给对应的底层接口：

商品查询：通过 Get_GoodsItemsPagedV2 获取在售状态、价格与图片，支持按关键词、分类或条码进行 --onsale 过滤。
积分折扣：利用 Get_PointAndDiscount 解析单品或整单系数，将冰冷的数字换算成“打八折”或“1 元积 1.2 分”等直观描述。
会员查询：通过 Get_MemberInfo 调取卡号对应的储值与积分余额。
收银下单：调用 Consume 接口，强制要求 --total-money 和 --paid-money 一致，并支持备注与支付方式。

适用边界与工程注意点

在生产环境中使用需关注以下细节：

密钥管理：必须通过环境变量或 config.json 注入 OpenId 与 Secret，严禁硬编码在源码中。
防误操作设计：Consume 属于真实写操作。脚本默认仅生成包含签名的预览请求，必须在用户明确发出“确认提交”指令并附加 --confirm 参数后才会真正发送。建议配合 --unique-code 实现幂等校验，避免网络重试导致重复扣款。
数据容错：接口返回的字段名存在大小写及空格差异（如 GooodsItemTypename 或 Price ），脚本已实现多候选键兜底，但在解析复杂返回值时应保持对服务端字段变更的警惕。
业务逻辑判断：若门店未配置特定的积分折扣规则，接口会返回默认系数（折扣 1.0、积分 0.0），这属于正常的空状态响应，而非系统故障。