Lewati ke konten utama

file · Referensi perintah

qzx listFiles

Apa fungsinya

Mencantumkan file dalam direktori dengan wildcard dan pencarian rekursif.

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.9. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.9.

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 OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:9ed75febb115f7e7e659a5047df5f47a43e95d5c7e32d3f5b1c96e4f85b27eff pada 2026-08-25.

Sintaks persis

qzx listFiles [directory_path] [pattern] [recursive] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

NamaTipeWajibDefaultDeskripsi
directory_pathstrTidak"."Jalur direktori yang file-nya akan dicantumkan
patternstrTidak"*"Pola untuk memfilter file (misalnya "*.txt" atau "doc*.pdf")
recursivestrTidakTidak dideklarasikanTingkat rekursi: default tidak ada, -r/--recursive tanpa batas, atau -rN/--recursiveN hingga N tingkat kedalaman

Contoh input

qzx listFiles

Cantumkan semua file di direktori saat ini

qzx listFiles C:\Documents

Cantumkan semua file di direktori C:\Documents (Windows)

qzx listFiles /home/user/documents

Cantumkan semua file di direktori /home/user/documents (Linux/Mac)

qzx listFiles . "*.py"

Cantumkan semua file Python di direktori saat ini

qzx listFiles src "*.js" -r

Cantumkan semua file JavaScript di direktori src dan semua subdirektorinya

qzx listFiles src "*.js" -r2

Cantumkan semua file JavaScript di direktori src hingga 2 tingkat subdirektori

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx listFiles [directory_path] [pattern] [recursive] --json

Contoh output yang diamati

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

Perintah contoh: qzx listFiles ../artifacts/qzx-evidence/golden-core-files "*.txt" -r --json

{
    "success": true,
    "directory": "../artifacts/qzx-evidence/golden-core-files",
    "pattern": "*.txt",
    "recursive": true,
    "recursion_depth": null,
    "files": [
        {
            "name": "alpha.txt",
            "path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\golden-core-files\\alpha.txt",
            "size": 33,
            "size_formatted": "33.0 B",
            "modified": 1789069884.8062317,
            "modified_formatted": "2026-09-10 14:51:24",
            "is_directory": false
        },
        {
            "name": "gamma.txt",
            "path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\golden-core-files\\nested\\gamma.txt",
            "size": 19,
            "size_formatted": "19.0 B",
            "modified": 1789069884.8072324,
            "modified_formatted": "2026-09-10 14:51:24",
            "is_directory": false
        }
    ],
    "message": "Found 2 files matching '*.txt' in '../artifacts/qzx-evidence/golden-core-files' (including subdirectories)",
    "meta": {
        "command": "listFiles",
        "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": 4.931,
        "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
        },
        "details": {
            "type": "object",
            "properties": {
                "directory": [],
                "pattern": []
            },
            "additionalProperties": true
        },
        "directory": [],
        "error": [],
        "error_code": {
            "type": "string"
        },
        "files": {
            "type": "array"
        },
        "pattern": [],
        "recursion_depth": [],
        "recursive": []
    },
    "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,
    "error": "Directory '../artifacts/qzx-evidence/missing-golden-core-path' not found.",
    "error_code": "path_not_found",
    "message": "Directory '../artifacts/qzx-evidence/missing-golden-core-path' not found.",
    "details": {
        "directory": "../artifacts/qzx-evidence/missing-golden-core-path",
        "pattern": "*"
    },
    "meta": {
        "command": "listFiles",
        "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": 5.373,
        "schema_version": 1
    }
}

Perintah yang ditangkap: qzx listFiles ../artifacts/qzx-evidence/missing-golden-core-path --json

Alur bukti: ditangkap dan divalidasi dengan digest.

Bukti dan asal-usul

Kanal dokumentasi
Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
Ketersediaan
0.2.2.0.9 atau lebih lama

Lanjut jelajahi

Perintah terkait

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

Jelajahi semua perintah QZX