# Propuestas de calidad (QoL) — 15 nov 2026 > **Estado (15 nov 2026):** 1.1 (prueba real), 1.2 (¿OpenCode está usando openhop?) y 1.3 (latido de los > workers) están implementados y publicados en **openhop 3.2.0**. El resto sigue pendiente. El problema que describió el dueño: *"a la gente le surgen fallos o no funciona del todo, se quejan, y la app dice que todo ok cuando no"*. Este documento lista por qué pasa y qué se puede hacer, en orden de impacto. ## Por qué la app dice "Todo funciona" cuando no Hoy el panel de salud (`_build_health`) comprueba **cosas que deberían estar bien**, no **que OpenCode funcione**: - que el keeper y el guard tengan su mutex (proceso vivo), - que el puerto 41987 acepte conexiones, - que WARP diga "Connected", - que `service.json` de OpenCode Desktop apunte al proxy, - errores recientes de `opencode.log` (solo como texto informativo). Lo que **no** comprueba: 1. Que una petición real a `opencode.ai` **a través del proxy** llegue y vuelva. El puerto puede estar abierto y el túnel muerto (WARP conectado sin pasar tráfico, DNS roto dentro del proxy, Tor sin circuitos). 2. Que OpenCode **esté usando** openhop. Si `service.json` no apunta al proxy y el shim no está en el PATH, la app no se queja: simplemente no hay nada que comprobar. Ese es el caso más común de "no funciona" con la app en verde. 3. Que el guard **esté haciendo su trabajo**. Un proceso vivo pero colgado sigue teniendo su mutex: la app dice "auto-rotation is on" y no rota nada. 4. Que el parche del cartel "Free limit reached" esté puesto (hoy ni se muestra). 5. Que el protocolo de WARP sea el correcto para el modo App-only (MASQUE, no WireGuard). ## Prioridad 1 — lo que quita la mayoría de los "a mí no me va" ### 1.1 Prueba real de conexión (de punta a punta) - Qué ve el usuario: un botón **Probar conexión** y una prueba automática cada ~2 minutos. Tres resultados posibles, en lenguaje normal: "El proxy no está escuchando", "El proxy funciona pero no sale a internet (WARP/Tor)" o "La conexión funciona; si OpenCode falla, el problema está en OpenCode". - Qué arregla: es la diferencia entre "creo que va" y "sé que va". Mientras no haya una prueba buena, la cabecera dice **"Comprobando…"** en vez de "Todo funciona". - Cómo: `urllib` con `ProxyHandler` a `https://opencode.ai/` por `127.0.0.1:41987`, 8 s de límite, en un hilo aparte (igual que `_refresh_egress_async`), resultado cacheado en `get_state()`. - Coste: 3–4 h. Riesgo: bajo (solo lee y prueba; no cambia configuración). ### 1.2 "¿OpenCode está usando openhop?" - Qué ve el usuario: si OpenCode Desktop no está conectado al proxy o el comando `opencode` no pasa por openhop, un aviso claro y un botón **Conectar OpenCode** (escribe `service.json` / deja el shim en el PATH) con la opción de reiniciar OpenCode. - Qué arregla: el fallo más frecuente en las quejas. La app está perfecta; OpenCode va por su cuenta. - Cómo: `desktop_service_wired` ya existe; falta tratar `False` como problema (hoy solo se usa para pintar la fila) y comprobar `path_wired`. Detectar también "OpenCode se abrió antes que el proxy" (proceso anterior a la instalación). - Coste: 3–5 h. Riesgo: medio (toca configuración de OpenCode, pero con el mismo código que ya usa el interruptor). ### 1.3 Latido (heartbeat) de los workers - Qué ve el usuario: "La protección dice estar encendida pero lleva 4 minutos sin dar señales" con botón **Reiniciar**. - Qué arregla: guard colgado que no rota y proxy zombie que acepta conexiones pero no las atiende. - Cómo: keeper y guard escriben su marca en `keeper/heartbeat.txt` y `guard/heartbeat.txt` cada 45 s y 10 s; `_build_health` avisa si el archivo tiene más de 4 min. Es barato y no depende de leer logs. - Coste: 1–2 h. Riesgo: bajo. ## Prioridad 2 — detalles que generan confusión ### 2.1 Estado del cartel "Free limit reached" - Mostrar si el parche está aplicado, y si no: "Cierra OpenCode Desktop 2 minutos y se pondrá solo" (el keeper lo aplica al detectar que está cerrado). Hoy `desktop_brand` existe pero la interfaz no dice nada. - Coste: 1 h. ### 2.2 Protocolo de WARP incorrecto - En App-only, WARP 2026.x solo funciona en MASQUE. Si está en WireGuard, el estado puede decir "Connected" y no pasar tráfico. Detectarlo con `warp-cli settings` y ofrecer el arreglo que ya existe (`ensure_warp_protocol`). - Coste: 1 h. ### 2.3 Copiar diagnóstico - Botón que copia un texto corto para pegar cuando alguien pide ayuda: versión, estado, últimos errores traducidos y rutas recortadas. Sin IPs, sin chats, sin nombres de usuario. - Coste: 1–2 h. ### 2.4 Versión de los workers desactualizada - Comparar la `VERSION` de `%LOCALAPPDATA%\openhop\scripts\ouc_common.py` con la de la app; si un exe viejo dejó código viejo, ofrecer **Reparar instalación**. - Coste: 1 h. ## Prioridad 3 — pulido ### 3.1 Que los errores recientes bajen el estado - Si hay errores de OpenCode en los últimos 15 minutos no explicados por una rotación, el estado pasa a "Con avisos" (hoy puede seguir en verde porque los errores solo se listan aparte). - Coste: 1 h. ### 3.2 Diagnóstico técnico dentro de la app - Reutilizar `doctor.py` (hoy solo Windows y solo terminal) en una pestaña "Detalles". - Coste: 3–4 h. ### 3.3 Instalación/desinstalación limpia en Linux - Ya está en el plan de Linux (paso 1: `src/` sin ventana, units, `--setup`/`--uninstall`). ## Recomendación 1. **Una tanda con 1.1 + 1.2 + 1.3** (unas 8–10 h de trabajo, se puede partir en dos sesiones). Es lo que convierte el panel en algo en lo que se puede confiar. 2. Después **2.1–2.4** en una sola pasada corta. 3. **3.1** junto con la tanda 2; **3.2** solo si alguien lo pide. Cada punto se prueba con `tools/preview_ui.py` y con la app real, sin tocar el ratón ni el foco del dueño.