Lewati ke konten utama

sistem · Referensi perintah

qzx listProcesses

Apa fungsinya

Mencantumkan proses yang sedang berjalan beserta penggunaan CPU nyata hasil sampling.

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.15. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.15.

Perilaku dan perlindungan bawaan

Memeriksa tanpa mengubah status

Eksekusi langsung untuk operasi ini

Berfungsi tanpa memanggil program native

Berfungsi tanpa menggunakan jaringan

Dirancang untuk bekerja tanpa elevasi hak akses

Klasifikasi keamanan ini ditinjau oleh Claude Opus 5.5 (Anthropic) terhadap digest implementasi sha256:58478fcdbdbcce78b8e761988b1c996b7e540fedca13b51c2ee70ed4ffea327b pada 2026-10-08.

Sintaks persis

qzx listProcesses [filter_str] [sort_by] [limit] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

NamaTipeWajibDefaultDeskripsi
filter_strstrTidakTidak dideklarasikanTeks opsional untuk memfilter nama proses
sort_bystrTidak"cpu"Field untuk mengurutkan hasil (pid, cpu, memory, atau name)
limitintTidak25Jumlah maksimum proses yang dikembalikan (default 25; 0 atau null mengembalikan semua proses)

Contoh input

qzx listProcesses

Cantumkan 25 proses dengan penggunaan CPU tertinggi saat ini

qzx listProcesses python

Cantumkan proses yang namanya mengandung "python"

qzx listProcesses null memory 10

Cantumkan 10 proses dengan penggunaan memori tertinggi

qzx listProcesses null pid 0

Cantumkan semua proses yang berjalan, diurutkan berdasarkan PID

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx listProcesses [filter_str] [sort_by] [limit] --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 listProcesses --json

{
    "success": true,
    "message": "Lists running processes with real CPU usage sampled over 0.5 s (similar to 'ps'/'top'). In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "listProcesses",
        "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
    },
    "collection_method": "Example value",
    "cpu_percent_scale": "Example value",
    "cpu_sample_seconds": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "displayed_processes": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "filter": "Example value",
    "limit": null,
    "os_type": "Windows",
    "processes": [
        {
            "pid": 4210,
            "name": "python",
            "cpu_percent": 4.2,
            "memory_readable": "82.4 MiB"
        }
    ],
    "sort_by": "Example value",
    "total_processes": 3
}
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
        },
        "collection_method": [],
        "cpu_percent_scale": {
            "type": "string"
        },
        "cpu_sample_seconds": [],
        "displayed_processes": [],
        "error": {
            "type": "string"
        },
        "filter": [],
        "limit": {
            "type": "null"
        },
        "os_type": [],
        "processes": [],
        "sort_by": [],
        "total_processes": []
    },
    "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: siap untuk penangkapan otomatis deterministik.

Bukti dan asal-usul

Kanal dokumentasi
Dokumentasi pengembangan 0.2.2.0.15 · main · sha256:b91acee86268edb7cb018a94e089ff8e95835eda3f2cf08b39796c0ab9654693
Ketersediaan
0.2.2.0.15 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