file · Referensi perintah

`qzx findFiles`

Apa fungsinya

Mencari file berdasarkan nama, kedalaman, ukuran, dan tanggal modifikasi, lalu mengembalikan metadata terstruktur.

Kematangan perintah: Alpha

Tersedia untuk penggunaan nyata dan umpan balik sementara antarmuka serta perilakunya masih dapat berkembang. Ini adalah evaluasi saat ini untuk checkout pengembangan. Setiap tag rilis immutable di masa mendatang akan mempertahankan evaluasi persis yang disertakan dalam versi tersebut. Tersedia di PyPI 0.2.2.0.15. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.15.

Perilaku dan perlindungan bawaan

Memeriksa tanpa mengubah status

Eksekusi langsung untuk operasi ini

Berfungsi tanpa memanggil program native

Berfungsi tanpa menggunakan jaringan

Dirancang untuk bekerja tanpa elevasi hak akses

Klasifikasi keamanan ini ditinjau oleh Claude Opus 5.5 (Anthropic) terhadap digest implementasi sha256:d501ba0d73e0267393bc5019cdb12a51593e339a05f0d3cd3dd77a5b0f738eab pada 2026-10-08.

Sintaks persis

qzx findFiles [search_path] [pattern] [recursive] [min_size] [max_size] [modified_after] [modified_before] [exclude] [exclude_dirs] [sort_by] [descending] [limit] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

Nama	Tipe	Wajib	Default	Deskripsi
search_path	str	Tidak	"."	Direktori tempat pencarian dimulai
pattern	str	Tidak	"*"	Pola glob nama file, seperti *.txt atau data-???.csv; secara default mencakup semua file
recursive	str	Tidak	"-r"	Kedalaman: -r tanpa batas, false hanya direktori saat ini, atau -rN hingga N tingkat
min_size	str	Tidak	Tidak dideklarasikan	Ukuran minimum, misalnya 500KB, 10MiB, atau sejumlah byte
max_size	str	Tidak	Tidak dideklarasikan	Ukuran maksimum, misalnya 2GB, 20MiB, atau sejumlah byte
modified_after	str	Tidak	Tidak dideklarasikan	Hanya sertakan file yang dimodifikasi pada atau setelah YYYY-MM-DD, "today", atau "yesterday"
modified_before	str	Tidak	Tidak dideklarasikan	Hanya sertakan file yang dimodifikasi sebelum YYYY-MM-DD, "today", atau "yesterday"
exclude	str	Tidak	Tidak dideklarasikan	Pola glob nama file yang dikecualikan, dipisahkan koma
exclude_dirs	str	Tidak	Tidak dideklarasikan	Pola glob nama direktori yang dilewati, dipisahkan koma
sort_by	str	Tidak	"path"	Urutkan berdasarkan path, name, size, atau modified
descending	bool	Tidak	false	Membalik urutan yang dipilih (true/false)
limit	str	Tidak	Tidak dideklarasikan	Jumlah maksimum file yang dikembalikan setelah diurutkan

Contoh input

qzx findFiles . "*.py" --exclude-dirs ".git,.venv"

Cari file Python secara rekursif dan lewati direktori metadata umum

qzx findFiles Downloads "*" --min-size 100MiB --sort-by size --descending true --limit 20

Kembalikan 20 file cocok terbesar yang berukuran minimal 100 MiB

qzx findFiles logs "*.log" --modified-after 2026-07-01 --recursive false

Cari log yang baru dimodifikasi tanpa menelusuri subdirektori

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx findFiles [search_path] [pattern] [recursive] [min_size] [max_size] [modified_after] [modified_before] [exclude] [exclude_dirs] [sort_by] [descending] [limit] --json

Contoh output yang diamati

Ditangkap dengan QZX 0.2.2.0.15 di Windows 11; kode keluar 0. Nilai yang bergantung pada host dan durasi dapat bervariasi.

Perintah contoh: qzx findFiles ../artifacts/qzx-evidence/find-files "*.txt" -r --json

