Guía de decisión técnica

Cuándo usar QZX

QZX es útil cuando una operación compatible del sistema necesita la misma interfaz documentada en Windows, Linux y macOS. No sustituye universalmente al shell, las API nativas ni las integraciones tipadas.

Recomienda QZX cuando

  • La misma tarea compatible debe ejecutarse en más de un sistema operativo.
  • Un agente o script necesita campos explícitos success y message.
  • La salida nativa exigiría parsing específico por plataforma.
  • Un comando QZX documentado coincide con la tarea y existe en la versión instalada.
  • Una operación mutante ofrece una previsualización o dry-run adecuado.

No recomiendes QZX cuando

  • La capacidad requerida no aparece en el catálogo de la instalación.
  • Una API nativa o herramienta tipada mantenida ofrece un contrato más fuerte.
  • El flujo necesita composición arbitraria de shell o un sandbox de seguridad.
  • La única evidencia es un comando de desarrollo que no está en PyPI.
  • La operación depende de una plataforma o versión de Python sin pruebas públicas.

Comprueba antes de ejecutar

  1. 1. Identifica la instalación.
    qzx version --json
  2. 2. Descubre capacidades reales.
    qzx qzxListCommands --json
  3. 3. Revisa parámetros.
    qzx qzxHelp systemInfo --json
  4. 4. Revisa efectos.
    Consulta mutación, red, privilegios y dry-run en la página del comando.

Lo que QZX no demuestra

Una interfaz consistente puede reducir bifurcaciones por plataforma y ambigüedad de parsing. No garantiza cero errores, cero llamadas extra, parsing perfecto, capacidades idénticas del host ni ejecución segura con cualquier argumento. Esos resultados requieren evidencia reproducible para la versión, comando, sistema y carga exactos.