wifi-qr 是一个轻量级的 Agent Skill，旨在通过命令行工具简化 Wi-Fi 网络的分享流程，让网络凭证传递从繁琐的手动输入转变为便捷的扫码即连。
核心用法
用户只需在终端执行简单指令，传入网络名称（SSID）、密码及可选的加密类型参数（默认为 WPA），即可调用系统 qrencode 工具生成符合 Wi-Fi Alliance 标准的二维码。该二维码可直接在终端显示或导出为图片文件，任何智能手机相机或扫码应用均可识别，扫描后自动填充网络信息并发起连接请求，彻底消除手动输入复杂密码（尤其是包含大小写、数字和特殊符号的强密码）时可能出现的错误。
显著优点
首先，安全性与隐私保护表现突出。作为纯文档型资产，该 Skill 本身不含任何可执行脚本，仅提供标准化的命令调用模板，所有数据处理均在本地完成，不存在数据上传、远程通信或第三方服务依赖，Wi-Fi 凭证不会离开用户设备。其次，极高的便捷性和跨平台兼容性。它解决了口头传递密码易出错、易遗忘的痛点，生成的二维码可被 iOS、Android 等主流系统原生支持。再者，依赖关系透明可靠。Skill 依赖的 qrencode 是成熟稳定的开源二维码生成库，通过系统官方包管理器（如 dnf）安装，版本由系统维护者控制，无已知 CVE 漏洞，且权限申请严格遵循最小化原则，仅申请必要的二进制工具调用权限。
潜在缺点或局限性
功能维度相对单一，专注于二维码生成，不提供密码加密保险库、历史记录管理或二维码有效期控制等高级功能。交互方式存在安全痕迹：用户需在命令行明文输入密码，这会不可避免地记录在终端历史文件（如 .bash_history）中，需要用户手动清理或使用隐私模式。作为 T3 来源的社区技能，虽然代码完全透明可审计，但缺乏企业级的长期维护承诺和 SLA 保障。此外，功能强依赖于系统预装的 qrencode 工具，若目标环境未安装则无法使用，且目前仅提供命令行接口，缺乏图形化配置界面。
适合的目标群体
该 Skill 特别适合需要频繁、临时分享 Wi-Fi 访问权限的场景。家庭用户可用于访客网络快速分享，避免反复告知密码；小型办公室、工作室的 IT 管理员可为临时员工或客户生成短期访问凭证；民宿、咖啡馆、图书馆、联合办公空间等公共场所经营者可将生成的二维码打印张贴在前台或桌面，提升访客数字化体验；技术爱好者和 DevOps 工程师也可将其集成到自动化部署脚本中，用于快速配置测试环境或 IoT 设备的网络连接。
使用风险
主要风险集中在凭证泄露和依赖管理上。命令行历史记录是首要隐患，输入的密码以明文形式存储在 shell 历史中，多人共用账户或环境时可能导致凭证扩散，建议使用后执行 history -c 或配置 HISTCONTROL=ignorespace。二维码本身的物理安全同样重要，生成的图片包含明文密码信息，若被未授权人员拍照留存或随意分享，可能导致网络访问权限失控。依赖维护方面，需确保 qrencode 通过官方软件源安装，避免使用来路不明的预编译版本。在企业级安全合规要求严格的环境中，直接分享 WPA 密码的方式可能不符合零信任安全策略，建议仅用于访客网络或配合网络隔离方案使用，避免用于访问核心生产资源的主网络。