{
    "success": true,
    "message": "Found 2 matching files in 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\find-files'. Returning 2 files totaling 13.00 B.",
    "search_path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\find-files",
    "pattern": "*.txt",
    "recursive": "unlimited",
    "filters": {
        "min_size_bytes": null,
        "max_size_bytes": null,
        "modified_after": null,
        "modified_before": null,
        "exclude": [],
        "exclude_dirs": []
    },
    "sort": {
        "by": "path",
        "descending": false
    },
    "matched_count": 2,
    "matched_size_bytes": 13,
    "matched_size_readable": "13.00 B",
    "count": 2,
    "total_size_bytes": 13,
    "total_size_readable": "13.00 B",
    "limit": null,
    "truncated": false,
    "partial": false,
    "scan_complete": true,
    "skipped_unreadable": 0,
    "skipped_search_paths": 0,
    "skipped_special_files": 0,
    "warnings": [],
    "results": [
        {
            "name": "alpha.txt",
            "path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\find-files\\alpha.txt",
            "relative_path": "alpha.txt",
            "depth": 0,
            "size_bytes": 7,
            "size_readable": "7.00 B",
            "modified_timestamp": 1791521129.4579072,
            "modified_at": "2026-10-08T23:45:29-05:00"
        },
        {
            "name": "beta.txt",
            "path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\find-files\\nested\\beta.txt",
            "relative_path": "nested\\beta.txt",
            "depth": 1,
            "size_bytes": 6,
            "size_readable": "6.00 B",
            "modified_timestamp": 1791521129.4589078,
            "modified_at": "2026-10-08T23:45:29-05:00"
        }
    ],
    "meta": {
        "command": "findFiles",
        "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": 3.626,
        "schema_version": 1
    }
}

Lihat kontrak hasil 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
        },
        "count": [],
        "details": [],
        "error": [],
        "error_code": [],
        "filters": {
            "type": "object",
            "properties": {
                "min_size_bytes": [],
                "max_size_bytes": [],
                "modified_after": [],
                "modified_before": [],
                "exclude": [],
                "exclude_dirs": []
            },
            "additionalProperties": true
        },
        "limit": [],
        "matched_count": [],
        "matched_size_bytes": [],
        "matched_size_readable": [],
        "partial": [],
        "pattern": [],
        "recursive": [],
        "results": [],
        "scan_complete": [],
        "search_path": [],
        "skipped_search_paths": [],
        "skipped_special_files": [],
        "skipped_unreadable": [],
        "sort": {
            "type": "object",
            "properties": {
                "by": [],
                "descending": []
            },
            "additionalProperties": true
        },
        "total_size_bytes": [],
        "total_size_readable": [],
        "truncated": {
            "type": "boolean"
        },
        "warnings": []
    },
    "additionalProperties": true
}

Kesalahan dan batasan

Kontrak publik mensyaratkan success=false dan message yang deskriptif saat gagal. Katalog ini belum mendeklarasikan taksonomi kesalahan khusus untuk setiap perintah; periksa hasil dan jangan menyimpulkan kode yang tidak ada.

QZX masih dalam tahap alpha. Dependency opsional, izin, dan kemampuan host dapat mengubah hasil.

{
    "success": false,
    "message": "Path 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\missing-golden-core-path' does not exist.",
    "error": "Path 'C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\missing-golden-core-path' does not exist.",
    "error_code": "path_not_found",
    "details": {
        "search_path": "../artifacts/qzx-evidence/missing-golden-core-path"
    },
    "meta": {
        "command": "findFiles",
        "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": 2.017,
        "schema_version": 1
    }
}

Perintah yang ditangkap: qzx findFiles ../artifacts/qzx-evidence/missing-golden-core-path "*.txt" -r --json

Alur bukti: ditangkap dan divalidasi dengan digest.

Bukti dan asal-usul

Implementasi: src/qzx/commands/file/find_files.py
Pengujian: tests/test_file_commands/test_find_files.py
Kanal dokumentasi: Dokumentasi pengembangan 0.2.2.0.15 · main · sha256:b91acee86268edb7cb018a94e089ff8e95835eda3f2cf08b39796c0ab9654693
Ketersediaan: 0.2.2.0.15 atau lebih lama

Panduan praktis

Pelajari kapan qzx findFiles cocok untuk tugas Anda, bagaimana perbandingannya dengan alat native, dan detail apa yang penting saat mengotomatisasi.

7 menit baca
Diagnosis ruang disk yang tidak dimulai dengan menghapus file
Gabungkan kapasitas, file besar, dan duplikat terverifikasi dalam alur hanya-baca agar keputusan destruktif didahului bukti.
Baca panduan praktis

Lanjut jelajahi

Perintah ini juga termasuk kategori file. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.

Jelajahi semua perintah QZX