Width-Concat Refactor Plan

EgoX2 (rgb) — Roadmap & Plan

260406-260412 · 8/9 phases done · smoke test pending

Steps9
완료8/9
Progress89%
Nextsmoke

Overall Vision

EgoX의 ego_Prior + GGA + depth/camera 기반 복잡한 conditioning을 전부 벗겨내고, Wan I2V 표준 image-conditioning 패턴(first-frame + zero temporal padding)을 ego 슬롯에 그대로 적용한 단순 베이스라인을 확보한다. 그 위에 Wan 2.2 I2V A14B 학습이 동작하면, 이후 다양한 해상도/데이터셋으로 빠르게 포팅 가능한 미니멀 코드베이스가 된다.

이번 주 갱신된 Phase 체크리스트

StepCommit목적상태
Step 0 — Baseline 검증WanTransformer forward 시그니처 + VAE temporal field 정적 검증✅ 완료
Step 1 — Dead file 삭제bfa0929custom_transformer.py + demb_samerope_trainer.py 제거✅ 완료 (−1430)
Step 2 — GGA/ego_prior/depth/camera 제거291149ffirst-frame conditioning + config widths✅ 완료 (−870)
Step 3 — width_concat helperd64e0e1_base/width_concat.py 헬퍼 5개 추출✅ 완료 (+115)
Step 4 — README + status_update9ce0a88문서 갱신✅ 완료 (−72)
Step 5 — Wan 2.2 어댑테이션4951484CLIP 조건부 로드, pipeline 수동 조립✅ 완료 (+56)
Step 6 — yaml config 시스템a33e56a2-stage argparse + dataset_type dispatch✅ 완료 (+113)
Step 7 — Dataset 분리23779b4EgoExo4D / DROID dataset 클래스 분리✅ 완료 (+130)
Step 8 — Smoke test1-step 학습 + 1-sample 추론 검증❌ 다음 사이클
Step 9 — transformer_2 dispatch2.2 low-noise expert 활용 결정❌ 검토 중

설계 결정 (이번 주)

결정 1: ego 슬롯 = first-frame + zero temporal padding

후보 (a) ego=0, (b) [exo_clean | random_ego], (c) channel 제거 중에서 user 지시로 (d) Wan I2V 표준 패턴 채택. 근거: VAE temporal field 실측에서 t=0 latent가 ff를 bit-identical하게 담음. pretrained 분포와 정합.

결정 2: square-ego 가정 파기

기존 pipeline은 exo_width = width - height; ego_width = height로 ego가 정사각형이라고 가정. DROID는 ego도 768 wide → 가정이 깨짐. Args.exo_width / Args.ego_width를 명시 인자로 받고 width = exo_width + ego_width를 내부에서 계산.

결정 3: _base/ 헬퍼 prefix

_base/의 underscore prefix가 core/finetune/models/__init__.py의 auto-import 필터에 걸려 register 대상에서 제외됨. 즉 wan_i2v/sft_trainer.py가 명시 import할 때만 로드 — 향후 Wan 2.2 1.3B 포팅 시 같은 헬퍼를 안전하게 재사용.

결정 4: transformer_2 무시

Wan 2.2 I2V A14B는 high-noise / low-noise dual expert. exp1이 transformer 하나만 쓰는 전략을 따름. 추후 품질 문제 발견 시 boundary_ratio dispatch 추가 고려.

Dependencies & Risks

Milestones

마일스톤예상실제코멘트
Width-concat 리팩토링04-1204-11~12예정대로
Wan 2.2 어댑테이션04-1204-111일 단축
Dataset 분리 + yaml config04-12계획 외 추가
Smoke test (1-step train)04-13다음 사이클