Lewati ke konten utama

sistem · Referensi perintah

qzx runScript

Apa fungsinya

Menjalankan skrip lokal Python, Bash, atau Windows Batch yang dipilih secara eksplisit dengan timeout dan retensi output terbatas.

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

Menggunakan alat native saat diperlukan

Berfungsi tanpa menggunakan jaringan

Menggunakan izin Anda saat ini; hasil dapat bervariasi

Karena tidak memiliki target filesystem yang dapat dipulihkan, skrip lokal yang dipilih pengguna hanya dijalankan jika --dangerously-bypass-approvals-and-sandbox atau --yolo digunakan. Bypass mengotorisasi eksekusi, tetapi tidak menjadikan skrip sebagai sandbox: tinjau kode dan argumennya terlebih dahulu. QZX tidak menambahkan nilai argumen ke metadata, tetapi skrip dapat mengeksposnya melalui stdout atau stderr yang ditangkap.

Jika suatu operasi tidak memiliki jalur pemulihan, QZX meminta konfirmasi eksplisit --dangerously-bypass-approvals-and-sandbox atau --yolo.

Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Sol terhadap digest implementasi sha256:215b544de7cc02c302210469d7ef8420e691eb65e183b42b6a960ae56a8c70ef pada 2026-09-05.

Sintaks persis

qzx runScript <script_path> [args] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

NamaTipeWajibDefaultDeskripsi
script_pathstrYaTidak dideklarasikanJalur skrip lokal yang akan dijalankan
argslistTidak[]Argumen yang diteruskan ke skrip. QZX tidak menambahkan nilainya ke metadata hasil, tetapi skrip itu sendiri dapat mencetaknya pada output yang ditangkap

Contoh input

qzx runScript myscript.py --yolo

Jalankan skrip Python ketika target mutasinya tidak dapat ditentukan

qzx runScript myscript.py arg1 arg2 --yolo

Jalankan dengan dua argumen tanpa QZX menambahkan nilainya ke metadata hasil

qzx runScript script.sh --dangerously-bypass-approvals-and-sandbox

Jalankan skrip Bash yang telah ditinjau tanpa cadangan pengaman

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx runScript <script_path> [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 runScript myscript.py --yolo --json

{
    "success": true,
    "message": "Executes one explicit Python, Bash, or Windows Batch script with a timeout and bounded retained output. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "runScript",
        "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."
    },
    "execution": {
        "timeout_seconds": [
            {
                "name": "example",
                "status": "ok"
            }
        ],
        "exit_code": "Example value",
        "timed_out": true
    },
    "script": "Example value",
    "stdout": "Command completed successfully."
}
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": [],
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        },
        "execution": {
            "oneOf": [
                {
                    "type": "object",
                    "properties": {
                        "timeout_seconds": [],
                        "exit_code": [],
                        "timed_out": {
                            "type": "boolean"
                        }
                    },
                    "additionalProperties": true
                },
                {
                    "type": "object",
                    "properties": {
                        "timeout_seconds": [],
                        "exit_code": {
                            "type": "null"
                        },
                        "timed_out": {
                            "type": "boolean"
                        },
                        "termination": []
                    },
                    "additionalProperties": true
                }
            ]
        },
        "script": [],
        "stderr": [],
        "stdout": []
    },
    "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 lingkungan privileged yang terkontrol.

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