Saltar al contenido principal

sistema · Referencia de comando

qzx diagnoseStorage

Qué hace

Diagnostica la presión de almacenamiento combinando capacidad, archivos grandes y duplicados verificados sin eliminar ni modificar archivos.

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

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

Es un diagnóstico estrictamente de solo lectura: no elimina ni modifica archivos. Los archivos grandes se presentan únicamente como evidencia para revisión y nunca se consideran automáticamente prescindibles. El espacio potencialmente recuperable se calcula sólo a partir de grupos duplicados confirmados por tamaño, SHA-256 y comparación byte por byte. La salud física S.M.A.R.T. permanece separada en getDiskHealth.

Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Sol contra el digest de implementación sha256:3f388a34b22a9b59259ba7c46dfec7a8ff570030f038c1a0aeba9b8f8a936bb9 el 2026-09-04.

Sintaxis exacta

qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --json

Parámetros

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

NombreTipoObligatorioPredeterminadoDescripción
pathstrNo"."Directorio cuyo uso de almacenamiento se diagnosticará (valor predeterminado: directorio actual)
min_file_sizestrNo"100MiB"Tamaño mínimo de la vista de archivos grandes, por ejemplo 100MiB o 1GB
max_filesintNo20Cantidad máxima de archivos grandes que se devolverá (1-1000)
duplicate_min_size_kbintNo10240Tamaño mínimo en KB que se considerará durante la búsqueda de duplicados (10240 = 10 MiB de forma predeterminada)
max_depthintNo6Profundidad máxima de directorios para buscar archivos grandes y duplicados (0-64; valor predeterminado: 6)
include_duplicatesboolNotrueEjecuta en el mismo flujo la búsqueda de duplicados verificados byte por byte (true/false; activada de forma predeterminada)

Ejemplos de entrada

qzx diagnoseStorage

Diagnosticar la presión de almacenamiento del directorio actual con búsquedas acotadas

qzx diagnoseStorage C:/ --max-depth 4 --max-files 30

Inspeccionar un volumen de Windows con menor profundidad y una lista mayor de archivos grandes

qzx diagnoseStorage /home --include-duplicates false --min-file-size 500MiB

Ejecutar un diagnóstico más rápido de capacidad y archivos grandes sin calcular hashes de duplicados

Para obtener la carga estructurada completa, añade --json: qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --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 diagnoseStorage --json

{
    "success": true,
    "message": "Diagnoses storage pressure by combining disk capacity, large-file discovery, and byte-verified duplicate analysis without deleting anything. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "diagnoseStorage",
        "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
    },
    "assessment": "Example value",
    "capacity": "Example value",
    "duplicates": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "large_files": "C:\\project\\example.txt",
    "partial": "Example value",
    "path": "C:\\project\\example.txt",
    "probe_status": {
        "capacity": "Example value",
        "large_files": "C:\\project\\example.txt",
        "duplicates": [
            {
                "name": "example",
                "status": "ok"
            }
        ]
    },
    "read_only": true,
    "recommendations": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "related_commands": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "report": "Analysis complete.\nNo blocking issues were found.",
    "scan_scope": {
        "max_depth": "Example value",
        "large_file_min_size": "C:\\project\\example.txt",
        "max_large_files_returned": "C:\\project\\example.txt",
        "duplicate_scan_requested": "Example value",
        "duplicate_min_size_kb": "Example value"
    },
    "warnings": [
        {
            "name": "example",
            "status": "ok"
        }
    ]
}
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
        },
        "assessment": [],
        "capacity": [],
        "duplicates": [],
        "large_files": [],
        "partial": [],
        "path": [],
        "probe_status": {
            "type": "object",
            "properties": {
                "capacity": {
                    "type": "string"
                },
                "large_files": {
                    "type": "string"
                },
                "duplicates": []
            },
            "additionalProperties": true
        },
        "read_only": {
            "type": "boolean"
        },
        "recommendations": [],
        "related_commands": {
            "type": "array"
        },
        "report": [],
        "scan_scope": {
            "type": "object",
            "properties": {
                "max_depth": [],
                "large_file_min_size": [],
                "max_large_files_returned": [],
                "duplicate_scan_requested": [],
                "duplicate_min_size_kb": []
            },
            "additionalProperties": true
        },
        "warnings": []
    },
    "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

Canal de documentación
Documentación de desarrollo 0.2.2.0.7a9 · main · sha256:e8fb90f76dc2e944e25bface47f96c7979a569f40bf1f8f6cbd1bd291441369e
Disponibilidad
0.2.2.0.7a9 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.

Explorar todos los comandos de QZX