Design Decisions ru

Проектные решения — «почему browsa не делает X»

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

Эти решения УСТОЯЛИСЬ. За каждым стоит реальная история провалов/споров; не предлагать заново без новых фактов. Формальные записи живут в docs/adr — эта страница человекочитаемый индекс к ним.

Продуктовые границы

Решение	Причина в одну строку	Запись
UI скачивания медиа удалён, не восстанавливать	инъекция заголовков на запросы chrome.downloads ненадёжна + анти-бот PO-token у YouTube; у пользователей browsa есть cat-catch/yt-dlp. Собственная fetch-механика ASR-конвейера не затронута	ADR-0001
Нет автопереключения сессий по вкладкам	смена разговора при переключении вкладок отбирает контроль у пользователя; глобальный единый разговор + явные новые сессии — дефолт	ADR-0002
Нет «квитанций контекста» на каждое сообщение	построено и удалено как бесполезное; кнопки 检查/撤销 чипа прикрепления остаются единственной инспекцией отправленного содержимого	тот же ADR
tabCapture fallback ASR «запись во время воспроизведения» отвергнут	длительность захвата в реальном времени = длительности воспроизведения; пауза/пропуск = тишина — невоспроизведённое видео не оттранскрибировать, ядро кейса умирает	AGENTS.md 2026-09-28
Направление «писать/действовать» на произвольной странице отложено	базовый copy-paste покрывает запись одиночного блоба; остальное — эпизодично; «做好太复杂» — рестарту нужны конкретные формы/батч-потоки, которые copy-paste не осилит	заметки роадмапа проекта
Обучающее направление — да, формы «квиз/полоса восприятия» — нет	отвергнуты ФОРМЫ, а не направление; любой рестарт сначала согласует форму	заметки learning-pivot

Данные и приватность

Решение	Причина в одну строку	Запись
Сохранённые пиксели изображений НИКОГДА не уничтожаются	пузыри показывают то, что было отправлено (по отчётам пользователей); сжатие только на стороне запроса (лейблы imagesSeen)	ADR-0013
Снимки сессий хранят байты изображений (без вычистки)	первый ход восстановленной сессии пересылает настоящие пиксели, чтобы пиксельные уточнения оставались отвечаемыми	ADR-0005

Протокол и архитектура

Решение	Причина в одну строку	Запись
thinking по умолчанию omit; echo-guard runs прав	reasoning.available реплеит ответ — показывать его значит дублировать	ADR-0004
Detail thread намеренно расходится с лестницей turn-request	изолированные сессии/скоупинг — продуктовое обещание, а не техдолг	ADR-0007
Один скоуп припоминания истории ввода на каждую поверхность ввода	↑ в карточке уточнения вспоминает уточнения, никогда отправки основного чата	ADR-0006
Инжектируемые в MAIN world функции держат хелперы вложенными	executeScript сериализует одну функцию; научил ReferenceError в настоящем Chrome	ADR-0009
Ограничения загрузки вендоров (RAW-копия Mol* / office wasm не прогревается / верификация в реальном расширении)	три постоянных правила	ADR-0008
Размер CAPABILITY_HINTS заморожен; рендереры рендерят автоматически, без кнопок	хинты — интерфейсный контракт, а не few-shot; кнопки декоративны	ADR-0010
Стриминговая фиксация блоков; никакого вендорского инкрементального парсера	сохраняет формы HTML байт-идентичными; достигнуто O(n)	ADR-0011
Список wontfix аудита эффективности	компромиссы устоялись (список ключей getAll и т.д.); не репортить заново	ADR-0012
Правило портирования: техники — да, сигнатурные фичи — нет	двуязычный вид субтитров youtube-digest был построен и откачен — сигнатура обучающего инструмента не сигнатура browsa	ADR-0003
Контракты вывода модели предпочитают форматы с training prior	урок nn: выдуманная спека без prior → модель угадывает → тихая деградация; заменено на dot	заметки render-контракта

Два постоянных правила для фич боковой панели

1. Любая фича панели, делающая собственный LLM-вызов, должна либо поддерживать все четыре apiStyle, либо падать ВИДИМО — карточка-помощник чтения статей была удалена, потому что молча пропускала Hermes (цена ветвления по протоколам > маржинальной ценности).
2. Никаких тумблеров настроек, о которых никто не просил: autoCleanBeforeExtract явно удалён решением пользователя — поведение просто фиксировано.

---

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