desarrollo · Referencia de comando
qzx cleanDevelopmentArtifacts
Qué hace
Busca cachés, dependencias instaladas y artefactos de compilación generados; de forma predeterminada solo previsualiza.
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.9. La documentación corresponde al checkout alpha 0.2.2.0.9.
Comportamiento y protecciones integradas
El modo real aplica los cambios que solicites
Vista previa disponible
Funciona sin invocar programas nativos
Funciona sin usar la red
Diseñado para funcionar sin elevación
QZX crea un archivo de recuperación antes de los cambios reales; usa --dangerously-bypass-approvals-and-sandbox/--yolo solo cuando decidas omitirlo deliberadamente.
Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Pro contra el digest de implementación sha256:2ead22b60a19636b621ac51800540f1426217ac47bc94e5080ce168e925add7d el 2026-08-25.
Sintaxis exacta
qzx cleanDevelopmentArtifacts [scan_path] [dry_run] [max_depth] --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| scan_path | str | No | "." | Directorio que se analizará (valor predeterminado: directorio de trabajo actual) |
| dry_run | bool | No | true | Previsualiza los directorios coincidentes sin eliminarlos |
| max_depth | int | No | 4 | Profundidad máxima de directorios que se inspeccionará; debe ser como mínimo 1 |
Ejemplos de entrada
qzx cleanDevelopmentArtifactsPrevisualizar los directorios de desarrollo generados bajo el directorio actual
qzx cleanDevelopmentArtifacts . --dry-run falseCrear un respaldo del directorio actual y después eliminar todos los directorios generados que coincidan
Para obtener la carga estructurada completa, añade --json: qzx cleanDevelopmentArtifacts [scan_path] [dry_run] [max_depth] --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 cleanDevelopmentArtifacts --json
{
"success": true,
"message": "Finds development caches, dependency directories, and generated build artifacts; preview is the default. In this illustrative example, the command completed successfully.",
"meta": {
"command": "cleanDevelopmentArtifacts",
"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
},
"deleted_folders": [
"project/.cache"
],
"deletion_failures": [
{
"name": "example",
"status": "ok"
}
],
"details": {
"scan_path": "C:\\project\\example.txt",
"dry_run": true,
"max_depth": "Example value"
},
"dry_run": true,
"errors": [],
"found_folders": [
"project/.cache"
],
"max_depth": "Example value",
"scan_path": "C:\\project\\example.txt",
"status": "ok",
"total_bytes_identified": 3,
"total_bytes_saved": 3,
"total_folders_found": 3,
"total_space_identified_readable": 3,
"total_space_saved_readable": 3
}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
},
"deleted_folders": [],
"deletion_failures": [],
"details": {
"oneOf": [
{
"type": "object",
"properties": {
"scan_path": [],
"dry_run": [],
"max_depth": []
},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"scan_path": []
},
"additionalProperties": true
}
]
},
"dry_run": [],
"error": {
"type": "string"
},
"error_code": {
"type": "string"
},
"errors": [],
"found_folders": [],
"max_depth": [],
"scan_path": [],
"status": {
"type": "string"
},
"total_bytes_identified": [],
"total_bytes_saved": [],
"total_folders_found": [],
"total_space_identified_readable": [],
"total_space_saved_readable": []
},
"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: requiere un destino desechable aislado.
Evidencia y procedencia
- Canal de documentación
- Documentación de desarrollo 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- Disponibilidad
- 0.2.2.0.9 o anterior
Sigue explorando
Comandos relacionados
Estos comandos también pertenecen a la categoría de desarrollo. Compáralos para elegir la operación que mejor resuelva tu tarea.
qzx auditRepositoryEjecuta auditorías de seguridad y calidad en un repositorio Git: secretos, archivos grandes, duplicados, cumplimiento de .gitignore y licencias.qzx compareFilesCompara archivos de texto línea por línea y archivos binarios mediante bytes exactos y SHA-256.qzx analyzeComplexityAnaliza métricas de complejidad del código en archivos o proyectos.qzx deployProjectPrevisualiza o despliega un artefacto explícito por SSH con respaldo remoto verificado, validación SHA-256, promoción atómica, comprobación de salud y rollback automático.