Home es

Wiki de browsa

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

browsa es una extensión de Chrome MV3 con chat en panel lateral: traslada los endpoints de modelos y agentes del propio usuario —en la nube, locales o autoalojados— a un panel lateral junto a cualquier página web, y adjunta la página que se está leyendo (artículo, PDF, vídeo, audio) como contexto del modelo. Sin cuentas, sin telemetría, sin paso de compilación para el código fuente de la extensión.

Esta wiki es la documentación de desarrollo / arquitectura. La documentación orientada al usuario vive en otros lugares:

Lo que se busca	Dónde ir
Instalar y usar browsa	README · README en chino
Conectar un modelo o agente (guía de proveedores)	docs/guide/providers (en: /en/guide/providers.html)
Privacidad y permisos tal como se muestran a los usuarios	docs site
Cambiar una decisión que parece equivocada	docs/adr primero — la mayoría de las preguntas «por qué browsa no hace X» se decidieron deliberadamente

Páginas de arquitectura (versión en chino: ver la barra lateral)

• Arquitectura — el viaje de un mensaje: content scripts → service worker → puertos → proveedores → render en streaming de vuelta al panel. Ciclo de vida de los puertos, sobre de respuesta, peculiaridades del service worker en MV3.
• Pipeline de renderizado — marked + DOMPurify + worker de KaTeX, confirmación por bloques en streaming, los seis renderizadores en vivo por valla de código (mermaid / echarts / markmap / smiles / pdb / dot) y sus contratos de vendor.
• Modelo de almacenamiento — el historial global plano, las instantáneas de sesión (índice ligero + claves de cuerpo), el ciclo de vida de las imágenes en el lado de la petición, el envejecimiento de contexto.
• Proveedores y agentes — los cuatro protocolos de red (chat / responses / anthropic / runs), los proveedores de agente (Hermes / OpenCode / OpenSquilla / Agent Bridge), el relevo de approvals y clarifications, la negociación del presupuesto de salida.
• ASR y análisis de vídeo — el pipeline de adjunto de audio/vídeo: descarga → transcodificación → Files API → sondeo → stream de Responses, marcadores de keyframes, preferencia de fuente de subtítulos.
• Modelo de seguridad — CSP de MV3 y parches de vendors, hooks de DOMPurify, defensas de extracción en el mundo MAIN, inyección de cabeceras vía DNR, reglas de ID/origen de la extensión.
• Decisiones de diseño — la lista de «por qué browsa no hace X». Cada entrada es una decisión cerrada con su motivo; no volver a proponer sin hechos nuevos.
• Contribuir — preparación del entorno de desarrollo, estructura de tests y sus restricciones, la disciplina de tests en lockstep, el arnés dev-preview, el flujo de releases.

Convenciones de esta wiki

• Bilingüe por parejas. Cada página tiene una gemela …-zh; la pareja se enlaza al inicio de cada página. Ambas son espejos semánticos, no traducciones literales (la misma regla que los README).
• La wiki explica; AGENTS.md gobierna. AGENTS.md es el superconjunto de ingeniería — invariantes, comandos y el registro acumulado de «por qué» que leen los agentes de código. Cada página de la wiki lleva un pie de fuente autoritativa que apunta a las secciones de AGENTS.md / ADRs que resume. Si alguna vez discrepan, ganan AGENTS.md (y los ADRs), y la página de la wiki debe corregirse.
• Regla de sincronización: un cambio a nivel de arquitectura que tenga página en la wiki actualiza esa página en el mismo PR (la misma disciplina que ya siguen los README).

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