Saltar al contenido principal

archivos · Referencia de comando

qzx getHumanLanguageStats

Qué hace

Analiza archivos para estimar la distribución de idiomas humanos; admite comodines y búsqueda recursiva.

Madurez del comando: Alpha

Disponible para uso real y retroalimentación mientras su interfaz y comportamiento todavía pueden evolucionar. Esta es la evaluación actual del checkout de desarrollo. Cada futuro tag inmutable de release conservará la evaluación exacta incluida en esa versión. Disponible en PyPI 0.2.2.0.8. La documentación corresponde al checkout alpha 0.2.2.0.8.

Comportamiento y protecciones integradas

Inspecciona sin cambiar el estado

Ejecución directa para esta operación

Funciona sin invocar programas nativos

Funciona sin usar la red

Diseñado para funcionar sin elevación

Este analizador es de solo lectura. Los avisos sobre diccionarios y los fallos por archivo se devuelven en campos estructurados; cualquier fallo hace fallar también el estado general sin contaminar la salida JSON.

Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Pro contra el digest de implementación sha256:2be4683e7103ff4766a4b8c08ab7efea44c03b6c3df1963dc43bedaeed4bda4c el 2026-08-25.

Sintaxis exacta

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

Parámetros

Desliza o usa la barra horizontal para ver todas las columnas.

NombreTipoObligatorioPredeterminadoDescripción
file_pathstrSíNo declaradoRuta de los archivos que se analizarán. Admite comodines como *.txt
ignore_commentsboolNofalseIndica si se ignoran los comentarios de código al analizar el texto. Admite el flag -i o --ignore-comments.
min_word_lengthintNo4Longitud mínima de las palabras que se considerarán para detectar el idioma
languagesstrNoNo declaradoLista de idiomas que se detectarán, separados por comas (valor predeterminado: todos los disponibles)
recursiveboolNofalseIndica si se buscan directorios recursivamente. Admite los flags -r, -R o --recursive.
show_files_matchboolNofalseIndica si se muestra la lista de archivos encontrados. Admite el flag --show_files_match.

Ejemplos de entrada

qzx getHumanLanguageStats myfile.txt

Analizar la distribución de idiomas de un archivo de texto

qzx getHumanLanguageStats code.py -i

Analizar un archivo Python e ignorar los comentarios mediante un flag

qzx getHumanLanguageStats "*.md" false 3

Analizar todos los archivos Markdown del directorio actual

qzx getHumanLanguageStats "docs/*.txt" -i

Analizar archivos de texto del directorio docs e ignorar los comentarios

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

Analizar recursivamente los archivos Python del directorio src mediante el flag -r

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

Analizar recursivamente todos los archivos Python e ignorar los comentarios mediante flags

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

Analizar recursivamente todos los archivos Python y mostrar la lista de archivos encontrados

Para obtener la carga estructurada completa, añade --json: qzx getHumanLanguageStats <file_path> [ignore_comments] [min_word_length] [languages] [recursive] [show_files_match] --json

Ejemplo de salida representativa

Este JSON ilustrativo deriva del contrato de resultado respaldado por la implementación actual. Muestra lo que el comando puede devolver sin afirmar que es una ejecución grabada; los valores varían según entradas, equipo, permisos y herramientas opcionales.

Comando del ejemplo: 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"
        }
    ]
}
Ver el contrato de resultado 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
}

Errores y límites

El contrato público exige success=false y un message descriptivo en fallos. Este catálogo aún no declara una taxonomía de errores específica para cada comando; revisa el resultado y no infieras códigos inexistentes.

QZX está en alpha. Dependencias opcionales, permisos y capacidades del host pueden cambiar el resultado.

Flujo de evidencia: lista para captura automática determinista.

Evidencia y procedencia

Canal de documentación
Documentación de desarrollo 0.2.2.0.8 · main · sha256:9aa902dfb6b006017e52972bf7871fef49b03ec24ff80741231d743d0354bfc2
Disponibilidad
0.2.2.0.8 o anterior

Sigue explorando

Comandos relacionados

Estos comandos también pertenecen a la categoría de archivos. Compáralos para elegir la operación que mejor resuelva tu tarea.

Explorar todos los comandos de QZX