名称： qr-code
描述： 生成与读取二维码。当用户需要将文本/URL转换为二维码，或从图像文件中解码/读取二维码时使用。支持PNG/JPG输出，并能从截图或图像文件中读取二维码。

二维码工具

将文本/URL生成二维码，或从图像中解码二维码。

功能特性

• 从任意文本、URL或数据生成二维码
• 自定义二维码尺寸与纠错等级
• 保存为PNG格式或在终端中显示
• 从图像文件（PNG、JPG等）读取/解码二维码
• 从截图中读取二维码

环境要求

安装Python依赖包：

生成二维码

pip install qrcode pillow

读取二维码

pip install pillow pyzbar

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

生成二维码

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

可选参数：

• --size：像素块大小（默认：10）
• --border：边框宽度（单位：块，默认：4）
• --error：纠错等级 L/M/Q/H（默认：M）

使用示例：

python scripts/qr_generate.py "Hello World" hello.png --size 15 --border 2

读取二维码

python scripts/qr_read.py image.png

返回二维码解码后的文本/URL。

快速示例

生成URL二维码：

import qrcode
img = qrcode.make("https://openclaw.ai")
img.save("openclaw.png")

从图像读取二维码：

from pyzbar.pyzbar import decode
from PIL import Image
data = decode(Image.open("qr.png"))
print(data[0].data.decode())

脚本说明

• scripts/qr_generate.py：支持自定义选项的二维码生成脚本
• scripts/qr_read.py：从图像文件解码二维码的脚本