sistem · Referensi perintah
qzx diagnoseStorage
Apa fungsinya
Mendiagnosis tekanan penyimpanan dengan menggabungkan kapasitas, file besar, dan duplikat terverifikasi tanpa menghapus atau mengubah file.
Kematangan perintah: Alpha
Tersedia untuk penggunaan nyata dan umpan balik sementara antarmuka serta perilakunya masih dapat berkembang. Ini adalah evaluasi saat ini untuk checkout pengembangan. Setiap tag rilis immutable di masa mendatang akan mempertahankan evaluasi persis yang disertakan dalam versi tersebut. Tersedia di PyPI 0.2.2.0.9. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.9.
Perilaku dan perlindungan bawaan
Memeriksa tanpa mengubah status
Eksekusi langsung untuk operasi ini
Berfungsi tanpa memanggil program native
Berfungsi tanpa menggunakan jaringan
Dirancang untuk bekerja tanpa elevasi hak akses
Ini diagnostik yang sepenuhnya hanya-baca: tidak menghapus atau mengubah file. File besar hanya disajikan sebagai bukti untuk ditinjau dan tidak pernah otomatis dianggap dapat dibuang. Ruang yang berpotensi dipulihkan dihitung hanya dari grup duplikat yang dikonfirmasi berdasarkan ukuran, SHA-256, dan perbandingan byte demi byte. Kesehatan fisik S.M.A.R.T. tetap terpisah di getDiskHealth.
Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Sol terhadap digest implementasi sha256:3f388a34b22a9b59259ba7c46dfec7a8ff570030f038c1a0aeba9b8f8a936bb9 pada 2026-09-04.
Sintaks persis
qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| path | str | Tidak | "." | Direktori yang penggunaan penyimpanannya akan didiagnosis (default: direktori saat ini) |
| min_file_size | str | Tidak | "100MiB" | Ukuran minimum untuk tampilan file besar, misalnya 100MiB atau 1GB |
| max_files | int | Tidak | 20 | Jumlah maksimum file besar yang dikembalikan (1-1000) |
| duplicate_min_size_kb | int | Tidak | 10240 | Ukuran minimum dalam KB yang dipertimbangkan saat mencari duplikat (default 10240 = 10 MiB) |
| max_depth | int | Tidak | 6 | Kedalaman maksimum direktori untuk mencari file besar dan duplikat (0-64; default: 6) |
| include_duplicates | bool | Tidak | true | Menjalankan pencarian duplikat terverifikasi byte demi byte dalam alur yang sama (true/false; aktif secara default) |
Contoh input
qzx diagnoseStorageDiagnosis tekanan penyimpanan direktori saat ini dengan pencarian terbatas
qzx diagnoseStorage C:/ --max-depth 4 --max-files 30Periksa volume Windows dengan kedalaman lebih kecil dan daftar file besar yang lebih panjang
qzx diagnoseStorage /home --include-duplicates false --min-file-size 500MiBJalankan diagnosis kapasitas dan file besar yang lebih cepat tanpa menghitung hash duplikat
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --json
Contoh output yang diamati
Ditangkap dengan QZX 0.2.2.0.9 di Windows 11; kode keluar 0. Nilai yang bergantung pada host dan durasi dapat bervariasi.
Perintah contoh: 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
}
}Lihat kontrak hasil 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
}Kesalahan dan batasan
Kontrak publik mensyaratkan success=false dan message yang deskriptif saat gagal. Katalog ini belum mendeklarasikan taksonomi kesalahan khusus untuk setiap perintah; periksa hasil dan jangan menyimpulkan kode yang tidak ada.
QZX masih dalam tahap alpha. Dependency opsional, izin, dan kemampuan host dapat mengubah hasil.
Alur bukti: ditangkap dan divalidasi dengan digest.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/system/diagnose_storage.py
- Kanal dokumentasi
- Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- Ketersediaan
- 0.2.2.0.9 atau lebih lama
Lanjut jelajahi
Perintah terkait
Perintah ini juga termasuk kategori sistem. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx clearScreenMembersihkan terminal interaktif secara langsung tanpa menjalankan cls, clear, atau command shell.qzx explainFileWithGeminiMempratinjau dan, setelah otorisasi eksplisit, mengirim sampel terbatas dari file ke Google Gemini untuk mendapatkan penjelasan.qzx checkSystemPathMendiagnosis variabel PATH, mencantumkan direktori rusak atau duplikat, dan menemukan semua instance suatu binary.qzx getCpuLoadMendapatkan informasi tentang penggunaan CPU saat ini.