본문으로 건너뛰기

시스템 · 명령 참조

qzx runDiagnosticCommand

기능

플랫폼별 허용 목록에서 엄격한 읽기 전용 네이티브 진단을 실행합니다.

명령 성숙도: Alpha

실제 사용과 피드백에 사용할 수 있지만 인터페이스와 동작은 아직 바뀔 수 있습니다. 현재 개발 체크아웃에 대한 평가입니다. 이후의 각 불변 릴리스 태그는 해당 버전에 포함된 정확한 평가를 보존합니다. PyPI 0.2.2.0.9에서 사용할 수 있습니다. 문서는 alpha 체크아웃 0.2.2.0.9에 해당합니다.

동작 및 내장 보호

상태를 변경하지 않고 검사합니다

이 작업은 직접 실행됩니다

필요할 때 네이티브 도구를 사용합니다

네트워크를 사용하지 않고 작동합니다

권한 상승 없이 작동하도록 설계되었습니다

Windows 또는 Unix 전용 목록의 읽기 전용 진단 유틸리티만 실행합니다. 경로를 거부하고 진단 실행 파일 선택에 PATH를 사용하지 않으며 셸도 사용하지 않고 각 유틸리티에서 허용된 인수를 검증합니다. netstat과 ss는 숫자 출력을 요구하고 프로세스 귀속을 제외하며 ss는 경로가 있는 Unix 소켓도 제외합니다. 바이너리 디렉터리에서 비밀을 상속하지 않는 최소 환경으로 실행합니다. stdout과 stderr를 별도의 메모리 제한으로 동시에 읽고 20초 뒤 프로세스를 종료합니다.

이 안전 분류는 2026-08-25에 OpenAI GPT-5.6 Pro가 구현 다이제스트 sha256:9d0e835537185032a2e1cf88c96f760a95c4be276275d79e1bb9d1e4f520754a를 기준으로 검토했습니다.

정확한 구문

qzx runDiagnosticCommand <command> [args] --json

매개변수

밀거나 가로 스크롤 막대를 사용해 모든 열을 확인하세요.

이름유형필수기본값설명
commandstr예선언되지 않음읽기 전용 진단. Windows: hostname, ipconfig, netstat, whoami. Unix: cal, date, free, hostname, netstat, ss, uname, uptime, whoami
argslist[str]아니요[]명령별 읽기 전용 문법에서 허용하는 인수

입력 예제

qzx runDiagnosticCommand hostname

로컬 호스트 이름 조회

qzx runDiagnosticCommand whoami

운영체제의 현재 사용자 조회

qzx runDiagnosticCommand uname -a

Unix에서 커널 및 아키텍처 조회

qzx runDiagnosticCommand ipconfig /all

Windows에서 전체 네트워크 구성 조회

qzx runDiagnosticCommand netstat -an

이름 해석 없이 연결을 숫자로 나열

전체 구조화 페이로드를 받으려면 --json을 추가하세요: qzx runDiagnosticCommand <command> [args] --json

대표 출력 예제

이 예시 JSON은 현재 구현이 뒷받침하는 결과 계약에서 파생됩니다. 기록된 실행이라고 주장하지 않고 명령이 반환할 수 있는 내용을 보여 주며, 값은 입력, 장비, 권한 및 선택 도구에 따라 달라집니다.

예제 명령: 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."
}
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"
    ]
}

오류 및 제한

공개 계약은 실패 시 success=false와 설명적인 message를 요구합니다. 이 카탈로그는 아직 명령별 오류 분류 체계를 선언하지 않으므로 결과를 확인하고 존재하지 않는 코드를 추정하지 마세요.

QZX는 alpha 단계입니다. 선택적 종속성, 권한 및 호스트 기능에 따라 결과가 달라질 수 있습니다.

근거 흐름: 캡처 및 다이제스트 검증 완료.

근거 및 출처

문서 채널
개발 문서 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
제공 여부
0.2.2.0.9 또는 이전

계속 살펴보기

관련 명령

이 명령들도 시스템 범주에 속합니다. 비교하여 작업에 가장 적합한 작업을 선택하세요.

모든 QZX 명령 살펴보기