본문으로 건너뛰기

시스템 · 명령 참조

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 명령 살펴보기