二维码识别

要解决的问题

当二维码以图片形式出现在工单、邮件或业务系统里时，人眼很难快速读出其中编码的文本或链接。尤其在商业零售的收银核验、物流单据的节点追踪、公共服务的窗口扫码、医疗健康的场景核验中，图片型二维码只能靠肉眼识别或专用扫码枪，重复性工作难以沉淀到自动化流程里。

技能如何工作

核心能力：

• 解析二维码图片中存储的信息内容
• 支持以 http 开头的图片地址作为查询输入
• 面向商品扫码、物流追踪、信息读取等场景

关键步骤：

1. 从请求中提取二维码图片地址，作为 qrcode 参数
2. 在 Skill 根目录执行脚本：

   python scripts/query_qrcode_read.py --qrcode https://example.com/qrcode.png
   

1. 脚本携带 API Key 调用接口，把图片地址提交给二维码识别服务
2. 从返回的 JSON 中读取 text 字段，即二维码编码的原始内容
3. 按实际返回回答用户，不做补全或推测

使用前需要在购买页注册并获取专属 API Key，把 Key 直接发给 AI 即可发起查询；若已配置环境变量 CHINAZ_QRCODE_READ_API_KEY，脚本可省略 --api-key 参数。Python 3 命令若命名为 python3，对应替换即可。

适用边界与注意点

• 一次只能查询一个二维码图片，批量任务必须逐条执行
• 仅覆盖二维码识别接口，不用于条码、车牌等其他识别能力
• 返回的识别内容仅供参考，不作为法律依据
• API Key 不输出、不复述、不保存，仅用于本次查询
• 常见错误包括 missing_api_key、invalid_input、network_error，按返回的 msg 定位，不要编造数据