用途：该技能驱动 unifi-pp-cli 二进制，封装完整的本地 UniFi Network 集成 API（设备、客户端、防火墙、ACL、网络、VPN、交换），并维护本地 SQLite 镜像，用于回答实时 API 无法直接回答的问题，例如昨天以来发生了什么变更、哪台设备刚加入、某个数据包会匹配哪条防火墙规则。适合脚本化或智能体驱动的 UniFi Network 审计、防火墙/ACL 审查和自建网关上的变更检测，偏向终端优先的家庭实验室/高级用户。
安装与验证：需先安装 CLI。默认安装命令为 npx -y @mvanhorn/printing-press-library install unifi --cli-only；若失败可回退为 go install github.com/mvanhorn/printing-press-library/library/devices/unifi/cmd/unifi-pp-cli@latest（需 Go 1.26.6 及以上）。安装后用 unifi-pp-cli --version 验证，并确保安装目录在 $PATH 中。
主要能力：topology 基于本地镜像生成从网关到交换机再到 AP 的物理设备树；drift 显示自上次同步以来站点配置（网络、防火墙、WiFi、DNS）的变更；newcomer 列出指定时间后首次出现的设备与客户端；port-audit 汇总各交换机的端口使用率与 PoE 状态；guest report 汇总访客网络使用情况；rule-predict 在做出实际变更前，针对已同步规则集预测假设的数据包会匹配哪条防火墙策略。
使用方式：先从网关 UI（Settings -> Control Plane -> Integrations -> Create API Key）生成 API 密钥并设置 UNIFI_API_KEY，随后运行 unifi-pp-cli doctor 验证。任意命令可加 --agent，等价于 --json --compact --no-input --no-color --yes。读取本地或 API 的命令会返回包含 meta（source、synced_at、reason）与 results 的信封，需解析 .results 与 .meta.source。可用 --select 过滤字段，--dry-run 预览请求，--home 或 UNIFI_HOME 等环境变量重定位路径。可用 which 以自然语言查找命令，命令还带有 recall/teach 的学习循环。
限制：不适用于 UniFi Protect（摄像头）或 UniFi Access（门禁），仅覆盖 Network 集成 API；不适用于旧版云端/CloudKey Controller API，其认证模型不同。rule-predict 基于最近同步的规则集进行模拟，不构成实时网关的保证。其余功能、收费与平台信息资料未提供。