qrcode2

本地二维码生成与识别（qrcode2）

本 Skill 在本地使用 Python 库生成和识别二维码，不依赖外部 HTTP 接口，适合在 OpenClaw/ClawHub 中做：

将文本/URL 快速生成 PNG 格式二维码图片（保存在本地路径）；
从本地二维码图片文件中解析出被编码的文本/URL；
与极速数据或营销落地页结合，给接口/页面生成扫码入口；
与远程版 jisu-qrcode（基于 https://www.jisuapi.com/api/qrcode/）搭配，一边用远程接口生成带模板/LOGO 的二维码 base64，一边用本地工具在沙箱内做测试和解码。

依赖安装

不提供 requirements.txt，请在当前环境中手动安装依赖：

pip install "qrcode[pil]" opencv-python

说明：
- qrcode[pil] 用于生成二维码（依赖 Pillow）；
- opencv-python 用于从图片中识别解码二维码。

脚本路径

脚本文件：skills/qrcode2/qrcode.py

使用方式与子命令

当前脚本提供两个子命令：

encode：生成二维码图片；
decode：从图片中识别二维码内容。

1. 生成二维码（encode）

python3 skills/qrcode2/qrcode.py encode '{"text":"https://www.jisuapi.com","out":"out/qrcode-jisuapi.png"}'

也可以使用 data 或 url 字段代替 text：

python3 skills/qrcode2/qrcode.py encode '{
  "url": "https://www.jisuapi.com",
  "out": "out/jisuapi-qr.png",
  "error_correction": "M",
  "box_size": 10,
  "border": 4
}'

请求 JSON 字段说明：

字段名	类型	必填	说明
text / data / url	string	是	要编码的文本或 URL，三者任选其一
out	string	否	输出图片路径（默认 `qrcode.png`）
version	int	否	QR 版本，1–40，留空则自动选择
error_correction	string	否	容错级别：`L/M/Q/H`，默认 `M`
box_size	int	否	每个模块（小方块）的像素大小，默认 `10`
border	int	否	边框宽度（模块数），默认 `4`
fill_color	string	否	前景色，默认 `black`
back_color	string	否	背景色，默认 `white`

成功时返回示例：

{
  "path": "out/jisuapi-qr.png",
  "text": "https://www.jisuapi.com",
  "error_correction": "M",
  "box_size": 10,
  "border": 4
}

2. 识别二维码（decode）

python3 skills/qrcode2/qrcode.py decode '{"path":"out/jisuapi-qr.png"}'

请求 JSON 字段说明：

字段名	类型	必填	说明
path	string	是	图片文件路径（也可使用 `image` / `file` 字段）

成功时返回示例：

{
  "text": "https://www.jisuapi.com",
  "points": [[100.0, 120.0], [300.0, 120.0], [300.0, 320.0], [100.0, 320.0]],
  "path": "out/jisuapi-qr.png"
}

若未检测到二维码或解码失败，会返回：

{
  "error": "decode_failed",
  "message": "No QR code detected or decode failed.",
  "path": "out/jisuapi-qr.png"
}

错误与依赖提示

若未安装依赖：
encode 时返回 {"error":"missing_dependency","message":"... qrcode[pil] ..."}；
decode 时返回 {"error":"missing_dependency","message":"... opencv-python ..."}。
当文件不存在或图片无法读取时，会返回 file_not_found / load_failed 等错误类型。

Installation