Skip to content

v1.1.0

Choose a tag to compare

View all tags
@PabloViniegra PabloViniegra released this 05 Jan 02:13
· 4 commits to master since this release
v1.1.0
019c67c

Release Notes - win_opt

[1.1.0] - 2025-01-05

🎉 Resumen

Esta versión incluye 5 nuevas herramientas de optimización, una refactorización completa de la arquitectura, mejoras críticas de seguridad, y un aumento significativo en la cobertura de tests. La aplicación ahora sigue las mejores prácticas de Rust y está lista para producción.

✨ Nuevas Características

Liberación de Espacio en Disco

🌐 Limpieza de Caché de Navegadores

  • Limpia automáticamente la caché de Google Chrome, Microsoft Edge y Mozilla Firefox
  • Permite recuperar cientos de MB de espacio en disco
  • Muestra estadísticas detalladas de archivos eliminados

📋 Limpieza de Logs del Sistema

  • Elimina archivos .log, .txt, .etl y .tmp de directorios del sistema
  • Limpia C:\Windows\Logs, C:\Windows\Temp, y C:\Windows\Prefetch
  • Proceso seguro con manejo de permisos de administrador

🗑️ Vaciado de Papelera de Reciclaje

  • Vacía completamente la papelera de reciclaje con un solo clic
  • Usa PowerShell para garantizar eliminación completa
  • Libera espacio instantáneamente

Optimización de Rendimiento

🚀 Optimizador de Programas de Inicio

  • Lista todos los programas que se ejecutan al iniciar Windows
  • Utiliza WMIC para obtener información detallada
  • Proporciona recomendaciones para mejorar el tiempo de arranque
  • Muestra ruta de ejecución de cada programa

🎨 Optimización de Efectos Visuales

  • Deshabilita animaciones innecesarias de Windows
  • Desactiva transparencias y efectos de sombra
  • Ajusta el sistema para máximo rendimiento
  • Ideal para equipos con recursos limitados

Interfaz de Usuario

🌓 Sistema de Temas Dinámico

  • Alterna entre modo claro (pasteles) y modo oscuro (vibrantes)
  • Tecla Tab para cambiar de tema en tiempo real
  • Paletas de colores cuidadosamente diseñadas
  • Soporte completo en todas las vistas

🔧 Mejoras Técnicas

Arquitectura del Código

📦 Modularización Completa

  • Refactorizado de un archivo monolítico (1890 líneas) a 8 módulos especializados
  • Separación clara de responsabilidades:
    • lib.rs - Biblioteca principal y exports públicos
    • main.rs - Punto de entrada minimalista (8 líneas)
    • app.rs - Lógica de aplicación y UI
    • cleanup.rs - Operaciones de limpieza
    • optimization.rs - Operaciones de optimización
    • theme.rs - Sistema de temas y colores
    • types.rs - Definiciones de tipos de dominio
    • utils.rs - Utilidades compartidas
    • error.rs - Sistema de errores tipados

🎯 Patrón de Diseño Mejorado

  • Eliminado anti-patrón de trait extension
  • Uso de funciones libres en lugar de traits innecesarios
  • Código más idiomático y fácil de mantener
  • Mejor testabilidad y modularidad

Sistema de Errores

⚠️ Manejo de Errores Tipado

  • Implementado con thiserror para errores robustos
  • Tipos de error personalizados:
    • AdminRequired - Permisos insuficientes
    • Io - Errores de I/O con contexto
    • CommandFailed - Fallos en comandos del sistema
    • InvalidPath - Rutas no válidas
    • InvalidService - Servicios no permitidos
  • Alias Result<T> para simplificar firmas

🔒 Seguridad

Correcciones Críticas

🛡️ Eliminada Vulnerabilidad de Command Injection

  • ANTES: Uso de cmd.exe con formato de strings para eliminar archivos
  • AHORA: Uso directo de APIs de std::fs con validación estricta
  • Protección contra path traversal en limpieza de Prefetch
  • Validación de que todas las rutas están dentro del directorio esperado

