Armazenamento
Antes de apagar arquivos, descubra por que o disco está cheio
A pergunta útil não é apenas “quanto espaço sobrou?”. Em um diagnóstico real você quer capacidade, arquivos grandes, duplicados confirmados e limites claros sobre o que não será tocado.
Alejandro Sánchez7 min de leitura

Comece por evidência somente leitura
diagnoseStorage combina capacidade do volume com uma busca limitada por arquivos grandes e, opcionalmente, duplicados. Ele não decide sozinho o que deve ser excluído.
qzx diagnoseStorage .
qzx diagnoseStorage . --json
Arquivo grande não é arquivo inútil
Uma imagem de máquina virtual, um banco de dados ou um backup pode ser enorme e ainda ser essencial. Por isso o QZX apresenta arquivos grandes como evidência para revisão, não como “lixo” automático.
Duplicado precisa ser comprovado
Apenas nomes iguais ou tamanhos iguais não bastam. O fluxo documentado de duplicados usa tamanho, SHA-256 e comparação byte a byte antes de tratar arquivos como idênticos. Isso permite estimar espaço potencialmente recuperável com uma base muito mais segura.
Mesma intenção em vários sistemas
Windows, Linux e macOS expõem armazenamento de formas diferentes. A vantagem de uma interface comum é permitir que o agente peça o mesmo diagnóstico e receba uma estrutura previsível sem reconstruir o procedimento para cada plataforma.
Comandos relacionados
getDiskSpaceObtém informações sobre o uso do espaço em disco.
findFilesProcura arquivos por nome, profundidade, tamanho e data de modificação e retorna metadados estruturados.
findDuplicateFilesProcura arquivos idênticos por tamanho, SHA-256 e verificação byte a byte.
getDiskHealthInspeciona a saúde S.M.A.R.T. de um disco com smartctl e distingue alertas do disco de falhas do comando.
Perguntas frequentes
O diagnoseStorage apaga arquivos?
Não. O diagnóstico é somente leitura e apresenta evidência para revisão.
Como o QZX confirma duplicados?
A documentação do comando descreve verificação por tamanho, SHA-256 e comparação byte a byte antes de considerar arquivos idênticos.
Funciona em mais de um sistema operacional?
Sim. O objetivo do QZX é oferecer uma interface consistente para Windows, Linux e macOS sem obrigar o agente a reinventar cada diagnóstico.