Home ru

Вики browsa

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

browsa — расширение Chrome MV3 с чатом в боковой панели: оно подключает ваши собственные эндпоинты моделей и агентов — облачные, локальные или самостоятельно размещённые — в боковую панель рядом с любой веб-страницей и прикрепляет страницу, которую вы читаете (статью, PDF, видео, аудио), как контекст для модели. Без аккаунта, без телеметрии, без этапа сборки для исходников расширения.

Эта вики — документация для разработчиков / по архитектуре. Пользовательская документация живёт в других местах:

Что вам нужно	Куда идти
Установить и использовать browsa	README · Chinese README
Подключить модель или агента (руководство по провайдерам)	docs/guide/providers (en: /en/guide/providers.html)
Приватность и разрешения, как их видят пользователи	docs site
Изменить решение, которое кажется ошибочным	сначала docs/adr — большинство вопросов «почему browsa не делает X» решались осознанно

Страницы об архитектуре (中文版见侧栏 / см. боковую панель)

• Архитектура — путь одного сообщения: контент-скрипты страницы → service worker → порты → провайдеры → потоковый рендеринг обратно в панель. Жизненный цикл портов, конверт ответов, подводные камни MV3 service worker.
• Конвейер рендеринга — marked + DOMPurify + KaTeX-воркер, стриминговая фиксация блоков, шесть живых рендереров fenced-блоков (mermaid / echarts / markmap / smiles / pdb / dot) и их вендорские контракты.
• Модель хранения — глобальная плоская история, снимки сессий (лёгкий индекс + ключи тел), жизненный цикл изображений на стороне запроса, старение контекста.
• Провайдеры и агенты — четыре сетевых протокола (chat / responses / anthropic / runs), агентские провайдеры (Hermes / OpenCode / OpenSquilla / Agent Bridge), реле одобрений и уточнений, согласование бюджета вывода.
• ASR и анализ видео — конвейер прикрепления аудио/видео: скачивание → перекодирование → Files API → опрос → поток Responses, маркеры ключевых кадров, предпочтение источников субтитров.
• Модель безопасности — CSP MV3 и патчи вендоров, хуки DOMPurify, защита экстракции в MAIN world, инъекция заголовков через DNR, правила ID/origin расширения.
• Проектные решения — список «почему browsa не делает X». Каждая запись — устоявшееся решение с обоснованием; не предлагать заново без новых фактов.
• Участие в разработке — настройка разработки, устройство тестов и их ограничения, дисциплина lockstep-тестов, dev-preview, процесс релиза.

Соглашения этой вики

• Двуязычие парами. У каждой страницы есть двойник …-zh; пара связана ссылками вверху каждой страницы. Это семантические зеркала, а не буквальные переводы (то же правило, что у README).
• Вики объясняет; AGENTS.md управляет. AGENTS.md — инженерное надмножество: инварианты, команды и накопленная летопись «почему», которую читают кодинг-агенты. Каждая страница вики несёт подвал Источник истины со ссылками на разделы AGENTS.md / ADR, которые она резюмирует. Если они когда-нибудь разойдутся, побеждают AGENTS.md (и ADR), а страницу вики следует исправить.
• Правило синхронизации: изменение уровня архитектуры, у которого есть страница вики, обновляет эту страницу в том же PR (та же дисциплина, которой уже следуют README).

Авторитетные версии: Home (англ.) / Home-zh (кит.) — снимок первичного перевода ИИ, синхронизирован 2026-10-01.