sistem · Referensi perintah

`qzx getGpuInfo`

Apa fungsinya

Memeriksa GPU terpasang dan melaporkan vendor, driver, memori, serta metrik penggunaan yang tersedia.

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

Menggunakan alat native saat diperlukan

Berfungsi tanpa menggunakan jaringan

Dirancang untuk bekerja tanpa elevasi hak akses

Menggunakan nvidia-smi dan satu provider inventaris platform saat tersedia. Setiap subprocess menerima argumen tanpa shell, memiliki timeout terbatas, dan mengubah kegagalan menjadi peringatan terstruktur; error provider tidak pernah mencemari output JSON.

Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:416bc228bb86ddfc33875346bd5f3fcb5f0b988a291f09c3d8e781dbfc351b2e pada 2026-08-25.

Sintaks persis

qzx getGpuInfo [detailed] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

Nama	Tipe	Wajib	Default	Deskripsi
detailed	bool	Tidak	false	Minta field tambahan untuk driver, memori, suhu, dan penggunaan jika platform menyediakannya

Contoh input

qzx getGpuInfo

Cantumkan GPU yang terdeteksi dengan nama vendor yang dinormalisasi

qzx getGpuInfo --detailed

Sertakan field driver, memori, suhu, dan penggunaan yang tersedia

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx getGpuInfo [detailed] --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 getGpuInfo --json

{
    "success": true,
    "message": "Detected 1 GPU from NVIDIA.",
    "gpus": [
        {
            "index": 0,
            "name": "NVIDIA GeForce RTX 4070",
            "vendor": "NVIDIA",
            "driver_version": "example-driver",
            "memory": {
                "total_mib": 12282,
                "used_mib": 2210,
                "free_mib": 10072
            },
            "utilization_percent": 18,
            "temperature_celsius": 44,
            "source": "nvidia-smi"
        }
    ],
    "gpu_count": 1,
    "detected_vendors": [
        "NVIDIA"
    ],
    "details": {
        "platform": "Windows",
        "detailed": true,
        "sources": [
            "nvidia-smi",
            "Win32_VideoController"
        ]
    },
    "meta": {
        "command": "getGpuInfo",
        "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
    }
}

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": {
            "oneOf": [
                {
                    "type": "object",
                    "properties": {
                        "platform": [],
                        "detailed": [],
                        "sources": []
                    },
                    "additionalProperties": true
                },
                {
                    "type": "object",
                    "properties": {
                        "received": []
                    },
                    "additionalProperties": true
                }
            ]
        },
        "detected_vendors": [],
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        },
        "gpu_count": [],
        "gpus": [],
        "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: memerlukan matriks sistem operasi yang kompatibel.

Bukti dan asal-usul

Implementasi: src/qzx/commands/system/get_gpu_info.py
Pengujian: tests/test_system_commands/test_get_gpu_info.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 ini juga termasuk kategori sistem. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.

Jelajahi semua perintah QZX