システム · コマンドリファレンス
qzx diagnoseStorage
機能
ファイルを削除・変更せずに、容量、大容量ファイル、検証済み重複を組み合わせてストレージ逼迫を診断します。
コマンドの成熟度: Alpha
実際の利用とフィードバックに使えますが、インターフェースと動作はまだ変更される可能性があります。 これは現在の開発チェックアウトに対する評価です。今後の各不変リリースタグには、そのバージョンに含まれた正確な評価が保存されます。 PyPI 0.2.2.0.9 で利用できます。ドキュメントは alpha チェックアウト 0.2.2.0.9 に対応しています。
動作と組み込み保護
状態を変更せずに検査します
この操作は直接実行されます
ネイティブプログラムを呼び出さずに動作します
ネットワークを使わずに動作します
権限昇格なしで動作するよう設計されています
厳密な読み取り専用診断で、ファイルの削除や変更は行いません。大容量ファイルはレビュー用の証拠としてのみ提示され、自動的に不要とは判断しません。回収可能性のある容量は、サイズ、SHA-256、バイト単位比較で確認済みの重複グループだけから計算します。物理的な S.M.A.R.T. 健康状態は getDiskHealth に分離されています。
この安全分類は 2026-09-04 に OpenAI GPT-5.6 Sol が実装ダイジェスト sha256:3f388a34b22a9b59259ba7c46dfec7a8ff570030f038c1a0aeba9b8f8a936bb9 と照合してレビューしました。
正確な構文
qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --jsonパラメータ
スワイプするか横スクロールバーを使って、すべての列を表示してください。
| 名前 | 型 | 必須 | 既定値 | 説明 |
|---|---|---|---|---|
| path | str | いいえ | "." | ストレージ使用状況を診断するディレクトリ (既定値: 現在のディレクトリ) |
| min_file_size | str | いいえ | "100MiB" | 大容量ファイル表示の最小サイズ。例: 100MiB または 1GB |
| max_files | int | いいえ | 20 | 返す大容量ファイルの最大件数 (1-1000) |
| duplicate_min_size_kb | int | いいえ | 10240 | 重複検索で対象にする最小サイズ (KB)。既定値 10240 = 10 MiB |
| max_depth | int | いいえ | 6 | 大容量ファイルと重複を探す最大ディレクトリ深度 (0-64、既定値: 6) |
| include_duplicates | bool | いいえ | true | 同じフロー内でバイト単位検証済みの重複検索を実行 (true/false、既定で有効) |
入力例
qzx diagnoseStorage範囲を制限した検索で現在のディレクトリのストレージ逼迫を診断
qzx diagnoseStorage C:/ --max-depth 4 --max-files 30浅い深度と多めの大容量ファイル一覧で Windows ボリュームを検査
qzx diagnoseStorage /home --include-duplicates false --min-file-size 500MiB重複ハッシュを計算せず、容量と大容量ファイルをより高速に診断
完全な構造化ペイロードを取得するには --json を追加します: qzx diagnoseStorage [path] [min_file_size] [max_files] [duplicate_min_size_kb] [max_depth] [include_duplicates] --json
観測された出力例
Windows 11 上の QZX 0.2.2.0.9 で取得。終了コードは 0。ホスト依存の値や所要時間は変わる場合があります。
例のコマンド: qzx diagnoseStorage ../artifacts/qzx-evidence/storage-triage --min-file-size 1KB --max-files 10 --duplicate-min-size-kb 1 --max-depth 2 --json
{
"success": true,
"message": "Storage diagnosis completed for 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage': 98.7% used with 45.00 GB free; 3 files matched the large-file threshold. Confirmed 1 duplicate group with up to 9.75 KB reclaimable if one copy per group is kept. QZX did not delete or modify any files.",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage",
"partial": false,
"read_only": true,
"scan_scope": {
"max_depth": 2,
"large_file_min_size": "1KB",
"max_large_files_returned": 10,
"duplicate_scan_requested": true,
"duplicate_min_size_kb": 1
},
"probe_status": {
"capacity": "ok",
"large_files": "ok",
"duplicates": "ok"
},
"assessment": {
"capacity_status": "critical",
"percent_used": 98.7,
"total_bytes": 3718889074688,
"total_readable": "3.38 TB",
"free_bytes": 48314122240,
"free_readable": "45.00 GB",
"large_files_matched": 3,
"large_files_returned": 3,
"duplicate_groups": 1,
"duplicate_files": 2,
"confirmed_reclaimable_bytes": 9984,
"confirmed_reclaimable_readable": "9.75 KB"
},
"capacity": {
"success": true,
"message": "Disk information for 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage': 3.34 TB used of 3.38 TB total (98.7% used), 45.00 GB free.",
"disk_info": {
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage",
"total_bytes": 3718889074688,
"used_bytes": 3670574952448,
"free_bytes": 48314122240,
"total": "3.38 TB",
"used": "3.34 TB",
"free": "45.00 GB",
"percent": 98.7
}
},
"large_files": {
"success": true,
"message": "Found 3 matching files in 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage'. Returning 3 files totaling 26.25 KiB.",
"search_path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage",
"pattern": "*",
"recursive": 2,
"filters": {
"min_size_bytes": 1024,
"max_size_bytes": null,
"modified_after": null,
"modified_before": null,
"exclude": [],
"exclude_dirs": []
},
"sort": {
"by": "size",
"descending": true
},
"matched_count": 3,
"matched_size_bytes": 26880,
"matched_size_readable": "26.25 KiB",
"count": 3,
"total_size_bytes": 26880,
"total_size_readable": "26.25 KiB",
"limit": 10,
"truncated": false,
"skipped_unreadable": 0,
"warnings": [],
"results": [
{
"name": "duplicate-a.bin",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\duplicate-a.bin",
"relative_path": "duplicate-a.bin",
"depth": 0,
"size_bytes": 9984,
"size_readable": "9.75 KiB",
"modified_timestamp": 1789069884.4857178,
"modified_at": "2026-09-10T14:51:24-05:00"
},
{
"name": "duplicate-b.bin",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\duplicate-b.bin",
"relative_path": "duplicate-b.bin",
"depth": 0,
"size_bytes": 9984,
"size_readable": "9.75 KiB",
"modified_timestamp": 1789069884.4865727,
"modified_at": "2026-09-10T14:51:24-05:00"
},
{
"name": "unique.bin",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\unique.bin",
"relative_path": "unique.bin",
"depth": 0,
"size_bytes": 6912,
"size_readable": "6.75 KiB",
"modified_timestamp": 1789069884.4865727,
"modified_at": "2026-09-10T14:51:24-05:00"
}
]
},
"duplicates": {
"success": true,
"scan_path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage",
"total_groups": 1,
"total_duplicate_files": 2,
"reclaimable_bytes": 9984,
"reclaimable_space_readable": "9.75 KB",
"duplicate_groups": {
"2467aef9f30a32bd4940b61dc4cd366c8c4f1677f514591d8cf1e0acf61f158e": {
"sha256": "2467aef9f30a32bd4940b61dc4cd366c8c4f1677f514591d8cf1e0acf61f158e",
"verification": "byte_for_byte",
"size_bytes": 9984,
"size_readable": "9.75 KB",
"files": [
"C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\duplicate-a.bin",
"C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\\duplicate-b.bin"
]
}
},
"message": "Duplicate files scan completed for 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage':\n- Duplicate groups identified: 1\n- Total duplicate file copies: 2\n- Reclaimable space: 9.75 KB\n\nTop Duplicate Groups:\n - [9.75 KB] SHA-256: 2467aef9f30a... (byte-for-byte verified)\n -> duplicate-a.bin\n -> duplicate-b.bin\n"
},
"recommendations": [
{
"priority": "high",
"action": "Review the largest files and confirmed duplicate groups before adding more data.",
"reason": "The target filesystem is 98.7% used."
},
{
"priority": "review",
"action": "Inspect the returned large-file paths and decide which are intentional; size alone is never a deletion signal.",
"reason": "Files at or above 1KB were found within depth 2."
},
{
"priority": "review",
"action": "Review each duplicate group and keep at least one intentional copy before removing anything manually.",
"reason": "Byte-for-byte verification found 1 group with up to 9.75 KB reclaimable."
},
{
"priority": "info",
"action": "Use getDiskHealth separately only when hardware health is relevant; capacity pressure does not imply a failing disk.",
"reason": "S.M.A.R.T. health and filesystem capacity are separate diagnostic questions."
}
],
"warnings": [],
"related_commands": [
"getDiskSpace",
"findFiles",
"findDuplicateFiles",
"getDiskHealth"
],
"report": "Storage diagnosis: C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\storage-triage\nCapacity: 98.7% used; 45.00 GB free of 3.38 TB. Status: critical.\nLarge files: 3 matched; 3 returned for review.\nDuplicates: 1 verified group(s), 2 duplicate file(s), up to 9.75 KB reclaimable if one copy per group is kept.\nSafety: read-only diagnosis; QZX did not delete or modify files.",
"meta": {
"command": "diagnoseStorage",
"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": 9.471,
"schema_version": 1
}
}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
},
"assessment": [],
"capacity": [],
"details": [],
"duplicates": [],
"error": [],
"error_code": [],
"large_files": [],
"partial": [],
"path": [],
"probe_status": {
"type": "object",
"properties": {
"capacity": {
"type": "string"
},
"large_files": {
"type": "string"
},
"duplicates": []
},
"additionalProperties": true
},
"read_only": {
"type": "boolean"
},
"recommendations": [],
"related_commands": {
"type": "array"
},
"report": [],
"scan_scope": {
"type": "object",
"properties": {
"max_depth": [],
"large_file_min_size": [],
"max_large_files_returned": [],
"duplicate_scan_requested": [],
"duplicate_min_size_kb": []
},
"additionalProperties": true
},
"warnings": []
},
"additionalProperties": true
}エラーと制限
公開コントラクトでは失敗時に success=false と説明的な message が必要です。このカタログではまだコマンドごとのエラー分類を宣言していません。結果を確認し、存在しないコードを推測しないでください。
QZX は alpha 段階です。オプション依存関係、権限、ホスト機能によって結果が変わる場合があります。
証拠フロー: 取得済み・ダイジェストで検証済み。
証拠と出所
- ドキュメントチャネル
- 開発ドキュメント 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- 提供状況
- 0.2.2.0.9 以前
さらに探す
関連コマンド
これらのコマンドも システム カテゴリに属します。比較して、タスクに最適な操作を選んでください。