qr-code-generator

name	qr-code-generator
description	高度可定制二维码生成技能，支持 PNG/SVG 输出、尺寸/边距/颜色/纠错等级/Logo/圆角/标签文字等配置，适用于链接分享、活动物料、产品包装、名片和网页入口。

QR Code Generator Skill

能力概览

将文本、URL、联系方式、Wi-Fi 配置等内容生成二维码文件，支持：

• 输出格式：PNG / SVG
• 尺寸：size 控制像素尺寸
• 边距：border 控制 quiet zone
• 颜色：前景色、背景色、透明背景
• 纠错等级：L / M / Q / H
• Logo：居中嵌入图片并自动留白
• 圆角模块：PNG 下支持模块圆角风格
• 标签文字：在二维码下方追加说明文字
• 输出路径：支持用户 workspace 相对路径

适用场景

• 活动报名/签到二维码
• 产品官网/落地页二维码
• 小程序/下载页入口
• Wi-Fi 连接二维码
• 名片 vCard / 联系方式二维码
• 海报、PPT、包装物料中的二维码资产

输入建议

用户可以直接说明：

• 二维码内容：URL 或文本
• 输出路径：如 output/qr.png
• 尺寸：如 1024
• 颜色：如黑白、品牌色、透明背景
• 是否加 logo
• 是否要 SVG 矢量格式
• 是否需要标签文字

示例提问

请用 qr-code-generator 生成一个二维码。
内容：https://example.com/campaign
输出：output/campaign-qr.png
尺寸：1024
前景色：#111827
背景色：#ffffff
纠错等级：H
标签文字：扫码了解活动详情

请生成一个透明背景 SVG 二维码。
内容：https://my-product.com
输出：output/product-qr.svg
前景色：#0f172a
背景透明：true
边距：2

请生成带 Logo 的品牌二维码。
内容：https://example.com/app
输出：output/app-qr.png
尺寸：1200
前景色：#2563eb
背景色：#ffffff
纠错等级：H
Logo：assets/logo.png
Logo 占比：0.22
圆角：8

执行参数

本 skill 是可执行 bundle（Node 版）。常用参数：

• --data：二维码承载内容，必填
• --output：输出文件路径，默认 qr-code.png
• --format：png 或 svg
• --size：图片尺寸，默认 1024
• --border：边距模块数，默认 4
• --error-correction：L/M/Q/H，默认 H
• --foreground：前景色，默认 #000000
• --background：背景色，默认 #ffffff
• --transparent：透明背景，仅 PNG/SVG 均支持
• --logo：Logo 图片路径，可选
• --logo-scale：Logo 占二维码宽度比例，默认 0.2
• --module-radius：PNG 模块圆角半径，默认 0
• --label：二维码底部标签文字，可选
• --label-font-size：标签字号，默认 42

质量建议

• 带 Logo 时建议纠错等级使用 H
• 印刷物料建议输出 SVG 或 size >= 1200 的 PNG
• 透明背景用于叠加设计稿时，注意二维码前景色和底色对比度
• Logo 占比建议 0.16 - 0.24，过大会影响识别
• 二维码内容越长，模块越密，建议增大尺寸和边距