Lewati ke konten utama

sistem · Referensi perintah

qzx runDiagnosticCommand

Apa fungsinya

Menjalankan diagnostik native yang sepenuhnya hanya-baca dari daftar yang diizinkan khusus platform.

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

Hanya menjalankan utilitas diagnostik hanya-baca dari daftar khusus Windows atau Unix. Jalur ditolak dan PATH tidak digunakan untuk memilih executable diagnostik; shell juga tidak digunakan, dan argumen yang diizinkan tiap utilitas divalidasi. netstat dan ss mewajibkan output numerik serta mengecualikan atribusi proses; ss juga mengecualikan socket Unix yang memiliki jalur. Eksekusi dilakukan dari direktori binary dengan lingkungan minimal yang tidak mewarisi rahasia. stdout dan stderr dibaca bersamaan dengan batas memori terpisah dan proses dihentikan setelah 20 detik.

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

Sintaks persis

qzx runDiagnosticCommand <command> [args] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

NamaTipeWajibDefaultDeskripsi
commandstrYaTidak dideklarasikanDiagnostik hanya-baca. Windows: hostname, ipconfig, netstat, dan whoami. Unix: cal, date, free, hostname, netstat, ss, uname, uptime, dan whoami
argslist[str]Tidak[]Argumen yang diterima oleh grammar hanya-baca khusus perintah

Contoh input

qzx runDiagnosticCommand hostname

Kueri nama host lokal

qzx runDiagnosticCommand whoami

Kueri pengguna sistem operasi saat ini

qzx runDiagnosticCommand uname -a

Kueri kernel dan arsitektur di Unix

qzx runDiagnosticCommand ipconfig /all

Kueri konfigurasi jaringan lengkap di Windows

qzx runDiagnosticCommand netstat -an

Cantumkan koneksi secara numerik tanpa resolusi nama

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx runDiagnosticCommand <command> [args] --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 runDiagnosticCommand hostname --json

{
    "success": true,
    "message": "Runs a strictly read-only native system diagnostic from a platform-specific allowlist. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "runDiagnosticCommand",
        "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": {
        "summary": "Additional structured context is included here."
    },
    "stdout": "Command completed successfully."
}
Lihat kontrak hasil JSON
{
    "type": "object",
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "error": {
            "oneOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ]
        },
        "error_code": {
            "type": "string"
        },
        "stdout": {
            "type": "string"
        },
        "stderr": {
            "type": "string"
        },
        "details": {
            "type": "object",
            "additionalProperties": true
        },
        "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
        }
    },
    "additionalProperties": true,
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
        "message",
        "meta",
        "success"
    ]
}

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

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.

Jelajahi semua perintah QZX