From 8452e8237310df933ad4bd9f4bfd01395ff8ae7e Mon Sep 17 00:00:00 2001
From: juanjo <desarrollo@faccsa.es>
Date: Thu, 3 Sep 2026 22:40:12 +0200
Subject: [PATCH] 03-sep: [doc] indice de comandos /ayuda con ejemplo de cada
 uno, agrupado por categorias

---
 vigilancia/pi_bot.py | 63 +++++++++++++++++++++++++++++++-------------
 1 file changed, 44 insertions(+), 19 deletions(-)

diff --git a/vigilancia/pi_bot.py b/vigilancia/pi_bot.py
index ae2ed81..a7085a4 100644
--- a/vigilancia/pi_bot.py
+++ b/vigilancia/pi_bot.py
@@ -235,25 +235,50 @@ def procesar(texto, chat_id):
         n = _int_arg(texto)
         procesar_bajar(n, chat_id)
     elif t in ("ayuda", "/ayuda", "help", "/help"):
-        enviar("Comandos:\n"
-               "<b>estado</b> — estado de la Pi\n"
-               "<b>temperatura</b> — temperatura\n"
-               "<b>tv &lt;mensaje&gt;</b> — mensaje rápido a la tele\n"
-               "<b>alarma &lt;mensaje&gt;</b> — secuencia completa (sirena x3)\n"
-               "<b>youtube &lt;URL&gt;</b> — reproduce YouTube y apaga al terminar\n"
-               "<b>descargar &lt;enlace&gt;</b> — añade a Download Station del NAS\n"
-               "<b>pelicula &lt;nombre&gt;</b> — buscar pelicula y descargar\n"
-               "<b>serie &lt;nombre&gt;</b> — buscar serie con temporadas/capitulos\n"
-               "<b>novedades</b> — ultimas novedades del catalogo\n"
-               "<b>busca &lt;nombre&gt;</b> — buscar en TODO internet (miles de pelis)\n"
-               "<b>genero</b> — catálogo por género (30 más descargadas)\n"
-               "<b>torrents &lt;n&gt;</b> — ver torrents del resultado n de /busca\n"
-               "<b>bajar &lt;n&gt;</b> — descargar al NAS el torrent n de /torrents\n"
-               "<b>panorama</b> — fotos de las cámaras\n"
-               "<b>limpieza</b> — limpia procesos atascados de la Pi\n"
-               "<b>reboot</b> — reinicia la Pi (necesita confirmar con /confirmar-reboot)\n"
-               "<b>servicios</b> — estado de los servicios del sistema",
-               chat_id)
+        enviar(
+            "📚 <b>ÍNDICE DE COMANDOS</b>\n"
+            "Escribe <b>/ayuda</b> cuando lo necesites.\n\n"
+            "━━━ 🎬 VIDEOCLUB ━━━\n"
+            "<b>1.</b> <code>busca &lt;nombre&gt;</code> — buscar en TODO internet\n"
+            "     ✏️ Ej: <code>/busca duna</code>\n"
+            "<b>2.</b> <code>genero</code> — catálogo por género (30 más descargadas)\n"
+            "     ✏️ Ej: <code>/genero</code> → 1 (pelis) → 12 (Horror)\n"
+            "<b>3.</b> <code>torrents &lt;n&gt;</code> — torrents del resultado n\n"
+            "     ✏️ Ej: <code>/torrents 1</code>\n"
+            "<b>4.</b> <code>bajar &lt;n&gt;</code> — descargar al NAS el torrent n\n"
+            "     ✏️ Ej: <code>/bajar 1</code>\n"
+            "<b>5.</b> <code>pelicula &lt;nombre&gt;</code> — buscar película (catálogo)\n"
+            "     ✏️ Ej: <code>/pelicula ant-man</code>\n"
+            "<b>6.</b> <code>serie &lt;nombre&gt;</code> — buscar serie (catálogo)\n"
+            "     ✏️ Ej: <code>/serie breaking bad</code>\n"
+            "<b>7.</b> <code>novedades</code> — últimas novedades del catálogo\n"
+            "     ✏️ Ej: <code>/novedades</code>\n\n"
+            "━━━ 🖥️ NAS / DESCARGAS ━━━\n"
+            "<b>8.</b> <code>descargar &lt;enlace&gt;</code> — añade a Download Station\n"
+            "     ✏️ Ej: <code>/descargar magnet:?xt=urn:btih:...</code>\n\n"
+            "━━━ 📺 TV ━━━\n"
+            "<b>9.</b> <code>tv &lt;mensaje&gt;</code> — mensaje rápido a la tele\n"
+            "     ✏️ Ej: <code>/tv la cena está lista</code>\n"
+            "<b>10.</b> <code>alarma &lt;mensaje&gt;</code> — secuencia completa (sirena x3)\n"
+            "     ✏️ Ej: <code>/alarma vienen a por vosotros</code>\n"
+            "<b>11.</b> <code>youtube &lt;URL&gt;</code> — reproduce YouTube en la TV\n"
+            "     ✏️ Ej: <code>/youtube https://youtu.be/xxxx</code>\n\n"
+            "━━━ 🛠️ SISTEMA ━━━\n"
+            "<b>12.</b> <code>estado</code> — estado de la Pi\n"
+            "     ✏️ Ej: <code>/estado</code>\n"
+            "<b>13.</b> <code>temperatura</code> — temperatura de la Pi\n"
+            "     ✏️ Ej: <code>/temperatura</code>\n"
+            "<b>14.</b> <code>panorama</code> — fotos de las cámaras\n"
+            "     ✏️ Ej: <code>/panorama</code>\n"
+            "<b>15.</b> <code>limpieza</code> — limpia procesos atascados\n"
+            "     ✏️ Ej: <code>/limpieza</code>\n"
+            "<b>16.</b> <code>servicios</code> — estado de los servicios\n"
+            "     ✏️ Ej: <code>/servicios</code>\n"
+            "<b>17.</b> <code>reboot</code> — reinicia la Pi\n"
+            "     ✏️ Ej: <code>/reboot</code> → confirmar con <code>/confirmar-reboot</code>\n"
+            "<b>18.</b> <code>ayuda</code> — este índice\n"
+            "     ✏️ Ej: <code>/ayuda</code>",
+            chat_id)
     elif t in ("servicios", "/servicios"):
         estado_svc = sh("systemctl is-active pi-bot tv-api autossh-tunel")
         nombres = "pi-bot\ntv-api\nautossh-tunel"