360 Secure SkillHub
360 安全技能中心

QR Code Generator

这是一款本地运行的QR码生成工具，无需调用外部API，核心支持生成文本/URL、WiFi连接、电子名片（vCard）三种类型QR码。典型场景包括分享网址、为客人提供WiFi自动连接码、制作电子名片。通过命令行传参使用，可自定义保存路径，输出为标准PNG图片，需先安装Python的qrcode依赖包。

ouyangabel
ouyangabel
热度 86.46
最近更新 2026-05-17 12:41:04
分类：效率依赖：代码执行 / 读写文件应用场景：图像生成 / 文件转换

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add qr-code-gen
Metadata
name
qr-code
description
Generate QR codes for text, URLs, WiFi connections, and business cards (vCard). Use when: (1) creating QR codes for websites or text, (2) generating WiFi connection QR codes for easy network sharing, (3) creating digital business card QR codes, or (4) any QR code generation needs. Supports saving to custom file paths.

QR Code Generator

Generate QR codes locally for various use cases. No API calls required - everything is generated on your machine.

When to Use

  • Share URLs quickly via QR codes
  • Create WiFi connection codes for guests
  • Generate digital business cards (vCard)
  • Encode any text data into QR format

Prerequisites

Install the required Python package:

pip3 install qrcode[pil]
# or on Ubuntu/Debian:
sudo apt-get install python3-qrcode

Quick Start

Generate URL QR Code

python3 scripts/qr-code.py text "https://example.com"
# Output: QR code saved to ~/qrcode_output.png

Generate WiFi QR Code

python3 scripts/qr-code.py wifi "MyNetwork" "myPassword"
# Scan with phone to auto-connect

Generate Business Card

python3 scripts/qr-code.py vcard --name "John Doe" --phone "+1234567890" --email "john@example.com"

Commands

text <content> [output_path]

Generate a QR code containing any text or URL.

Parameters:

  • content: The text or URL to encode
  • output_path: Optional. Where to save the PNG file. Defaults to ~/qrcode_output.png

Examples:

# Basic URL
python3 scripts/qr-code.py text "https://github.com"

# Custom output location
python3 scripts/qr-code.py text "Hello World" ./hello_qr.png

# Long URL (auto-fits to QR version)
python3 scripts/qr-code.py text "https://example.com/very/long/path?with=parameters"

wifi <ssid> <password> [output_path]

Generate a QR code that allows phones to connect to WiFi automatically.

Parameters:

  • ssid: WiFi network name
  • password: WiFi password
  • output_path: Optional output path

Supported phones:

  • iOS 11+ (Camera app)
  • Android 9+ (Camera or WiFi settings)
  • Most QR scanner apps

Example:

python3 scripts/qr-code.py wifi "HomeWiFi" "secretPass123" ~/wifi_qr.png

vcard --name <name> [options] [output_path]

Generate a vCard (digital business card) QR code.

Options:

  • --name, -n (required): Full name
  • --phone, -p: Phone number
  • --email, -e: Email address
  • --org, -o: Organization/Company
  • --title, -t: Job title
  • --url, -u: Website URL
  • output: Optional output path

Examples:

# Simple card
python3 scripts/qr-code.py vcard --name "张三"

# Full business card
python3 scripts/qr-code.py vcard \
  --name "John Smith" \
  --phone "+1-555-1234" \
  --email "john@company.com" \
  --org "Acme Corp" \
  --title "Senior Developer" \
  --url "https://johnsmith.dev" \
  ~/business_card.png

Tips

  • QR codes use high error correction - they still work even if partially obscured
  • For large amounts of text, the QR code will automatically use a larger version
  • Generated files are standard PNG images that can be printed or shared digitally
  • WiFi QR codes follow the universal WIFI: format standard

Troubleshooting

"Missing qrcode module" error:

pip3 install qrcode[pil]

Permission denied when saving:

  • Check that the output directory exists
  • Ensure you have write permissions

Output

All generated QR codes are saved as PNG images. The output path will be displayed after successful generation.