05-sep: [vigilancia] comandos /aiMesh /qos /limite /seguridad para el ASUS desde Telegram

docs/raspberry_pi.md

@@ -82,6 +82,42 @@ Desde Telegram, el bot consulta el ASUS mediante la clave de servicio de la Rasp
 
 El reinicio exige la palabra `confirmar`. Las consultas actuales no cambian la configuracion.
 
+## Funcionalidades Mesh / QoS / Limite / Seguridad implementadas (05-sep-2026)
+
+Cuatro comandos nuevos del bot, desplegados y verificados:
+
+```text
+/aiMesh estado                          # router + nodos, señal y roaming
+/aiMesh reiniciar <nodo> confirmar      # reinicia un nodo por nombre
+/aiMesh reconstruir confirmar           # reconstruye la malla
+
+/qos estado
+/qos adaptive confirmar                 # auto gaming/streaming (QoS)
+/qos tradicional confirmar              # prioridades manuales
+/qos apagar confirmar                   # restaura aceleracion NAT
+
+/limite listar                          # reglas activas (Mbps)
+/limite poner <dispositivo> <bajada> <subida>   # en Mbps
+/limite quitar <dispositivo>
+
+/seguridad estado                       # AiProtection + filtro de palabras
+/seguridad bloquear <palabra>           # p. ej. tiktok
+/seguridad desbloquear <palabra>
+```
+
+Detalles tecnicos:
+
+- **AiMesh** se lee con la libreria `asusrouter` (v1.21.3 ya presente en la Pi) via `AsusData.AIMESH`. Los nodos se resuelven por alias tolerante a tildes/minusculas (`bedroom`, `living room`). Las acciones usan `AsusSystem.NODE_REBOOT` (con `device_list=<MAC>`), `AIMESH_REBUILD` y `AIMESH_REBOOT`.
+- **Estado actual detectado:** router principal RT-AX88U PRO (fw 3.0.0.6.102) + nodos `Bedroom` (192.168.50.76, enlace 2.4GHz rssi -59) y `Living Room` (192.168.50.13, enlace 2.4GHz rssi -69), ambos ZenWiFi AX Mini.
+- **Bandwidth limiter y QoS** se gestionan por NVRAM via SSH. Formato real de `qos_bw_rulelist` (confirmado en vivo): reglas `enable>MAC>dl_kbps>ul_kbps>indice` separadas por `<`, sin `<` inicial. Al cambiar reglas se aplica `service restart_qos`.
+- **El router ya tenia el limiter activo con 7 reglas** (Caroline-tablet 25 Mbps, y 6 dispositivos a 30 Mbps). `/limite listar` las muestra. El modulo reconstruye el payload sin perder ninguna.
+- Conversiones en `Mbps x 1024` (coherentes con la UI del router: 30720 kbps = 30 Mbps).
+- **QoS y bandwidth limiter desactivan la aceleracion NAT** (aviso incluido en la respuesta del bot).
+- `/seguridad` usa el filtro de contenidos `keyword_rulelist` (AiProtection) con `service restart_bwdpi`. El bloqueo por categorias Trend Micro requiere la base web del router y queda como posible evolucion.
+- `asusrouter==1.21.3` y `aiohttp` anadidos a `vigilancia/requirements.txt`.
+
+Las acciones destructivas (reiniciar nodo, reconstruir, cambiar QoS, quitar ultima regla) piden `confirmar` como en el patron `router reiniciar`.
+
 ## Capacidades del RT-AX88U PRO
 
 El router puede centralizar muchas funciones para Telegram:
@@ -205,6 +241,8 @@ Cada unidad debe tener un registro con hostname, MAC, IP Ethernet, IP Wi-Fi, ser
 
 Catalogo de capacidades del RT-AX88U PRO consultado con el usuario, agrupado por area, para implementar desde Telegram cuando se pida. Ninguna de estas se ha implementado todavia salvo que se indique.
 
+> **Actualizacion 05-sep-2026 (tarde):** los comandos `/aiMesh`, `/seguridad`, `/limite` y `/qos` ya estan implementados y desplegados. Ver seccion «Funcionalidades Mesh / QoS / Limite / Seguridad implementadas» mas abajo.
+
 **Red y Wi-Fi**
 - Apagar/encender cada banda Wi-Fi (2.4/5 GHz) por separado.
 - Ajustar canales y potencia de senal para optimizar cobertura.