TL;DR

kage는 실제 헤드리스 크롬으로 각 페이지를 끝까지 로딩시킨 뒤 사람이 본 그대로의 DOM을 스냅샷으로 뜨고, 모든 JavaScript를 제거하고 CSS·이미지·폰트만 로컬 경로로 내려받아 스크립트 없는 정적 사본을 만든다. robots.txt와 sitemap.xml을 존중하는 폭넓이 우선 크롤이 페이지를 URL 기준으로 결정론적으로 매핑해 Ctrl-C로 중단해도 이어서 재개할 수 있고, 완성된 미러는 kage pack으로 위키백과 오프라인 배포에 쓰이는 ZIM 아카이브나 아무것도 설치되지 않은 컴퓨터에서도 실행되는 단일 실행파일로 압축할 수 있다. 추적 스크립트나 죽은 API 호출이 전혀 없는 순수 결과물이라 몇 년 뒤에도 그대로 열리는 오프라인 아카이브, 인터넷 없는 환경에서의 문서 배포, 지인에게 사이트 사본을 통째로 건네는 용도에 맞는다.

핵심 포인트

• 출력이 표준 ZIM 포맷이라 kage 없이도 Kiwix 생태계(데스크톱 앱, iOS/Android)에서 그대로 열리고 몇 년 뒤에도 호환된다.
• 동일한 미러를 pack하면 매번 바이트 단위로 동일한 파일이 나와 체크섬으로 캐시하거나 무결성을 검증할 수 있다.
• `--app`을 붙이면 터미널 창 없이 더블클릭으로 열리는 macOS `.app` 번들까지 만들어준다.
• webview 태그로 빌드하면 시스템 브라우저 탭이 아니라 OS 네이티브 WebView로 열려 진짜 앱처럼 느껴진다.