花美家AI花店订单管理

要解决什么问题

花店或鲜花电商若对接 香缤玫瑰 平台（xcx.xiangbinmeigui.com），每次下单、查单、配送都要自己拼系统参数、算 MD5 签名，还要对照文档维护多套接口。人工在对话里重复这些步骤，既容易漏 timestamp/nonce，也容易把密钥写进聊天记录。

本技能把平台侧约定收敛成可复用的调用路径：由 Agent 按文档发起请求，而不是让你每次口述签名算法。

技能如何工作

• 核心库：scripts/xiangbin_api.py 负责签名（generate_sign()）、下单、查询、配送等封装；完整字段说明见 references/api_docs.md。
• 鉴权：所有请求携带 appid、timestamp、nonce、sign；appid 与密钥分别来自环境变量 XBMG_APPID、XBMG_SECRET（需向用户确认后写入环境，勿硬编码）。
• 签名规则：除 sign 外参数按名 ASCII 升序 → key=value& 拼接 → 末尾 secret= → MD5 并转大写；实现以脚本为准，不必手算。
• 业务接口：下单、订单查询、订单配送三类主流程。
• 定时拉单：可按 references/cron_config.md 配置约每 5 分钟查询最新订单并通知（若你启用该能力）。

适用边界与注意点

• 技能覆盖的是 平台 HTTP API 的调用与签名，不包含 ERP、财务对账或自有库存系统的改造。
• 未配置 XBMG_APPID / XBMG_SECRET 时，任何接口调用都会失败；密钥权限与账号归属需你方与平台确认。
• 返回体格式以平台实时响应为准，对接前建议在测试环境用查询接口验签与字段映射。