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.6a11. La documentación corresponde al checkout alpha 0.2.2.0.6a11.
Seguridad y efectos
Puede modificar estado
Parámetro dry-run documentado
No invoca programas nativos según la clasificación
Sin uso de red documentado
No requiere elevación de forma inherente
Antes de mutar, QZX crea un archivo de recuperación; --dangerously-bypass-approvals-and-sandbox/--yolo lo omite explícitamente.
Esta clasificación de seguridad fue revisada por OpenAI Codex (authorized project audit) contra el digest de implementación sha256:2fc30d56a0fbe2579969f74563bd707f2cc88efb828da67badf563e58121cd53 el 2026-07-30.
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": {
"type": "object",
"properties": {
"scan_path": [],
"dry_run": [],
"max_depth": []
},
"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.6a11 · main · sha256:d1bf56371df81b2a79619d8219eed92ccf790be1584c528e211381ca7aa85302
- Disponibilidad
- 0.2.2.0.6a11 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.