小紫 二维码插件
v1.0.0 · 办公自动化 · 官方
简介
小紫 二维码插件 v1.0,本地生成与识别二维码:
- generate 文本/URL/WiFi 字符串 → 二维码图片
- decode 从 PNG/JPG 等图片识别二维码内容
- batch 批量生成多个二维码
- Win / macOS / Linux 通用,本地不上传
典型场景:活动链接出码、WiFi 分享码、名片网址、识别截图里的二维码。
操作说明
| action | 功能 |
|---|---|
generate | 生成单张二维码 |
decode | 解析图片中的二维码 |
batch | 按 JSON 列表批量生成 |
info | 检查依赖是否安装 |
generate 参数:
content必填,URL、文本、WiFi 字符串等output输出路径,不填则自动保存到 output 目录size模块像素,默认 10error_correction纠错 L/M/Q/H,默认 Mformatpng(默认)或 jpg
decode 参数:
filepath图片路径,支持 png/jpg/bmp/webp 等
batch 参数:
itemsJSON 数组:[{"name":"官网","content":"https://..."}]output_dir批量输出目录
安装
- 解压到
D:\xiaozi-plugins\办公自动化\二维码插件\ - 复制
python/到本目录 - 安装依赖:
python\python.exe -m pip install qrcode[pil] Pillow opencv-python-headless
- 测试:
run.bat --action info
| 文件 | 说明 |
|---|---|
qrcode_plugin.py | 主程序 |
run.bat / run.sh | 启动脚本 |
二维码插件.md | 用户文档 |
命令行
run.bat --action generate --content "https://www.example.com" --output D:\qr\site.png
run.bat --action generate --content "Hello 小紫" --size 12 --error_correction H
run.bat --action decode --filepath D:\qr\scan.png
run.bat --action batch --items "[{\"name\":\"a\",\"content\":\"https://a.com\"}]" --output_dir D:\qr\batch
注册技能 qrcode_tool
名称: qrcode_tool
描述: 二维码 v1.0。generate/decode/batch生成解析批量二维码。用户生成链接WiFi文本二维码、识别图片中QR码时使用。generate需content;decode需filepath;batch需items JSON。
脚本: D:\xiaozi-plugins\办公自动化\二维码插件\run.bat
参数 JSON:
{
"type": "object",
"properties": {
"action": {"type": "string", "enum": ["generate", "decode", "batch", "info"], "description": "操作类型"},
"content": {"type": "string", "description": "generate内容"},
"output": {"type": "string", "description": "输出图片路径"},
"filepath": {"type": "string", "description": "decode图片路径"},
"items": {"type": "string", "description": "batch JSON数组"},
"output_dir": {"type": "string", "description": "batch输出目录"},
"size": {"type": "string", "description": "模块大小"},
"border": {"type": "string", "description": "边框宽度"},
"error_correction": {"type": "string", "description": "L/M/Q/H"},
"format": {"type": "string", "description": "png/jpg"}
},
"required": ["action"]
}
对话示例
| 场景 | 说法 |
|---|---|
| 生成 | 把 https://example.com 生成二维码 |
| WiFi | 生成 WiFi 二维码,内容是 xxx |
| 识别 | 看看这张图片里的二维码是什么 |
| 批量 | 批量生成这几个链接的二维码 |
| 保存 | 生成二维码保存到 D:\qr\a.png |
常见错误
| 现象 | 处理 |
|---|---|
| 缺依赖 | pip install qrcode[pil] Pillow opencv-python-headless |
| 未识别 | 图片不清晰或不是 QR 码 |
| content 为空 | generate 必须传内容 |
| python folder missing | 复制 python |
能力边界
| 支持 | 不支持 |
|---|---|
| 文本/URL/WiFi QR | 条形码 |
| PNG/JPG 生成解析 | 艺术码/Logo 嵌入 |
| 批量生成 | 摄像头实时扫 |
与其他插件配合
- image_tool:生成后压缩/转格式
- ocr_tool:图文混合场景
详见包内 二维码插件.md。