技能简介
该技能提供二维码的生成与读取功能,支持将文本、URL等数据编码为二维码图像,或从图片文件中解码提取原始信息。
业务背景
业务人员频繁遇到信息传递场景:对外需要把联系方式、电子名片或调查问卷转成二维码便于传播;对内需要处理供应商、客户发来的含二维码的合同附件或验收单据截图。本技能双向满足编码与解码需求,减少人工转录错误。
落地案例:销售团队拜访客户前,将个人电子名片链接生成高纠错级别二维码,即便名片折叠污损仍能正常识别;采购同事收到供应商邮件中的JPG对账单,上面带有订单二维码,直接解析图片即可提取订单号录入系统,避免肉眼识别出错。
能做什么
- 将任意文本或URL转换为二维码图像
- 自定义二维码尺寸、边距和纠错级别
- 输出PNG格式文件或在终端直接显示
- 从PNG、JPG等图像文件中读取二维码内容
- 解析截图中的二维码信息
使用说明
安装依赖
生成功能需安装:
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_read.py image.png
执行后返回解码后的文本或URL内容。
输入与输出
见下方输入与输出表格。
| 项目 | 内容 |
|---|---|
| 输入 | 文本/URL字符串、图像文件(PNG/JPG)、可选参数(–size/–border/–error) |
| 输出 | PNG格式二维码图像、解码后的文本字符串、终端ASCII图形 |
| 适用人群 | 需要快速生成分享链接二维码的运营人员、需批量处理二维码数据的开发者、从图片提取二维码信息的普通用户 |
| 不包含 | 二维码视觉设计定制、动态内容管理、扫描行为分析、一维码/条形码支持 |
风险提示
- pyzbar依赖系统级库,不同操作系统需单独配置运行环境
- 低纠错级别(L)的二维码在污损后可能无法识别
- 生成的二维码包含原始明文信息,敏感数据需谨慎分享
- 从网络下载的二维码图片可能包含恶意链接,解码后请核实内容
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/omar-khaleel/qr-code-pro/SKILL.md
来源类型:GitHub仓库
常见问题
Q1:二维码生成与识别 适合哪些场景?
A:适合需要「该技能提供二维码的生成与读取功能,支持将文本、URL等数据编码为二维码图」的场景,尤其是希望快速验证并落地的团队与个人。
Q2:第一次使用应该先做什么?
A:先明确目标任务,再按照页面中的“能做什么”和“使用说明”完成最小可行流程。
Q3:如何判断是否值得长期使用?
A:建议连续使用 1-2 周,对比效率、稳定性和协作成本,再决定是否纳入长期工具栈。