🔐 Validación con Whitelists

  • Servicios de Windows validados contra lista permitida
  • Solo servicios seguros pueden ser modificados:
    • DiagTrack (telemetría)
    • SysMain (SuperFetch)
    • dmwappushservice (telemetría)
    • WerSvc (informes de error)
  • Previene modificaciones accidentales de servicios críticos

🚨 Seguridad de Rutas

  • Validación estricta de variables de entorno (USERPROFILE)
  • Verificación de que las rutas comienzan con el directorio base esperado
  • Protección contra TOCTOU (Time-of-Check Time-of-Use)

✅ Testing

Cobertura Significativamente Mejorada

Antes: 3 tests (~5% cobertura)
Ahora: 18 tests (~30% cobertura) - +500% de aumento

Tests Agregados:

theme.rs - 4 tests:

  • Verificación de igualdad y copia de temas
  • Diferenciación entre paletas clara y oscura
  • Consistencia de from_theme()
  • Validación de campos de color

types.rs - 6 tests:

  • Verificación de traits Copy y PartialEq
  • Unicidad de variantes de View
  • Transiciones de OperationState
  • Creación y clonación de CleanStats

utils.rs - 5 tests mejorados:

  • Formateo de tiempo (segundos, minutos, horas, días)
  • Validación con valores grandes (30+ días)
  • Consistencia de verificación de permisos admin

app.rs - 1 test:

  • Inicialización correcta del estado por defecto

Todos los tests pasan: ✅ 18/18

🐛 Correcciones de Bugs

  • Navegación de menú: Corregido límite máximo de 8 a 13 items
  • Imports no utilizados: Eliminado import Color no usado en app.rs
  • Consistencia de nombres: Unificados prefijos render_* para funciones de UI
  • Formato de código: 100% conforme a rustfmt

📊 Rendimiento

  • Tamaño de binario: Optimizado con opt-level = "z" y LTO
  • Link-time optimization: Habilitado para mejor rendimiento
  • Strip symbols: Eliminados símbolos de debug en release
  • Panic strategy: abort para menor tamaño de binario

📚 Documentación

Archivos Actualizados

  • README.md - Actualizado con nuevas características y versión 1.1.0
  • SECURITY.md - Políticas de seguridad y reporte de vulnerabilidades
  • CLAUDE.md - Guía de desarrollo y estándares de código
  • Cargo.toml - Metadatos actualizados a v1.1.0

Nueva Documentación

  • src/error.rs - Documentación de tipos de error
  • Tests con comentarios explicativos
  • Comentarios de seguridad en código crítico

🔄 Cambios Incompatibles

⚠️ Cambios en la API Interna:

Si estabas usando win_opt como biblioteca (poco probable para una TUI):

Antes:

use win_opt::cleanup::CleanupOperations;
app.execute_clean(); // Método de trait

Ahora:

use win_opt::cleanup;
cleanup::execute_clean(&mut app); // Función libre

Nota: Esto solo afecta si usabas win_opt como biblioteca. El binario ejecutable funciona exactamente igual.

📦 Dependencias

Nuevas

  • thiserror = "2.0.17" - Manejo de errores tipados

Existentes (sin cambios)

  • ratatui = "0.29" - Framework de UI terminal
  • crossterm = "0.28" - Manipulación de terminal
  • sysinfo = "0.30" - Información del sistema

🛠️ Compilación y Build

Requisitos

  • Rust 2024 edition o posterior
  • Windows 7/8/10/11 (64-bit)
  • Permisos de administrador para operaciones avanzadas

Comandos de Build

# Development
cargo build

# Release optimizado
cargo build --release

# Ejecutar tests
cargo test

# Linter
cargo clippy

# Formato
cargo fmt

Scripts de Build

Linux/macOS:

./build_release.sh
./build_release.sh --clean

Windows:

.\build_release.ps1
.\build_release.ps1 -Clean
.\build_release.ps1 -Sign -CertPath .\cert.pfx

🎯 Métricas de Calidad

