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.

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.9. La documentación corresponde al checkout alpha 0.2.2.0.9.

Comportamiento y protecciones integradas

Inspecciona sin cambiar el estado

Ejecución directa para esta operación

Usa una herramienta nativa cuando hace falta

Funciona sin usar la red

Diseñado para funcionar sin elevación

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 OpenAI GPT-5.6 Pro contra el digest de implementación sha256:9d0e835537185032a2e1cf88c96f760a95c4be276275d79e1bb9d1e4f520754a el 2026-08-25.

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.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
Disponibilidad: 0.2.2.0.9 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