# 작업 사양: ACT2 — 3D 세트장 s03에서 결투 장면 빈 배경 4컷 캡처 (0크레딧)

목적: 액션씬 "영수증 결투"의 3D 배경 버전 준비. 웹 세트장 `muyeo-s03`(캠퍼스 내 도로)에서 컷별 카메라 구도로 **사람이 없는 빈 배경**을 캡처한다. 실사 변환은 이 작업 범위 밖이다(다음 단계, Codex).

## 절대 규칙
- 크레딧이 드는 도구(`dreamina-canvas`, 이미지·영상 생성 API)를 호출하지 않는다.
- 수정·생성 가능: `C:/Ai_Coding/apps/studio/episodes/2026-11-17_action-duel-3d/` 아래만.
- **`apps/agent-tower/` 아래 파일은 읽기만 한다.** sets/muyeo-s03의 app.js, index.html, s03.glb도 수정 금지.
- 다른 워커가 `episodes/2026-11-17_action-duel/`에서 작업 중이다. 그 폴더는 건드리지 않는다.
- 로컬 서버는 `127.0.0.1`에만 바인딩한다. 작업이 끝나면 서버 프로세스를 종료한다.

## 참고 (읽기)
- `C:/Ai_Coding/apps/agent-tower/sets/muyeo-s03/README.md`, `app.js`
  - 프리셋 좌표: overview, c01, hurdle, han
  - 도로는 x축 방향 약 200m, 보행로는 z≈5 부근, 한조교 구역은 x≈156
- 캡처 방식 견본: `C:/Ai_Coding/apps/agent-tower/tools/capture_tour_cover.py`
  - playwright headless chromium, `--use-angle=swiftshader`
- app.js의 camera는 window에 노출돼 있지 않다. 그래서 **에피소드 폴더에 캡처 전용 페이지를 새로 만든다.**
  - `capture/index.html`: three@0.160.0 CDN, GLTFLoader로 `/sets/muyeo-s03/s03.glb`를 로드하고, 조명은 app.js와 같은 값을 쓴다.
  - 정적 서버 루트는 `C:/Ai_Coding/apps/agent-tower`로 두고, 캡처 페이지는 그 아래 경로로 접근한다.
  - 캡처 페이지 파일은 에피소드 폴더에 두고, 서버에서 접근할 수 있게 경로를 구성한다(예: 서버를 `C:/Ai_Coding/apps`에 띄우고 두 경로를 모두 참조).

## 할 일
1. glb 노드 이름 목록을 뽑아 `capture/nodes.txt`에 저장한다.
   - **인물·마네킹·캐릭터·사람 형상 메시**(이름에 char, man, person, mannequin, areum, han, 인물 등)는 숨긴다(`visible=false`).
   - 숨긴 노드 목록을 기록한다.
   - 이름만으로 판단이 안 되면, 캡처 화면에 사람 형상이 보이는지 확인해서 판단한다.
2. 1920×1080, 사람 없음으로 4장을 캡처한다. HUD는 없어야 한다.

   | 파일 | 컷 | 구도 |
   |---|---|---|
   | `BG3D-C1.png` | C1 대치 | 와이드 정면. 보행로 중앙선을 따라 길이 멀리 뻗는 소실점 구도, 눈높이 1.6m, 화각 넓게(약 24mm 상당). 양옆 가로수 |
   | `BG3D-C2.png` | C2 돌진·회피 | 보행로 옆에서 보행로를 수직으로 바라보는 측면 구도, 눈높이 1.4m, 약 35mm. 화면 좌우로 길이 지나감 |
   | `BG3D-C3.png` | C3 결재판 | 로우앵글. 높이 0.6m에서 약간 올려다봄, 약 28mm. 배경에 나무 윗부분과 하늘 |
   | `BG3D-C4.png` | C4 종이비 | 와이드 고정, 높이 2.5m에서 보행로를 비스듬히 내려다봄, 약 24mm |

   - 위치는 한조교 구역(x≈150~160) 근처의 직선 보행로를 우선한다. 4컷이 **같은 장소**로 읽혀야 한다.
3. 카메라 값(position, target, fov)을 `capture/cameras.json`에 저장한다. 다시 캡처할 수 있어야 한다.
4. `capture/contact.png`를 만든다. 4장을 2×2로 축소해 합친 것이다.
5. `README.md`에 다음을 짧게 적는다.
   - 무엇을 어떻게 캡처했는지
   - 숨긴 노드
   - 각 컷의 용도
   - 다음 단계: Codex로 실사 배경 변환 → 원본과 50% 겹쳐 구도 확인 → Seedance 생성

## 완료 보고에 붙일 것
1. `ls -R` 에피소드 폴더
2. 숨긴 노드 목록
3. `cameras.json` 내용
4. 4장 각각의 해상도(ffprobe 또는 PIL)
5. contact.png 경로
6. 사람 형상이 남아 있는지 직접 확인한 결과. 남아 있으면 남아 있다고 그대로 보고한다.
