二维码识别器

要解决什么问题

在自动化脚本、客服工单或内容审核流程里，你经常拿到截图、扫描件或批量导出的图片，需要读出其中的二维码或条形码，而不是肉眼逐张打开。手工复制既慢，也容易在 EAN-13、Code-128 等条码类型上出错。本技能面向「从图片路径批量解码」这一具体场景，把识别结果落成可用的文本或结构化载荷。

技能如何工作

核心输入是 image 参数：支持单张路径，也支持 glob 一次匹配多张图。识别链路依赖 Pillow 读图、pyzbar（底层 zbar）做码制检测与解码，可处理常见位图格式（如 PNG、JPG、BMP）。

解码结果覆盖典型业务载荷：

• URL 与纯文本
• 联系方式等常见编码内容
• 一维条形码（如 EAN-13、Code-128）

需要排查识别失败或对比多张图时，可加 --verbose 输出更细的过程信息；若要把结果落盘做后续流水线，可用 --save 写入文件，避免只在终端里一闪而过。

适用边界与注意点

• 系统侧必须先装好 zbar（macOS / Ubuntu 各有对应包名），否则 pyzbar 无法工作。
• 文档强调摄像头与文件两种输入；实际集成时以你运行环境中的调用方式为准，文件路径 + glob 是资料里写明的稳定入口。
• 图片模糊、反光、裁切过度或码制不在支持范围内时，识别可能为空；--verbose 有助于区分「未检测到码」与「读图失败」。