初めて触れるプロジェクト
編集する前に、技術構成、依存関係、検出事項を把握します。
プロジェクトを調べるQZXの動作例
問題から
役立つ答えへ。
プロジェクトを調べ、ディスクの使用状況を確認し、HTTPレスポンスを読み解きます。各コマンドから何がわかるかを見て、次の行動を決めましょう。
読み取り専用検証可能な記録人が読みやすい出力とJSON
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。
数値は記録された各例のものです。コピーできるコマンドはお使いのターミナルで実行し、結果は環境によって変わります。