用途：从脚本或智能体管理并分析 3CX V20+ 电话系统配置，覆盖用户、组、振铃组、队列、IVR、中继、DID、出入站规则、报表、备份、安全与集成等全部 XAPI 对象。
安装与验证：先安装 CLI 再调用命令。可用 npx -y @mvanhorn/printing-press-library install 3cx-xapi --cli-only 安装，默认放入 macOS/Linux 的 $HOME/.local/bin 或 Windows 的 %LOCALAPPDATA%\Programs\PrintingPress\bin。若 npx 失败（无 Node、离线等），可回退直装（需 Go 1.26.6+）：go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/3cx-xapi/cmd/3cx-xapi-pp-cli@latest，安装到 $GOPATH/bin。用 3cx-xapi-pp-cli --version 验证，并确保二进制目录在 $PATH 中。
主要能力：将整个配置图镜像到本地 SQLite，支持离线全文搜索（search）、按时间窗口对比配置差异（diff）、审计指向已删除/禁用/不存在分机或 DID 的悬空引用（audit）、汇总防攻击与防火墙等攻击面（posture）、追踪到某分机的所有路由（trace）、从 CSV 幂等批量开通分机（provision）、跨队列汇总队列与坐席绩效及 SLA 违约（qrollup），以及合并活动日志、事件日志、当前通话与系统状态的时间窗口状态视图（changed）。
限制：不用于实时呼叫控制（应答、转接、发起通话），那属于 Call Control API；不可用于拨打电话、收发通话或作为软电话；不用于终端用户语音留言播放或 Web 客户端聊天。它是配置与报表工具，不是面向用户的客户端。安装前需确认 CLI 可用，否则不要继续执行技能命令。