La razón de diseño
Por qué existe QZX
Los agentes de IA y la automatización se benefician de un éxito explícito, mensajes descriptivos y campos predecibles. QZX ofrece esa interfaz para sus operaciones documentadas y deja el trabajo no compatible o específico de una plataforma a las herramientas nativas.
Menos ramas por plataforma
En los comandos compatibles, el mismo nombre y modelo de argumentos puede reemplazar ramas separadas de PowerShell, GNU/Linux y macOS. Esto reduce instrucciones duplicadas; no elimina las diferencias del equipo.
Dos modos de salida deliberados
El valor predeterminado es legible para personas. --json solicita el objeto estructurado completo para programas y agentes. La automatización no debe inferir JSON de la presentación predeterminada.
Disponibilidad visible
El catálogo separa los comandos incluidos en PyPI 0.2.2.0.2 de los que solo existen en desarrollo. Cada referencia identifica plataformas, parámetros, alias y seguridad a partir de la implementación inspeccionada.
Límites de confianza visibles
QZX se ejecuta con los permisos del usuario actual. Algunas operaciones mutan estado o invocan herramientas nativas. La página de seguridad explica respaldos, vistas previas, bypasses y telemetría.
Una regla práctica para decidir
Usa QZX cuando un comando documentado cubra la operación y resulte útil un contrato CLI consistente. Prefiere una API nativa, una integración tipada o el shell cuando necesites capacidades propias de una plataforma, streaming, semántica nativa exacta o una frontera de seguridad más fuerte.