二维码编解码

技能简介

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

业务背景

在日常业务中，员工常需快速分享网址、产品信息或设备参数。本技能将文字一键转为二维码，方便打印张贴或微信传递；也能扫描客户提供的二维码图片，自动提取其中的链接或编号，省去手动输入的麻烦，提升内外部协作效率。

落地案例：市场部制作展会海报时，将官网活动页URL生成二维码印刷在易拉宝上，访客扫码即可报名；售后工程师收到客户发来的故障设备照片，其中包含二维码铭牌，直接截图读取即可获取设备序列号，无需让客户反复口述核对。

能做什么

• 将任意文本或网址转换为二维码图片
• 自定义二维码尺寸、边距和纠错级别
• 从本地图片或截图中读取二维码信息
• 输出PNG格式文件或在终端直接显示

使用说明

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-intelligence/SKILL.md
来源类型：GitHub仓库