본문으로 건너뛰기

QZX 실행 예제

문제에서
유용한 답으로.

프로젝트를 살펴보고, 디스크 공간을 조사하거나, HTTP 응답을 확인하세요. 각 명령어로 무엇을 알 수 있는지 보고 다음 단계를 결정하세요.

읽기 전용검증 가능한 기록사람이 읽기 쉬운 출력과 JSON

무엇을 조사하고 싶으신가요?

세 가지 일상적인 작업으로 QZX의 작동 방식을 살펴보세요.

오류가 발생하는 URL

HTTP 상태를 읽고, 서버가 응답했다는 사실과 페이지를 이용할 수 있다는 사실을 구분하세요.

응답 살펴보기

01 / 프로젝트

수정하기 전에 프로젝트를 이해하세요.

기술 구성, 의존성, 발견 사항을 하나의 보고서로 확인하세요. 발견된 테스트와 린터는 실제 상태 그대로 “설정됨, 실행 안 함”으로 표시됩니다.

프로젝트 루트에서 실행해 보세요
qzx diagnoseProject . --json
QZX가 발견한 내용
기술 구성
Python
중복 제외 패키지
1
발견 사항
1

명시된 의존성 httpx

작은 테스트용 프로젝트에서 기록한 결과입니다. 이 조사에서는 프로젝트의 테스트나 린터를 실행하지 않았습니다.

JSON 발췌 보기
{
    "success": true,
    "details": {
        "technologies": [
            "Python"
        ],
        "dependencies": {
            "unique_declared_package_count": 1,
            "unique_packages": [
                "httpx"
            ]
        },
        "version_control": {
            "status": "not_repository"
        },
        "file_scan": {
            "scanned_file_count": 3,
            "scan_complete": true
        },
        "summary": {
            "issue_count": 1,
            "verification": {
                "release_readiness": "not_assessed"
            }
        },
        "validation": {
            "tests": {
                "status": "configured_not_run"
            },
            "lint": {
                "status": "configured_not_run"
            }
        }
    }
}

02 / 스토리지

무엇이 공간을 차지하는지 확인하세요.

볼륨 용량을 확인하고 큰 파일과 중복이 확인된 파일의 목록을 살펴보세요. 진단은 파일을 그대로 보존하므로, 결과를 보고 처리 방법을 결정할 수 있습니다.

검사할 폴더에서 실행해 보세요
qzx diagnoseStorage . --min-file-size 1KB --max-files 10 --duplicate-min-size-kb 1 --max-depth 2 --json
살펴볼 저장 공간
사용 중
99.4%
여유 공간
19.85 GB
중복 그룹
1

범위가 제한된 테스트용 폴더에서 기록한 결과입니다. 표시된 용량은 해당 폴더가 속한 볼륨의 용량입니다. 파일은 삭제되지 않았습니다.

JSON 발췌 보기
{
    "success": true,
    "read_only": true,
    "partial": false,
    "scan_scope": {
        "max_depth": 2,
        "large_file_min_size": "1KB"
    },
    "assessment": {
        "capacity_status": "critical",
        "percent_used": 99.4,
        "free_readable": "19.85 GB",
        "duplicate_groups": 1,
        "confirmed_reclaimable_bytes": 9984,
        "reclaimable_space_basis": "logical_content_bytes",
        "physical_reclaimable_bytes": null
    }
}

03 / HTTP

URL이 어떤 응답을 반환하는지 확인하세요.

명령어 실행 상태와 HTTP 결과를 구분하세요. 이 기록에서는 요청이 완료되었고 서버는 404를 반환했습니다.

공개 URL로 실행해 보세요
qzx checkUrlStatus https://example.com 10 --json
맥락과 함께 보는 404 응답
HTTP 상태
404
검사
완료
요청한 리소스
찾을 수 없음

이 404는 로컬 테스트용 HTTP 서버에서 기록한 것입니다. 복사할 수 있는 명령어는 example.com에 요청을 보내며, 해당 요청에 대한 별도의 응답을 받습니다.

JSON 발췌 보기
{
    "success": true,
    "is_online": false,
    "status_code": 404
}

터미널에서 사용해 보세요

문제를 고르고, 명령어 하나로 시작하세요.

배포된 QZX 버전을 설치하고 사용자의 환경에서 읽기 전용 검사를 실행하세요.

python -m pip install --upgrade qzx
설치 방법
이 결과의 출처

기록일: 2026-10-08. 사용 환경: QZX 0.2.2.0.15, CPython 3.13.13, Windows 11 10.0.26200.

수치는 기록된 예제의 결과입니다. 복사한 명령어는 사용자의 터미널에서 실행되며, 결과는 환경에 따라 달라집니다.