Home zh

browsa Wiki（中文）

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

browsa 是一个 Chrome MV3 侧边栏对话扩展：把你自己的模型 / 智能体端点——云端的、本地的、自建的——搬进网页旁边的侧边栏，并能把正在读的页面（文章、PDF、视频、音频）附进模型上下文。无账号、无遥测、扩展源码零构建。

本 wiki 是开发者 / 架构文档。面向用户的文档在别处：

你想做什么	去哪里
安装使用 browsa	README · 中文 README
接模型 / Agent（供应商配置指南）	docs/guide/providers
面向用户的隐私与权限说明	官网首页
觉得某个设计不合理想改	先看 docs/adr——大多数「browsa 为什么不做 X」都是拍过板的决定

架构文档（English pages in the sidebar）

• 架构总览 — 一条消息的旅程：content script → service worker → 端口 → provider → 流式渲染回面板。端口生命周期、响应信封、MV3 SW 的坑。
• 渲染管线 — marked + DOMPurify + KaTeX worker、流式块级提交、六个围栏实时渲染器（mermaid / echarts / markmap / smiles / pdb / dot）及其 vendor 契约。
• 存储模型 — 全局扁平 history、会话快照（轻索引 + 内容键）、请求侧图片生命周期、上下文老化。
• Provider 层与 Agent 接入 — 四种 wire protocol（chat / responses / anthropic / runs）、四家 agent（Hermes / OpenCode / OpenSquilla / Agent Bridge）、审批与澄清中继、输出预算协商。
• ASR 与视听精读 — 音视频附加管线：下载 → 转码 → Files API → 轮询 → Responses 流、关键帧标记、字幕来源偏好。
• 安全模型 — MV3 CSP 与 vendor 补丁、DOMPurify hook、MAIN world 提取防御、DNR 头注入、扩展 ID/origin 规则。
• 设计决策 — 「browsa 为什么不做 X」清单。每条都是拍板的决定及其理由；没有新事实不要翻案。
• 参与开发 — 开发环境、测试布局与约束、lockstep 测试纪律、dev-preview 工具、发版流程。

本 wiki 的约定

• 成对双语。 每页有 …-zh / 英文孪生页，页首互链。两者是语义镜像而非逐字翻译（与 README 同规）。
• wiki 负责解释，AGENTS.md 负责裁决。 AGENTS.md 是工程事实的超集——不变量、命令、给编码 agent 读的「为什么」档案。每页页脚有源头指针，指向它概括的 AGENTS.md 节 / ADR。两者冲突时以 AGENTS.md 与 ADR 为准，并应回头修 wiki 页。
• 同步规则：架构级变更若存在对应 wiki 页，同一 PR 内更新（与 README 的既有纪律相同）。