Home ja

browsa Wiki（日本語）

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

browsa は Chrome MV3 のサイドパネル型チャット拡張。自分自身の モデル／エージェントエンドポイント（クラウド、ローカル、セルフホストいずれも）を、任意の Web ページの横にあるサイドパネルに持ち込み、いま読んでいるページ（記事・PDF・動画・音声）をモデルのコンテキストとして添付する。アカウント不要、テレメトリなし、拡張ソースにビルド工程なし。

この wiki は開発者／アーキテクチャ向けドキュメント。ユーザー向けドキュメントは別の場所にある:

目的	参照先
browsa のインストールと利用	README · 中文 README
モデルやエージェントの接続（プロバイダガイド）	docs/guide/providers (en: /en/guide/providers.html)
ユーザーに表示されるプライバシーと権限	docs サイト
おかしく見える判断を変えたい	まず docs/adr へ。「browsa はなぜ X をしないのか」の大半は意図して決められた判断

アーキテクチャページ（各言語版はサイドバー / see sidebar）

• アーキテクチャ — 1 つのメッセージの旅: コンテンツスクリプト → service worker → ポート → プロバイダ → ストリーミング描画でパネルへ戻る。ポートのライフサイクル、レスポンスエンベロープ、MV3 service worker の注意点。
• レンダリングパイプライン — marked + DOMPurify + KaTeX ワーカー、ストリーミングのブロックコミット、6 つのフェンス型ライブレンダラ（mermaid / echarts / markmap / smiles / pdb / dot）とそのベンダー契約。
• ストレージモデル — グローバルなフラット履歴、セッションスナップショット（軽量インデックス + ボディキー）、リクエスト側の画像ライフサイクル、コンテキストのエージング。
• プロバイダとエージェント — 4 つのワイヤプロトコル（chat / responses / anthropic / runs）、エージェントプロバイダ（Hermes / OpenCode / OpenSquilla / Agent Bridge）、承認・clarify リレー、出力バジェットの交渉。
• ASR と動画解析 — 音声・動画添付パイプライン: ダウンロード → トランスコード → Files API → ポーリング → Responses ストリーム、キーフレームマーカー、字幕ソースの優先順位。
• セキュリティモデル — MV3 CSP とベンダーパッチ、DOMPurify フック、MAIN ワールド抽出の防御、DNR ヘッダ注入、拡張 ID／オリジンの規則。
• 設計判断 — 「browsa はなぜ X をしないのか」リスト。各項目は理由付きの確定済み判断。新しい事実なしに再提案しないこと。
• コントリビューティング — 開発環境のセットアップ、テスト構成とその制約、lockstep テスト規律、dev-preview ハーネス、リリースフロー。

この wiki の規約

• ペアで多言語化。 すべてのページには …-zh の双子ページがあり、各ページ先頭で相互リンクする。両者は意味の鏡像であり、逐語訳ではない（README と同じ規則）。
• wiki は説明し、AGENTS.md が裁定する。 AGENTS.md が工学上のスーパーセット — コーディングエージェントが読む、不変条件・コマンド・蓄積された「なぜ」の記録。各 wiki ページには、要約対象の AGENTS.md セクション／ADR を指す Source of truth フッターが付く。両者が食い違った場合は AGENTS.md（および ADR）が優先され、wiki ページの方を直す。
• 同期規則: wiki ページを持つアーキテクチャレベルの変更は、同じ PR 内でそのページを更新する（README がすでに従っているのと同じ規律）。

権威版: Home（英語） / Home-zh（中文） — AI による初翻スナップショット、同期日 2026-10-01。