sistema · Referência do comando
qzx diagnoseStorage
O que faz
Diagnostica a pressão de armazenamento combinando capacidade, arquivos grandes e duplicados verificados sem excluir nem modificar arquivos.
Maturidade do comando: Alpha
Disponível para uso real e feedback enquanto a interface e o comportamento ainda podem evoluir. Esta é a avaliação atual do checkout de desenvolvimento. Cada tag de release imutável futuro preservará a avaliação exata incluída nessa versão. Disponível no PyPI 0.2.2.0.9. A documentação corresponde ao checkout alpha 0.2.2.0.9.
Comportamento e proteções integradas
Inspeciona sem alterar o estado
Execução direta para esta operação
Funciona sem invocar programas nativos
Funciona sem usar a rede
Projetado para funcionar sem elevação
É um diagnóstico estritamente somente leitura: não exclui nem modifica arquivos. Arquivos grandes são apresentados apenas como evidência para revisão e nunca são considerados automaticamente descartáveis. O espaço potencialmente recuperável é calculado somente a partir de grupos duplicados confirmados por tamanho, SHA-256 e comparação byte a byte. A saúde física S.M.A.R.T. permanece separada em getDiskHealth.
Esta classificação de segurança foi revisada por OpenAI GPT-5.6 Sol em relação ao digest de implementação sha256:3f388a34b22a9b59259ba7c46dfec7a8ff570030f038c1a0aeba9b8f8a936bb9 em 2026-09-04.
Sintaxe exata
qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --jsonParâmetros
Deslize ou use a barra horizontal para ver todas as colunas.
| Nome | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| path | str | Não | "." | Diretório cujo uso de armazenamento será diagnosticado (padrão: diretório atual) |
| min_file_size | str | Não | "100MiB" | Tamanho mínimo da visualização de arquivos grandes, por exemplo 100MiB ou 1GB |
| max_files | int | Não | 20 | Quantidade máxima de arquivos grandes a retornar (1-1000) |
| duplicate_min_size_kb | int | Não | 10240 | Tamanho mínimo em KB considerado na busca de duplicados (10240 = 10 MiB por padrão) |
| max_depth | int | Não | 6 | Profundidade máxima de diretórios para procurar arquivos grandes e duplicados (0-64; padrão: 6) |
| include_duplicates | bool | Não | true | Executa no mesmo fluxo a busca por duplicados verificados byte a byte (true/false; ativada por padrão) |
Exemplos de entrada
qzx diagnoseStorageDiagnosticar a pressão de armazenamento do diretório atual com buscas limitadas
qzx diagnoseStorage C:/ --max-depth 4 --max-files 30Inspecionar um volume do Windows com menor profundidade e uma lista maior de arquivos grandes
qzx diagnoseStorage /home --include-duplicates false --min-file-size 500MiBExecutar um diagnóstico mais rápido de capacidade e arquivos grandes sem calcular hashes de duplicados
Para obter o payload estruturado completo, adicione --json: qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --json
Exemplo de saída observada
Capturado com QZX 0.2.2.0.9 no Windows 11; código de saída 0. Valores dependentes do host e a duração podem variar.
Comando do exemplo: qzx diagnoseStorage ../artifacts/qzx-evidence/storage-triage --min-file-size 1KB --max-files 10 --duplicate-min-size-kb 1 --max-depth 2 --json
{
"success": true,
"message": "Storage diagnosis completed for 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage': 98.7% used with 45.00 GB free; 3 files matched the large-file threshold. Confirmed 1 duplicate group with up to 9.75 KB reclaimable if one copy per group is kept. QZX did not delete or modify any files.",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage",
"partial": false,
"read_only": true,
"scan_scope": {
"max_depth": 2,
"large_file_min_size": "1KB",
"max_large_files_returned": 10,
"duplicate_scan_requested": true,
"duplicate_min_size_kb": 1
},
"probe_status": {
"capacity": "ok",
"large_files": "ok",
"duplicates": "ok"
},
"assessment": {
"capacity_status": "critical",
"percent_used": 98.7,
"total_bytes": 3718889074688,
"total_readable": "3.38 TB",
"free_bytes": 48314122240,
"free_readable": "45.00 GB",
"large_files_matched": 3,
"large_files_returned": 3,
"duplicate_groups": 1,
"duplicate_files": 2,
"confirmed_reclaimable_bytes": 9984,
"confirmed_reclaimable_readable": "9.75 KB"
},
"capacity": {
"success": true,
"message": "Disk information for 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage': 3.34 TB used of 3.38 TB total (98.7% used), 45.00 GB free.",
"disk_info": {
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage",
"total_bytes": 3718889074688,
"used_bytes": 3670574952448,
"free_bytes": 48314122240,
"total": "3.38 TB",
"used": "3.34 TB",
"free": "45.00 GB",
"percent": 98.7
}
},
"large_files": {
"success": true,
"message": "Found 3 matching files in 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage'. Returning 3 files totaling 26.25 KiB.",
"search_path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage",
"pattern": "*",
"recursive": 2,
"filters": {
"min_size_bytes": 1024,
"max_size_bytes": null,
"modified_after": null,
"modified_before": null,
"exclude": [],
"exclude_dirs": []
},
"sort": {
"by": "size",
"descending": true
},
"matched_count": 3,
"matched_size_bytes": 26880,
"matched_size_readable": "26.25 KiB",
"count": 3,
"total_size_bytes": 26880,
"total_size_readable": "26.25 KiB",
"limit": 10,
"truncated": false,
"skipped_unreadable": 0,
"warnings": [],
"results": [
{
"name": "duplicate-a.bin",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\duplicate-a.bin",
"relative_path": "duplicate-a.bin",
"depth": 0,
"size_bytes": 9984,
"size_readable": "9.75 KiB",
"modified_timestamp": 1789069884.4857178,
"modified_at": "2026-09-10T14:51:24-05:00"
},
{
"name": "duplicate-b.bin",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\duplicate-b.bin",
"relative_path": "duplicate-b.bin",
"depth": 0,
"size_bytes": 9984,
"size_readable": "9.75 KiB",
"modified_timestamp": 1789069884.4865727,
"modified_at": "2026-09-10T14:51:24-05:00"
},
{
"name": "unique.bin",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\unique.bin",
"relative_path": "unique.bin",
"depth": 0,
"size_bytes": 6912,
"size_readable": "6.75 KiB",
"modified_timestamp": 1789069884.4865727,
"modified_at": "2026-09-10T14:51:24-05:00"
}
]
},
"duplicates": {
"success": true,
"scan_path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage",
"total_groups": 1,
"total_duplicate_files": 2,
"reclaimable_bytes": 9984,
"reclaimable_space_readable": "9.75 KB",
"duplicate_groups": {
"2467aef9f30a32bd4940b61dc4cd366c8c4f1677f514591d8cf1e0acf61f158e": {
"sha256": "2467aef9f30a32bd4940b61dc4cd366c8c4f1677f514591d8cf1e0acf61f158e",
"verification": "byte_for_byte",
"size_bytes": 9984,
"size_readable": "9.75 KB",
"files": [
"C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\duplicate-a.bin",
"C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\duplicate-b.bin"
]
}
},
"message": "Duplicate files scan completed for 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage':\n- Duplicate groups identified: 1\n- Total duplicate file copies: 2\n- Reclaimable space: 9.75 KB\n\nTop Duplicate Groups:\n - [9.75 KB] SHA-256: 2467aef9f30a... (byte-for-byte verified)\n -> duplicate-a.bin\n -> duplicate-b.bin\n"
},
"recommendations": [
{
"priority": "high",
"action": "Review the largest files and confirmed duplicate groups before adding more data.",
"reason": "The target filesystem is 98.7% used."
},
{
"priority": "review",
"action": "Inspect the returned large-file paths and decide which are intentional; size alone is never a deletion signal.",
"reason": "Files at or above 1KB were found within depth 2."
},
{
"priority": "review",
"action": "Review each duplicate group and keep at least one intentional copy before removing anything manually.",
"reason": "Byte-for-byte verification found 1 group with up to 9.75 KB reclaimable."
},
{
"priority": "info",
"action": "Use getDiskHealth separately only when hardware health is relevant; capacity pressure does not imply a failing disk.",
"reason": "S.M.A.R.T. health and filesystem capacity are separate diagnostic questions."
}
],
"warnings": [],
"related_commands": [
"getDiskSpace",
"findFiles",
"findDuplicateFiles",
"getDiskHealth"
],
"report": "Storage diagnosis: C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\nCapacity: 98.7% used; 45.00 GB free of 3.38 TB. Status: critical.\nLarge files: 3 matched; 3 returned for review.\nDuplicates: 1 verified group(s), 2 duplicate file(s), up to 9.75 KB reclaimable if one copy per group is kept.\nSafety: read-only diagnosis; QZX did not delete or modify files.",
"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": 9.471,
"schema_version": 1
}
}Ver o 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": [],
"details": [],
"duplicates": [],
"error": [],
"error_code": [],
"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
}Erros e limites
O contrato público exige success=false e uma message descritiva em caso de falha. Este catálogo ainda não declara uma taxonomia de erros específica para cada comando; revise o resultado e não infira códigos inexistentes.
O QZX está em alpha. Dependências opcionais, permissões e recursos do host podem alterar o resultado.
Fluxo de evidência: capturada e validada por digest.
Evidência e procedência
- Implementação
- src/qzx/commands/system/diagnose_storage.py
- Canal de documentação
- Documentação de desenvolvimento 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- Disponibilidade
- 0.2.2.0.9 ou anterior
Continue explorando
Comandos relacionados
Estes comandos também pertencem à categoria sistema. Compare-os para escolher a operação que melhor resolve sua tarefa.
qzx clearScreenLimpa diretamente um terminal interativo sem iniciar cls, clear nem um shell de comandos.qzx explainFileWithGeminiMostra uma prévia e, após autorização explícita, envia amostras limitadas de um arquivo ao Google Gemini para obter uma explicação.qzx checkSystemPathDiagnostica a variável PATH, lista diretórios quebrados ou duplicados e localiza todas as instâncias de um binário.qzx getCpuLoadObtém informações sobre o uso atual da CPU.