Design Decisions ko

설계 결정 — "browsa는 왜 X를 하지 않는가"

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

이 결정들은 확정됐다(SETTLED). 각각 뒤에 실제 실패/논쟁 역사가 있다; 새로운 사실 없이 다시 제안하지 마라. 정식 기록은 docs/adr에 산다 — 이 페이지는 사람이 읽는 인덱스다.

제품 경계

결정	한 줄 이유	기록
미디어 다운로드 UI 제거, 복원 금지	chrome.downloads 요청에 대한 헤더 주입은 불신뢰 + YouTube PO 토큰 안티봇; browsa 사용자에겐 cat-catch/yt-dlp가 있다. ASR 파이프라인 자체의 페치 기계장치는 영향 없음	ADR-0001
탭별 세션 자동 전환 없음	탭 전환 시 대화를 바꾸는 것은 사용자에게서 통제를 가져간다; 전역 단일 대화 + 명시적 새 세션이 기본값이다	ADR-0002
메시지별 "컨텍스트 영수증" 없음	쓸모없어서 만들었다가 제거함; 첨부 칩의 检查/撤销(검사/실행 취소) 버튼만이 전송 내용 검사 수단으로 남는다	같은 ADR
tabCapture "재생하며 녹음" ASR 폴백 기각	실시간 캡처 길이 = 재생 길이; 일시정지/스킵 구간은 침묵 — 재생 안 된 비디오는 전사될 수 없어 핵심 사례가 죽는다	AGENTS.md 2026-09-28
범용 페이지 "쓰기/행동" 방향 보류	복사-붙여넣기 베이스라인이 단일 덩어리 쓰기를 커버한다; 나머지는 산발적이다. "做好太复杂"(제대로 하려면 너무 복잡하다) — 재시작은 복사-붙여넣기가 못 다루는 구체적인 폼/배치 흐름을 필요로 한다	프로젝트 로드맵 노트
학습 방향은 yes, "퀴즈/이해도 바" 형식은 no	기각된 것은 형식이지 방향이 아니다; 재시작은 언제나 형식부터 맞춘다	학습-피벗 노트

데이터 & 프라이버시

결정	한 줄 이유	기록
저장된 이미지 픽셀은 결코 파괴되지 않는다	버블은 전송된 것을 보여준다(사용자 보고 기반); 압축은 요청 측에서만(imagesSeen 라벨)	ADR-0013
세션 스냅숏은 이미지 바이트를 유지한다(제거 없음)	복원된 세션의 첫 턴이 실제 픽셀을 재전송해 픽셀 수준 후속 질문이 답 가능하게 머문다	ADR-0005

프로토콜 & 아키텍처

결정	한 줄 이유	기록
thinking 기본 omit; runs 에코 가드는 옳다	reasoning.available은 답변을 리플레이한다 — 보여주면 중복된다	ADR-0004
디테일 스레드는 턴-요청 사다리에서 의도적으로 갈라진다	격리 세션/스코핑은 기술 부채가 아니라 제품 약속이다	ADR-0007
입력 표면마다 하나의 입력-히스토리 리콜 스코프	후속 카드의 ↑는 후속 질문만 리콜하고 메인 채팅 전송은 절대 아니다	ADR-0006
MAIN 월드 주입 함수는 헬퍼를 중첩 유지	executeScript는 함수 하나를 직렬화한다; 실제 Chrome의 ReferenceError가 이것을 가르쳤다	ADR-0009
벤더 로딩 제약 (Mol* RAW 복사 / office wasm 미예열 / 실제 확장 검증)	세 개의 상설 규칙	ADR-0008
CAPABILITY_HINTS 크기 동결; 렌더러는 자동 렌더, 버튼 없음	힌트는 few-shot이 아니라 인터페이스 계약이다; 버튼은 장식이다	ADR-0010
스트리밍 블록 커밋; 벤더 증분 파서 없음	HTML 형태를 바이트 동일하게 유지한다; O(n) 달성	ADR-0011
효율성 감사 wontfix 목록	트레이드오프 확정(getAll 키 목록 등); 재보고 금지	ADR-0012
포팅 규칙: 기술은 yes, 시그니처 기능은 no	youtube-digest의 이중 자막 뷰는 만들었다가 되돌렸다 — 학습 도구의 시그니처는 browsa의 것이 아니다	ADR-0003
모델 출력 계약은 학습 선험이 있는 포맷을 선호한다	nn의 교훈: 발명된 스펙에는 선험이 없다 → 모델이 추측한다 → 조용한 열화; dot으로 대체	렌더-계약 노트

사이드 패널 기능을 위한 두 상설 규칙

1. 자체 LLM 호출을 하는 모든 패널 기능은 네 apiStyle을 모두 지원하거나 눈에 보이게 실패해야 한다 — 논문 읽기 도우미 카드는 Hermes를 조용히 건너뛰어 제거되었다(프로토콜 분기 비용 > 한계 가치).
2. 아무도 요청하지 않은 설정 토글 금지: autoCleanBeforeExtract는 사용자 결정으로 명시적으로 제거되었다 — 동작은 그냥 고정이다.

---

원본 출처: docs/adr/0001-0013 전체; AGENTS.md 곳곳의 do-not-re-propose 항목. 권위판: Design-Decisions(영어) / Design-Decisions-zh(중국어) — AI 초벌 번역 스냅숏, 동기화 2026-10-01.