docs: 현 상태(v1.0.0) 기능/위장 레이어/위험 정리한 README 작성

reset 이후 README 가 없어진 상태에서 코드 동작을 분석해 새로 작성.

- 동작 원리: JS (`content.js`) + HTTP 헤더 (`rules.json`) 두 레이어
  Mac 위장 (UA, platform, userAgentData / user-agent, sec-ch-ua-platform)
- 설치 / 파일 구조 / 권한 정리
- 알려진 위험: "허용되지 않는 비정상적 접근" 팝업 실측 트리거 사실과
  추가 핑거프린팅 신호(고엔트로피 CH, WebGL 등) 미위장 한계 명시

README.md

@@ -0,0 +1,54 @@
+# Chzzk Mac Spoofer (Grid Bypass)
+
+치지직(CHZZK) 시청 시 브라우저 환경을 Mac 으로 위장해 그리드(Grid) 설치 없이 1080p 화질을 시청하기 위한 Chrome / Edge / Whale 계열 확장 (Manifest V3).
+
+## 동작 원리
+
+치지직은 Windows 에서 1080p 시청 시 자체 그리드 앱 설치를 요구하지만, Mac 환경에서는 요구하지 않습니다. 이 확장은 치지직 페이지에 한해 브라우저가 Mac 으로 보이도록 두 레이어를 동시에 위장합니다.
+
+JS 레벨 위장 — `content.js` (`world: MAIN`, `run_at: document_start`)
+
+- `navigator.userAgent` → `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ... Chrome/122.0.0.0 Safari/537.36`
+- `navigator.platform` → `MacIntel`
+- `navigator.userAgentData` → `{ brands: [Chromium/122, Google Chrome/122, Not-A.Brand/24], mobile: false, platform: "macOS" }`
+
+네트워크 레벨 위장 — `rules.json` (declarativeNetRequest `modifyHeaders`)
+
+- `user-agent` → 위와 동일한 Mac Chrome 122 문자열
+- `sec-ch-ua-platform` → `"macOS"`
+- 적용 범위: `||chzzk.naver.com` 의 `main_frame` / `sub_frame` / `xmlhttprequest` / `ping` / `script` 요청
+
+JS 와 HTTP 헤더 값을 일치시켜 페이지가 보는 식별값과 서버가 받는 식별값이 어긋나지 않도록 합니다.
+
+## 설치
+
+1. 이 저장소를 `git clone` 또는 ZIP 다운로드해 임의의 폴더에 둡니다.
+2. Chrome 계열 브라우저에서 `chrome://extensions` 접속.
+3. 우상단 **개발자 모드** 활성화.
+4. **압축해제된 확장 프로그램을 로드합니다** 클릭 → 위 폴더 선택.
+5. 치지직(`https://chzzk.naver.com`) 새로고침.
+
+## 파일 구조
+
+```
+manifest.json     확장 정의 (MV3)
+content.js        navigator.userAgent / platform / userAgentData 를 Mac 으로 위장
+rules.json        declarativeNetRequest 로 user-agent / sec-ch-ua-platform 헤더 위장
+popup.html/css/js 툴바 팝업 (상태 표시)
+icons/            확장 아이콘
+```
+
+## 권한
+
+- `declarativeNetRequest`, `declarativeNetRequestWithHostAccess` — 요청 헤더 위장에 필요
+- `host_permissions`: `*://*.naver.com/*`, `*://*.ncloud.com/*` — 치지직 / 네이버 CDN 요청에 규칙 적용
+
+## 알려진 위험
+
+본 확장으로 치지직 페이지를 열었을 때 **"허용되지 않는 비정상적 접근입니다. 반복적인 접근 시 운영 정책에 따라 조치될 수 있습니다."** 팝업이 뜨는 사례가 실측으로 확인되었습니다. 치지직이 JS 의 `navigator.*`, 저엔트로피 Client Hints 외에 고엔트로피 Client Hints (`sec-ch-ua-platform-version`, `sec-ch-ua-arch`, `sec-ch-ua-full-version-list` 등), WebGL renderer, Canvas 등 추가 핑거프린팅 신호를 함께 보는 것으로 추정됩니다. 이 확장은 그 모든 신호를 위장하지는 않습니다.
+
+팝업이 반복되면 계정 제재 가능성이 있다고 명시되어 있으니, 본인 책임 하에 사용하시고 팝업이 뜨면 사용을 중단하시기 바랍니다.
+
+## 면책
+
+본 확장은 학습 및 개인 사용 목적의 우회 도구입니다. 사용에 따른 모든 책임은 사용자에게 있으며, 치지직 약관 및 관련 법령을 준수하여 사용하시기 바랍니다.