Lewati ke konten utama

file · Referensi perintah

qzx getHumanLanguageStats

Apa fungsinya

Menganalisis file untuk memperkirakan distribusi bahasa manusia; mendukung 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

Analyzer ini hanya-baca. Peringatan tentang kamus dan kegagalan per file dikembalikan dalam field terstruktur; kegagalan apa pun juga membuat status keseluruhan gagal tanpa mencemari output JSON.

Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:2be4683e7103ff4766a4b8c08ab7efea44c03b6c3df1963dc43bedaeed4bda4c pada 2026-08-25.

Sintaks persis

qzx getHumanLanguageStats <file_path> [ignore_comments] [min_word_length] [languages] [recursive] [show_files_match] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

NamaTipeWajibDefaultDeskripsi
file_pathstrYaTidak dideklarasikanJalur file yang akan dianalisis. Mendukung wildcard seperti *.txt
ignore_commentsboolTidakfalseMenentukan apakah komentar kode diabaikan saat menganalisis teks. Mendukung flag -i atau --ignore-comments.
min_word_lengthintTidak4Panjang minimum kata yang dipertimbangkan untuk mendeteksi bahasa
languagesstrTidakTidak dideklarasikanDaftar bahasa yang akan dideteksi, dipisahkan koma (default: semua yang tersedia)
recursiveboolTidakfalseMenentukan apakah direktori dicari secara rekursif. Mendukung flag -r, -R, atau --recursive.
show_files_matchboolTidakfalseMenentukan apakah daftar file yang ditemukan ditampilkan. Mendukung flag --show_files_match.

Contoh input

qzx getHumanLanguageStats myfile.txt

Analisis distribusi bahasa pada file teks

qzx getHumanLanguageStats code.py -i

Analisis file Python dan abaikan komentar menggunakan flag

qzx getHumanLanguageStats "*.md" false 3

Analisis semua file Markdown di direktori saat ini

qzx getHumanLanguageStats "docs/*.txt" -i

Analisis file teks di direktori docs dan abaikan komentar

qzx getHumanLanguageStats "src/**/*.py" -r

Analisis secara rekursif file Python di direktori src dengan flag -r

qzx getHumanLanguageStats "**/*.py" -r -i

Analisis secara rekursif semua file Python dan abaikan komentar menggunakan flag

qzx getHumanLanguageStats "**/*.py" -r --show_files_match

Analisis secara rekursif semua file Python dan tampilkan daftar file yang ditemukan

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx getHumanLanguageStats <file_path> [ignore_comments] [min_word_length] [languages] [recursive] [show_files_match] --json

Contoh output representatif

JSON ilustratif ini berasal dari kontrak hasil yang didukung implementasi saat ini. Ini menunjukkan apa yang dapat dikembalikan perintah tanpa mengklaim sebagai eksekusi yang direkam; nilainya bervariasi menurut input, mesin, izin, dan alat opsional.

Perintah contoh: qzx getHumanLanguageStats myfile.txt --json

{
    "success": true,
    "message": "Analyzes files to estimate human-language distribution, with wildcard and recursive search support. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "getHumanLanguageStats",
        "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": 0,
        "schema_version": 1
    },
    "aggregated_stats": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "file_stats": [
        {
            "path": "README.md",
            "language": "English",
            "confidence_percent": 98.4
        }
    ],
    "files_analyzed": "C:\\project\\example.txt",
    "files_failed": "C:\\project\\example.txt",
    "files_found": "C:\\project\\example.txt",
    "files_processed": "C:\\project\\example.txt",
    "matched_files": "C:\\project\\example.txt",
    "status": "ok",
    "warnings": [
        {
            "name": "example",
            "status": "ok"
        }
    ]
}
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
        },
        "aggregated_stats": [],
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        },
        "file_stats": [],
        "files_analyzed": [],
        "files_failed": [],
        "files_found": [],
        "files_processed": [],
        "matched_files": [],
        "status": {
            "type": "string"
        },
        "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.

Alur bukti: siap untuk penangkapan otomatis deterministik.

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