Home ko

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를 안 하지"의 대부분은 의도적으로 내려진 결정이다

아키텍처 문서 (한국어판)

• 아키텍처 — 한 메시지의 여정: 콘텐츠 스크립트 → 서비스 워커 → 포트 → 프로바이더 → 패널로의 스트리밍 렌더링. 포트 수명 주기, 응답 엔벨로프, MV3 서비스 워커의 함정들.
• 렌더링 파이프라인 — marked + DOMPurify + KaTeX 워커, 스트리밍 블록 커밋, 여섯 개의 펜스 실시간 렌더러(mermaid / echarts / markmap / smiles / pdb / dot)와 그 벤더 계약.
• 스토리지 모델 — 전역 플랫 히스토리, 세션 스냅숏(경량 인덱스 + 본문 키), 요청 측 이미지 수명 주기, 컨텍스트 에이징.
• 프로바이더와 에이전트 — 네 가지 와이어 프로토콜(chat / responses / anthropic / runs), 에이전트 프로바이더(Hermes / OpenCode / OpenSquilla / Agent Bridge), 승인·확인 중계, 출력 예산 협상.
• ASR 및 영상 분석 — 오디오/비디오 첨부 파이프라인: 다운로드 → 트랜스코딩 → Files API → 폴링 → Responses 스트림, 키프레임 마커, 자막 소스 우선순위.
• 보안 모델 — MV3 CSP와 벤더 패치, DOMPurify 훅, MAIN 월드 추출 방어, DNR 헤더 주입, 확장 ID/오리진 규칙.
• 설계 결정 — "browsa는 왜 X를 하지 않는가" 목록. 모든 항목은 이유가 붙은 확정된 결정이다; 새로운 사실 없이는 다시 제안하지 마라.
• 기여하기 — 개발 환경, 테스트 구성과 그 제약, lockstep 테스트 규율, dev-preview 도구, 릴리스 흐름.

이 위키의 규약

• 쌍둥이 쌍으로 다국어. 모든 페이지에는 …-zh 쌍둥이 페이지가 있고, 페이지 맨 위에서 쌍이 서로 링크된다. 두 페이지는 축자 번역이 아니라 의미의 거울이다(README와 같은 규칙).
• 위키는 설명하고, AGENTS.md가 다스린다. AGENTS.md는 공학 사실의 상위 집합이다 — 불변식, 명령, 코딩 에이전트가 읽는 누적된 "왜" 기록. 각 위키 페이지는 자신이 요약하는 AGENTS.md 절 / ADR을 가리키는 원본 출처 푸터를 단다. 둘이 어긋나면 AGENTS.md(및 ADR)가 이기며, 위키 페이지를 고쳐야 한다.
• 동기화 규칙: 위키 페이지가 존재하는 아키텍처 수준 변경은 같은 PR에서 그 페이지를 갱신한다(README가 이미 지키는 것과 같은 규율).

권위판: Home(영어) / Home-zh(중국어) — AI 초벌 번역 스냅숏, 동기화 2026-10-01.