openhop

srcCódigo fuente

Código fuente

Todos los archivos de la última versión de openhop, tal cual están publicados. Lee lo que quieras o descárgalo todo en un zip.

Commit
c8cfb4c
Fecha
16 nov 2026
Archivos
62 archivos
Descargar el código (zip)

zip · 758 KB · SHA-256 6ce65b028777bf92…

qol-proposals.md

111 líneas · 5,8 KB · Markdown

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