Wifi Qr

核心功能

Wi-Fi QR 是一款基于命令行的二维码生成工具，核心功能是将 Wi-Fi 网络凭证（SSID、密码、加密类型）转换为标准格式的二维码图片。生成的二维码遵循 Wi-Fi Alliance 的 Wi-Fi 连接协议规范，任何现代智能手机（iOS 11+、Android 10+）的相机应用均可识别并一键连接网络。

显著优点

1. 极简体验：无需图形界面，一条命令即可生成二维码，适合服务器、远程终端等无 GUI 环境
2. 跨平台兼容：输出为标准 PNG 图像，兼容所有支持 Wi-Fi 二维码协议的设备
3. 安全可控：二维码仅在本地生成，网络凭证不经过任何第三方服务
4. 效率工具：批量生成访客网络、IoT 设备配网场景下的网络凭证极为高效

潜在局限

1. 依赖单一：必须预先安装 qrencode 二进制工具，在极简容器环境中可能需要额外配置
2. 功能单一：仅支持二维码生成，不包含网络配置管理、密码强度检测等周边功能
3. 无持久化：不保存历史生成的网络配置，每次需重新输入参数
4. 终端限制：纯命令行交互，对非技术用户存在使用门槛

适合人群

• 系统管理员需要为数据中心/办公环境批量生成访客 Wi-Fi 凭证
• 开发者构建 IoT 设备配网流程，需要程序化生成网络配置二维码
• Linux 高级用户希望快速分享家庭网络给访客，避免口头告知复杂密码

常规风险提示

• 密码暴露：生成的二维码图片包含明文密码，分享时需注意传输渠道安全
• 截图留存：终端显示的二维码若被屏幕截图，可能在不知情的情况下泄露凭证
• 协议版本：默认 WPA 加密类型，如需连接旧设备需显式指定 WEP/WPA2 等参数
• 依赖完整性：qrencode 工具若被篡改，可能生成恶意二维码，建议从可信软件源安装

核心用法

Wi-Fi QR 是一个极简的纯文档型 Agent Skill，核心功能是为 Wi-Fi 网络凭证生成标准化的连接二维码。用户只需提供网络名称（SSID）和密码，Skill 即可输出对应的 qrencode 命令，生成符合 Wi-Fi 联盟标准的 QR 码图像。

使用方法极为直接：通过 wifi-qr "网络名" "密码" 即可生成默认 WPA/WPA2 类型的连接码，也可通过 --type 参数指定安全协议。生成的 QR 码可被绝大多数现代智能手机原生相机或扫码工具识别，扫描后自动弹出网络连接确认，无需手动输入繁琐密码。

该 Skill 本身不包含可执行代码，仅输出命令示例和文档指引，实际执行完全依赖用户本地系统已安装的 qrencode 二进制工具，属于典型的"文档驱动型"工具设计。

显著优点

极致轻量化：纯 Markdown 文档结构，零第三方代码依赖，仅依托系统级成熟工具，体积和攻击面均降至最低。

安全透明：CLS-Certify 六维扫描全项通过，无外部网络请求、无敏感信息收集、无代码混淆，隐私合规达到 GDPR/CCPA 标准。密码数据全程本地处理，不上传至任何云端。

跨平台兼容：qrencode 作为开源标准工具，主流 Linux 发行版（Fedora、Ubuntu、Debian）、macOS 均可直接安装，Windows 也可通过 WSL 或移植版本使用。

场景适配精准：特别适合家庭网络访客共享、民宿/咖啡厅等小型商用场景、企业内部临时访客网络等需要快速、安全分享 Wi-Fi 凭证的场合。

潜在缺点与局限性

依赖预装环境：Skill 本身不提供 qrencode 的自动安装能力，用户需手动执行系统包管理命令（如 sudo dnf install qrencode），在权限受限或陌生环境中可能遇到工具缺失问题。

无交互式体验：纯命令行文档输出，不提供图形界面或一键生成按钮，对非技术用户存在一定使用门槛。

密码泄露风险转移：虽然 Skill 本身安全，但生成的命令或 QR 码图像可能留存于终端历史记录、截图或临时文件中，需要用户自行管理后续的信息清理。

功能边界固定：仅支持标准 Wi-Fi 二维码格式，不支持企业级 802.1X 认证、隐藏 SSID 等复杂网络配置场景。

适合的目标群体

• 技术型用户与开发者：熟悉命令行操作，能够快速完成工具链配置
• 小型商户与民宿运营者：需要频繁向访客分享网络，追求零接触、高效率的连网体验
• 家庭网络管理员：希望为亲友访客提供便捷的 Wi-Fi 分享方式，避免口头重复密码
• 企业 IT 支持人员：为临时访客、外包人员快速生成限时网络接入凭证

常规使用风险

终端历史泄露：输入的 Wi-Fi 密码默认会被记录于 shell 历史文件（如 .bash_history），建议配合 HISTCONTROL=ignorespace 或使用临时环境变量传参。

QR 码图像残留：生成的 PNG 文件若未妥善删除，可能被后续使用者获取。建议在 /tmp 目录生成并及时清理。

共享屏幕暴露：演示或录屏过程中展示含密码的命令或 QR 码，可能导致敏感信息意外泄露。

依赖工具版本差异：不同发行版 qrencode 版本可能对特殊字符（如空格、引号、Unicode SSID）的编码处理存在细微差异，生成前建议验证目标设备的扫码兼容性。