sistem · Referensi perintah
qzx explainFileWithGemini
Apa fungsinya
Mempratinjau dan, setelah otorisasi eksplisit, mengirim sampel terbatas dari file ke Google Gemini untuk mendapatkan penjelasan.
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
Pratinjau tersedia
Berfungsi tanpa memanggil program native
Menggunakan jaringan untuk tugas yang didokumentasikan
Dirancang untuk bekerja tanpa elevasi hak akses
Perilaku default hanya mempratinjau file yang telah diresolusi, provider, sumber instruksi, dan batas; tidak membaca kredensial, tidak menggunakan jaringan, dan tidak membagikan konten. Request nyata memerlukan dry_run=false dan apply=true, membatasi file, instruksi, serta setiap bagian sampel, menolak file biner, dan mengirim kunci melalui header. Hasil melaporkan model dan jumlah persis karakter sumber yang dibagikan kepada Google Gemini tanpa mengembalikan rahasia atau body error provider.
Menggunakan layanan eksternal yang didokumentasikan dan hanya membagikan data yang dijelaskan di bawah.
Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:ddc5d31a339e89383a9157b28bf5aae6e5d38a23b501f9728c1df1bab5d2e571 pada 2026-08-25.
Sintaks persis
qzx explainFileWithGemini <file_path> [sample_size] [model] [custom_prompt] [max_file_size_mb] [dry_run] [apply] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| file_path | str | Ya | Tidak dideklarasikan | Jalur file teks yang akan dijelaskan |
| sample_size | int | Tidak | 500 | Jumlah karakter yang diambil sebagai sampel dari awal, tengah, dan akhir (10-100000; default: 500) |
| model | str | Tidak | "" | Model Gemini yang digunakan; jika kosong, model kompatibel yang tersedia akan dipilih |
| custom_prompt | str | Tidak | "" | Instruksi khusus yang dikirim ke Gemini sebelum sampel terbatas |
| max_file_size_mb | int | Tidak | 10 | Ukuran maksimum file lokal yang diterima dalam mebibyte (1-100; default: 10) |
| dry_run | bool | Tidak | true | Mempratinjau secara persis jenis data yang akan dibagikan tanpa menghubungi Gemini |
| apply | bool | Tidak | false | Mengotorisasi request eksternal; memerlukan dry_run=false |
Contoh input
qzx explainFileWithGemini "path/to/file.txt"Pratinjau sampel terbatas dan layanan eksternal tanpa mengirim isi file
qzx explainFileWithGemini "path/to/file.txt" 1000 "" "" 10 --dry-run false --applyKirim hingga 1000 karakter dari setiap bagian sampel ke Google Gemini
qzx explainFileWithGemini "path/to/file.txt" 500 "gemini-2.5-flash" "" 10 --dry-run false --applyGunakan model Gemini tertentu yang tersedia setelah otorisasi eksplisit
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx explainFileWithGemini <file_path> [sample_size] [model] [custom_prompt] [max_file_size_mb] [dry_run] [apply] --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 explainFileWithGemini "path/to/file.txt" --json
{
"success": true,
"message": "Previews and optionally sends bounded file samples to Google Gemini for explanation. In this illustrative example, the command completed successfully.",
"meta": {
"command": "explainFileWithGemini",
"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
},
"details": {
"dry_run": true,
"content_shared": true,
"external_service": "Example value"
},
"encoding": "Example value",
"explanation": "Example value",
"external_service": "Example value",
"file_path": "C:\\project\\example.txt",
"file_sha256": "C:\\project\\example.txt",
"file_size_bytes": 4096,
"model_used": "Example value",
"next_step": "Example value",
"sample_size": "Example value",
"usage": "Example value"
}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
},
"details": {
"type": "object",
"properties": {
"dry_run": {
"type": "boolean"
},
"content_shared": {
"type": "boolean"
},
"external_service": []
},
"additionalProperties": true
},
"encoding": [],
"error": [],
"error_code": [],
"explanation": [],
"external_service": [],
"file_path": [],
"file_sha256": [],
"file_size_bytes": [],
"model_used": [],
"next_step": {
"type": "string"
},
"sample_size": [],
"usage": []
},
"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
- 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 diagnoseStorageMendiagnosis tekanan penyimpanan dengan menggabungkan kapasitas, file besar, dan duplikat terverifikasi tanpa menghapus atau mengubah file.qzx getCpuLoadMendapatkan informasi tentang penggunaan CPU saat ini.qzx clearScreenMembersihkan terminal interaktif secara langsung tanpa menjalankan cls, clear, atau command shell.qzx getCurrentDateTimeMenampilkan tanggal dan waktu lokal saat ini beserta zona waktu, kalender, minggu ISO, dan timestamp.