二维码编解码

技能简介

该技能提供二维码的生成与读取功能，支持将文本、URL等数据编码为PNG格式二维码图片，也可从截图或图像文件中解析出原始内容。

业务背景

满足企业内外部信息快速传递与采集的需求，打通线上线下数据交互通道。员工可将产品链接、电子名片或工单编号生成二维码印刷于物料，客户扫码即可直达；同时支持从现场照片、屏幕截图中批量提取二维码内容，替代手工录入，减少差错并加速业务流程数字化。

落地案例：市场部策划线下展会时，需为200款展品生成带追踪参数的专属链接二维码。通过本技能批量调用API，设置中等容错级别确保展台光线复杂环境下仍可识别，输出统一尺寸的PNG图片用于印刷展架。展会结束后，销售团队用手机拍摄现场收集的名片二维码，批量上传至系统解析，自动提取客户官网链接导入CRM，避免人工录入网址的错误与遗漏。

能做什么

• 将任意文本或链接转换为可扫描的二维码图片
• 自定义二维码尺寸、边距和容错级别
• 从PNG/JPG等格式的图片中提取二维码信息
• 直接识别屏幕截图中的二维码内容

使用说明

1. 安装依赖

生成二维码需执行：

pip install qrcode pillow

读取二维码需执行：

pip install pillow pyzbar

系统额外要求：Windows需安装Visual C++ Redistributable；macOS执行brew install zbar；Linux执行apt install libzbar0。

2. 生成二维码

python scripts/qr_generate.py "https://example.com" output.png

可选参数：--size设置像素尺寸（默认10），--border设置边框盒数（默认4），--error设置容错等级L/M/Q/H（默认M）。

3. 读取二维码

python scripts/qr_read.py image.png

执行后返回解码后的文本或URL内容。

输入与输出

见下方输入与输出表格。

风险提示

• 解析来源不明的二维码可能暴露设备于恶意链接风险
• 高容错级别会增加二维码图案复杂度，部分老旧扫描器可能识别困难
• pyzbar依赖的系统库若未正确安装会导致读取功能完全失效

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/omar-khaleel/qr-code/SKILL.md
来源类型：开源社区技能