メインコンテンツへ移動

システム · コマンドリファレンス

qzx listProcesses

機能

実際にサンプリングした CPU 使用率とともに実行中のプロセスを列挙します。

コマンドの成熟度: Alpha

実際の利用とフィードバックに使えますが、インターフェースと動作はまだ変更される可能性があります。 これは現在の開発チェックアウトに対する評価です。今後の各不変リリースタグには、そのバージョンに含まれた正確な評価が保存されます。 PyPI 0.2.2.0.15 で利用できます。ドキュメントは alpha チェックアウト 0.2.2.0.15 に対応しています。

動作と組み込み保護

状態を変更せずに検査します

この操作は直接実行されます

ネイティブプログラムを呼び出さずに動作します

ネットワークを使わずに動作します

権限昇格なしで動作するよう設計されています

この安全分類は 2026-10-08 に Claude Opus 5.5 (Anthropic) が実装ダイジェスト sha256:58478fcdbdbcce78b8e761988b1c996b7e540fedca13b51c2ee70ed4ffea327b と照合してレビューしました。

正確な構文

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

パラメータ

スワイプするか横スクロールバーを使って、すべての列を表示してください。

名前型必須既定値説明
filter_strstrいいえ未宣言プロセス名を絞り込む任意のテキスト
sort_bystrいいえ"cpu"結果の並べ替えフィールド (pid、cpu、memory、name)
limitintいいえ25返す最大プロセス数 (既定は 25、0 または null ですべてのプロセスを返す)

入力例

qzx listProcesses

現在 CPU 使用率が最も高い 25 プロセスを列挙

qzx listProcesses python

名前に "python" を含むプロセスを列挙

qzx listProcesses null memory 10

メモリ使用量が多い上位 10 プロセスを列挙

qzx listProcesses null pid 0

実行中のすべてのプロセスを PID 順に列挙

完全な構造化ペイロードを取得するには --json を追加します: qzx listProcesses [filter_str] [sort_by] [limit] --json

代表的な出力例

この説明用 JSON は現在の実装が裏付ける結果コントラクトから生成されています。記録された実行だと主張せず、コマンドが返し得る内容を示します。値は入力、マシン、権限、オプションツールによって変わります。

例のコマンド: 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
}
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
}

エラーと制限

公開コントラクトでは失敗時に success=false と説明的な message が必要です。このカタログではまだコマンドごとのエラー分類を宣言していません。結果を確認し、存在しないコードを推測しないでください。

QZX は alpha 段階です。オプション依存関係、権限、ホスト機能によって結果が変わる場合があります。

証拠フロー: 決定論的な自動取得が可能。

証拠と出所

ドキュメントチャネル
開発ドキュメント 0.2.2.0.15 · main · sha256:b91acee86268edb7cb018a94e089ff8e95835eda3f2cf08b39796c0ab9654693
提供状況
0.2.2.0.15 以前

さらに探す

関連コマンド

これらのコマンドも システム カテゴリに属します。比較して、タスクに最適な操作を選んでください。

QZX の全コマンドを見る