sistem · Referensi perintah
qzx getCurrentDirectory
Apa fungsinya
Menampilkan direktori kerja saat ini dan inventaris berguna dari isinya.
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:97129a232a0a5fb5464056db34600937e724d35ffa33189f51041969392d344c pada 2026-08-25.
Sintaks persis
qzx getCurrentDirectory [full] [size] [details] [limit] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| full | bool | Tidak | true | Tampilkan jalur lengkap (true) atau hanya nama direktori (false) |
| size | bool | Tidak | false | Hitung secara rekursif ukuran logis direktori serta total file dan direktori turunannya |
| details | bool | Tidak | false | Sertakan analisis rekursif, pratinjau entri langsung, ringkasan per ekstensi, file terbesar dan terbaru, izin, serta kapasitas filesystem |
| limit | int | Tidak | 10 | Jumlah maksimum entri pada setiap daftar detail (1-100; default: 10) |
Contoh input
qzx getCurrentDirectoryTampilkan jalur saat ini dan hitung file serta direktori pada tingkat tersebut
qzx getCurrentDirectory --sizeTambahkan ukuran rekursif dan total turunan melalui satu kali traversal filesystem
qzx getCurrentDirectory --details --limit 20Kembalikan analisis direktori terperinci dengan maksimum 20 item per daftar
qzx getCurrentDirectory --full falseTampilkan hanya nama direktori saat ini sebagai jalur yang terlihat
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx getCurrentDirectory [full] [size] [details] [limit] --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 getCurrentDirectory --json
{
"success": true,
"current_dir": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\QZX-Source",
"full_path": true,
"displayed_path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\QZX-Source",
"directory_name": "QZX-Source",
"parent_directory": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange",
"contents": {
"scope": "current_level",
"entry_count": 36,
"file_count": 25,
"directory_count": 11,
"symlink_count": 0,
"other_count": 0,
"hidden_count": 5,
"is_empty": false,
"immediate_files_size_bytes": 149389,
"immediate_files_size_formatted": "145.89 KiB",
"detected_project_markers": [
".git",
"README.md",
"pyproject.toml",
"setup.py"
],
"scan_complete": true,
"scan_error_count": 0
},
"analysis_requested": {
"size": false,
"details": false,
"list_limit": 10
},
"message": "Current directory: C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\QZX-Source. At this level: 25 files, 11 directories, 0 symbolic links, 0 other entries (36 total).",
"meta": {
"command": "getCurrentDirectory",
"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": 7.988,
"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
},
"analysis_requested": {
"type": "object",
"properties": {
"size": [],
"details": [],
"list_limit": []
},
"additionalProperties": true
},
"contents": [],
"current_dir": [],
"details": {
"type": "object",
"properties": {
"received_limit": [],
"minimum": {
"type": "integer"
},
"maximum": {
"type": "integer"
}
},
"additionalProperties": true
},
"directory_name": [],
"displayed_path": [],
"error": {
"type": "string"
},
"error_code": {
"type": "string"
},
"full_path": [],
"home_relative_path": [],
"parent_directory": [],
"recursive_analysis": []
},
"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/get_current_directory.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 getCurrentDateTimeMenampilkan tanggal dan waktu lokal saat ini beserta zona waktu, kalender, minggu ISO, dan timestamp.qzx getCurrentUserMendapatkan informasi tentang pengguna yang sedang login.qzx getCpuLoadMendapatkan informasi tentang penggunaan CPU saat ini.qzx getDiskHealthMemeriksa kesehatan S.M.A.R.T. disk dengan smartctl dan membedakan peringatan disk dari kegagalan perintah.