Design Decisions es

Decisiones de diseño — «por qué browsa no hace X»

English | 中文 | 日本語 | 한국어 | Español | Português | Русский

Estas decisiones están CERRADAS. Cada una tiene detrás una historia real de fallos/argumentos; no volver a proponerlas sin hechos nuevos. Los registros formales viven en docs/adr — esta página es el índice legible por humanos.

Límites del producto

Decisión	Razón en una línea	Registro
UI de descarga de medios eliminada, no restaurar	la inyección de cabeceras en peticiones chrome.downloads no es fiable + anti-bot PO-token de YouTube; los usuarios de browsa tienen cat-catch/yt-dlp. La maquinaria fetch propia del pipeline de ASR no se ve afectada	ADR-0001
Sin auto-cambio de sesión por pestaña	cambiar de conversación al cambiar de pestaña le quita control al usuario; conversación global única + sesiones nuevas explícitas es el comportamiento por defecto	ADR-0002
Sin «recibos de contexto» por mensaje	se construyó y se eliminó por no ser útil; los botones 检查/撤销 del chip de adjunto siguen siendo la única inspección del contenido enviado	mismo ADR
Fallback de ASR tabCapture «grabar mientras se reproduce» rechazado	la duración de la captura en tiempo real = la duración de la reproducción; los segmentos en pausa/saltados son silencio — un vídeo no reproducido no puede transcribirse, lo que mata el caso principal	AGENTS.md 2026-09-28
Dirección «escribir/actuar» en páginas genéricas archivada	el flujo básico de copiar-pegar cubre la escritura de bloques sueltos; el resto es episódico; «做好太复杂» — un reinicio necesita un flujo concreto de formulario/lote que el copiar-pegar no maneja	notas del roadmap del proyecto
Dirección de aprendizaje sí, formas «quiz me / barra de percepción» no	se rechazaron las FORMAS, no la dirección; cualquier reinicio alinea primero la forma	notas del learning-pivot

Datos y privacidad

Decisión	Razón en una línea	Registro
Los píxeles de imagen almacenados NUNCA se destruyen	las burbujas muestran lo que se envió (impulsado por reportes de usuarios); la compresión solo en el lado de la petición (etiquetas imagesSeen)	ADR-0013
Las instantáneas de sesión conservan los bytes de imagen (sin recorte)	el primer turno de una sesión restaurada reenvía los píxeles reales para que las preguntas de seguimiento a nivel de píxel sigan siendo respondibles	ADR-0005

Protocolo y arquitectura

Decisión	Razón en una línea	Registro
thinking por defecto omit; la guarda de eco de runs es correcta	reasoning.available repite la respuesta — mostrarla duplicaría	ADR-0004
El hilo de detalle diverge deliberadamente de la escalera de turn-request	las sesiones/el scoping aislados son la promesa del producto, no deuda técnica	ADR-0007
Un alcance de recall del historial de entrada por superficie de entrada	↑ en una tarjeta de seguimiento recuerda seguimientos, nunca envíos del chat principal	ADR-0006
Las funciones inyectadas en el mundo MAIN mantienen sus helpers anidados	executeScript serializa una función; un ReferenceError en Chrome real enseñó esto	ADR-0009
Restricciones de carga de vendors (copia RAW de Mol* / wasm de office sin precalentar / verificación en extensión real)	tres reglas permanentes	ADR-0008
Tamaño de CAPABILITY_HINTS congelado; los renderizadores renderizan automáticamente, sin botones	los hints son un contrato de interfaz, no few-shot; los botones son decorativos	ADR-0010
Confirmación por bloques en streaming; sin parser incremental de vendor	mantiene las formas HTML idénticas byte a byte; se logró O(n)	ADR-0011
Lista de wontfix de la auditoría de eficiencia	compromisos cerrados (lista de claves de getAll, etc.); no volver a reportar	ADR-0012
Regla de portado: técnicas sí, características insignia no	la vista de subtítulos bilingüe de youtube-digest se construyó y se revirtió — la insignia de una herramienta de aprendizaje no es la de browsa	ADR-0003
Los contratos de salida del modelo prefieren formatos con prior de entrenamiento	la lección de nn: una especificación inventada no tiene prior → el modelo adivina → degradación silenciosa; reemplazada por dot	notas del contrato de renderizado

Dos reglas permanentes para las funciones del panel lateral

1. Toda función del panel que haga su propia llamada LLM debe soportar los cuatro apiStyles o fallar DE FORMA VISIBLE — la tarjeta de ayuda de lectura de papers se eliminó porque saltaba a Hermes en silencio (coste de ramificar protocolos > valor marginal).
2. Ningún conmutador de ajustes que nadie pidió: autoCleanBeforeExtract se eliminó explícitamente por decisión del usuario — el comportamiento simplemente queda fijo.

---

Versiones autoritativas: Design-Decisions (inglés) / Design-Decisions-zh (chino) — instantánea de primera traducción por IA, sincronizada el 2026-10-01.