| # 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. |