theus-cli 0.2.82 → 0.2.84

package/vendor/theus-arsenal/skills/instaladores-python/SKILL.md

@@ -1,820 +0,0 @@
----
-name: instaladores-python
-description: Empaquetado comercial de Python para Windows — compilación extrema con Nuitka,
-  adelgazamiento del dist, análisis de huella de DLL y empaquetado con Inno Setup para
-  distribuir los instaladores más pequeños y de arranque más rápido. Solo para optimización
-  avanzada de tamaño/arranque, no para conversiones básicas de script a exe.
----
-
-# Instaladores Python (grado comercial)
-
-Actúa como **experto en despliegue comercial de Python**. El objetivo es el instalador de Windows **más pequeño, de arranque más rápido y más limpio**. El enfoque central es **"Nuitka en modo carpeta (dist) + empaquetado con Inno Setup"** — nada de builds de un solo archivo, nada de ventanas de consola parásitas.
-
-## Cuándo usarla
-
-Actívala cuando el usuario pida explícitamente empaquetado **avanzado** de Python u optimización de tamaño/arranque en Windows:
-
-- Compilación extrema / de grado comercial con Nuitka, builds de tamaño mínimo o arranque más rápido
-- Adelgazamiento de la carpeta `dist`, análisis de huella de DLL, trade-offs de tamaño 32 vs 64 bits
-- Empaquetado con Inno Setup con metadatos completos y desinstalación limpia sin residuos
-
-Esta skill apunta a optimización avanzada — no a la conversión básica "script a exe" de un solo archivo.
-
-## Cómo funciona
-
-1. **Confirmar los parámetros del build** — nombre de la app, versión, publicador, nombre del exe, directorios de origen/salida, icono. Nunca autocompletar; preguntar al usuario.
-2. **Verificar el build de origen** — consola deshabilitada, LTO activado, runtime de VC++ presente.
-3. **Compilar con Nuitka** usando la estrategia de exclusión de módulos y plugins de abajo.
-4. **Adelgazar la carpeta `dist`** — eliminar símbolos de depuración, cachés, tests y docs, con salvaguardas para los metadatos requeridos en runtime.
-5. **Analizar las DLL** para encontrar y recortar las dependencias más grandes.
-6. **Empaquetar con Inno Setup** — compresión LZMA2 ultra, metadatos completos, desinstalación sin residuos y redistribuible de VC++ de la arquitectura correcta.
-
-## Ejemplos
-
-- "Empaqueta este proyecto PySide2 con Nuitka en el instalador comercial más pequeño posible" → ejecutar el flujo completo: recomendar 32 bits, excluir WebEngine/3D/Charts, adelgazar `dist`, empaquetar con Inno Setup.
-- "Mi exe pesa 400 MB, ¿cómo lo reduzco a la mitad?" → analizar las DLL, cambiar a `opencv-python-headless`, eliminar `opengl32sw`, aplicar el adelgazamiento del `dist`.
-- "Tras instalar no abre en un sistema limpio" → asegurar que el redistribuible de VC++ de la arquitectura correcta va incluido en el script de Inno Setup.
-
----
-
-## Filosofía central
-
-Mantén siempre el esquema **"Nuitka en modo carpeta (dist) + Inno Setup"**. Rechaza la versión de un solo archivo y la ventana de consola.
-
----
-
-## Caso de referencia real (app de escritorio PySide2 de producción, 323 MB, con OpenCV / Playwright)
-
-### Resumen del proyecto
-- **Tamaño total**: 323 MB
-- **Dependencias principales**: PySide2 (22.52 MB), OpenCV (62.38 MB), Playwright (76.74 MB)
-- **Python**: 3.8 (32 bits)
-- **DLL**: 71 archivos, 93.23 MB en total
-
-### Estrategias de optimización clave
-1. OK: **Python de 32 bits** → tamaño reducido 20-30 %
-2. OK: **Librería estándar comprimida** → 0.74 MB
-3. OK: **Exclusión de módulos** → sin pytest/unittest/setuptools
-4. OK: **Plugins de Qt recortados** → solo los necesarios
-
-### Distribución del tamaño
-
-| Componente | Tamaño | % | Sugerencia |
-|------------|--------|---|-----------|
-| playwright | 76.74 MB | 23.8 % | Eliminar si no es imprescindible |
-| OpenCV | 62.38 MB | 19.3 % | Usar opencv-python-headless |
-| PySide2 | 22.52 MB | 7.0 % | Excluir WebEngine/3D/Charts |
-| Resto de dependencias | 161.36 MB | 49.9 % | - |
-
-### Efecto esperado
-
-| Tipo de proyecto | Nuitka sin optimizar | Optimizado | Medición del caso de referencia |
-|------------------|----------------------|------------|-------------------------------|
-| Tkinter + stdlib | 150-250 MB | **80-120 MB** | - |
-| PyQt/PySide | 200-400 MB | **120-250 MB** | 323 MB (con OpenCV etc.) |
-| Con numpy/pandas | 300-600 MB | **180-350 MB** | - |
-
----
-
-## Flujo central (ejecutar estrictamente)
-
-Cuando el usuario pida empaquetar, sigue estos pasos:
-
-**Paso 1: confirmación obligatoria de parámetros (PROHIBIDO usar valores por defecto)**
-
-> **Regla importante: todos los parámetros siguientes deben confirmarse uno a uno con el usuario. Prohibido autocompletar o asumir valores.**
-
-Hay que preguntar y confirmar (*esperar respuesta explícita antes de continuar*):
-
-| Parámetro | Descripción | Ejemplo |
-|-----------|-------------|---------|
-| **Nombre de la app** | Nombre visible del software | `AnotadorRojo` |
-| **Versión** | Versionado semántico | `1.0.0` |
-| **Publicador/Empresa** | Publicador mostrado en el Panel de control | `MiEmpresa` |
-| **Ejecutable principal** | Nombre del exe principal | `AnotadorRojo.exe` |
-| **Ruta de origen** | Ruta absoluta de la carpeta dist de Nuitka | `D:\proyecto\dist` |
-| **Ruta de salida** | Dónde generar el instalador | `D:\proyecto\output` |
-| **Ruta del icono** | Archivo .ico (opcional, recomendado) | `D:\proyecto\icon.ico` |
-| **URL del sitio** | Opcional, enlace en el Panel de control | `https://example.com` |
-
-**Plantilla de pregunta:**
-> "Necesito que confirmes uno a uno los siguientes parámetros de empaquetado:
-> 1. Nombre de la app:
-> 2. Versión:
-> 3. Publicador/Empresa:
-> 4. Ejecutable principal (p. ej. xxx.exe):
-> 5. Ruta de origen (carpeta dist de Nuitka):
-> 6. Ruta de salida (dónde guardar el instalador):
-> 7. Ruta del icono (.ico, puede quedar vacío):
-> 8. URL del sitio (puede quedar vacío):
->
-> Responde cada uno, o 'omitir' para dejarlo vacío."
-
-**Paso 2: verificación de calidad de la compilación (crítico)**
-
-Antes de generar código, plantea esta **confirmación crítica** (Inno Setup es solo un empaquetador y no puede cambiar cómo se comporta el programa):
-
-> "ATENCIÓN — **verificación de parámetros de compilación**:
-> 1. **Sin consola**: confirma que la carpeta dist se compiló con `nuitka --windows-console-mode=disable` (si no, tras instalar seguirá apareciendo la ventana negra).
-> 2. **Alto rendimiento**: confirma si se usó `--lto=yes` (si no, el arranque puede ser lento).
-> 3. **Runtime**: asegúrate de que la carpeta dist incluye el runtime de VC++ necesario, para que funcione en sistemas limpios.
->
-> **Si el origen está listo responde 'confirmado'; si no, recompila primero.**"
-
-**Paso 3: generar el código**
-Tras la confirmación, genera el script con **metadatos completos** y el **arreglo del icono de desinstalación**.
-
----
-
-## Compilación extrema con Nuitka
-
-### 1. Estrategia 32 bits vs 64 bits
-
-**Por qué el caso de referencia usó Python de 32 bits:**
-
-| Componente | 64 bits | 32 bits | Ahorro |
-|------------|---------|---------|--------|
-| python3x.dll | ~4.5 MB | ~3.8 MB | 15 % |
-| Qt5Core.dll | ~8 MB | ~5 MB | 37 % |
-| numpy | ~30 MB | ~20 MB | 33 % |
-| **Total** | base | **-20~30 %** | - |
-
-**Condiciones para recomendar 32 bits:**
-- OK: el programa usa < 2 GB de memoria
-- OK: no procesa archivos gigantes (< 2 GB)
-- OK: el usuario objetivo tiene PCs de oficina normales
-
-**Cómo compilar en 32 bits:**
-```bash
-# 1. Instalar Python de 32 bits (puede convivir con el de 64)
-# Descarga: https://www.python.org/downloads/windows/
-
-# 2. Instalar dependencias con el Python de 32 bits
-py -3.12-32 -m pip install -r requirements.txt
-
-# 3. Compilar con el Python de 32 bits
-py -3.12-32 -m nuitka --standalone ...tus-parametros
-```
-
-### 2. Lista de exclusión de módulos (verificada en el caso de referencia)
-
-**Exclusiones seguras** (no se necesitan en runtime):
-```
-unittest,test,pytest,_pytest,doctest,pdb,pdbpp,
-setuptools,pip,distutils,pkg_resources,
-email.mime,http.server,xmlrpc,pydoc
-```
-
-**Efecto esperado**: ahorro de **30-50 MB**
-
-### 3. Optimización específica por framework GUI
-
-#### Tkinter extremo (recomendado, el más ligero)
-```bash
-nuitka --standalone --windows-console-mode=disable ^
-    --lto=yes ^
-    --jobs=8 ^
-    --enable-plugin=tk-inter ^
-    --enable-plugin=anti-bloat ^
-    --noinclude-pytest-mode=nofollow ^
-    --noinclude-setuptools-mode=nofollow ^
-    --nofollow-import-to=unittest,test,pytest,_pytest,doctest,pdb,pdbpp ^
-    --nofollow-import-to=setuptools,pip,distutils,pkg_resources ^
-    --nofollow-import-to=email.mime,http.server,xmlrpc,pydoc ^
-    --python-flag=no_docstrings ^
-    --output-dir=dist ^
-    --windows-icon-from-ico=icon.ico ^
-    --remove-output ^
-    main.py
-```
-
-**Tamaño esperado**: 80-120 MB (optimizado)
-
-#### PyQt5 / PySide2
-```bash
-nuitka --standalone --windows-console-mode=disable ^
-    --lto=yes ^
-    --jobs=8 ^
-    --enable-plugin=pyqt5 ^
-    --enable-plugin=anti-bloat ^
-    --noinclude-pytest-mode=nofollow ^
-    --noinclude-setuptools-mode=nofollow ^
-    --nofollow-import-to=unittest,test,pytest,_pytest,doctest,pdb ^
-    --nofollow-import-to=setuptools,pip,distutils,pkg_resources ^
-    --nofollow-import-to=PyQt5.QtWebEngine,PyQt5.QtWebEngineWidgets ^
-    --nofollow-import-to=PyQt5.Qt3D,PyQt5.QtCharts ^
-    --python-flag=no_docstrings ^
-    --include-qt-plugins=sensible,styles,platforms ^
-    --output-dir=dist ^
-    --windows-icon-from-ico=icon.ico ^
-    --remove-output ^
-    main.py
-```
-
-**Tamaño esperado**: 120-250 MB (optimizado)
-
-### 4. Script de compilación de un clic
-
-**Guardar como `build_optimized.bat` (raíz del proyecto):**
-
-```batch
-@echo off
-chcp 65001 >nul
-setlocal enabledelayedexpansion
-
-echo ========================================
-echo Compilacion Nuitka con optimizacion extrema
-echo ========================================
-
-REM === Zona de configuracion (edita con tus valores reales) ===
-set APP_NAME=TuApp
-set MAIN_FILE=main.py
-set ICON_FILE=icon.ico
-
-REM === Deteccion automatica de nucleos de CPU ===
-REM Usa la variable de entorno de Windows (wmic fue retirado en Win11 22H2+;
-REM si no se detecta, --jobs=0 compilaria en un solo hilo)
-set CPU_CORES=%NUMBER_OF_PROCESSORS%
-if not defined CPU_CORES set CPU_CORES=4
-set /a BUILD_JOBS=%CPU_CORES%
-
-REM === Lista de exclusion de modulos verificada ===
-set EXCLUDE_MODULES=unittest,test,pytest,_pytest,doctest,pdb,pdbpp
-set EXCLUDE_MODULES=%EXCLUDE_MODULES%,setuptools,pip,distutils,pkg_resources
-set EXCLUDE_MODULES=%EXCLUDE_MODULES%,email.mime,http.server,xmlrpc,pydoc
-
-echo.
-echo [1/4] Limpiando compilaciones anteriores...
-if exist dist rd /s /q dist
-if exist build rd /s /q build
-
-echo.
-echo [2/4] Compilando con Nuitka (estrategia de optimizacion aplicada)...
-echo - Nucleos de CPU: %CPU_CORES% (usando %BUILD_JOBS% hilos)
-echo - Modulos excluidos: %EXCLUDE_MODULES%
-echo.
-
-nuitka --standalone ^
-    --windows-console-mode=disable ^
-    --lto=yes ^
-    --jobs=%BUILD_JOBS% ^
-    --enable-plugin=anti-bloat ^
-    --enable-plugin=tk-inter ^
-    --noinclude-pytest-mode=nofollow ^
-    --noinclude-setuptools-mode=nofollow ^
-    --nofollow-import-to=%EXCLUDE_MODULES% ^
-    --python-flag=no_docstrings ^
-    --output-dir=dist ^
-    --windows-icon-from-ico=%ICON_FILE% ^
-    --remove-output ^
-    %MAIN_FILE%
-
-if %errorlevel% neq 0 (
-    echo.
-    echo [ERROR] La compilacion fallo.
-    pause
-    exit /b 1
-)
-
-echo.
-echo [3/4] Midiendo el resultado...
-for /f %%a in ('powershell -NoProfile -Command "(Get-ChildItem -LiteralPath 'dist\%APP_NAME%.dist' -Recurse -File | Measure-Object -Property Length -Sum).Sum"') do set TOTAL_SIZE=%%a
-set TOTAL_SIZE=%TOTAL_SIZE:,=%
-set /a SIZE_MB=%TOTAL_SIZE% / 1048576
-echo - Tamano tras compilar: %SIZE_MB% MB
-
-echo.
-echo [4/4] Ejecutando adelgazamiento del dist...
-powershell -ExecutionPolicy Bypass -File slim_dist.ps1 -DistPath "dist\%APP_NAME%.dist"
-
-echo.
-echo ========================================
-echo Compilacion terminada
-echo ========================================
-pause
-```
-
-### 5. Script de adelgazamiento del dist
-
-**Guardar como `slim_dist.ps1` (junto a build_optimized.bat):**
-
-```powershell
-param(
-    [string]$DistPath
-)
-
-$ErrorActionPreference = "Continue"  # No silenciar errores: un borrado fallido se muestra, evita falsos exitos
-
-Write-Host "`n========================================" -ForegroundColor Cyan
-Write-Host "Adelgazamiento del dist" -ForegroundColor Cyan
-Write-Host "========================================" -ForegroundColor Cyan
-
-if (-not (Test-Path $DistPath)) {
-    Write-Host "[ERROR] No existe el directorio: $DistPath" -ForegroundColor Red
-    exit 1
-}
-
-# Medir tamano inicial
-$InitialSize = (Get-ChildItem -Path $DistPath -Recurse -File | Measure-Object -Property Length -Sum).Sum / 1MB
-Write-Host "`nTamano inicial: $([math]::Round($InitialSize, 2)) MB" -ForegroundColor Yellow
-
-Write-Host "`n[Aplicando estrategia de limpieza...]" -ForegroundColor Green
-
-# 1. Borrar simbolos de depuracion
-Write-Host "`n[1/7] Borrando simbolos .pdb..." -ForegroundColor Green
-$pdbFiles = Get-ChildItem -Path $DistPath -Recurse -Include *.pdb -File
-$pdbSize = ($pdbFiles | Measure-Object -Property Length -Sum).Sum / 1MB
-if ($pdbFiles.Count -gt 0) {
-    $pdbFiles | Remove-Item -Force
-    Write-Host "  Borrados $($pdbFiles.Count) archivos, ahorro de $([math]::Round($pdbSize, 2)) MB"
-} else {
-    Write-Host "  Sin archivos .pdb (ya optimizado)" -ForegroundColor Gray
-}
-
-# 2. Borrar stubs de tipos
-Write-Host "`n[2/7] Borrando stubs .pyi..." -ForegroundColor Green
-$pyiFiles = Get-ChildItem -Path $DistPath -Recurse -Include *.pyi -File
-$pyiSize = ($pyiFiles | Measure-Object -Property Length -Sum).Sum / 1MB
-if ($pyiFiles.Count -gt 0) {
-    $pyiFiles | Remove-Item -Force
-    Write-Host "  Borrados $($pyiFiles.Count) archivos, ahorro de $([math]::Round($pyiSize, 2)) MB"
-} else {
-    Write-Host "  Sin archivos .pyi (ya optimizado)" -ForegroundColor Gray
-}
-
-# 3. Borrar __pycache__
-Write-Host "`n[3/7] Borrando caches __pycache__..." -ForegroundColor Green
-$pycacheDirs = Get-ChildItem -Path $DistPath -Recurse -Directory -Filter "__pycache__"
-$pycacheSize = 0
-foreach ($dir in $pycacheDirs) {
-    $size = (Get-ChildItem -Path $dir.FullName -Recurse -File | Measure-Object -Property Length -Sum).Sum
-    $pycacheSize += $size
-    Remove-Item -Path $dir.FullName -Recurse -Force
-}
-if ($pycacheDirs.Count -gt 0) {
-    Write-Host "  Borrados $($pycacheDirs.Count) directorios, ahorro de $([math]::Round($pycacheSize / 1MB, 2)) MB"
-} else {
-    Write-Host "  Sin __pycache__ (ya optimizado)" -ForegroundColor Gray
-}
-
-# 4. Borrar directorios de tests
-Write-Host "`n[4/7] Borrando directorios test/tests..." -ForegroundColor Green
-$testDirs = Get-ChildItem -Path $DistPath -Recurse -Directory | Where-Object { $_.Name -match '^tests?$' }
-$testSize = 0
-foreach ($dir in $testDirs) {
-    $size = (Get-ChildItem -Path $dir.FullName -Recurse -File | Measure-Object -Property Length -Sum).Sum
-    $testSize += $size
-    Remove-Item -Path $dir.FullName -Recurse -Force
-}
-if ($testDirs.Count -gt 0) {
-    Write-Host "  Borrados $($testDirs.Count) directorios, ahorro de $([math]::Round($testSize / 1MB, 2)) MB"
-} else {
-    Write-Host "  Sin directorios de tests (ya optimizado)" -ForegroundColor Gray
-}
-
-# 5. Borrar documentacion y ejemplos
-Write-Host "`n[5/7] Borrando directorios docs/examples..." -ForegroundColor Green
-$docDirs = Get-ChildItem -Path $DistPath -Recurse -Directory | Where-Object { $_.Name -match '^(docs|examples|samples|demo)$' }
-$docSize = 0
-foreach ($dir in $docDirs) {
-    $size = (Get-ChildItem -Path $dir.FullName -Recurse -File | Measure-Object -Property Length -Sum).Sum
-    $docSize += $size
-    Remove-Item -Path $dir.FullName -Recurse -Force
-}
-if ($docDirs.Count -gt 0) {
-    Write-Host "  Borrados $($docDirs.Count) directorios, ahorro de $([math]::Round($docSize / 1MB, 2)) MB"
-} else {
-    Write-Host "  Sin directorios de documentacion (ya optimizado)" -ForegroundColor Gray
-}
-
-# 6. Borrar archivos .pyc
-Write-Host "`n[6/7] Borrando bytecode .pyc..." -ForegroundColor Green
-$pycFiles = Get-ChildItem -Path $DistPath -Recurse -Include *.pyc -File
-$pycSize = ($pycFiles | Measure-Object -Property Length -Sum).Sum / 1MB
-if ($pycFiles.Count -gt 0) {
-    $pycFiles | Remove-Item -Force
-    Write-Host "  Borrados $($pycFiles.Count) archivos, ahorro de $([math]::Round($pycSize, 2)) MB"
-} else {
-    Write-Host "  Sin archivos .pyc (ya optimizado)" -ForegroundColor Gray
-}
-
-# 7. Recortar metadatos .dist-info
-Write-Host "`n[7/7] Recortando metadatos .dist-info..." -ForegroundColor Green
-$distInfoDirs = Get-ChildItem -Path $DistPath -Recurse -Directory -Filter "*.dist-info"
-$removedCount = 0
-$removedSize = 0
-foreach ($infoDir in $distInfoDirs) {
-    # Borrar solo archivos contables de la instalacion; conservar METADATA y entry_points.txt
-    # (los lee importlib.metadata en runtime; borrarlos rompe el descubrimiento de plugins)
-    $filesToRemove = @("RECORD", "INSTALLER", "direct_url.json")
-    foreach ($fileName in $filesToRemove) {
-        $file = Join-Path $infoDir.FullName $fileName
-        if (Test-Path $file) {
-            $size = (Get-Item $file).Length
-            $removedSize += $size
-            Remove-Item $file -Force
-            $removedCount++
-        }
-    }
-}
-if ($removedCount -gt 0) {
-    Write-Host "  Borrados $removedCount archivos de metadatos, ahorro de $([math]::Round($removedSize / 1MB, 2)) MB"
-} else {
-    Write-Host "  Sin metadatos que limpiar (ya optimizado)" -ForegroundColor Gray
-}
-
-# Medir tamano final
-$FinalSize = (Get-ChildItem -Path $DistPath -Recurse -File | Measure-Object -Property Length -Sum).Sum / 1MB
-$SavedSize = $InitialSize - $FinalSize
-$SavedPercent = if ($InitialSize -gt 0) { ($SavedSize / $InitialSize) * 100 } else { 0 }
-
-Write-Host "`n========================================" -ForegroundColor Cyan
-Write-Host "Limpieza completada" -ForegroundColor Green
-Write-Host "========================================" -ForegroundColor Cyan
-Write-Host "Tamano inicial: $([math]::Round($InitialSize, 2)) MB" -ForegroundColor Yellow
-Write-Host "Tamano final: $([math]::Round($FinalSize, 2)) MB" -ForegroundColor Green
-Write-Host "Espacio ahorrado: $([math]::Round($SavedSize, 2)) MB ($([math]::Round($SavedPercent, 1))%)" -ForegroundColor Cyan
-Write-Host "========================================`n" -ForegroundColor Cyan
-
-Write-Host "[Referencia]" -ForegroundColor Yellow
-Write-Host "Proyecto de referencia: 323 MB (incluye PyQt, OpenCV, Playwright y otras librerias pesadas)" -ForegroundColor Gray
-Write-Host "Si tu proyecto es Tkinter puro + stdlib, el objetivo deberia estar en 80-150 MB" -ForegroundColor Gray
-```
-
-**Efecto esperado**: ahorro del **15-30 %** del tamaño
-
-### 6. Herramienta de análisis de dependencias DLL
-
-**Guardar como `analyze_dlls.py` (para encontrar a los que más pesan):**
-
-```python
-"""
-Herramienta de analisis de dependencias DLL.
-Ayuda a identificar los archivos mas pesados y sugiere optimizaciones.
-"""
-import sys
-from pathlib import Path
-
-def analyze_dlls(dist_path: str):
-    """Analiza las dependencias DLL del directorio dist."""
-    dist_dir = Path(dist_path)
-
-    if not dist_dir.exists():
-        print(f"[ERROR] El directorio no existe: {dist_path}")
-        return
-
-    print("=" * 70)
-    print("Analisis de dependencias DLL")
-    print("=" * 70)
-
-    # Recolectar todas las DLL
-    dll_files = list(dist_dir.rglob("*.dll"))
-
-    if not dll_files:
-        print("\nNo se encontraron archivos DLL")
-        return
-
-    # Ordenar por tamano
-    dll_data = [(dll, dll.stat().st_size) for dll in dll_files]
-    dll_data.sort(key=lambda x: x[1], reverse=True)
-
-    total_size = sum(size for _, size in dll_data)
-
-    print(f"\nTotal de DLL: {len(dll_files)}")
-    print(f"Tamano total de DLL: {total_size / 1024 / 1024:.2f} MB\n")
-
-    # Comparativa con el proyecto de referencia
-    print("[Referencia] DLL del proyecto de referencia:")
-    print("  - Total: 71 archivos")
-    print("  - Tamano: 93.23 MB")
-    print("  - Los mayores: libopenblas (26.85 MB), opengl32sw (15.25 MB)\n")
-
-    # Analizar DLL mayores de 3 MB
-    large_dlls = [(dll, size) for dll, size in dll_data if size > 3 * 1024 * 1024]
-
-    if large_dlls:
-        print("=" * 70)
-        print("ATENCION: DLL mayores de 3 MB (foco principal)")
-        print("=" * 70)
-
-        for dll, size in large_dlls:
-            size_mb = size / 1024 / 1024
-            relative_path = dll.relative_to(dist_dir)
-            name_lower = dll.name.lower()
-
-            print(f"\n{size_mb:8.2f} MB  {dll.name}")
-            print(f"           Ubicacion: {relative_path.parent}")
-
-            # Sugerencias de optimizacion
-            suggestions = get_optimization_suggestion(name_lower)
-            if suggestions:
-                for suggestion in suggestions:
-                    print(f"            {suggestion}")
-
-    # Buscar DLL redundantes
-    print("\n" + "=" * 70)
-    print(" Chequeo de redundancia")
-    print("=" * 70)
-
-    # Versiones de depuracion
-    debug_dlls = [dll for dll, _ in dll_data if dll.stem.endswith('d')]
-    if debug_dlls:
-        print(f"\nATENCION: {len(debug_dlls)} DLL en version debug (se pueden borrar):")
-        for dll in debug_dlls:
-            print(f"  - {dll.name}")
-    else:
-        print("\nOK: sin DLL de depuracion (ya optimizado)")
-
-    # VC++ Runtime
-    vc_runtimes = [dll for dll, _ in dll_data if 'vcruntime' in dll.name.lower() or 'msvcp' in dll.name.lower()]
-    if vc_runtimes:
-        print(f"\n[Runtime de VC++] Encontradas {len(vc_runtimes)}:")
-        for dll in vc_runtimes:
-            size_mb = dll.stat().st_size / 1024 / 1024
-            print(f"  - {dll.name} ({size_mb:.2f} MB)")
-        print("   Son necesarias; el proyecto de referencia tambien las incluye")
-
-    # Listado completo
-    print("\n" + "=" * 70)
-    print(" Listado de DLL (por tamano, top 20)")
-    print("=" * 70)
-    print(f"\n{'Tamano (MB)':>11}  {'Archivo':<30}  Ubicacion")
-    print("-" * 70)
-
-    for dll, size in dll_data[:20]:
-        size_mb = size / 1024 / 1024
-        relative_path = dll.relative_to(dist_dir)
-        location = str(relative_path.parent) if relative_path.parent != Path('.') else "raiz"
-        print(f"{size_mb:11.2f}  {dll.name:<30}  {location}")
-
-    if len(dll_data) > 20:
-        remaining_size = sum(size for _, size in dll_data[20:]) / 1024 / 1024
-        print(f"... y {len(dll_data) - 20} DLL mas, {remaining_size:.2f} MB en total")
-
-
-def get_optimization_suggestion(dll_name: str) -> list:
-    """Devuelve sugerencias de optimizacion segun el nombre de la DLL."""
-    suggestions = []
-
-    if "openblas" in dll_name or "mkl" in dll_name:
-        suggestions.append("Libreria de calculo; en el caso de referencia libopenblas pesaba 26.85 MB")
-        suggestions.append("Si no necesitas computo de alto rendimiento, considera una version ligera")
-
-    elif "opencv" in dll_name or "ffmpeg" in dll_name:
-        suggestions.append("Relacionada con OpenCV; opencv_videoio_ffmpeg pesaba 18.48 MB en la referencia")
-        suggestions.append("Considera opencv-python-headless")
-
-    elif "qt5" in dll_name or "qt6" in dll_name or "pyside" in dll_name:
-        suggestions.append("Libreria Qt; Qt5Core pesaba 5.13 MB en la referencia")
-        suggestions.append("Excluye los modulos que no uses (WebEngine, 3D, Charts)")
-
-    elif "opengl" in dll_name and "sw" in dll_name:
-        suggestions.append("Renderizador OpenGL por software; la referencia conservaba 15.25 MB")
-        suggestions.append("Normalmente se puede borrar (usando renderizado por hardware)")
-
-    elif "d3dcompiler" in dll_name:
-        suggestions.append("Compilador de DirectX; 3.53 MB en la referencia")
-
-    elif "mfc140" in dll_name:
-        suggestions.append("Libreria MFC; 4.89 MB en la referencia")
-
-    return suggestions
-
-
-if __name__ == "__main__":
-    if len(sys.argv) < 2:
-        print("Uso: python analyze_dlls.py <ruta-del-dist>")
-        print("Ejemplo: python analyze_dlls.py dist/main.dist")
-        sys.exit(1)
-
-    analyze_dlls(sys.argv[1])
-```
-
-**Uso:**
-```bash
-python analyze_dlls.py dist/TuApp.dist
-```
-
----
-
-## Flujo de optimización completo
-
-### Paso 1: configurar el script de compilación
-
-Edita `build_optimized.bat` y cambia estas 3 líneas:
-
-```batch
-set APP_NAME=TuApp           REM Cambia por el nombre real
-set MAIN_FILE=main.py        REM Tu archivo principal
-set ICON_FILE=icon.ico       REM Tu icono
-```
-
-### Paso 2: compilar + adelgazar de un clic
-
-```bash
-# En la raiz del proyecto
-build_optimized.bat
-```
-
-### Paso 3: analizar las DLL
-
-```bash
-python analyze_dlls.py dist/TuApp.dist
-```
-
-### Paso 4: optimizar según el análisis
-
-**Si usas OpenCV** → cambia a la versión headless
-```bash
-pip uninstall opencv-python
-pip install opencv-python-headless
-```
-
-**Si usas Qt** → excluye módulos innecesarios
-```batch
-REM Anadir al comando de compilacion
---nofollow-import-to=PyQt5.QtWebEngine,PyQt5.Qt3D,PyQt5.QtCharts
-```
-
-**Borrar el renderizador por software** (si no lo necesitas)
-```powershell
-# En el directorio dist
-Remove-Item "opengl32sw.dll" -Force
-```
-
----
-
-## Gestión del runtime de VC++
-
-### Opción 1: enlace estático (recomendado)
-```bash
-nuitka --static-libpython=yes ...
-```
-
-### Opción 2: incluir el instalador del runtime (recomendado para distribución comercial)
-Añadir al script de Inno Setup:
-
-```iss
-; ATENCION: la arquitectura del runtime de VC++ debe coincidir con la del build de Python/Nuitka.
-; Esta skill recomienda Python de 32 bits, por eso se incluye vc_redist.x86.exe por defecto;
-; si compilas con Python de 64 bits, cambia ambas lineas a vc_redist.x64.exe.
-[Files]
-Source: "{#MySourceDir}\..\vc_redist.x86.exe"; DestDir: "{tmp}"; Flags: deleteafterinstall
-
-[Run]
-Filename: "{tmp}\vc_redist.x86.exe"; Parameters: "/quiet /norestart"; StatusMsg: "Instalando el runtime..."; Flags: waituntilterminated
-```
-
-> Descarga: [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist)
-
----
-
-## Plantilla de script Inno Setup (versión comercial)
-
-```iss
-; =====================================================================
-;  Script de instalacion comercial para Python (Inno Setup 6.x)
-;  Caracteristicas: compresion LZMA2 extrema | metadatos completos |
-;  desinstalacion sin residuos
-; =====================================================================
-
-; --- 1. Definicion de parametros ---
-#define MyAppName        "{{APP_NAME}}"
-#define MyAppVersion     "{{APP_VERSION}}"
-#define MyAppPublisher   "{{PUBLISHER}}"
-#define MyAppURL         "{{APP_URL}}"
-#define MyAppExeName     "{{EXE_NAME}}"
-#define MySourceDir      "{{SOURCE_DIR}}"
-#define MyOutputDir      "{{OUTPUT_DIR}}"
-;#define MyIconPath      "{{ICON_PATH}}"
-
-[Setup]
-; --- Identidad ---
-AppId={{GENERATE_RANDOM_GUID}}
-AppName={#MyAppName}
-AppVersion={#MyAppVersion}
-AppPublisher={#MyAppPublisher}
-AppPublisherURL={#MyAppURL}
-AppSupportURL={#MyAppURL}
-AppUpdatesURL={#MyAppURL}
-
-; --- Ruta de instalacion y permisos ---
-DefaultDirName={autopf}\{#MyAppName}
-DefaultGroupName={#MyAppName}
-DisableDirPage=no
-DisableProgramGroupPage=no
-PrivilegesRequired=admin
-
-; --- Salida ---
-OutputDir={#MyOutputDir}
-OutputBaseFilename=Setup_{#MyAppName}_v{#MyAppVersion}
-
-; --- Experiencia visual ---
-WizardStyle=modern
-#ifdef MyIconPath
-SetupIconFile={#MyIconPath}
-UninstallDisplayIcon={app}\{#MyAppExeName}
-#endif
-
-; --- Compresion (nucleo) ---
-Compression=lzma2/ultra64
-SolidCompression=yes
-LZMAUseSeparateProcess=yes
-
-; --- Arquitectura ---
-; Nota: solo los builds de 64 bits necesitan el modo de instalacion de 64 bits.
-; Esta skill recomienda Python de 32 bits — en builds de 32 bits deja esto comentado,
-; para que la app se instale como 32 bits y coincida con el vc_redist.x86.exe incluido.
-; Descomenta solo si compilas con Python de 64 bits.
-;ArchitecturesInstallIn64BitMode=x64compatible
-
-[Languages]
-Name: "spanish"; MessagesFile: "compiler:Languages\Spanish.isl"
-
-[Files]
-Source: "{#MySourceDir}\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs
-
-[UninstallDelete]
-Type: filesandordirs; Name: "{app}\*"
-
-[Icons]
-Name: "{autodesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"; Tasks: desktopicon
-Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"
-Name: "{group}\Desinstalar {#MyAppName}"; Filename: "{uninstallexe}"
-
-[Tasks]
-Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked
-
-[Run]
-Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#MyAppName}}"; Flags: nowait postinstall skipifsilent
-```
-
----
-
-## Placeholders
-
-| Placeholder | Descripción | Ejemplo |
-|-------------|-------------|---------|
-| `{{APP_NAME}}` | Nombre visible del software | `AnotadorRojo` |
-| `{{APP_VERSION}}` | Versión | `1.0.0` |
-| `{{PUBLISHER}}` | Publicador/Empresa | `MiEmpresa` |
-| `{{APP_URL}}` | URL del sitio | `https://example.com` |
-| `{{EXE_NAME}}` | Nombre del ejecutable principal | `AnotadorRojo.exe` |
-| `{{SOURCE_DIR}}` | Carpeta dist de Nuitka | `D:\proyecto\dist\AnotadorRojo.dist` |
-| `{{OUTPUT_DIR}}` | Ruta de salida del instalador | `D:\proyecto\output` |
-| `{{ICON_PATH}}` | Ruta del icono | `D:\proyecto\icon.ico` |
-| `{{GENERATE_RANDOM_GUID}}` | **Generar un GUID único** | En Inno Setup: "Tools > Generate GUID" |
-
----
-
-## Preguntas frecuentes
-
-### P1: ¿Tras instalar, doble clic y no pasa nada?
-1. Abre CMD y ejecuta el exe a mano para ver el error
-2. Comprueba si falta el runtime de VC++
-3. Comprueba que la compilación de Nuitka terminó bien
-
-### P2: ¿El instalador pesa demasiado?
-**Métodos de optimización:**
-1. Compilar con Python de 32 bits (ahorra 20-30 %)
-2. Aplicar la lista de exclusión de módulos
-3. Activar el plugin anti-bloat
-4. Ejecutar el script de adelgazamiento del dist
-5. Analizar las DLL y eliminar los archivos grandes innecesarios
-
-### P3: ¿Falsos positivos del antivirus?
-**Soluciones:**
-- Enviar el binario a los principales antivirus para solicitar whitelist
-- Comprar un certificado de firma de código (p. ej. Sectigo, DigiCert)
-- Evitar la compresión UPX
-
-### P4: ¿Windows muestra "Windows protegió tu equipo"?
-- Un certificado de firma EV obtiene confianza inmediata
-- Los certificados normales ganan confianza gradualmente con el volumen de instalaciones
-
----
-
-## Registro de problemas reales
-
-- **Tras instalar, falta python3xx.dll**: usar obligatoriamente `--standalone` de Nuitka; confirmar que la dll está en el dist; no empaquetar la versión de un solo archivo.
-- **Tras instalar, clic sin respuesta**: el arranque de la GUI puede bloquearse por dependencias pesadas; diferir sus imports al momento de uso (p. ej. al "exportar"); añadir logs para diagnosticar.
-- **Nuitka + MinGW falla en rutas no ASCII**: copiar el código a un directorio ASCII antes de compilar; fijar `PYTHONIOENCODING=utf-8`.
-- **Inno Setup avisa que `x64` está obsoleto (solo cuando un build de 64 bits necesita modo 64 bits)**: usar `ArchitecturesInstallIn64BitMode=x64compatible`; los builds de 32 bits no lo necesitan.
-- **`--disable-console` está obsoleto**: usar `--windows-console-mode=disable`.
-- **Aparece `_nuitka_temp.exe` en el dist**: excluirlo en la sección [Files].
-
----
-
-## Efecto esperado de las optimizaciones
-
-| Combinación | Reducción de tamaño | Mejora de arranque | Riesgo |
-|-------------|--------------------|--------------------|--------|
-| Compilación básica | base | base | ninguno |
-| + `--lto=yes` | 5-10 % | 10-20 % | OK: ninguno |
-| + anti-bloat | 15-25 % | - | OK: ninguno |
-| + exclusión de módulos | 20-35 % | 5 % | OK: ninguno |
-| + adelgazamiento del dist | 25-40 % | - | OK: ninguno |
-| + compilación 32 bits | 40-60 % | - | OK: ninguno |
-| **Todo combinado** | **45-65 %** | **15-25 %** | OK: **sin riesgo** |
-
-> ATENCIÓN: **no se recomienda la compresión UPX** — aunque reduce más el tamaño, dispara con facilidad falsos positivos de los antivirus.