시스템 · 명령 참조
qzx diagnoseStorage
기능
파일을 삭제하거나 수정하지 않고 용량, 대용량 파일 및 검증된 중복을 결합해 저장 공간 압박을 진단합니다.
명령 성숙도: Alpha
실제 사용과 피드백에 사용할 수 있지만 인터페이스와 동작은 아직 바뀔 수 있습니다. 현재 개발 체크아웃에 대한 평가입니다. 이후의 각 불변 릴리스 태그는 해당 버전에 포함된 정확한 평가를 보존합니다. PyPI 0.2.2.0.9에서 사용할 수 있습니다. 문서는 alpha 체크아웃 0.2.2.0.9에 해당합니다.
동작 및 내장 보호
상태를 변경하지 않고 검사합니다
이 작업은 직접 실행됩니다
네이티브 프로그램을 호출하지 않고 작동합니다
네트워크를 사용하지 않고 작동합니다
권한 상승 없이 작동하도록 설계되었습니다
엄격한 읽기 전용 진단으로 파일을 삭제하거나 수정하지 않습니다. 대용량 파일은 검토를 위한 근거로만 제시되며 자동으로 불필요한 파일로 간주하지 않습니다. 잠재적 회수 공간은 크기, SHA-256, 바이트 단위 비교로 확인된 중복 그룹에서만 계산합니다. 물리적 S.M.A.R.T. 상태는 getDiskHealth에서 별도로 다룹니다.
이 안전 분류는 2026-09-04에 OpenAI GPT-5.6 Sol가 구현 다이제스트 sha256:3f388a34b22a9b59259ba7c46dfec7a8ff570030f038c1a0aeba9b8f8a936bb9를 기준으로 검토했습니다.
정확한 구문
qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --json매개변수
밀거나 가로 스크롤 막대를 사용해 모든 열을 확인하세요.
| 이름 | 유형 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| path | str | 아니요 | "." | 저장 공간 사용을 진단할 디렉터리(기본값: 현재 디렉터리) |
| min_file_size | str | 아니요 | "100MiB" | 대용량 파일 보기의 최소 크기(예: 100MiB 또는 1GB) |
| max_files | int | 아니요 | 20 | 반환할 대용량 파일 최대 개수(1-1000) |
| duplicate_min_size_kb | int | 아니요 | 10240 | 중복 검색에서 고려할 최소 크기(KB, 기본값 10240 = 10 MiB) |
| max_depth | int | 아니요 | 6 | 대용량 파일과 중복을 찾을 최대 디렉터리 깊이(0-64, 기본값: 6) |
| include_duplicates | bool | 아니요 | true | 같은 흐름에서 바이트 단위로 검증된 중복 검색 실행(true/false, 기본 활성화) |
입력 예제
qzx diagnoseStorage범위가 제한된 검색으로 현재 디렉터리의 저장 공간 압박 진단
qzx diagnoseStorage C:/ --max-depth 4 --max-files 30더 얕은 깊이와 더 큰 대용량 파일 목록으로 Windows 볼륨 검사
qzx diagnoseStorage /home --include-duplicates false --min-file-size 500MiB중복 해시를 계산하지 않고 용량 및 대용량 파일을 더 빠르게 진단
전체 구조화 페이로드를 받으려면 --json을 추가하세요: qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --json
관찰된 출력 예제
Windows 11의 QZX 0.2.2.0.9에서 캡처했으며 종료 코드는 0입니다. 호스트에 따라 달라지는 값과 실행 시간은 변할 수 있습니다.
예제 명령: 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
}
}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
}오류 및 제한
공개 계약은 실패 시 success=false와 설명적인 message를 요구합니다. 이 카탈로그는 아직 명령별 오류 분류 체계를 선언하지 않으므로 결과를 확인하고 존재하지 않는 코드를 추정하지 마세요.
QZX는 alpha 단계입니다. 선택적 종속성, 권한 및 호스트 기능에 따라 결과가 달라질 수 있습니다.
근거 흐름: 캡처 및 다이제스트 검증 완료.
근거 및 출처
- 문서 채널
- 개발 문서 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- 제공 여부
- 0.2.2.0.9 또는 이전
계속 살펴보기
관련 명령
이 명령들도 시스템 범주에 속합니다. 비교하여 작업에 가장 적합한 작업을 선택하세요.