Files
watch_sceen_ai/PLAN.md
claude-owner 7d20a40a84 feat(capture): lock decision #1 and prove Xvfb+Chromium frame capture
Decision #1: watch the real Discord screen share by running a real web client
under a virtual display (Xvfb) and capturing rendered frames — not bot/selfbot
protocol receive. PLAN.md records all locked decisions and the step list.

PoC (poc/capture_xvfb.py + test_page.html) launches system Chrome non-headless
under Xvfb via Playwright and captures 6 changing, non-blank frames -> de-risks
the display+capture chain on the .9 host.
2026-08-09 20:52:57 +09:00

51 lines
2.8 KiB
Markdown

# watch_sceen_ai — 착수 계획 (확정본)
디스코드 화면공유를 실시간으로 함께 보며 **음성으로** 대화하는 AI.
## 확정된 결정 (2026-08-09)
1. **캡처 방식 (눈)** — 봇 프로토콜 수신/셀프봇 ❌.
.9 서버에 **가상 디스플레이(Xvfb) + 진짜 디스코드 클라이언트(웹 Chromium)** 를 띄우고,
상대의 공유 스트림 화면을 **프레임으로 캡처**한다.
- 근거: Discord 공식 봇은 비디오 송수신을 모두 막음. 셀프봇 수신 라이브러리는 없고(있어도 송출 전용) 유저토큰 필요 → 밴 위험.
- 진짜 클라이언트가 스트림을 정상 디코딩/렌더 → 우리는 그 픽셀만 읽음. 무인 서버 실행 가능.
- WebRTC 특성상 완전 `--headless` 불가 → Xvfb 가상 X 서버 필요.
2. **대화 방식** — 음성 실시간. STT→LLM→TTS 스트리밍으로 지연 최소화, 사용자 인터럽트 지원.
3. **두뇌** — Claude **OAuth**로 가장 싸고 빠른 모델(Haiku 계열).
+ .9의 RTX 5050으로 소형 로컬 VLM을 돌려 매 프레임 1차 이해·**화면 변화 감지**를 값싸게 처리,
어려운 화면만 Haiku로 에스컬레이션 (하이브리드).
4. **실행 위치** — 이 리눅스 호스트(.9).
## 단계별 착수 목록
### 1단계 · 눈: 캡처 파이프라인 ← 지금
- [x] 호스트 도구 확인 (Node/Xvfb/ffmpeg/google-chrome 존재)
- [ ] **PoC: Xvfb에서 비-헤드리스 Chromium이 재생 화면을 렌더 → 프레임 캡처 검증** (최대 리스크 선제거)
- [ ] 캡처 주기 + 프레임 변화 감지(동일 화면 반복 전송 방지)
- [ ] 프레임을 파이프라인에 공급하는 소스 인터페이스
### 2단계 · 디스코드 접속
- [ ] Xvfb 크롬에서 Discord 웹 로그인 (별도 계정 권장)
- [ ] 음성 채널 참여 + 상대 스트림 "보기" 클릭 자동화
- [ ] 스트림 video 영역만 크롭 캡처
### 3단계 · 두뇌 (하이브리드 비전)
- [ ] 로컬 VLM(예: moondream2 / Qwen2-VL-2B) 프레임 1차 이해 + 변화 감지
- [ ] Claude OAuth(Haiku)로 어려운 프레임 에스컬레이션
- [ ] 최신 화면 맥락 저장소
### 4단계 · 음성 대화
- [ ] STT (faster-whisper, 스트리밍/부분전사)
- [ ] 대화 브레인 (화면맥락 + 대화이력)
- [ ] TTS (MeloTTS 등, 이 호스트에 자산 있음)
- [ ] 말 끊기 인터럽트 + 지연 최적화
### 5단계 · 통합·운영
- [ ] 인지 루프 + 대화 루프 동시 실행
- [ ] proactive(화면 크게 바뀌면 먼저 말 걸기)
- [ ] 끊김 복구, 비용 모니터링, 서비스화
## 주의
- 캡처용 디스코드 계정은 메인 말고 **별도 계정 권장**(자동화 회색지대, 밴 위험 최소화).
- 로컬 GPU 8GB VRAM 제약 → 소형 VLM만. 큰 이해는 클라우드.