核心用法
QR Code Generator 是一款基于 Python 的二维码生成技能，通过命令行脚本实现文本、URL、WiFi 凭证、vCard 联系人等多种数据格式的二维码转换。核心工作流为：调用 generate_qr.py 脚本，传入数据内容与输出参数，自动生成可扫描的二维码图像。
主要功能模式：
- 基础文本/URL：直接传入字符串生成标准二维码
- WiFi 网络配置：通过
--wifi-ssid和--wifi-pass参数生成可直接扫码联网的 WiFi 二维码（支持 WPA/WPA2 自动格式） - vCard 联系人：将 vCard 格式字符串编码为二维码，手机扫描即可自动导入通讯录
- 多格式输出：PNG（默认，带 PIL 依赖）、SVG（矢量可缩放）、ASCII（终端预览）
- 高级调参：支持调整模块尺寸（
-s）、边框宽度（--border）、纠错等级（--error-correction，H 级可容忍 30% 图案损坏）
显著优点
1. 零配置开箱即用：脚本自动检测并安装 qrcode[pil] 依赖，无需手动配置 Python 环境
2. 场景覆盖全面：从个人名片到企业 WiFi 部署，单工具满足多场景需求
3. 输出格式灵活：PNG 适合打印物料，SVG 适配 Web/设计系统，ASCII 便于终端调试
4. 纠错机制可靠：四级纠错（L/M/Q/H）可选，H 级支持在二维码中央叠加 Logo 仍可读
5. 完全本地执行：数据处理在本地完成，无网络传输隐私泄露风险
潜在局限
- 依赖 Python 环境：目标系统需预装 Python 3，极简环境可能受限
- 无图形界面：纯 CLI 交互，对非技术用户存在学习门槛
- WiFi 参数硬编码：密码以明文形式嵌入二维码，分享后无法撤销权限（需配合路由器访客网络使用）
- vCard 需手动拼装：缺乏交互式联系人表单，复杂字段（如头像 BASE64）需自行处理
- 无批量生成能力：单次仅处理一个二维码，大规模场景需自行脚本封装
适合人群
- 开发者/运维人员：快速生成测试环境的 WiFi 登录码或 API 文档链接
- 小型企业/工作室：制作带 Logo 的品牌二维码（配合 H 级纠错）
- 隐私敏感用户：避免使用在线二维码生成服务，数据不出本地
- 终端爱好者：ASCII 输出模式契合命令行工作流
常规风险提示
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 数据暴露 | WiFi 密码、个人信息编码后仍可被任意扫码设备读取 | 仅向可信对象展示，避免公开场合长期张贴 |
| 恶意链接 | 生成工具本身不验证 URL 安全性，可能编码钓鱼网站 | 扫码方需自行校验目标域名 |
| 依赖安全 | 自动安装的 `qrcode[pil]` 包来自 PyPI，存在供应链攻击可能 | 建议在隔离环境运行，或预先锁定依赖版本 |
| 纠错滥用 | H 级纠错虽强，但过度遮挡（如大面积 Logo）仍可能降低识别率 | 测试打印/显示后的实际扫描效果 |