sistema · Referencia de comando
qzx checkSystemPath
Qué hace
Diagnostica la variable PATH, enumera directorios rotos o duplicados y localiza todas las instancias de un binario.
Madurez del comando: Alpha
Disponible para uso real y retroalimentación mientras su interfaz y comportamiento todavía pueden evolucionar. Esta es la evaluación actual del checkout de desarrollo. Cada futuro tag inmutable de release conservará la evaluación exacta incluida en esa versión. Disponible en PyPI 0.2.2.0.8. La documentación corresponde al checkout alpha 0.2.2.0.8.
Comportamiento y protecciones integradas
Inspecciona sin cambiar el estado
Ejecución directa para esta operación
Funciona sin invocar programas nativos
Funciona sin usar la red
Diseñado para funcionar sin elevación
Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Pro contra el digest de implementación sha256:2160beec766e8e62a4e262e9457fe4a59368d2c02af69a0e8d4bab7cb9c6123b el 2026-08-25.
Sintaxis exacta
qzx checkSystemPath [binary_name] --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| binary_name | str | No | "" | Nombre opcional del binario que se buscará (por ejemplo, python, node o git) |
Ejemplos de entrada
qzx checkSystemPathInspeccionar los directorios de PATH para detectar duplicados, errores y rutas de carpetas no válidas
qzx checkSystemPath pythonDiagnosticar PATH y enumerar todas las ubicaciones físicas de los ejecutables de python según su orden de prioridad de ejecución
Para obtener la carga estructurada completa, añade --json: qzx checkSystemPath [binary_name] --json
Ejemplo de salida representativa
Este JSON ilustrativo deriva del contrato de resultado respaldado por la implementación actual. Muestra lo que el comando puede devolver sin afirmar que es una ejecución grabada; los valores varían según entradas, equipo, permisos y herramientas opcionales.
Comando del ejemplo: qzx checkSystemPath --json
{
"success": true,
"message": "Diagnoses the system PATH variable, lists broken or duplicate folders, and locates all instances of a binary. In this illustrative example, the command completed successfully.",
"meta": {
"command": "checkSystemPath",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 0,
"schema_version": 1
},
"binary_matches": [
{
"name": "example",
"status": "ok"
}
],
"binary_searched": "Example value",
"broken_paths": [],
"duplicate_paths": [],
"path_summary": {
"total_entries": 3,
"valid_count": true,
"broken_count": 3,
"duplicate_count": 3
}
}Ver el contrato de resultado JSON
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"binary_matches": [],
"binary_searched": [],
"broken_paths": [],
"duplicate_paths": [],
"error": {
"type": "string"
},
"path_summary": {
"type": "object",
"properties": {
"total_entries": [],
"valid_count": [],
"broken_count": [],
"duplicate_count": []
},
"additionalProperties": true
}
},
"additionalProperties": true
}Errores y límites
El contrato público exige success=false y un message descriptivo en fallos. Este catálogo aún no declara una taxonomía de errores específica para cada comando; revisa el resultado y no infieras códigos inexistentes.
QZX está en alpha. Dependencias opcionales, permisos y capacidades del host pueden cambiar el resultado.
Flujo de evidencia: lista para captura automática determinista.
Evidencia y procedencia
- Implementación
- src/qzx/commands/system/check_system_path.py
- Canal de documentación
- Documentación de desarrollo 0.2.2.0.8 · main · sha256:9aa902dfb6b006017e52972bf7871fef49b03ec24ff80741231d743d0354bfc2
- Disponibilidad
- 0.2.2.0.8 o anterior
Sigue explorando
Comandos relacionados
Estos comandos también pertenecen a la categoría de sistema. Compáralos para elegir la operación que mejor resuelva tu tarea.
qzx checkExecutableLocaliza un ejecutable en el PATH y, sólo si se solicita, lee su salida convencional de --version.qzx clearScreenLimpia directamente una terminal interactiva sin iniciar cls, clear ni un shell de comandos.qzx aboutMuestra los datos del producto QZX, su creador, mantenedor y licencia.qzx diagnoseStorageDiagnostica la presión de almacenamiento combinando capacidad, archivos grandes y duplicados verificados sin eliminar ni modificar archivos.