확장 샌드박스 안: content.js → runtime.sendMessage → background.js(service worker). content.js 에서는 네이티브 통신을 못 한다. background.js → sendNativeMessage → Chrome. Chrome 은 OS 지정 위치의 manifest 에서 allowed_origins 에 이 확장이 있는지 대조한 뒤 호스트를 자식 프로세스로 spawn 한다. Chrome → 호스트는 stdin 으로 최대 64MiB, 호스트 → Chrome 은 stdout 으로 최대 1MB. 메시지 하나는 4바이트 길이 헤더 다음 UTF-8 JSON 이다. stdout 에 print 한 글자라도 새면 길이 자리에 끼어 프로토콜이 깨지므로 로그는 stderr 로 보낸다.

-- 확장은 로컬 바이너리를 직접 못 띄운다 — Chrome 이 manifest 를 보고 대신 띄운다
spawn :: Manifest -> ExtensionId -> Maybe Process
spawn m ext
  | ext `elem` allowedOrigins m = Just (run (path m))   -- 와일드카드 불가, path 는 절대경로
  | otherwise                   = Nothing
-- manifest = { name, description, path, type = "stdio", allowedOrigins }
-- 자리: Windows 레지스트리 · macOS ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/

-- 대화는 소켓도 HTTP 도 아닌 stdin/stdout. 메시지 = 4바이트 길이(네이티브 바이트 순서) ++ UTF-8 JSON
frame :: Json -> Bytes
frame j = len (utf8 j) <> utf8 j                         -- 쓰고 flush

unframe :: Bytes -> Maybe (Json, Bytes)
unframe b | B.null b  = Nothing                          -- Chrome 이 파이프를 닫았다 — 종료
          | otherwise = let (n, rest) = B.splitAt 4 b
                        in Just (first decode (B.splitAt (fromLen n) rest))
-- stdout 에 print 한 글자가 새면 길이 자리에 낀다 → 로그는 stderr
-- 호스트가 부르는 것(yt-dlp)도 절대경로 — GUI 로 띄운 Chrome 은 .zshrc 를 안 읽고, 호스트는 사용자 셸 환경을 물려받지 않는다

limit :: Direction -> Bytes
limit HostToChrome = 1 MB      -- 비대칭. 크면 잘라 보내거나 connectNative 로 나눈다
limit ChromeToHost = 64 MiB

-- 부를 수 있는 곳은 background(service worker) 뿐 — 흐름이 두 파일로 갈린다
content    = sendMessage . extract                      -- 페이지에서 값만
background = onMessage (\m reply -> sendNativeMessage host m reply >> pure True)  -- True: 비동기 응답 채널 유지
-- sendNativeMessage 는 응답 하나 뒤 프로세스가 끝난다 · 진행률을 흘리려면 connectNative 로 Port
#553

“항상 열기”를 체크하면 허용이 origin 단위로 저장된다. chrome://settings/handlers 는 웹 프로토콜 핸들러(mailto: 등)만 다루는 별개 화면이라 여기서는 못 푼다. ① chrome://settings/content/all 에서 사이트 데이터를 삭제한다 → 재시작해 다이얼로그가 다시 뜨면 해제된 것이다. 안 뜨면 ② Chrome 을 백그라운드까지 완전 종료하고 → Preferences 에서 그 origin 의 스킴 항목을 지운 뒤 → 재시작해 다시 확인한다. ② 를 건너뛰고 실행 중에 편집하면 종료 시 메모리 상태로 덮어써 되돌아간다. excluded_schemes 에 true 인 스킴은 반대로 차단 상태이고, 같은 파일에서 푼다.

-- 설정 UI 에는 항목이 없다 — 체크는 프로필의 Preferences JSON 에 origin 단위로 저장된다
-- Preferences 의 protocol_handler.allowed_origin_protocol_pairs
type Allowed = Map Origin (Map Scheme Bool)

allowAlways :: Origin -> Scheme -> Allowed -> Allowed   -- 다이얼로그의 "항상 열기"
allowAlways o s = insertWith union o (singleton s True)

reset :: Origin -> Scheme -> Allowed -> Allowed         -- 설정 UI 에는 이 함수가 없다
reset o s = adjust (delete s) o

-- ① chrome://settings/content/all 에서 사이트 데이터 삭제 — 이걸로 풀리면 끝
-- ② 안 풀리면 Chrome 을 백그라운드까지 끄고 파일에서 reset, 재시작
quit :: Allowed -> Allowed -> Allowed
quit memory _disk = memory                              -- 실행 중에 고치면 종료 때 덮인다

-- 재시작 뒤 다이얼로그가 다시 뜨면 풀린 것이다

prefs :: OS -> Profile -> FilePath
prefs MacOS   p = "~/Library/Application Support/Google/Chrome" </> p </> "Preferences"
prefs Windows p = "%LOCALAPPDATA%\\Google\\Chrome\\User Data" </> p </> "Preferences"
prefs Linux   p = "~/.config/google-chrome" </> p </> "Preferences"
#593