sistem · Referensi perintah
qzx getDiskSpace
Apa fungsinya
Mendapatkan informasi penggunaan ruang disk.
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
Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:174a32ca33b3f7d3d5a37d35b145e842916f5f4a29a4e671346ccdc5331f90fc pada 2026-08-25.
Sintaks persis
qzx getDiskSpace [path] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| path | str | Tidak | Tidak dideklarasikan | Jalur yang informasi disknya akan diambil. Jika tidak diberikan, semua disk akan ditampilkan |
Contoh input
qzx getDiskSpaceDapatkan informasi tentang semua disk yang tersedia
qzx getDiskSpace C:Dapatkan informasi tentang drive C: (Windows)
qzx getDiskSpace /homeDapatkan informasi tentang partisi /home (Linux atau Mac)
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx getDiskSpace [path] --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 getDiskSpace . --json
{
"success": true,
"message": "Disk information for '.': 3.34 TB used of 3.38 TB total (98.7% used), 44.99 GB free.",
"disk_info": {
"path": ".",
"total_bytes": 3718889074688,
"used_bytes": 3670577057792,
"free_bytes": 48312016896,
"total": "3.38 TB",
"used": "3.34 TB",
"free": "44.99 GB",
"percent": 98.7
},
"meta": {
"command": "getDiskSpace",
"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": 3.378,
"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
},
"disk_info": [],
"disks": [],
"error": {
"type": "string"
},
"summary": {
"type": "object",
"properties": {
"total_disks": [],
"total_space": [],
"total_space_readable": [],
"used_space": [],
"used_space_readable": [],
"free_space": [],
"free_space_readable": [],
"percent_used": []
},
"additionalProperties": true
}
},
"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.
{
"success": false,
"error": "Path '../artifacts/qzx-evidence/missing-golden-core-path' does not exist",
"message": "Failed to get disk information: Path '../artifacts/qzx-evidence/missing-golden-core-path' does not exist.",
"meta": {
"command": "getDiskSpace",
"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": 2.952,
"schema_version": 1
}
}Perintah yang ditangkap: qzx getDiskSpace ../artifacts/qzx-evidence/missing-golden-core-path --json
Alur bukti: ditangkap dan divalidasi dengan digest.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/system/get_disk_space.py
- Kanal dokumentasi
- Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- Ketersediaan
- 0.2.2.0.9 atau lebih lama
Panduan praktis
Gunakan perintah ini dalam konteks
Pelajari kapan qzx getDiskSpace cocok untuk tugas Anda, bagaimana perbandingannya dengan alat native, dan detail apa yang penting saat mengotomatisasi.
Lanjut jelajahi
Perintah terkait
Perintah ini juga termasuk kategori sistem. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx getDiskHealthMemeriksa kesehatan S.M.A.R.T. disk dengan smartctl dan membedakan peringatan disk dari kegagalan perintah.qzx getGpuInfoMemeriksa GPU terpasang dan melaporkan vendor, driver, memori, serta metrik penggunaan yang tersedia.qzx getCurrentUserMendapatkan informasi tentang pengguna yang sedang login.qzx getRamInfoMendapatkan informasi terperinci tentang penggunaan RAM.