file · Referensi perintah
qzx downloadFile
Apa fungsinya
Mengunduh file dari Internet, mirip dengan wget atau curl.
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
Mode nyata menerapkan perubahan yang Anda minta
Eksekusi langsung untuk operasi ini
Berfungsi tanpa memanggil program native
Menggunakan jaringan untuk tugas yang didokumentasikan
Dirancang untuk bekerja tanpa elevasi hak akses
Membuat target baru tanpa meminta persetujuan. Target yang ada tetap utuh kecuali --overwrite digunakan secara eksplisit; sebelum menggantinya, dibuat cadangan pengaman dengan perlindungan kegagalan. Hanya menerima URL HTTP/HTTPS absolut, menerapkan batas waktu, dan melakukan penggantian akhir secara atomik.
QZX membuat arsip pemulihan sebelum perubahan nyata; gunakan --dangerously-bypass-approvals-and-sandbox/--yolo hanya jika Anda sengaja memilih untuk melewatinya.
Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:bfba9193ca946ab5eb99d10987b6d6103468ff086964a3dc21d3237d2a022a34 pada 2026-08-25.
Sintaks persis
qzx downloadFile <url> <destination_path> [show_progress] [timeout] [overwrite] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| url | str | Ya | Tidak dideklarasikan | URL file yang akan diunduh |
| destination_path | str | Ya | Tidak dideklarasikan | Jalur tempat file unduhan disimpan |
| show_progress | bool | Tidak | true | Menentukan apakah progres unduhan ditampilkan |
| timeout | int | Tidak | 30 | Waktu tunggu maksimum dalam detik |
| overwrite | bool | Tidak | false | Mengganti target yang ada setelah membuat cadangan pengaman |
Contoh input
qzx downloadFile https://example.com/file.txt downloads/file.txtUnduh file contoh
qzx downloadFile https://example.com/file.zip downloads/file.zip falseUnduh file tanpa menampilkan progres
qzx downloadFile https://example.com/large-file.iso downloads/file.iso true 120Unduh file besar dengan timeout yang diperpanjang
qzx downloadFile https://example.com/file.txt downloads/file.txt --overwriteGanti file yang ada setelah membuat cadangan pengaman
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx downloadFile <url> <destination_path> [show_progress] [timeout] [overwrite] --json
Contoh output representatif
JSON ilustratif ini berasal dari kontrak hasil yang didukung implementasi saat ini. Ini menunjukkan apa yang dapat dikembalikan perintah tanpa mengklaim sebagai eksekusi yang direkam; nilainya bervariasi menurut input, mesin, izin, dan alat opsional.
Perintah contoh: qzx downloadFile https://example.com/file.txt downloads/file.txt --json
{
"success": true,
"message": "Downloads a file from the Internet (similar to 'wget' or 'curl' in Unix). In this illustrative example, the command completed successfully.",
"meta": {
"command": "downloadFile",
"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": 0,
"schema_version": 1
},
"destination": "C:\\project\\example.txt",
"details": {
"destination": "C:\\project\\example.txt"
},
"overwrite": true,
"show_progress": [
{
"name": "example",
"status": "ok"
}
],
"start_time": "Example value",
"timeout": "Example value",
"url": "https://example.com"
}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
},
"destination": [],
"details": {
"oneOf": [
{
"type": "object",
"properties": {
"destination": []
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"destination": [],
"overwrite": {
"type": "boolean"
}
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"timeout_seconds": [],
"partial_file_removed": {
"type": "boolean"
}
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"url": [],
"allowed_schemes": {
"type": "array"
}
},
"additionalProperties": true
}
]
},
"error": {
"type": "string"
},
"error_code": {
"type": "string"
},
"overwrite": [],
"show_progress": [],
"start_time": [],
"timeout": [],
"url": []
},
"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: memerlukan endpoint terotorisasi atau fixture yang telah ditinjau.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/file/download_file.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 file. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx detectFileTypeMengidentifikasi file reguler menggunakan signature konten terbatas, penyempurnaan opsional dengan libmagic, dan perbandingan ekstensi secara eksplisit.qzx extractZipMengekstrak arsip ZIP setelah memvalidasi jalur, tipe, batas, dan konflik pada target.qzx deletePathMempratinjau atau menghapus file maupun direktori dari filesystem.qzx findBrokenSymlinksMencari symbolic link rusak yang mengarah ke file atau direktori yang tidak ada.