docs: add Colab GPU test notebook for real-model verification

CPU-only dev env verified via mocks; the notebook runs the full real
pipeline on Colab Pro T4: clone → ffmpeg/venv install → detect (GPU
capability tier) → 127 unit/integration tests → sample TTS (KO+EN
tech terms) → real faster-whisper transcription → hotword/postprocess
→ API smoke → benchmark.

README.md

@@ -108,6 +108,17 @@ docker compose --profile gpu up -d
 
 API + Redis + 워커, 공유 스토어 볼륨. `LUKESCRIBE_API_KEYS` 필수.
 
+## Colab 실전 테스트 (GPU)
+
+이 저장소의 CI/개발 환경은 CPU-only라 모델·ffmpeg는 mock으로만 검증했다.
+GPU + 실제 faster-whisper 모델로 실전 검증하려면 **Colab 노트북**을 사용한다
+(Colab Pro T4 GPU 권장 — 터미널에서도 동일 명령 실행 가능):
+
+- `notebooks/luke-scribe-colab.ipynb` — 클론 → 설치 → `detect`(GPU 감지) →
+  테스트 → 샘플 TTS 생성 → **실제 한국어 전사** → hotword/후처리 → API 스모크 → 벤치마크
+- 노트북은 `scripts/build_colab_notebook.py`로 생성/재생성한다
+- private 저장소이면 1번 셀의 `GITEA_TOKEN`에 토큰을 넣는다
+
 ## 알려진 제한 (v0.1)
 
 - 실시간 decode는 `EngineOwner` 스텁 (실제 WS decode는 GPU 환경에서 활성화).