sistema · Referencia de comando

`qzx runDiagnosticCommand`

Qué hace

Ejecuta un diagnóstico nativo estrictamente de solo lectura desde una lista permitida específica de la plataforma.

Comando canónico: runDiagnosticCommand

Alias aceptados: Ninguno

Distingue mayúsculas: no

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.6a8. La documentación corresponde al checkout alpha 0.2.2.0.6a8.

Seguridad y efectos

Solo lectura según la clasificación actual

Sin parámetro dry-run documentado

Puede invocar programas nativos

Sin uso de red documentado

No requiere elevación de forma inherente

Solo ejecuta utilidades de diagnóstico de solo lectura de una lista específica para Windows o Unix. Rechaza rutas y no usa el PATH para elegir el ejecutable diagnóstico; tampoco usa shell y valida los argumentos permitidos por cada utilidad. netstat y ss exigen salida numérica y excluyen atribución de procesos; ss también excluye sockets Unix con rutas. Ejecuta desde el directorio del binario con un entorno mínimo que no hereda secretos. Lee simultáneamente stdout y stderr con límites de memoria separados y termina el proceso tras 20 segundos.

Esta clasificación de seguridad fue revisada por Codex contra el digest de implementación sha256:994f9d24b7880a4db32667b69295fa01d5fb2f92b5f4810a9a27554bd9a5d833 el 2026-07-30.

Sintaxis exacta

qzx runDiagnosticCommand <command> [args] --json

Parámetros

Desliza o usa la barra horizontal para ver todas las columnas.

Nombre	Tipo	Obligatorio	Predeterminado	Descripción
command	str	Sí	No declarado	Diagnóstico de solo lectura. Windows: hostname, ipconfig, netstat y whoami. Unix: cal, date, free, hostname, netstat, ss, uname, uptime y whoami
args	list[str]	No	[]	Argumentos aceptados por la gramática de solo lectura específica del comando

Ejemplos de entrada

qzx runDiagnosticCommand hostname

Consultar el nombre del host local

qzx runDiagnosticCommand whoami

Consultar el usuario actual del sistema operativo

qzx runDiagnosticCommand uname -a

Consultar el kernel y la arquitectura en Unix

qzx runDiagnosticCommand ipconfig /all

Consultar la configuración completa de red en Windows

qzx runDiagnosticCommand netstat -an

Listar conexiones numéricamente sin resolver nombres

Para obtener la carga estructurada completa, añade --json: qzx runDiagnosticCommand <command> [args] --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 runDiagnosticCommand hostname --json

{
    "success": true,
    "message": "Runs a strictly read-only native system diagnostic from a platform-specific allowlist. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "runDiagnosticCommand",
        "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
    },
    "details": {
        "summary": "Additional structured context is included here."
    },
    "stdout": "Command completed successfully."
}

Ver el contrato de resultado JSON

{
    "type": "object",
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "error": {
            "oneOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ]
        },
        "error_code": {
            "type": "string"
        },
        "stdout": {
            "type": "string"
        },
        "stderr": {
            "type": "string"
        },
        "details": {
            "type": "object",
            "additionalProperties": true
        },
        "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
        }
    },
    "additionalProperties": true,
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "message",
        "meta",
        "success"
    ]
}

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: capturada y validada por digest.

Evidencia y procedencia

Implementación: src/qzx/commands/system/run_diagnostic_command.py
Pruebas: tests/test_system_commands/test_run_diagnostic_command.py
Canal de documentación: Documentación de desarrollo 0.2.2.0.6a8 · main · sha256:040df8bbcb6b707bb4cdb7c2c1ad4cc6956ab647a451dc215ea78cdbb4c8ad96
Disponibilidad: 0.2.2.0.6a8 o anterior

Sigue explorando

Estos comandos también pertenecen a la categoría de sistema. Compáralos para elegir la operación que mejor resuelva tu tarea.

Explorar todos los comandos de QZX