ProxMenux/lang/es/CHANGELOG.md


## 2026-05-31

### Nueva versión ProxMenux v1.2.2 — *Consolidación estable del ciclo v1.2.1.x*

Release estable que lleva al canal principal las cuatro prereleases del ciclo **v1.2.1.x** en un solo movimiento. El trabajo a lo largo de esas cuatro betas se centró en tres temas: hacer del Health Monitor algo realmente configurable en lugar de solo observable (thresholds por categoría, duraciones de dismiss por evento, un audit log de supresiones activas), expandir el stack de notificaciones para cubrir alrededor de 80 servicios a través de Apprise mientras se persisten eventos durante las Quiet Hours, y convertir el propio proceso del Monitor en un ciudadano del sistema más silencioso y predecible en hosts idle. Por encima de eso, esta release entrega detección automática de updates en contenedores LXC, una reescritura end-to-end del instalador de Coral TPU con los últimos drivers upstream, y una larga lista de fixes visibles para el operador — handshake del terminal HTTPS, detección de kernel updates en PVE 9.x, flujo del instalador NVIDIA en Alpine LXC, gestión del audio acompañante en passthrough de GPU mixta, y varias optimizaciones runtime en los bucles de scan del Monitor. Cinco contribuciones de código directas de la comunidad shipean junto con esta release ([@jcastro](https://github.com/jcastro) ×5, [@pespinel](https://github.com/pespinel) ×1) y el trabajo de GPU passthrough lo impulsaron los reports detallados de campo de [@ghosthvj](https://github.com/ghosthvj) — ver los Acknowledgments al final.

---

## 🩺 Health Monitor — Configurable, granular, auditable

Tres piezas acopladas que juntas permiten al operador ajustar el Health Monitor a la envoltura real de su host en lugar de trabajar alrededor de sus defaults, y gestionar dismisses con el mismo control fino que ya tienen sobre el resto del dashboard.

### Thresholds Warning / Critical por categoría

Cada check que corre el Health Monitor está parametrizado por un par de números — un *Warning* y un *Critical* — y ambos están ahora expuestos bajo **Settings → Health Monitor Thresholds**. Los defaults que shipean con ProxMenux son razonables para el host Proxmox medio, pero cada entorno tiene su propia envoltura:

- Un homelab pequeño con un único SSD quiere paginar antes en capacidad (75 / 90 %) para dejar margen a snapshots.
- Un nodo de datacenter con almacenamiento Ceph redundante puede ser mucho más relajado con los warnings de memoria (un working set del 90 % es normal con ZFS ARC).
- Un mini-PC refrigerado pasivamente necesita thresholds de temperatura más bajos que un servidor con refrigeración forzada — misma clase de disco, distinta envoltura física.

Los cambios surten efecto en el siguiente scan — el Health Monitor relee los valores desde `/usr/local/share/proxmenux/health_thresholds.json` en cada ciclo, sin restart del servicio. Los mismos números también alimentan los rangos de color de cada widget del dashboard (barras de almacenamiento, anillos de CPU/memoria, chips de temperatura, el punto del modal de disco), de forma que la clasificación visual en cualquier punto del Monitor mapea a un rango definido respecto al par configurado.

### Duración de dismiss por evento con badge Permanent

El botón *Dismiss* en cada alerta del Health Monitor abre ahora un pequeño dropdown con tres opciones:

- **24 hours** — default anterior, se comporta exactamente como antes
- **7 days** — útil para una condición temporal de la que no quieres oír durante una migración de una semana
- **Permanently** — silencia este `error_key` concreto indefinidamente

Los dismisses permanentes se persisten con `suppression_hours = -1` en la base de datos de persistencia, nunca re-emiten, nunca re-notifican y se marcan con un badge ámbar **Permanent** distinto en el Health Monitor para que el operador siempre sepa qué alertas están silenciadas intencionadamente. La infraestructura backend para el centinela permanente ya existía — solo le faltaba a la UI una forma de fijarlo. El contrato de API es pequeño y backwards-compatible: `POST /api/health/acknowledge` acepta un campo body opcional `suppression_hours` (entero positivo para horas, `-1` para permanente); omitirlo preserva el comportamiento previo y usa la supresión configurada de la categoría. Un segundo endpoint nuevo `POST /api/health/un-acknowledge {error_key}` limpia un acknowledgment previamente registrado para que la alerta vuelva a ser elegible para dispararse — usado por el panel Active Suppressions abajo.

### Panel Active Suppressions en Settings

Una nueva sección dentro de **Settings → Health Monitor**, justo debajo de las duraciones de supresión por categoría, lista cada alerta actualmente silenciada — tanto los dismisses con tiempo limitado (con un badge *22h remaining* / *6d remaining*) como los permanentes (con el badge ámbar *Permanent* del dashboard). Cada fila lleva el `error_key`, la categoría, la severidad, el timestamp en que se registró el dismiss, y un botón **Re-enable** que limpia el acknowledgment server-side. Los re-enables están **encolados** — pulsar el botón marca la fila en verde con texto tachado y cambia el botón a *Undo*, y el `POST /api/health/un-acknowledge` real solo se dispara cuando el usuario pulsa **Save**, de modo que un lote de re-enables se entrega atómicamente junto a cualquier cambio pendiente de dropdown por categoría. La acción está protegida por el toggle de *Edit* del Health Monitor en la parte superior de la card. Los dismisses permanentes **solo pueden revertirse desde aquí** — el dashboard no expone intencionadamente un affordance per-alerta de un-dismiss para evitar re-enables accidentales, por lo que el panel de Settings es la superficie deliberada de auditoría + revert para ellos. La lista también se refresca automáticamente cuando se hace un dismiss de una alerta desde el modal del Health Monitor mientras la página de Settings ya está abierta, vía un evento `health-suppression-changed` del navegador más listeners en `window focus` y `document visibilitychange`.

### Tiers de severidad de Disk I/O

Una ventana deslizante de 24 h clasifica ahora los errores ATA / SCSI de dmesg en tres buckets: silencioso (0–10 eventos transitorios), WARNING (11–100) y CRITICAL (100+, o cualquier error duro como UNC / Buffer I/O / Sense Key Hardware Error). Los días tranquilos se quedan tranquilos, pero un único evento de Buffer I/O sigue paginando inmediatamente.

---

## 📨 Canal de notificación Apprise — Paridad completa de features

La integración Apprise que aterrizó como un adapter básico en 1.2.1.4-beta se ha graduado a paridad completa con los canales nativos. Una sola URL de Apprise llega ahora a alrededor de 80 servicios de notificación (Pushover, ntfy, Slack, Matrix, mailto, signal, Pushbullet, Mattermost, Microsoft Teams vía webhooks, …) sin que ProxMenux necesite un adapter dedicado para cada uno. La pestaña Apprise en Notifications expone los mismos controles que Telegram, Gotify, Discord y Email:

- El bloque **Notification Categories** completo — las mismas 10 categorías con sus sub-toggles por evento, idéntico a los otros canales
- **Quiet Hours** — ventana start/end por canal, con el mismo comportamiento de buffering (los eventos disparados durante la ventana se persisten en SQLite y se liberan como un resumen agrupado cuando la ventana cierra, en lugar de dropearse silenciosamente)
- **Daily Digest** — entrega opt-in de un resumen una vez al día a una hora elegida

El filtrado per-channel del backend ya aplicaba genéricamente a cada canal incluyendo Apprise vía el bloque `channel_overrides` — la UI simplemente no estaba surfaceando los controles.

Tres fixes de fiabilidad shipean junto, todos surfaceados después del rollout beta inicial:

1. **Mobile overflow** en viewports estrechos. La fila de Apprise URL solía romper el diseño — el placeholder empaquetaba cuatro URLs de ejemplo completas en una línea y los `<code>` inline de los ejemplos no tenían regla `break-all`. El placeholder es ahora un único ejemplo conciso (`tgram://bottoken/ChatID`), el wrapper del input URL fuerza `min-w-0 / flex-1 / shrink-0` en sus children, y el párrafo de ejemplos usa `break-all min-w-0` para que envuelva limpiamente a cualquier ancho.

2. **Regresión del whitelist backend** que rechazaba Apprise con HTTP 400. El conjunto de canales hardcodeado del validador de notifications-test (`{telegram, gotify, discord, email, all}`) tenía a `apprise` ausente, por lo que cada test o send de Apprise devolvía `400 Invalid channel` antes de que la librería fuera siquiera invocada. El whitelist se deriva ahora en vivo desde `notification_channels.CHANNEL_TYPES`, de forma que añadir una nueva implementación de canal en el futuro no puede regresionar silenciosamente este validador otra vez.

3. **Error reporting opaco** cuando el destino devolvía una respuesta no-2xx. Cuando un destino (`jsons://`, `ntfy://`, `slack://`, …) rechazaba el payload, el operador solo veía un mensaje genérico *"Apprise rejected the notification (transport failure)"*. El canal captura ahora el logger interno de Apprise durante `notify()` y surfacea el HTTP status code real más el response body del destino (capado a 300 caracteres) — de forma que un beta tester debuggeando un webhook custom puede ver inmediatamente si el servidor upstream está rechazando su schema de payload.

---

## 📦 Detección de updates en LXC

Una nueva sección dedicada en **Settings** (entre *Health Monitor Thresholds* y *Notifications*) con un único toggle que protege el scan per-CT de `apt list --upgradable` / `apk list -u` end-to-end. Default ON. Cuando está OFF el scan para completamente (sin llamadas `pct exec`), cada entrada `type=lxc` se purga inmediatamente del registry de managed-installs, y el toggle de notificación correspondiente en *Notifications → Services* desaparece de la UI mientras preserva su preferencia almacenada.

El checker lee también el `mtime` de la caché de metadata del package-manager de cada CT y dispara `apt-get update` / `apk update` desde fuera vía `pct exec` si tiene más de 24 h, con timeout de 60 s y fallo silencioso. Los CTs appliance long-running cuyas cachés estaban meses obsoletas surfacean por fin su backlog real upstream — un CT Debian 12 con caché de 524 días pasó de "0 updates" a "117 (12 security)" en hardware de lab.

---

## 🐧 Coral TPU en LXC — Últimos drivers upstream

El instalador de Coral para LXC (`scripts/gpu_tpu/install_coral_lxc.sh`) se ha reescrito end-to-end para instalar el **último driver `gasket-dkms` upstream** y el **último runtime `libedgetpu1`** (220 líneas añadidas, 150 eliminadas). Los módulos Coral M.2 / mPCIe que antes fallaban al compilar en kernels PVE 9 ahora instalan y bindean limpiamente. Las notificaciones de update registry-driven que aterrizaron en 1.2.1.2 mantienen ambos paquetes frescos en adelante: la pestaña Hardware + Notifications señalizan cuando feranick/gasket-driver publica una release nueva, y el runtime `libedgetpu1` tracked vía `apt` recibe el flujo estándar de System Updates.

El **path de uninstall del instalador Coral** acompañante también aterriza en este ciclo — espejando el flujo NVIDIA para que una instalación Coral pueda revertirse limpiamente si el usuario re-despliega el host sin aceleración TPU.

---

## ⚡ Optimizaciones de rendimiento del Monitor

Una corrida de strace + sampling de 10 minutos sobre un host live surfaceó tres sitios donde el scanner de background del Monitor estaba spawning subprocesos más agresivamente de lo necesario. Los tres están arreglados en 1.2.2:

### Tormenta de subprocesos fail2ban
En hosts donde `fail2ban-client` no estaba instalado, el wrapper de caché alrededor de `_f2b_get_banned_ips()` solo actualizaba su timestamp en éxito. Cada request HTTP al dashboard caía a través del check de caché y disparaba un `execve("fail2ban-client", ...)` fresco que inmediatamente fallaba con `ENOENT` — 250+ llamadas `execve` fallidas en una ventana de 10 minutos. `shutil.which('fail2ban-client')` se resuelve ahora **una vez** al cargar el módulo y el timestamp de caché se actualiza incondicionalmente. Los hosts sin Fail2Ban tienen ahora cero syscalls de `fail2ban-client` por request.

### Colisión del scheduler de smartctl
El polling de temperatura SMART de discos, la lectura de temperatura CPU y la probe de latency solían dispararse en el mismo offset dentro de cada minuto, produciendo un spike medible de CPU / IO cuando todos sus subprocesos spawneaban juntos. Las polls están ahora staggered (latency primero, luego temperatura CPU, luego SMART de disco) preservando la cadencia per-disco de 60 s — el spike ha desaparecido, el CPU total bajo carga no cambia.

### Subproceso de inventario LXC
El mount monitor solía llamar `lxc-info -n <vmid> -p` por cada CT corriendo solo para obtener su PID init. Ahora lee `/proc/<lxc-start-pid>/task/<lxc-start-pid>/children` directamente y solo cae a `lxc-info` cuando la lectura de `/proc` falla. Un subproceso por CT por ciclo de scan eliminado — medible en hosts con 20+ contenedores.

---

## 🔌 Handshake del terminal HTTPS

Cada modal de terminal en el Monitor (terminal del dashboard, terminal LXC, terminal de scripts) solía fallar con *WebSocket connection error* en hosts donde HTTPS estaba habilitado. La root cause era específica al path `gevent + SSL`: el `WebSocketHandler` de gevent-websocket estaba apilado sobre la implementación de protocolo de flask-sock, por lo que el servidor emitía **dos** cabeceras `HTTP/1.1 101 Switching Protocols` consecutivas y el navegador cerraba la conexión como un frame corrupto. Quitar el argumento explícito `handler_class=WebSocketHandler` restaura una única respuesta 101 y el handshake completa con normalidad. El fix es invisible para operadores corriendo en HTTP plano — no estaban afectados — pero desbloquea cada install fronteada por HTTPS (reverse proxies, deployments con certificate-managed, cualquier cosa detrás de nginx/Traefik).

Adicionalmente, el panel de terminal solía perder su conexión WebSocket cuando el usuario activaba la feature de auto-traducción del navegador (los prompts "translate this page" de Chrome / Edge / Safari). El traductor mueve nodos del DOM que React aún mantiene como refs, y el componente WebSocket React se rompe porque su ref de contenedor apunta a un nodo movido. Añadido `translate="no"` en los divs contenedores del terminal para que el traductor salte el tty embebido por completo — las traducciones en el resto de la página siguen funcionando.

---

## 🐧 Health Monitor — Detección de kernel updates en PVE 9.x (#208)

En hosts Proxmox VE 9.x, la fila *System Updates → Kernel / PVE* reportaba "Kernel/PVE up to date" incluso cuando un update para el kernel corriendo estaba esperando upstream. Tres causas combinadas, tres fixes combinados:

1. **La lista de prefijos de kernel-packages** incluye ahora `proxmox-kernel-*` y `proxmox-firmware-*` — PVE 9.x shipea kernels bajo `proxmox-kernel-`, no el prefijo `pve-kernel-` de 7.x / 8.x. El regex anterior nunca matcheaba los paquetes nuevos y por tanto nunca flagueaba ningún update de kernel en 9.x.

2. **El dry-run cambió de `apt-get upgrade --dry-run` a `apt-get dist-upgrade --dry-run`**. PVE 9 shipea kernel updates empaquetados como instalaciones nuevas (no como upgrades directas de un paquete existente), y el `upgrade --dry-run` plano no considera nuevas instalaciones en absoluto. `dist-upgrade --dry-run` sí.

3. **La detección del kernel corriendo** lee ahora `uname -r` y flaguea un update como *running-kernel update* cuando el paquete matchea la release corriendo exactamente o su meta-package de branch (p. ej. `proxmox-kernel-6.14` para un host en `6.14.11-4-pve`). El texto de la fila distingue *"Running kernel update available (reboot required)"* de *"N kernel update(s) available (none for running kernel)"* para que el operador sepa si necesita reboot o solo instalar.

---

## 🟢 Instalador NVIDIA

Varias mejoras impulsadas por los reports detallados de campo de [@ghosthvj](https://github.com/ghosthvj) sobre configuraciones de GPU mixta (ver Acknowledgments):

- **Ventana de compatibilidad de kernel** — el menú de versiones respeta ahora el rango de drivers compatibles del kernel corriendo, ofreciendo solo branches que no fallarán al compilar contra el kernel del host.
- **Soporte Alpine LXC** — el install de userspace container-side se reescribió para que succeda en hosts Alpine; la detección de espacio libre funciona fiablemente en todos los layouts de almacenamiento (LVM-thin, ZFS, directory, etc).
- **NVENC patch awareness** — cuando el host tiene el patch NVENC aplicado, el menú de versiones se estrecha a drivers soportados por el patch para que reinstalar nunca lo pierda silenciosamente.
- **Feedback de uninstall** — el path de uninstall reporta ahora un mensaje claro de completación en lugar de volver al menú en silencio.

---

## 🌐 Sitio de documentación — Migración i18n completa

El sitio de documentación acompañante (proxmenux.com) shipea ahora bajo URLs prefijadas por locale (`/en/...` y `/es/...`) con la plumbing de next-intl. Cada doc page es bilingüe — 107 páginas traducidas al español (sin placeholders copy-of-English). El root `/` redirige a `/en/` vía meta-refresh + JS para que la URL apex siga resolviendo a algo útil. Los RSS feeds funcionan per-locale en `/en/rss.xml` y `/es/rss.xml`, con el canonical `/rss.xml` conservado para backwards compatibility con suscriptores de feed existentes. La búsqueda client-side está wireada vía **Pagefind** — el índice se construye fresh en cada deploy de CI desde el HTML output final y se descarga fragmentariamente por el cliente, así que la búsqueda funciona sin un servidor backend.

Nuevas páginas de documentación cubren la sección **Active Suppressions** en la pestaña Settings y el **dropdown Dismiss por evento** en el modal del Health Monitor, ambas con capturas reflejando la nueva UI.

---

## 🔧 Otras mejoras

- **Sección AI Enhancement en Notifications** — reescrita de una fila uppercase atenuada que los testers consistentemente scrolleaban sin ver, a un label foreground normal-case con un icono `Sparkles` líder y un badge persistente (verde *Active* cuando IA está habilitada, neutro *Optional* cuando no lo está) para que la feature sea descubrible independientemente del estado.
- **Monitorización de temperatura de discos** — readings mejorados, caching más inteligente entre probes SMART, y un modal de historia rediseñado que abre a 24 h por defecto con estadísticas min / avg / max.
- **Detección de updates de funciones post-install** — el Monitor trackea optimizaciones ProxMenux instaladas (Log2Ram, Memory Settings, System Limits, Logrotate, …) y notifica cuando hay una versión más nueva disponible, con apply one-click desde Settings.
- **Flujo de update de Secure Gateway (Tailscale)** — update one-click de Tailscale desde Settings con indicadores Last-checked / Installed / Latest y notificación cuando se publica una nueva versión.
- **Menú Helper-Scripts** — context más rico e información útil para cada entrada, haciendo más fácil saber qué hace cada script antes de ejecutarlo.
- **Wording de agregación burst** — los resúmenes burst reportan ahora solo los eventos *adicionales* que llegaron después de la alerta individual inicial, de forma que el operador ya no ve el primer evento contado dos veces.
- **Clasificador de errores conocidos** — regex con word-boundary en patrones ATA / UNC para que mensajes de kernel como `nvidia_uvm:FatalError` ya no se clasifiquen mal como problemas de cable ATA.
- **Errores de control de VM / CT** — start / stop / restart fallido surfacea ahora el stderr real de `pvesh` (p. ej. *"no space left on device"*) en el toast de la UI y dispara una notificación `vm_fail` / `ct_fail`, en lugar del bare 500 INTERNAL SERVER ERROR que el operador solía ver.
- **Path de apply de log2ram** — el flujo auto / update reinicia ahora log2ram después de escribir el nuevo size, de forma que un `512M` configurado realmente surte efecto en el tmpfs corriendo sin restart manual.
- **PVE webhook URL** — el webhook de notificación sigue ahora automáticamente el estado SSL activo, cambiando entre `http://` y `https://` cuando toggleas HTTPS en el panel.
- **Cascada de 401 frontend** — la login screen ya no se traga un 401 para siempre tras un estado breve de token rancio; la flag de dedup se limpia al mount y al login exitoso.

---

## 🙏 Acknowledgments

Esta release incluye contribuciones de código directas de la comunidad y una cantidad sustancial de feedback que dio forma al diseño. Particular agradecimiento a:

### Contributors de código

**[@jcastro](https://github.com/jcastro)** entregó cinco mejoras directas que shipean con v1.2.2:

- **Selección de ISOs de VM desde todos los almacenamientos ISO** — nuevo helper compartido `scripts/global/iso_storage_helpers.sh` más integración en `vm_creator.sh`, `select_linux_iso.sh` y `select_windows_iso.sh`. El picker de ISO lee ahora desde cada almacenamiento Proxmox tagueado como ISO content en lugar de estar pinned a `local`. Commit [`092b548d`](https://github.com/MacRimi/ProxMenux/commit/092b548d).
- **Selector de canal de release en Settings** — un menú proper bajo `scripts/menus/config_menu.sh` para flipear entre los canales de install estable y beta in-place, con la gestión correcta de `version.txt` / `beta_version.txt` en cada lado. Commit [`f8a8c43d`](https://github.com/MacRimi/ProxMenux/commit/f8a8c43d).
- **ZFS autotrim en el auto post-install** — `auto_post_install.sh` habilita ahora `autotrim=on` en pools ZFS root por defecto (con el disable correspondiente en el path de uninstall), de forma que installs SSD-backed reclaman espacio liberado sin intervención manual. Commit [`8877f987`](https://github.com/MacRimi/ProxMenux/commit/8877f987).
- **Detección de webhook loopback + handoff de update** — `flask_notification_routes.py` clasifica correctamente webhooks de `127.0.0.1` / `localhost` como loopback, y el handoff de update del script `menu` ya no flackea en edge cases. Commit [`70ab072c`](https://github.com/MacRimi/ProxMenux/commit/70ab072c).
- **Figurine bumped a 2.0.0** — refresh del banner tool en `customizable_post_install.sh`, con la página de docs actualizada para matchear. Commit [`aba94028`](https://github.com/MacRimi/ProxMenux/commit/aba94028).

**[@pespinel](https://github.com/pespinel)** arregló una regresión del beta-installer que rompía los paths de servicio tras el move al nuevo layout runtime — `install_proxmenux_beta.sh` resuelve ahora los paths correctos de la unit systemd en first install y en update. Commit [`0daab74a`](https://github.com/MacRimi/ProxMenux/commit/0daab74a).

### Field reports que dieron forma al trabajo de GPU + Coral

Los reports detallados y sugerencias de **[@ghosthvj](https://github.com/ghosthvj)** sobre el flujo de hardware passthrough impulsaron las mejoras de scripts de GPU en esta release. Los fixes del instalador NVIDIA, el hardening del lifecycle de GPU + audio acompañante en `switch_gpu_mode.sh`, y el checklist de audio-companion iGPU en `add_gpu_vm.sh::detect_optional_gpu_audio` empezaron todos desde sus reports de edge cases que los paths de código previos manejaban pobremente.

### Todos los demás

Un gracias enorme a cada usuario que abrió un issue en GitHub, comentó en [GitHub Discussions](https://github.com/MacRimi/ProxMenux/discussions), reportó un bug en el canal de la comunidad, o pasó a compartir qué funcionaba y qué no en su hardware. **Muchas de las mejoras internas en esta release — el stagger del scheduler de smartctl, el fix de caché de fail2ban, el reemplazo `lxc-info /proc`, el handshake del terminal HTTPS, la detección de kernel-update en PVE 9.x, todo el wiring de Apprise — empezaron como un report de alguien encontrándose con el problema.** Seguid llegando.

---


## 2026-04-20

### Nueva versión ProxMenux v1.2.1 — *SR-IOV Awareness & GPU Passthrough Hardening*

Release puntual sobre **v1.2.0** que aborda tres áreas reportadas por la comunidad y que necesitaban arreglo antes del siguiente ciclo estable: reconocimiento completo de SR-IOV en todo el subsistema GPU/PCI, gestión robusta de los dispositivos de audio acompañantes de la GPU durante el attach y detach de passthrough (Intel iGPU con audio del chipset, tarjetas discretas con audio HDMI, VMs con GPU mixta), y fixes de compatibilidad para los proveedores de notificaciones con IA (endpoints custom OpenAI-compatible tipo LiteLLM/MLX/LM Studio, modelos de razonamiento de OpenAI, y modelos thinking de Gemini 2.5+/3.x). También incluye mejoras de calidad de vida en el instalador NVIDIA, el Monitor de salud de discos, y los helpers de ciclo de vida de LXC usados por los wizards de passthrough.

---

## 🎛️ SR-IOV Awareness en todo el subsistema GPU

Intel `i915-sriov-dkms` y AMD MxGPU dividen la Physical Function (PF) de una GPU en Virtual Functions (VFs) que pueden asignarse de forma independiente a LXCs y VMs. Anteriormente ProxMenux no tenía reconocimiento alguno de SR-IOV: trataba VFs y PFs de manera idéntica, lo que podía reescribir `vfio.conf` con el vendor:device ID de la PF, colapsar el árbol de VFs en el siguiente arranque, y dejar a los usuarios sin poder iniciar sus guests. Se ha auditado y endurecido cada ruta que pudiera alterar un árbol de VFs activo.

### Helpers de detección
- Nuevos `_pci_is_vf`, `_pci_has_active_vfs`, `_pci_sriov_role`, `_pci_sriov_filter_array` en `scripts/global/pci_passthrough_helpers.sh`
- Equivalentes HTTP/JSON en la ruta Flask de GPU — la UI del Monitor lee el estado VF/PF directamente desde sysfs (`physfn`, `sriov_totalvfs`, `sriov_numvfs`, `virtfn*`)

### Pre-start hook (`gpu_hook_guard_helpers.sh`)
El guard pre-start de las VMs ahora reconoce Virtual Functions. Tanto la rama de sintaxis slot-only (que solía iterar todas las funciones del slot y exigir `vfio-pci` en todas) como la rama full-BDF saltan las VFs, de modo que Proxmox puede realizar su rebind vfio-pci por VF con normalidad. El falso bloqueo "GPU passthrough device is not ready" en VMs SR-IOV ha desaparecido.

### Los scripts de mode-switch rechazan operaciones SR-IOV
`switch_gpu_mode.sh`, `switch_gpu_mode_direct.sh`, `add_gpu_vm.sh`, `add_gpu_lxc.sh`, `vm_creator.sh`, `synology.sh`, `zimaos.sh` y `add_controller_nvme_vm.sh` rechazan ahora las VFs y las PFs con VFs activas antes de tocar la configuración del host. Un dialog claro "SR-IOV Configuration Detected" explica la situación. Para los wizards invocados en mitad de flujo (creadores de VM) el mensaje se entrega por `whiptail` para que interrumpa limpiamente, seguido de una línea `msg_warn` por dispositivo para dejar rastro en el log.

### Nuevo estado "SR-IOV active" en la UI del Monitor
La tarjeta GPU de la página Hardware gana un tercer estado visual con un color teal dedicado, una pill in-line `SR-IOV ×N` (o `SR-IOV VF` para una Virtual Function), y ramas LXC y VM en discontinuo/atenuadas. El botón Edit se oculta porque el estado está gestionado por hardware.

![SR-IOV active card and modal](https://raw.githubusercontent.com/MacRimi/ProxMenux/main/images/sriov-indicator.png)

### Modal dashboard para GPUs SR-IOV
Al abrir el modal de una Physical Function con VFs activas se muestra ahora:
- Banner de métricas agregadas ("Metrics below reflect the Physical Function, aggregate across N VFs")
- Telemetría normal en tiempo real de la GPU para la PF
- Una tabla **Virtual Functions**, una fila por VF, con el driver actual (`i915`, `vfio-pci`, unbound) y la VM o LXC específica que la consume, incluyendo el estado running/stopped — los consumidores se descubren cruzando entradas `hostpci` y líneas de mount `/dev/dri/renderDN` contra el BDF de la VF y el nodo DRM render

Al abrir el modal de una Virtual Function se muestran su PF padre (clickable para navegar de vuelta al modal de la PF), el driver actual y el consumidor.

### El popup de VM Conflict Policy ya no se dispara para VFs de SR-IOV
La regex en `detect_affected_vms_for_selected` casaba el slot (`00:02`) contra VMs que tenían una VF (`00:02.1`) asignada, produciendo un dialog confuso "Keep GPU in VM config". Con el gate SR-IOV upstream, el flujo nunca llega a ese camino de código para slots SR-IOV.

---

## 🔊 GPU + Audio Passthrough — Hardening de ciclo de vida completo

Una ronda de fixes en torno a cómo el passthrough de GPU gestiona su dispositivo de audio acompañante. Anteriormente, solo se recogía automáticamente el hermano `.1` de una GPU discreta; el passthrough de iGPU Intel a una VM — donde el audio vive separado en el chipset en `00:1f.3` y no en `00:02.1` — se saltaba silenciosamente. En el detach, el viejo `sed` que limpiaba líneas hostpci por substring de slot también podía eliminar una GPU no relacionada cuyo BDF contuviera el slot buscado como substring (p. ej. el slot `00:02` casando dentro de `0000:02:00.0`). Ambos caminos son ahora robustos.

### Checklist de audio-companion de iGPU en el attach
`add_gpu_vm.sh::detect_optional_gpu_audio` mantiene la fast path de auto-include para el clásico hermano `.1` (NVIDIA / AMD discretas con audio HDMI en la tarjeta). Cuando no existe audio `.1`, el script ahora:
- Escanea sysfs en busca de cada controlador PCI de audio del host
- Salta cualquier cosa ya cubierta por el IOMMU group de la GPU
- Pregunta al usuario mediante un `_pmx_checklist` (`dialog` en modo standalone, `whiptail` en modo wizard llamado desde `vm_creator`/`synology`/`zimaos`) qué controladores de audio pasar junto con la GPU
- Muestra cada entrada con su driver actual en el host (`snd_hda_intel`, `snd_hda_codec_*`, etc.) para que la decisión sea informada
- Por defecto **none** — el usuario opta activamente por incluirlos

### Cascada de audio huérfano en el detach
Cuando el usuario elige "Remove GPU from VM config" durante un mode switch, los scripts hacen ahora un seguimiento con limpieza dirigida:
- `switch_gpu_mode.sh`, `switch_gpu_mode_direct.sh` y `add_gpu_vm.sh::cleanup_vm_config` (limpieza de la VM origen en el flujo "move GPU") llaman todos al helper compartido `_vm_list_orphan_audio_hostpci`
- El helper usa un escaneo en dos pasadas del config de la VM: pasada 1 registra las bases de slot de las entradas hostpci display/3D; pasada 2 clasifica las entradas de audio y **salta cualquier audio cuyo slot aún tenga un hermano display en la misma VM** — protegiendo el audio HDMI de otras dGPUs que queden en la VM
- Antes el simple match por substring habría marcado el `02:00.1` de NVIDIA como huérfano al hacer detach de una iGPU Intel en `00:02.0`
- El flujo interactivo de switch confirma las eliminaciones con un checklist de `dialog` (por defecto ON). La variante web hace auto-remove sin preguntar — el runner no tiene buena forma de renderizar un checklist — y loguea cada BDF que ha tocado

### Extensión de la cascada a vfio.conf
Para cada audio eliminado por la cascada, los scripts de switch-mode comprueban ahora si su BDF sigue referenciado por cualquier otra VM vía `_pci_bdf_in_any_vm`. Si nada más lo usa, el `vendor:device` se añade a `SELECTED_IOMMU_IDS` antes de que se ejecute el update de `/etc/modprobe.d/vfio.conf`. Eso cierra el bucle para el caso de la iGPU Intel: `8086:51c8` (PCH HD Audio) se retira ahora de `vfio.conf` junto con `8086:46a3` (iGPU) cuando ambos salen del modo VM y ninguna otra VM los referencia. Si otra VM aún usa el audio, el ID se conserva deliberadamente — sin efectos secundarios rompedores sobre otras VMs. `add_gpu_vm.sh` NO extiende la limpieza en el flujo *move*, porque la GPU sigue en uso en otro sitio y sus IDs deben permanecer.

### Regex precisa de eliminación de hostpci
Cada `sed` inline usado para hacer detach de una GPU del config de una VM casaba antes el slot como substring libre:
```
/^hostpci[0-9]+:.*${slot}/d
```
Para `slot=00:02` ese patrón casa la substring dentro de `0000:02:00.0` (una dGPU NVIDIA no relacionada en el slot `02:00`) y borraría ambas tarjetas. El fix ancla el match a la forma BDF real:
```
/^hostpci[0-9]+:[[:space:]]*(0000:)?${slot}\.[0-7]([,[:space:]]|$)/d
```
Aplicado en `switch_gpu_mode.sh`, `switch_gpu_mode_direct.sh` y `add_gpu_vm.sh::cleanup_vm_config`. El helper basado en awk en `vm_storage_helpers.sh::_remove_pci_slot_from_vm_config` (usado por los wizards NVMe) ya usaba el patrón correcto y no necesitó cambios.

---

## 🤖 Compatibilidad de proveedores de IA — OpenAI-Compatible, modelos Reasoning y Thinking

Tres fixes coordinados que desbloquean categorías de modelos previamente rechazadas por el pipeline de mejora de notificaciones.

### Endpoints OpenAI-compatible
LiteLLM, MLX, LM Studio, vLLM, LocalAI, Ollama-proxy — el `list_models()` del proveedor exigía antes `"gpt"` en cada nombre de modelo, así que los setups locales sirviendo `mlx-community/...`, `Qwen3-...`, `mistralai/...` veían una lista de modelos vacía. Cuando se establece una Custom Base URL, la comprobación de substring `"gpt"` se omite ahora y `EXCLUDED_PATTERNS` (embeddings, whisper, tts, dall-e) es el único filtro. La capa de ruta Flask también deja de intersectar el resultado contra `verified_ai_models.json` para endpoints custom — la lista verificada solo describe los IDs oficiales de modelo de OpenAI y estaba borrando cada modelo local que el usuario realmente servía.

### Modelos reasoning de OpenAI
`o1`, `o3`, `o3-mini`, `o4-mini`, `gpt-5`, `gpt-5-mini`, `gpt-5.1`, `gpt-5.2-pro`, `gpt-5.4-nano`, etc. (excluyendo las variantes `*-chat-latest`) usan un contrato API más estricto: `max_completion_tokens` en lugar de `max_tokens`, sin `temperature`. Enviar los parámetros clásicos de chat producía HTTP 400 Bad Request para todos ellos. Un detector en `openai_provider.py` bifurca ahora el payload en consecuencia y establece `reasoning_effort: "minimal"` — por defecto estos modelos gastan su presupuesto de output en razonamiento interno y devuelven una respuesta vacía para la breve petición de traducción de notificación.

### Modelos thinking de Gemini 2.5+ / 3.x
`gemini-2.5-flash`, `2.5-pro`, `gemini-3-pro-preview`, `gemini-3.1-pro-preview`, etc. tienen "thinking" interno activado por defecto. Con el pequeño presupuesto de tokens usado para el enriquecimiento de notificaciones (≤250 tokens), el presupuesto de thinking consumía toda la asignación y el modelo devolvía output vacío con `finishReason: MAX_TOKENS`. `gemini_provider.py` establece ahora `thinkingConfig.thinkingBudget: 0` para variantes no-`lite` de 2.5+ y 3.x, de modo que los tokens disponibles van a la respuesta visible al usuario. Las variantes lite (sin thinking activado) quedan intactas.

---

## 📋 Refresh de Verified AI Models

`AppImage/config/verified_ai_models.json` refrescado para los proveedores re-testeados contra APIs en vivo. La nueva herramienta privada de mantenimiento (mantenida fuera de la AppImage) re-ejecuta un test estandarizado de translate+explain contra cada modelo que anuncia cada proveedor, clasifica pass / warn / fail, e imprime un snippet JSON listo para pegar. Re-ejecutar antes de cada release de ProxMenux para mantener la lista al día.

| Provider | New recommended | Notes |
|----------|-----------------|-------|
| **OpenAI** | `gpt-4.1-nano` | `gpt-4.1-nano`, `gpt-4.1-mini`, `gpt-4o-mini`, `gpt-4.1`, `gpt-4o`, `gpt-5-chat-latest`, más `gpt-5.4-nano` / `gpt-5.4-mini` desde 2026-03. Snapshots con fecha y modelos legacy excluidos. Modelos reasoning soportados por el código pero no listados por defecto — más lentos / más caros sin mejorar la calidad de las notificaciones |
| **Gemini** | `gemini-2.5-flash-lite` | `gemini-2.5-flash-lite`, `gemini-2.5-flash` (funciona ahora), `gemini-3-flash-preview`. Aliases `latest` omitidos intencionadamente — resolvían a modelos distintos entre ejecuciones y producían timeouts en algunas regiones. Las variantes Pro rechazan `thinkingBudget=0` y son excesivas para traducción de notificaciones |
| Groq / Anthropic / OpenRouter | *sin cambios* | Marcados con un `_note` — se re-verificarán en cuanto haya keys disponibles |

---

## 🩺 Monitor de salud de discos — Persistencia de observaciones en el journal watcher

Un bug latente en `notification_events.py::_check_disk_io` hacía que los errores de I/O del kernel en tiempo real capturados por el journal watcher se superficiaran como notificaciones pero nunca se escribieran en la tabla permanente de observaciones por disco. En la práctica el escaneo paralelo periódico de dmesg solía registrar la observación poco después, pero bajo casos límite de timing (ventana de dmesg obsoleta, restart de servicio justo después del error, rotación de buffer) la observación podía perderse.

El journal watcher registra ahora la observación antes del gate de cooldown de notificación de 24h, usando la misma clasificación de signature por familia (`io_<disk>_ata_connection_error`, `io_<disk>_block_io_error`, `io_<disk>_ata_failed_command`) que el escaneo periódico. Ambos caminos deduplican ahora en la misma fila vía el UPSERT en `record_disk_observation`, de modo que los conteos de ocurrencias son precisos sin importar qué detector disparó primero.

---

## 🔧 Pulido del instalador NVIDIA

### Race condition de `lsmod` silenciada
Durante la reinstalación, la verificación de unload de módulos en `unload_nvidia_modules` producía errores espurios `lsmod: ERROR: could not open '/sys/module/nvidia_uvm/holders'` porque `lsmod` lee `/proc/modules` y luego abre el directorio `holders/` de cada módulo, que desaparece transitoriamente mientras el módulo está siendo eliminado. La comprobación lee ahora `/proc/modules` directamente e inserta sleeps cortos para dejar que el kernel finalice el unload antes de re-verificar. Aplicado en el mismo espíritu a los otros cuatro call sites de `lsmod` en el script.

### Dialog → whiptail en el flujo de update LXC
El mensaje "Insufficient Disk Space" en `update_lxc_nvidia` y la confirmación "Update NVIDIA in LXC Containers" usan ahora dialogs estilo `whiptail` consistentes con el resto del messaging in-flow, evitando la rotura visual que `dialog --msgbox` causaba al renderizarse en mitad de la secuencia en la fase de update de contenedores.

---

## 🧵 Helper de ciclo de vida LXC — Stop seguro con timeout

Un `pct stop` simple puede colgarse indefinidamente cuando el contenedor tiene un lock obsoleto de una operación abortada previa, cuando los procesos de dentro (Plex, Jellyfin, bases de datos) ignoran TERM y caen en uninterruptible-sleep mientras la GPU que estaban usando es arrancada, o cuando `pct shutdown --timeout` no es respetado por pct mismo. Reportes de campo de esperas de 5+ min durante mode switches de GPU hicieron de esto un peligro real de UX.

Nuevo helper compartido `_pmx_stop_lxc <ctid> [log_file]` en `pci_passthrough_helpers.sh`:
1. Devuelve 0 inmediatamente si el contenedor no está corriendo
2. `pct unlock` best-effort (silencioso ante fallo) — la mayoría de contenedores no están realmente bloqueados; solo nos importan los casos en que lo están
3. `pct shutdown --forceStop 1 --timeout 30` envuelto en un `timeout 45` externo para no esperar nunca más que eso a la fase graceful, incluso si pct se atasca en I/O del backend
4. Verifica el estado real vía `pct status` — pct puede devolver no-cero mientras el contenedor está de hecho parado
5. Si sigue corriendo, `pct stop` envuelto en `timeout 60`. Verificar de nuevo
6. Devuelve 1 solo si el contenedor está realmente atascado tras ~107 s totales — el wizard continúa en lugar de colgarse

Cableado en las tres rutas de modo GPU que paran LXCs durante un switch: `switch_gpu_mode.sh`, `switch_gpu_mode_direct.sh`, y `add_gpu_vm.sh::cleanup_lxc_configs`.

---

## ⚙️ Estabilidad del prompt de reboot en `add_gpu_vm.sh`

El prompt final "Reboot Required" del wizard de asignación GPU-a-VM estaba disparando reboots espurios en ciertas invocaciones de cadena de menú (`menu` → `main_menu` → `hw_grafics_menu` → `add_gpu_vm`). Con el helper `_pmx_yesno` a veces devolvía exit 0 sin que el usuario hubiera confirmado realmente, llamando `reboot` de inmediato. Con un `read` simple en su lugar el proceso quedaba suspendido por SIGTTIN cuando la cadena de menú desligaba el script del grupo de proceso foreground del terminal, dejando `[N]+ Stopped menu` en el shell padre sin posibilidad de responder.

El prompt usa ahora `whiptail --yesno` invocado directamente (el patrón verificado para funcionar de forma fiable en esa cadena de menú) e inserta una pausa `Press Enter to continue ... read -r` entre la respuesta "Yes" y la llamada real a `reboot` — de modo que un Enter accidental en el botón de confirmar no puede disparar un reboot inmediato sin un paso de confirmación visible primero.

---

### 🙏 Gracias

Gracias a los usuarios que reportaron los casos de SR-IOV, LiteLLM/MLX y GPU + audio — estas mejoras existen gracias a reportes detallados y reproducibles. No dudéis en seguir reportando issues o sugiriendo mejoras 🙌.

---


## 2026-04-17

### Nueva versión ProxMenux v1.2.0 — *AI-Enhanced Monitoring*


![ProxMenux AI](https://raw.githubusercontent.com/MacRimi/ProxMenux/main/images/ProxMenux_ai.png)

Esta release es la culminación del ciclo beta v1.1.9.1 → v1.1.9.6 e introduce la mayor evolución de **ProxMenux Monitor** hasta la fecha: notificaciones mejoradas con IA, un sistema de notificaciones multicanal rediseñado, una experiencia de hardware y almacenamiento totalmente reelaborada, y mejoras amplias de rendimiento en todo el stack de monitorización. También consolida todo el trabajo reciente en los scripts de Storage, Hardware y GPU/TPU.

---

## 🤖 ProxMenux Monitor — Notificaciones mejoradas con IA

Las notificaciones pueden mejorarse ahora usando IA para generar mensajes claros y contextuales en lugar del output técnico crudo.

Ejemplo — en lugar de `backup completed exitcode=0 size=2.3GB`, la IA produce: *"The web server backup completed successfully. Size: 2.3GB"*.

### Lo que hace la IA
- Transforma notificaciones técnicas en mensajes legibles
- Traduce a tu idioma preferido
- Te deja elegir el nivel de detalle: minimal, standard o detailed
- Funciona con Telegram, Discord, Email, Pushover y Webhooks

### Lo que la IA NO hace
- **No** es un chatbot ni un asistente
- **No** analiza tu sistema ni toma decisiones
- **No** tiene acceso a datos más allá de la notificación que está procesando
- **No** ejecuta comandos ni modifica el servidor
- **No** almacena historial ni aprende de tus datos

### Soporte multi-proveedor
Elige entre 6 proveedores de IA, cada uno con su propia API key almacenada de forma independiente:
- **Groq** — inferencia rápida, free tier generoso
- **Google Gemini** — excelente relación calidad/precio, free tier disponible
- **OpenAI** — estándar de la industria
- **Anthropic Claude** — excelente para escritura y traducción
- **OpenRouter** — 300+ modelos con una sola API key
- **Ollama** — ejecución 100% local, sin internet

### Verified AI Models
Una lista curada de modelos (`verified_ai_models.json`) testeada específicamente para mejora de notificaciones.

- **Verificación híbrida**: el sistema obtiene los modelos del lado del proveedor y filtra para mostrar solo los testeados que funcionan correctamente
- **Memoria de modelo por proveedor**: el modelo seleccionado se guarda por proveedor, de modo que cambiar de proveedor preserva cada elección
- **Verificación diaria**: una tarea en background comprueba la disponibilidad de modelos y migra automáticamente a una alternativa verificada si el modelo actual desaparece
- **Modelos incompatibles excluidos**: Whisper, TTS, image/video, embeddings, guard models, etc. se filtran por proveedor

| Provider | Recommended | Also Verified |
|----------|-------------|---------------|
| Gemini | gemini-2.5-flash-lite | gemini-flash-lite-latest |
| OpenAI | gpt-4o-mini | gpt-4.1-mini |
| Groq | llama-3.3-70b-versatile | llama-3.1-70b-versatile, llama-3.1-8b-instant, llama3-70b-8192, llama3-8b-8192, mixtral-8x7b-32768, gemma2-9b-it |
| Anthropic | claude-3-5-haiku-latest | claude-3-5-sonnet-latest, claude-3-opus-latest |
| OpenRouter | meta-llama/llama-3.3-70b-instruct | meta-llama/llama-3.1-70b-instruct, anthropic/claude-3.5-haiku, google/gemini-flash-2.5-flash-lite, openai/gpt-4o-mini, mistralai/mixtral-8x7b-instruct |
| Ollama | (todos los modelos locales) | Sin filtrado — muestra todos los modelos instalados |

### Custom AI Prompts
Los usuarios avanzados pueden definir su propio prompt para tener control total sobre el formato y la traducción.

- **Selector de Prompt Mode** — Default Prompt o Custom Prompt
- **Export / Import** — guarda y comparte prompts custom entre instalaciones
- **Example Template** — punto de partida para construir tu propio prompt
- **Community Prompts** — enlace directo a GitHub Discussions para compartir plantillas
- El selector de idioma se oculta en modo Custom Prompt (defines el idioma de salida en el propio prompt)

### Contexto enriquecido
- El **uptime** del sistema se incluye solo para eventos de error/warning (no informativos) — ayuda a distinguir errores de arranque vs runtime
- Tracking de **frecuencia de eventos** — indica problemas recurrentes vs puntuales
- Datos de **SMART disk health** pasados para errores relacionados con discos
- La base de datos de **errores conocidos de Proxmox** mejora la precisión del diagnóstico
- Instrucciones de prompt más claras para prevenir alucinaciones de la IA

---

## 📨 Rediseño del sistema de notificaciones

- **Arquitectura multicanal** — canales Telegram, Discord, Pushover, Email y Webhook corriendo simultáneamente
- **Configuración por evento** — habilita/deshabilita tipos de evento específicos por canal
- **Channel Overrides** — personaliza el comportamiento de notificación por canal
- **Endpoint webhook seguro** — sistemas externos pueden enviar notificaciones autenticadas
- **Almacenamiento cifrado** — API keys y datos sensibles guardados cifrados
- **Procesamiento basado en cola** — worker en background con reintento automático para notificaciones fallidas
- **Almacenamiento de config basado en SQLite** — reemplaza el config basado en ficheros para mayor fiabilidad

### Soporte de Telegram Topics
Envía notificaciones a un topic específico dentro de grupos con Topics habilitado.
- Nuevo campo **Topic ID** en el canal Telegram
- Detección automática de grupos con topics habilitados
- Totalmente retrocompatible

### Notificaciones de update de ProxMenux
El Monitor detecta ahora cuándo se publica una nueva versión de ProxMenux.
- **Doble canal** — monitoriza tanto stable (`version.txt`) como beta (`beta_version.txt`)
- **Integración con GitHub** — compara versiones locales vs remotas
- **Dashboard Update Indicator** — el logo de ProxMenux cambia a una variante de update cuando se detecta una nueva versión (no intrusivo, sin popups)
- **Estado persistente** — el estado se guarda en `config.json`, reseteado por los scripts de update
- Un único toggle en Settings controla ambos canales (habilitado por defecto)

---

## 🖥️ Panel de Hardware — Detección ampliada

La página Hardware se ha ampliado significativamente, con mejor detección y detalle por dispositivo más rico.

- **Controladoras SCSI / SAS / RAID** — modelo, driver y slot PCI mostrados en la sección de storage controllers
- **Detección de PCIe Link Speed** — los drives NVMe muestran la velocidad de link actual (generación PCIe y ancho de carriles), facilitando detectar drives que rinden por debajo por ancho de banda limitado del slot
- **Modal de detalle de disco mejorado** — los drives NVMe, SATA, SAS y USB exponen ahora sus campos específicos (info de link PCIe, versión/velocidad SAS, tipo de interfaz) en lugar de una vista genérica
- **Reconocimiento más inteligente de tipo de disco** — etiquetado uniforme para NVMe SSDs, SATA SSDs, HDDs y discos extraíbles
- **Caching de Hardware Info** (`lspci`, `lspci -vmm`) — la caché de 5 min evita escaneos repetidos de datos que no cambian

---

## 💽 Storage Overview — Salud, observaciones, exclusiones

El Storage Overview se ha reelaborado en torno al estado en tiempo real y al tracking controlado por el usuario.

### Alineación del estado de salud de disco
- Los badges reflejan ahora el estado **actual** SMART reportado por Proxmox, no un peor histórico
- **Observaciones preservadas** — los hallazgos históricos siguen accesibles vía el badge "X obs."
- **Recuperación automática** — cuando SMART reporta healthy de nuevo, el disco muestra inmediatamente **Healthy**
- Eliminado el viejo tracking `worst_health` que requería limpieza manual

### Mejoras del registro de discos
- **Lookup inteligente por serial** — cuando un serial es desconocido el sistema comprueba si existe una entrada con serial antes de insertar una nueva
- **Sin duplicados** — previene entradas separadas para el mismo disco apareciendo con/sin serial
- **Soporte de discos USB** — gestiona drives USB que pueden aparecer bajo nombres de dispositivo distintos entre reboots

### Exclusiones de Storage e interfaces de Red
- Sección **Storage Exclusions** — excluye drives de la monitorización de salud y notificaciones
- **Network Interface Exclusions** — nueva sección para excluir interfaces (bridges `vmbr`, bonds, NICs físicas, VLANs) de salud y notificaciones; ideal para interfaces deshabilitadas intencionadamente que de otro modo generarían falsas alertas
- **Toggles separados** por ítem para Health monitoring y Notifications

### Robustez en la detección de discos
- **Validación de Power-On-Hours** — detecta y corrige valores absurdamente grandes (miles de millones de horas) en drives con codificación SMART no estándar
- **Bit masking inteligente** — extrae el valor correcto de drives que empaquetan info extra en bytes altos
- **Fallback elegante** — muestra "N/A" en lugar de números imposibles cuando los datos no pueden parsearse

---

## 🧠 Monitor de salud y ciclo de vida de errores

### Limpieza de errores obsoletos
Los errores de recursos que ya no existen se resuelven ahora automáticamente.
- **VMs / CTs eliminadas** — los errores relacionados se auto-resuelven cuando se elimina el recurso
- **Discos retirados** — los errores de drives USB desconectados o hot-swap se limpian
- **Cambios de cluster** — los errores de cluster se limpian cuando un nodo abandona el cluster
- **Patrones de log** — los errores basados en logs se auto-resuelven tras 48 horas sin recurrencia
- **Updates de seguridad** — las notificaciones de update se auto-resuelven tras 7 días

### Sistema de migración de base de datos
- **Detección automática de columnas** — las columnas faltantes se añaden en el arranque
- **Compatibilidad de schema** — funciona tanto con convenciones de nombrado de columna antiguas como nuevas
- **Retrocompatible** — se soportan bases de datos de versiones anteriores de ProxMenux
- **Migración elegante** — sin pérdida de datos durante updates de schema

---

## 🧩 Modal de detalle VM / CT

El modal de detalle VM/CT se ha rediseñado por completo para mejorar la usabilidad.

- **Navegación con tabs** — *Overview* (información general, estado, uso de recursos) y *Backups* (historial dedicado)
- **Mejoras visuales** — iconos en todo, jerarquía y espaciado mejorados, mejor distinción VM vs CT
- **Adaptación a móvil** — se adapta correctamente a pantallas móviles tanto en webapp como en acceso directo por navegador, sin más overflow en dispositivos pequeños
- **Controles touch-friendly** — botones y espaciado mayores

### Modal de Secure Gateway
- **Lista de storage con scroll** cuando hay muchos destinos disponibles
- Layout adaptado a móvil y jerarquía visual mejorada

### Conexión de terminal
- **Fix de bucle de reconexión** que afectaba a dispositivos móviles
- Manejo mejorado de WebSocket para navegadores móviles
- Recuperación más elegante de timeouts de conexión

### Gestión de Fail2ban y Lynis
- **Botones de delete** añadidos en Settings para ambas herramientas
- Eliminación limpia de paquetes y ficheros de configuración
- Dialog de confirmación para prevenir borrado accidental

---

## ⚡ Optimizaciones de rendimiento

Reducción importante de uso de CPU y eliminación de picos en el Monitor.

### Intervalos de polling escalonados
Los collectors corren ahora en schedules con offset para prevenir ejecución simultánea:

| Collector | Schedule |
|-----------|----------|
| CPU sampling | Cada 30s en offset 0 |
| Temperature sampling | Cada 15s en offset 7s |
| Latency pings | Cada 60s en offset 25s |
| Temperature record | Cada 60s en offset 40s |
| Health collector | Arranca en offset 55s |
| Notification polling | Health=10s, Updates=30s, ProxMenux=45s, AI=50s |

### Información de sistema cacheada
Los comandos costosos se cachean ahora para reducir ejecución repetida:

| Command | Cache TTL | Impact |
|---------|-----------|--------|
| `pveversion` | 6 horas | Elimina picos de CPU del 23%+ por ejecución de Perl |
| `apt list --upgradable` | 6 horas | Reduce consultas del gestor de paquetes |
| `pvesh get /cluster/resources` | 30 segundos | 6 llamadas API por request reducidas a 1 |
| `sensors` | 10 segundos | Lecturas de temperatura cacheadas entre polls |
| `smartctl` (SMART health) | 30 minutos | Health checks de disco reducidos desde cada 5 min |
| `lspci` / `lspci -vmm` | 5 minutos | Info de hardware cacheada (no cambia) |
| `journalctl --since 24h` | 1 hora | Conteo de intentos de login cacheado (92% de reducción) |

### Timeouts de journalctl aumentados
Previene cascadas de timeout bajo carga del sistema:

| Query Type | Before | After |
|------------|--------|-------|
| Short-term (3-10 min) | 3s | 10s |
| Medium-term (1 hour) | 5s | 15s |
| Long-term (24 hours) | 5s | 20s |

### Frecuencia de polling reducida
- Intervalo de `TaskWatcher` subido de **2s → 5s** (60% menos comprobaciones)

### GitHub Actions
- Todas las actions de workflow actualizadas a **v6** para compatibilidad con Node.js 24
- Warnings de deprecación eliminados en CI/CD

---

## 🧰 Scripts — Trabajo en Storage, Hardware y GPU/TPU

Esta release también consolida trabajo significativo en los scripts core de ProxMenux.

### Scripts de Storage
- **Tests SMART programados** y flujo interactivo de test SMART mejorado con feedback de progreso más claro
- Reelaboración de **formateo de disco** (`format-disk.sh`) con selección de dispositivo más segura y flujo de dialog
- **Disk passthrough** para VMs y CTs — enumeración de dispositivos actualizada, identificación basada en serial, y teardown más limpio
- **Adición de controladora NVMe para VMs** — selección de tipo de controladora y detección de slot mejoradas
- **Import disk image** — validación de path más suave y reporte de progreso
- Refresh de la guía manual de **Disk & storage**

### Scripts de Hardware / GPU / TPU
- **Coral TPU installer** actualizado para kernels y udev rules actuales (Proxmox VE 8 & VE 9)
- **NVIDIA installer** — instalación de driver más limpia, manejo de kernel headers, y flujo de attachment VM/LXC
- **GPU mode switch** (variantes directa e interactiva) — switching más seguro entre modos iGPU
- **Add GPU to VM / LXC** — dialogs de selección unificados y gestión de permisos
- **Herramientas de GPU Intel / AMD** mantenidas en sync con los nuevos patrones compartidos
- **Hardware & graphics menu** reestructurado para consistencia con el resto de ProxMenux


## 2026-03-14

### Nueva versión v1.1.9 — *Helper Scripts Catalog Rebuilt*

### Cambiado

- **Helper Scripts Menu — Reconstrucción completa del catálogo**
  El catálogo de Helper Scripts se ha reconstruido por completo para adaptarse a la nueva arquitectura de datos del proyecto [Community Scripts](https://community-scripts.github.io/ProxmoxVE/).

  La implementación previa dependía de un fichero `metadata.json` que ya no existe en el repositorio upstream. El catálogo conecta ahora directamente a la **API de PocketBase** (`db.community-scripts.org`), que es la nueva fuente de datos oficial del proyecto.

  Un nuevo workflow de GitHub Actions genera un índice local `helpers_cache.json` que reemplaza la antigua dependencia de metadata. Esta nueva caché es más rica, más estructurada, e incluye:
  - Tipo de script, slug, descripción, notas y credenciales por defecto
  - Variantes de OS por script (p. ej. Debian, Alpine) — cada una mostrada como una opción seleccionable separada en el menú
  - URL directa de GitHub y **URL Mirror** (`git.community-scripts.org`) para cada script
  - Nombres de categoría embebidos directamente en la caché — sin necesidad de requests externos para construir el menú
  - Metadata adicional: puerto por defecto, website, logo, soporte de update, disponibilidad ARM

  Los scripts que soportan múltiples variantes de OS (p. ej. Docker con Alpine y Debian) muestran ahora correctamente **una entrada por OS**, cada una con su propia opción de descarga GitHub y Mirror — restaurando el comportamiento que existía antes de la migración upstream.

---

### 🎖 Reconocimiento especial

Esta actualización no habría sido posible sin la apertura y colaboración de los mantenedores de **Community Scripts**.

Cuando la estructura de metadata upstream cambió y rompió el catálogo de ProxMenux, los mantenedores respondieron rápidamente, explicaron la nueva arquitectura en detalle y proporcionaron toda la información necesaria para reconstruir la integración limpiamente.

Agradecimientos especiales a:

- **MickLeskCanbiZ ([@MickLesk](https://github.com/MickLesk))** — por documentar la nueva estructura de path de scripts por tipo y slug, y por la guía técnica clara y directa.
- **Michel Roegl-Brunner ([@michelroegl-brunner](https://github.com/michelroegl-brunner))** — por explicar la nueva estructura de colecciones de PocketBase (`script_scripts`, `script_categories`).

El proyecto Helper Scripts es un recurso extraordinario para la comunidad Proxmox. Los scripts pertenecen enteramente a sus autores y mantenedores — ProxMenux simplemente ofrece una forma guiada de descubrirlos y lanzarlos. Todo el crédito va a la comunidad detrás de [community-scripts/ProxmoxVE](https://github.com/community-scripts/ProxmoxVE).

## 2025-09-18

### Nueva versión v1.1.8 — *ProxMenux Offline Mode*

![ProxMenux Offline](https://macrimi.github.io/ProxMenux/ProxMenux_offline.png)

---

### Añadido

- **Modo de ejecución offline (sin dependencia de GitHub)**
  Todos los scripts core de ProxMenux se ejecutan ahora **enteramente en local**, sin requerir requests en vivo a GitHub (`raw.githubusercontent.com`).
  Este cambio proporciona:
  - Mayor estabilidad durante la ejecución
  - Sin interrupciones por timeouts de red o bloqueos regionales de GitHub
  - Soporte para **entornos offline o aislados**

  ⚠️ Esta actualización resuelve issues recientes donde usuarios en ciertas regiones eran incapaces de ejecutar scripts debido a errores de CDN o filtrado TLS al descargar ficheros `.sh` desde URLs raw de GitHub.

  **🎖 Reconocimiento especial: @cod378**
  Esta conversión offline ha sido posible gracias al extraordinario trabajo de **@cod378**,
  que rediseñó toda la lógica interna del installer y el updater, refactorizó el sistema de gestión de ficheros,
  e implementó el nuevo workflow de ejecución totalmente local.
  Sin su colaboración, dedicación y aportación técnica, esta transformación no habría sido posible.

- **ProxMenux Monitor v1.0.1**
  Esta actualización trae un gran salto en la interfaz de **ProxMenux Monitor**.
  Nuevas funciones y mejoras:
  - `Proxy Support`: Accede a ProxMenux a través de proxies inversos con plena funcionalidad
  - `Authentication System`: Asegura tu dashboard con protección por contraseña
  - `Two-Factor Authentication (2FA)`: Soporte opcional TOTP para mayor seguridad
  - `PCIe Link Speed Detection`: Ver velocidades de conexión NVMe y detectar cuellos de botella de rendimiento
  - `Enhanced Storage Display`: Auto-formatea tamaños de disco (GB → TB cuando corresponde)
  - `SATA/SAS Interface Info`: Detecta y muestra el tipo de storage (SATA, SAS, NVMe, etc.)
  - `Health Monitoring System`: Health check integrado del sistema con alertas descartables
  - Renderizado mejorado entre navegadores y mejor rendimiento

- **Helper Scripts Menu (Mirror Support)**
  El menú `Helper Scripts` ahora:
  - Detecta **URLs mirror** y muestra opciones de descarga alternativas cuando están disponibles
  - Lista las versiones de OS disponibles cuando un helper script depende de la versión (p. ej. instaladores de plantillas)

---

### Arreglado

- Fixes menores y refinamientos a lo largo del codebase para asegurar compatibilidad offline total y una experiencia de usuario más suave.


## 2025-09-04

### Nueva versión v1.1.7

### Añadido

- **ProxMenux Monitor**
  Tu nueva herramienta de monitorización para Proxmox. Descubre todas las funciones que te ayudarán a gestionar y supervisar tu infraestructura eficientemente.

  ProxMenux Monitor está diseñado para soportar futuras actualizaciones donde **se puedan disparar acciones sin usar el terminal**, gestionadas a través de una **interfaz amigable** accesible en múltiples formatos y dispositivos.

  Accede en: **http://your-server-ip:8008**

  ![ProxMenux Monitor](https://macrimi.github.io/ProxMenux/monitor/welcome.png)
- **Nuevo método de eliminación de banner**
  Una nueva función para deshabilitar el mensaje de suscripción de Proxmox con seguridad mejorada:
  - Crea un backup completo antes de modificar ningún fichero
  - Muestra un warning claro de que pueden producirse breaking changes con futuras actualizaciones de la GUI
  - Si la GUI no carga, el usuario puede revertir los cambios por SSH desde el menú post-install usando la herramienta **"Uninstall Options → Restore Banner"**

  Gracias especiales a **@eryonki** por proporcionar el método mejorado.

---

### Mejorado

- **CORAL TPU Installer actualizado para PVE 9**
  El instalador del driver CORAL TPU soporta ahora tanto **Proxmox VE 8 como VE 9**, asegurando compatibilidad con los kernels y udev rules más recientes.

- **Instalación e integración de Log2RAM**
  - La instalación de Log2RAM es ahora idempotente y puede ejecutarse con seguridad múltiples veces.
  - Ajusta automáticamente la configuración de `journald` para alinearse con el tamaño y comportamiento de Log2RAM.
  - Asegura que el journaling esté correctamente afinado para evitar overflows o agotamiento de RAM en sistemas con poca memoria.

- **Función de optimización de Red (LXC + NFS)**
  Mejorada para prevenir warnings de "martian source" en setups donde **contenedores LXC comparten storage con VMs** vía NFS dentro del mismo servidor.

- **Progreso de APT Upgrade**
  Al ejecutar actualizaciones completas del sistema vía ProxMenux, se muestra ahora una **barra de progreso en tiempo real**, dando al usuario visibilidad clara del proceso de update.

---

### Arreglado

- Otras pequeñas mejoras y fixes para optimizar el rendimiento en runtime y eliminar bugs menores.


## 2025-01-10

### Nueva versión v1.1.6

![Shared Resources Menu](https://macrimi.github.io/ProxMenux/share/main-menu.png)


### Añadido

- **Nuevo menú: Mount and Share Manager**
  Introducido un nuevo menú integral para gestionar recursos compartidos entre el host Proxmox y los contenedores LXC:

  **Opciones de configuración del host:**
  - **Configure NFS Shared on Host** - Añadir, ver y eliminar recursos NFS compartidos en el servidor Proxmox con gestión automática de exports
  - **Configure Samba Shared on Host** - Añadir, ver y eliminar recursos Samba/CIFS compartidos en el servidor Proxmox con configuración de share
  - **Configure Local Shared on Host** - Crear y gestionar directorios locales compartidos con los permisos adecuados en el host Proxmox

  **Opciones de integración LXC:**
  - **Configure LXC Mount Points (Host ↔ Container)** - **Función core** que permite montar directorios del host dentro de contenedores LXC con gestión automática de permisos. Incluye la capacidad de **ver los mount points existentes** para cada contenedor de forma clara y organizada y **eliminar mount points** con verificación apropiada de que el proceso se completó con éxito. Especialmente optimizado para **contenedores no privilegiados** donde el mapeo UID/GID es crítico.
  - **Configure NFS Client in LXC** - Configura un cliente NFS dentro de contenedores privilegiados
  - **Configure Samba Client in LXC** - Configura un cliente Samba dentro de contenedores privilegiados
  - **Configure NFS Server in LXC** - Instala servidor NFS dentro de contenedores privilegiados
  - **Configure Samba Server in LXC** - Instala servidor Samba dentro de contenedores privilegiados

  **Documentación y soporte:**
  - **Help & Info (commands)** - Guías integrales con instrucciones manuales paso a paso para todos los escenarios de compartición

  Todo el sistema está construido en torno a la funcionalidad de **LXC Mount Points**, que detecta automáticamente los tipos de filesystem, gestiona el mapeo de permisos entre usuarios del host y del contenedor, y proporciona integración fluida tanto para contenedores privilegiados como no privilegiados.

---

### Mejorado

- **Mejora de auto-detección de Log2RAM**
  En el script automático de post-install, la función de instalación de Log2RAM ahora pregunta al usuario cuando la detección automática de disco ssd/m2 falla.
  Esto asegura que Log2RAM pueda instalarse aún en sistemas donde la detección automática de disco no funciona correctamente.

---

### Arreglado

- **Verificación del repositorio de updates de Proxmox**
  Arreglado un issue en la función de update de Proxmox donde los ficheros source vacíos del repositorio causaban errores durante la verificación de conflictos. La función gestiona ahora correctamente ficheros vacíos de `/etc/apt/sources.list.d/` sin lanzar falsos warnings.

  Gracias a **@JF_Car** por reportar este issue.

---

### Reconocimientos

Gracias especiales a **@JF_Car**, **@ghosthvj** y **@jonatanc** por sus pruebas, feedback valioso y sugerencias que ayudaron a refinar la funcionalidad de recursos compartidos y a mejorar la experiencia general de usuario.


## 2025-08-20

### Nueva versión v1.1.5

### Añadido

- **Nuevo script: Upgrade PVE 8 a PVE 9**
  Añadida una herramienta de upgrade completa ubicada bajo `Utilities and Tools`. Proporciona:
  1. **Upgrade automático** de PVE 8 a 9
  2. **Upgrade interactivo** con confirmaciones paso a paso
  3. **Modo check-only** usando `check-pve8to9`
  4. **Instrucciones manuales** mostradas en orden para usuarios que prefieren actualizar manualmente

- **Nuevas herramientas en System Utilities**
  - [`s-tui`](https://github.com/amanusk/s-tui): Monitorización de CPU basada en terminal con gráficas
  - [`intel-gpu-tools`](https://gitlab.freedesktop.org/drm/igt-gpu-tools): Útil para diagnósticos de GPU Intel

---

### Mejorado

- **Gestión de APT Upgrade**
  La función de upgrade de PVE bloquea ahora el proceso si algún paquete pide confirmación manual. Esto evita upgrades parciales y asegura consistencia.

- **Optimización de Red (sysctl)**
  - Parámetros de kernel obsoletos eliminados (p. ej. `tcp_tw_recycle`, `nf_conntrack_helper`) para prevenir warnings en **Proxmox 9 / kernel 6.14**
  - Ahora genera solo parámetros sysctl válidos y al día

- **Gestión de Patch de CPU AMD**
  - Aplica ahora `idle=nomwait` correcto y opciones KVM (`ignore_msrs=1`, `report_ignored_msrs=0`)
  - El warning esperado está ahora documentado y gestionado con seguridad para estabilidad con Ryzen/EPYC

- **Fixes de Timezone y NTP**
  - Detecta automáticamente la timezone usando geolocalización por IP pública
  - Fallback a UTC si la detección falla
  - Reinicia Postfix tras establecer la timezone → resuelve el warning de mismatch `/var/spool/postfix/etc/localtime`

- **Lógica del Repository & Package Installer**
  - Verifica ahora que existan repositorios funcionales antes de instalar ningún paquete
  - Si no hay ninguno disponible, añade un repositorio **Debian stable** como fallback
  - Reemplaza el obsoleto `mlocate` por `plocate` (compatible con Debian 13 y Proxmox 9)

- **Logs y Feedback de usuario mejorados**
  - Las acciones que fallan proporcionan ahora mensajes precisos (en lugar de marcarse falsamente como éxito)
  - Ayuda a los usuarios a entender claramente qué se ha aplicado o saltado


## 2025-08-06

### Nueva versión v1.1.4

### Añadido

- **Preparación de compatibilidad con Proxmox 9**
  Esta versión prepara **ProxMenux** para el próximo **Proxmox VE 9**:
  - La función para añadir los repositorios oficiales de Proxmox soporta ahora el nuevo formato `.sources` usado en Proxmox 9, manteniendo retrocompatibilidad con Proxmox 8.
  - La eliminación de banner se soporta ahora opcionalmente para Proxmox 9.

- **Detección de xshok-proxmox**
  Añadida una comprobación para detectar si el script post-install `xshok-proxmox` ya ha sido ejecutado.
  Si se detecta, se muestra un warning para evitar ajustes conflictivos:

  ```
  It appears that you have already executed the xshok-proxmox post-install script on this system.

  If you continue, some adjustments may be duplicated or conflict with those already made by xshok.

  Do you want to continue anyway?
  ```

---

### Mejorado

- **Eliminación de banner (Proxmox 8.4.9+)**
  Actualizada la lógica para eliminar el banner de suscripción en **Proxmox 8.4.9**, debido a cambios en `proxmoxlib.js`.

- **LXC Disk Passthrough (UUID persistente)**
  La función para añadir un disco físico a un contenedor LXC usa ahora **paths persistentes basados en UUID**.
  Esto asegura que los discos permanezcan correctamente montados, incluso si el orden `/dev/sdX` cambia por hardware nuevo.

  ```bash
  PERSISTENT_DISK=$(get_persistent_path "$DISK")
  if [[ "$PERSISTENT_DISK" != "$DISK" ]] ...
  ```

- **System Utilities Installer**
  Comprueba ahora si las sources APT están disponibles antes de instalar las herramientas seleccionadas.
  Si una nueva instalación de Proxmox no tiene repos activos, **añadirá automáticamente las sources por defecto** para evitar fallos de instalación.

- **Activación de IOMMU en sistemas ZFS**
  La función que habilita IOMMU para passthrough verifica ahora los parámetros de kernel existentes para evitar duplicación si el usuario ya los ha configurado manualmente.

---

### Arreglado

- Limpieza de código menor y rendimiento de runtime mejorado en varios módulos.


## 2025-07-20

### Cambiado

- **Eliminación del banner de suscripción (Proxmox 8.4.5+)**
  Mejorada la función `remove_subscription_banner` para asegurar compatibilidad con Proxmox 8.4.5, donde el método de eliminación de banner fallaba tras instalaciones limpias.

- **Detección de Log2RAM mejorada**
  Tanto en los scripts post-install automático como personalizable, se ha mejorado la lógica para la instalación de Log2RAM.
  Ahora detecta correctamente si Log2RAM ya está configurado y evita disparar errores o reconfiguración.

- **Instalación de Figurine optimizada**
  La función `install_figurine` evita ahora duplicar entradas en `.bashrc` si la personalización del prompt root ya existe.


### Añadido

- **Nueva función: Nombrado persistente de interfaces de Red**
  Añadida una nueva función `setup_persistent_network` para crear nombres de interfaz de red estables usando ficheros `.link` basados en direcciones MAC.
  Esto evita renombrados impredecibles (p. ej. `enp2s0` convirtiéndose en `enp3s0`) cuando cambia el hardware, se reordena la topología PCI o se aplican configuraciones de passthrough.

  **¿Por qué usar ficheros `.link`?**
  Porque los nombres predecibles de interfaz en `systemd` pueden cambiar con reordenamientos o reemplazos de hardware. Usar ficheros `.link` estáticos atados a direcciones MAC asegura consistencia, especialmente en sistemas con múltiples NICs o setups de passthrough.

  Gracias especiales a [@Andres_Eduardo_Rojas_Moya] por contribuir la función de nombrado
  de red persistente y por la idea original.

```bash
[Match]
MACAddress=XX:XX:XX:XX:XX:XX

[Link]
Name=eth0
```


## 2025-07-01

### Nueva versión v1.1.3

![Installer Menu](https://macrimi.github.io/ProxMenux/install/install.png)

- **Dos modos de instalación para ProxMenux**
  El installer ofrece ahora dos modos distintos:
  1. **Versión Lite (sin traducciones):** Solo instala dos paquetes oficiales de Debian (`dialog`, `jq`) para habilitar menús y parsing JSON. No se escriben ficheros más allá del directorio de configuración.
  2. **Versión Full (con traducciones):** Usa un virtual environment y permite seleccionar el idioma de interfaz durante la instalación.

  Al actualizar, si el usuario cambia de full a lite, la versión vieja se **eliminará automáticamente** para una transición limpia.

### Añadido

- **Nuevo script: Setup automatizado de post-instalación**
  Un nuevo script post-install minimal que realiza el setup esencial automáticamente:
  - Upgrade y sync del sistema
  - Eliminar el banner enterprise
  - Optimizar APT, journald, logrotate, límites del sistema
  - Mejorar gestión de kernel panic, ajustes de memoria, entropía, red
  - Añadir tweaks a `.bashrc` y **auto-instalación de Log2RAM** (si se detecta SSD/M.2)

- **Nueva función: Configuración de Log2RAM**
  Disponible ahora tanto en los scripts post-install personalizable como automático.
  En sistemas con SSD/NVMe, Log2RAM se **habilita automáticamente** para preservar la vida del disco.

- **Nuevos menús:**
  - 🧰 **System Utilities Menu**
    Permite a los usuarios seleccionar e instalar herramientas CLI útiles con validación de comando apropiada.
  - 🌐 **Network Configuration & Repair**
    Un nuevo menú interactivo para analizar y reparar interfaces de red.

### Mejorado

- **Lógica del menú Post-Install**
  Las opciones están ahora agrupadas más lógicamente para mejor usabilidad.

- **Menú VM Creation**
  Mejorado con soporte mejorado de modelo de CPU y opciones custom.

- **Script UUP Dump ISO Creator**
  - Añadida opción para **personalizar la ubicación de la carpeta temporal**
  - Arreglado un issue donde se eliminaba la carpeta temp entera en lugar de solo el contenido
    💡 Sugerido por [@igrokit](https://github.com/igrokit)
    [#17](https://github.com/MacRimi/ProxMenux/issues/17), [#11](https://github.com/MacRimi/ProxMenux/issues/11)

- **Script Physical Disk to LXC**
  Gestiona ahora **discos formateados con XFS** correctamente.
  ¡Gracias a [@antroxin](https://github.com/antroxin) por reportar y testear!

- **System Utilities Installer**
  Reescrito para **verificar la disponibilidad del comando** tras la instalación, asegurando que las herramientas funcionen como se espera.
  🐛 Fix para [#18](https://github.com/MacRimi/ProxMenux/issues/18) por [@DST73](https://github.com/DST73)

### Arreglado

- **Habilitar IOMMU en ZFS**
  La detección y configuración para habilitar IOMMU en sistemas basados en ZFS es ahora totalmente funcional.
  🐛 Fix para [#15](https://github.com/MacRimi/ProxMenux/issues/15) por [@troponaut](https://github.com/troponaut)

### Otros

- Mejoras de rendimiento y limpieza de código en varios módulos.


## 2025-06-06

### Añadido

- **Nuevo menú: Proxmox PVE Helper Scripts**
  Introducido oficialmente el nuevo menú **Proxmox PVE Helper Scripts**, reemplazando el anterior: Esenciales Proxmox.
  Este nuevo menú incluye:
  - Búsqueda de script por nombre en tiempo real
  - Navegación basada en categoría

  Es una forma más limpia, rápida y funcional de acceder a los scripts de la comunidad en Proxmox.

  ![Helper Scripts Menu](https://macrimi.github.io/ProxMenux/menu-helpers-script.png)


- **Nuevos modelos de CPU en VM Creation**
  El menú de selección de CPU en VM creation ha sido ampliado considerablemente para soportar perfiles avanzados de CPU QEMU y x86-64.
  Esto permite mejor compatibilidad con sistemas guest modernos y fine-tuning del rendimiento para workloads específicos, incluyendo virtualización anidada y funciones asistidas por hardware.


  ![CPU Config](https://macrimi.github.io/ProxMenux/vm/config-cpu.png)

  Gracias a **@Nida Légé (Nidouille)** por sugerir esta mejora.


- **Soporte para imágenes de disco `.raw`**
  La herramienta de import de disco para VMs soporta ahora ficheros `.raw`, además de `.img`, `.qcow2` y `.vmdk`.
  Esto mejora la compatibilidad cuando se trabaja con exports de disco de otros hypervisors o herramientas de backup.

  💡 Sugerido por **@guilloking** en [GitHub Issue #5](https://github.com/MacRimi/ProxMenux/issues/5)


- **Detección de Locale al saltarse idiomas**
  La función que deshabilita idiomas extra de APT incluye ahora:
  - Detección automática de locale (`LANG`)
  - Auto-generación de `en_US.UTF-8` si no se encuentra ninguno
  - Previene warnings durante ejecución de scripts debido a locale indefinido


### Mejorado

- **Lógica de saltado de idioma APT**
  La gestión mejorada de locale asegura compatibilidad del sistema antes de deshabilitar traducciones:
  ```bash
  if ! locale -a | grep -qi "^${default_locale//-/_}$"; then
      echo "$default_locale UTF-8" >> /etc/locale.gen
      locale-gen "$default_locale"
  fi
  ```

- **Velocidad de System Update**
  Los upgrades de sistema post-install son ahora más rápidos:
  - El proceso de upgrade (`dist-upgrade`) está separado de las actualizaciones de índice de plantillas de contenedor.
  - El refresh de índice es ahora una función opcional seleccionada en el script.


## 2025-05-27

### Arreglado
- **URL de ISO de Kali Linux actualizada**
  Arreglada la URL de descarga incorrecta para el ISO de Kali Linux en el módulo de instalador Linux. El nuevo path correcto es:
  ```
  https://cdimage.kali.org/kali-2025.1c/kali-linux-2025.1c-installer-amd64.iso
  ```

### Mejorado
- **Transiciones de menú dialog más rápidas**
  Mejorada la respuesta UI en todos los menús interactivos reemplazando `whiptail` por `dialog`, ofreciendo transiciones más rápidas y navegación más suave.

- **Soporte Coral USB en LXC**
  Mejorada la lógica para configurar passthrough de Coral USB TPU en contenedores LXC:
  - Refactorizada la configuración en bloques modulares con mejor estructura y comentarios inline.
  - Separación clara de la lógica de Coral USB (`/dev/coral`) y Coral M.2 (`/dev/apex_0`).
  - Mantiene retrocompatibilidad con configuraciones LXC existentes.
  - Introducido passthrough Coral USB persistente usando una udev rule:
    ```bash
    # Create udev rule for Coral USB
    SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="9302", MODE="0666", TAG+="uaccess", SYMLINK+="coral"

    # Map /dev/coral if it exists
    if [ -e /dev/coral ]; then
        echo "lxc.mount.entry: /dev/coral dev/coral none bind,optional,create=file" >> "$CONFIG_FILE"
    fi
    ```
  - Gracias especiales a **@Blaspt** por validar el passthrough Coral USB persistente y por sugerir el uso del symlink `/dev/coral`.


### Añadido
- **Soporte de passthrough Coral USB persistente**
  Añadido soporte de udev rule para dispositivos Coral USB para mapearlos persistentemente como `/dev/coral`, habilitando passthrough consistente entre reboots. Este path se detecta y mapea automáticamente en la configuración del contenedor.

- **Integración de RSS Feed**
  Añadido soporte para generar un RSS feed para el changelog, permitiendo a los usuarios mantenerse informados de updates a través de clientes de noticias.

- **Automatización del Release Service**
  Implementado un nuevo servicio de gestión de release para automatizar la publicación y tagging de versiones, empezando con la versión **v1.1.2**.


## 2025-05-13

### Arreglado

- **Fix de startup en versiones recientes de Proxmox**\
  Arreglado un issue donde algunas instalaciones recientes de Proxmox carecían del directorio `/usr/local/bin`, causando errores al instalar el menú de ejecución. El script crea ahora el directorio si no existe antes de descargar el menú principal.\
  Gracias a **@danielmateos** por detectar y reportar este issue.

### Mejorado

- **Lógica de instalación de Lynis actualizada en Post-Install Settings**\
  La función `install_lynis()` se ha mejorado para instalar siempre la **última versión** de Lynis clonando el repositorio oficial de GitHub:
  ```
  https://github.com/CISOfy/lynis.git
  ```
  El proceso de instalación asegura ahora que siempre se obtenga la última versión y se enlace correctamente dentro del path del sistema.

  Gracias a **@Kamunhas** por reportar esta oportunidad de mejora.

- **Optimización de memoria equilibrada para sistemas con poca memoria**
  Mejorados los ajustes de memoria por defecto para soportar mejor sistemas con RAM limitada. La configuración previa podía impedir que servidores de bajas specs arrancaran. Ahora se usa un conjunto más equilibrado de parámetros de kernel, y la compactación de memoria se habilita si el sistema la soporta.

  ```bash
  cat <<EOF | sudo tee /etc/sysctl.d/99-memory.conf
  # Balanced Memory Optimization
  vm.swappiness = 10
  vm.dirty_ratio = 15
  vm.dirty_background_ratio = 5
  vm.overcommit_memory = 1
  vm.max_map_count = 65530
  EOF

  # Enable memory compaction if supported by the system
  if [ -f /proc/sys/vm/compaction_proactiveness ]; then
    echo "vm.compaction_proactiveness = 20" | sudo tee -a /etc/sysctl.d/99-memory.conf
  fi

  # Apply settings
  sudo sysctl -p /etc/sysctl.d/99-memory.conf
  ```

  Estos valores ayudan a mantener la capacidad de respuesta y la estabilidad del sistema incluso en condiciones de memoria constreñidas.

  Gracias a **@chesspeto** por señalar este issue y ayudar a refinar la optimización.


## 2025-05-04

### Añadido
- **Menú interactivo Help & Info**
  Añadido un nuevo script llamado `Help and Info`, que proporciona un menú interactivo de referencia de comandos para Proxmox VE a través de una interfaz basada en dialog.
  Esta herramienta ofrece a los usuarios una forma rápida de navegar y copiar comandos útiles para gestionar y mantener su servidor Proxmox, todo en una ubicación centralizada.

  ![Help and Info Menu](https://macrimi.github.io/ProxMenux/help/help-info-menu.png)

  *Figura 1: Menú interactivo de referencia de comandos Help and Info.*

- **Uninstaller para utilidades Post-Install**
  Se ha añadido un nuevo script al menú **Post-instalación**, permitiendo a los usuarios desinstalar utilidades o paquetes que se instalaron previamente a través del script post-install.

### Mejorado
- **Menú de selección de utilidades en el script de Post-instalación**
  La sección `Install Common System Utilities` incluye ahora un menú donde los usuarios pueden elegir qué utilidades instalar, en lugar de instalar todas por defecto. Esto da más control sobre lo que se añade al sistema.

- **Detección de PV Header antiguo y auto-fix**
  Tras actualizar el sistema, el script post-update incluye ahora una comprobación de seguridad para discos físicos con headers LVM PV (Physical Volume) obsoletos.
  Este issue puede ocurrir cuando las máquinas virtuales tienen acceso passthrough a discos y modifican involuntariamente la metadata del volumen. El script detecta y actualiza ahora automáticamente estos headers.
  Si ocurre algún error durante el proceso, se muestra un warning al usuario.

- **Traducciones más rápidas en menús**
  Varios menús de post-instalación con auto-traducciones se han optimizado para reducir tiempos de carga y mejorar la experiencia de usuario.


## 2025-04-14

### Añadido
- **Nuevo script: Disk Passthrough a un CT**
Introducido un nuevo script que permite asignar un disco físico dedicado a un contenedor (CT) en Proxmox VE.
Esta utilidad lista los discos físicos disponibles (excluyendo los discos de sistema y montados), permite al usuario seleccionar un contenedor y un disco, y luego formatea o reutiliza el disco antes de montarlo dentro del CT en un path especificado.
Soporta detección de filesystems existentes y asegura que los permisos estén correctamente configurados. Ideal para casos de uso como contenedores Samba, Nextcloud, o de videovigilancia.

### Mejorado
- Identificación visual de discos para passthrough a VMs
Mejorada la lógica de detección de discos en el script Disk Passthrough a una VM incluyendo indicadores visuales y metadata.
Los discos muestran ahora tags como ⚠ In use, ⚠ RAID, ⚠ LVM, o ⚠ ZFS, facilitando reconocer su estado actual de un vistazo. Esto ayuda a prevenir errores de selección y mejora la claridad para el usuario.

## 2025-03-24
### Mejorado
- Mejorada la lógica para detectar discos físicos en el script **Disk Passthrough a una VM**. Anteriormente, el script mostraba en algunos setups discos que ya estaban montados en el sistema. Esta actualización asegura que solo se muestren discos no montados en Proxmox, previniendo confusión y conflictos potenciales.

- Esta mejora asegura que los discos ya montados o asignados a otras VMs se excluyan de la lista de discos disponibles, proporcionando un proceso de selección más preciso y fiable.

## [1.1.1] - 2025-03-21
### Mejorado
- Mejorada la lógica del script post-install para prevenir sobrescribir o añadir ajustes duplicados si ajustes similares ya están configurados por el usuario.
- Añadida una nota de warning a la documentación explicando que usar diferentes scripts post-instalación no se recomienda para evitar conflictos y ajustes duplicados.

### Añadido
- **Crear VM Synology DSM**:
  Un nuevo script que crea una VM para instalar Synology DSM. El script automatiza el proceso de descargar tres loaders distintos con la opción de usar un loader custom proporcionado por el usuario desde las opciones de almacenamiento local.
  Además, permite el uso tanto de discos virtuales como físicos, que son asignados automáticamente por el script.

  ![VM description](https://macrimi.github.io/ProxMenux/vm/synology/dsm_desc.png)

  *Figura 1: Resumen del setup de la VM Synology DSM.*

- **Nuevo menú VM Creation**:
  Se ha creado un nuevo menú para habilitar la creación de VM desde plantillas o scripts custom.

- **Actualización del menú principal**:
  Añadida una nueva entrada al menú principal para acceder al menú de creación de VM desde plantillas o scripts.

## 2025-03-06
### Añadido
- Completada la sección de documentación web para ampliar la información sobre scripts actualizados.

## [1.1.0] - 2025-03-04
### Añadido
- Creado un script post-install personalizable para Proxmox con 10 secciones y 35 opciones seleccionables distintas.

## [1.0.7] - 2025-02-17
### Añadido
- Creado un menú con scripts esenciales de la comunidad Proxmox VE Helper-Scripts.

## [1.0.6] - 2025-02-10
### Añadido
- Añadido soporte de traducción en tiempo real usando Google Translate.
- Modificados los scripts existentes para soportar múltiples idiomas.
- Actualizado el script de instalación para instalar y configurar:
  - `jq` (para gestionar datos JSON)
  - Python 3 y virtual environment (requerido para traducciones)
  - Google Translate (`googletrans`) (para soporte multi-idioma)
- Introducido soporte para los siguientes idiomas:
  - English
  - Spanish
  - French
  - German
  - Italian
  - Portuguese
- Creado un script de utilidad para funciones auxiliares que soportan la ejecución de menús y scripts.

## [1.0.5] - 2025-01-31
### Añadido
- Añadido el script **Repair Network**, que incluye:
  - Verify Network
  - Show IP Information
- Creado el **Network Menu** para gestionar funciones relacionadas con la red.

## [1.0.4] - 2025-01-20
### Añadido
- Creado un script para añadir un disco passthrough a una VM.
- Creado el **Storage Menu** para gestionar funciones relacionadas con almacenamiento.

## [1.0.3] - 2025-01-13
### Añadido
- Creado un script para importar imágenes de disco en una VM.

## [1.0.2] - 2025-01-09
### Modificado
- Actualizado el **script de configuración de Coral TPU** para:
  - Incluir también el setup de Intel iGPU.
  - Instalar drivers de GPU para aplicaciones de videovigilancia para soportar VAAPI y QuickSync.
- Añadida una función para **desinstalar ProxMenux**.

## [1.0.1] - 2025-01-03
### Añadido
- Creado un script para añadir **soporte Coral TPU en un LXC** para uso en programas de videovigilancia.

## [1.0.0] - 2024-12-18
### Añadido
- Release inicial de **ProxMenux**.
- Creado un script para añadir **drivers Coral TPU** a Proxmox.