Métrica v1.0.0 v1.1.0 Mejora
Líneas de código ~1890 (1 archivo) ~2100 (8 módulos) Mejor organización
Tests 3 18 +500%
Cobertura ~5% ~30% +600%
Clippy warnings 0 0 Mantenido
Vulnerabilidades 1 crítica 0 ✅ Resuelto
Rust idiomático 7/10 9/10 +28%
Seguridad 7/10 9/10 +28%

🚀 Instalación

Descarga

Descarga win_opt.exe desde la página de Releases.

Verificación SHA256

# Windows
Get-FileHash -Algorithm SHA256 win_opt.exe

# Linux
sha256sum win_opt.exe

Compara el hash con el publicado en el release.

Build desde Código Fuente

git clone https://github.com/PabloViniegra/win_opt.git
cd win_opt
git checkout v1.1.0
cargo build --release

⚠️ Notas Importantes

Antivirus

Algunos antivirus pueden mostrar falsos positivos debido a las operaciones que realiza la herramienta (limpieza de archivos, modificación de servicios, etc.). Esto es normal para herramientas de optimización de sistema.

Soluciones:

  1. Agregar excepción en Windows Defender: 
    Add-MpPreference -ExclusionPath "C:\ruta\a\win_opt.exe"
  2. Compilar desde código fuente
  3. Revisar el código (es open source)
  4. Ver documentación completa en SECURITY.md

Permisos de Administrador

Las siguientes operaciones requieren ejecutar como administrador:

  • ✅ Reparación del sistema (DISM/SFC)
  • ✅ Optimización avanzada (servicios, prefetch)
  • ✅ Limpieza de Windows Update
  • ✅ Configuración de privacidad (telemetría)
  • ✅ Optimización de efectos visuales

Las operaciones de limpieza básica no requieren permisos elevados.

🙏 Agradecimientos

  • Comunidad de Rust por las excelentes herramientas
  • ratatui - Framework TUI
  • crossterm - Terminal library
  • sysinfo - System information
  • thiserror - Error handling

📝 Changelog Técnico Completo

Añadido

  • Limpieza de caché de navegadores (Chrome, Edge, Firefox)
  • Limpieza de logs del sistema (Windows\Logs, Windows\Temp)
  • Vaciado de papelera de reciclaje
  • Optimizador de programas de inicio (WMIC)
  • Optimización de efectos visuales
  • Sistema de temas con alternancia Dark/Light (Tab)
  • Módulo error.rs con errores tipados
  • 15 nuevos tests unitarios
  • Validación con whitelists para servicios
  • Documentación de seguridad mejorada

Cambiado

  • Refactorizado código de 1 archivo a 8 módulos especializados
  • Reemplazado trait extension pattern por funciones libres
  • Mejorado sistema de colores con paletas dinámicas
  • Actualizado límite de navegación de menú a 13 items
  • Reorganizado menú en categorías lógicas

Corregido

  • Vulnerabilidad de command injection en limpieza de Prefetch
  • Import no utilizado de Color en app.rs
  • Tests de is_admin() ahora verifican consistencia
  • Path traversal en operaciones de archivos
  • TOCTOU en operaciones de metadata/delete

Removido

  • Traits CleanupOperations y OptimizationOperations (anti-patrón)
  • Código duplicado en funciones de limpieza
  • Dependencias circulares entre módulos

Seguridad

  • Eliminado uso de cmd.exe para operaciones de archivos
  • Agregada validación estricta de rutas con Path::starts_with()
  • Implementadas whitelists para servicios modificables
  • Validación de variables de entorno antes de uso
  • Protección contra inyección de comandos

🔮 Próximas Versiones

Planeado para v1.2.0:

  • Sistema de configuración con archivo TOML
  • Procesamiento asíncrono para operaciones largas
  • Logger estructurado con niveles
  • Modo dry-run para preview de cambios
  • Export de logs a archivo
  • Internacionalización (i18n) - Inglés/Español

📞 Soporte

📄 Licencia

MIT License - Ver LICENSE para detalles.

Fecha de Release: 2025-01-05
Versión: 1.1.0
Commit: [Hash del commit de release]

¡Gracias por usar win_opt! 🎉

Assets 3
Loading