Home pt

Wiki do browsa

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

browsa é uma extensão Chrome MV3 de chat em painel lateral: ela traz os seus próprios endpoints de modelo e agente — na nuvem, locais ou auto-hospedados — para um painel lateral ao lado de qualquer página web, e anexa a página que você está lendo (artigo, PDF, vídeo, áudio) como contexto do modelo. Sem conta, sem telemetria, sem etapa de build para o código-fonte da extensão.

Esta wiki é a documentação de desenvolvedor / arquitetura. A documentação voltada ao usuário vive em outro lugar:

O que você quer	Onde ir
Instalar e usar o browsa	README · Chinese README
Conectar um modelo ou agente (guia de provedores)	docs/guide/providers (en: /en/guide/providers.html)
Privacidade e permissões como exibidas aos usuários	docs site
Mudar uma decisão que parece errada	docs/adr primeiro — a maioria das perguntas "por que o browsa não faz X" foi decidida deliberadamente

Páginas de arquitetura (中文版见侧栏 / veja a barra lateral)

• Arquitetura — a jornada de uma mensagem: content scripts → service worker → portas → provedores → renderização em streaming de volta ao painel. Ciclo de vida das portas, envelope de resposta, pegadinhas do service worker em MV3.
• Pipeline de renderização — marked + DOMPurify + worker KaTeX, commit de blocos em streaming, os seis renderizadores ao vivo por fence (mermaid / echarts / markmap / smiles / pdb / dot) e seus contratos de vendors.
• Modelo de armazenamento — o histórico global e plano, snapshots de sessão (índice leve + chaves de corpo), o ciclo de vida de imagens no lado da requisição, envelhecimento de contexto.
• Provedores e agentes — os quatro protocolos de rede (chat / responses / anthropic / runs), os provedores de agente (Hermes / OpenCode / OpenSquilla / Agent Bridge), o relay de aprovações e esclarecimentos, a negociação de orçamento de saída.
• ASR e análise de vídeo — o pipeline de anexação de áudio/vídeo: download → transcode → Files API → polling → stream Responses, marcadores de keyframe, preferência de fonte de legendas.
• Modelo de segurança — CSP MV3 e patches de vendors, hooks do DOMPurify, defesas da extração no MAIN world, injeção de cabeçalhos via DNR, regras de ID/origem da extensão.
• Decisões de design — a lista de "por que o browsa não faz X". Cada entrada é uma decisão consolidada com seu motivo; não reapresente a proposta sem fatos novos.
• Contribuindo — configuração de dev, estrutura dos testes e suas restrições, a disciplina de testes em lockstep, o harness dev-preview, o fluxo de release.

Convenções desta wiki

• Bilíngue em pares. Cada página tem uma gêmea …-zh; o par é linkado no topo de cada página. Os dois são espelhos semânticos, não traduções literais (a mesma regra dos READMEs).
• A wiki explica; o AGENTS.md governa. AGENTS.md é o supraconjunto de engenharia — invariantes, comandos e o registro acumulado de "porquês" que os agentes de código leem. Cada página da wiki carrega um rodapé de fonte da verdade apontando para as seções do AGENTS.md / ADRs que ela resume. Quando eles discordarem, o AGENTS.md (e os ADRs) vencem, e a página da wiki deve ser corrigida.
• Regra de sincronização: uma mudança em nível de arquitetura que tenha uma página na wiki atualiza essa página no mesmo PR (a mesma disciplina que os READMEs já seguem).

Versões autoritativas: Home (inglês) / Home-zh (chinês) — instantâneo de primeira tradução por IA, sincronizado em 2026-10-01.