Guía de decisión técnica
Cuándo usar QZX en lugar del shell o APIs nativas
QZX es útil cuando un agente de IA o una automatización necesita la misma operación documentada del sistema 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
successymessage. - 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. Identifica la instalación.
qzx version --json - 2. Descubre capacidades reales.
qzx listCommands --json - 3. Revisa parámetros.
qzx help getSystemInfo --json - 4. Revisa efectos.
Consulta mutación, red, privilegios y dry-run en la página del comando.
De la decisión al valor
Prueba ahora un flujo de solo lectura
No necesitas diseñar una automatización nueva para comprobar si QZX ayuda. Empieza con un diagnóstico existente, revisa el JSON y deja cualquier decisión de limpieza fuera de la secuencia de comandos.
Diagnóstico de almacenamiento
Mide capacidad, muestra archivos grandes y confirma duplicados en una sola consulta de solo lectura. Un archivo grande nunca se considera automáticamente recuperable.
qzx diagnoseStorage . --jsonDiagnóstico de proyecto para un agente de IA
Dale al agente evidencia estructurada del proyecto antes de pedirle que cambie código.
qzx diagnoseProject . --jsonLo 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.