vision.cpp: mmlab 배포 경로 완성 — 비정사각 러너 · 래퍼 규약 · 검증 하네스 결함 5건

[201815054]

develop 32커밋. 배포 경로(vision-cli)로 mmdet·mmseg·mmpose 가 전부 돈다.

왜 지금인가

가이드를 fresh clone 에서 문서대로 밟아보니 코드가 넷 틀려 있었다. 하네스로는 다 통과하는데
사용자가 쓸 경로는 아무도 안 밟았기 때문이다.

러너 — 비정사각 입력 (c2ff2ea)

vision-cli 가 정사각 리사이즈만 했다. 비정사각 모델을 주면 크래시 없이 조용히 틀린다.

모델	전	후
mmseg cityscapes 512×1024	512×512 로 줄어 출력 155,648 → 77,824	온전
mmpose 256×192	전 계열 불가	통과

근원은 install_arch.py 의 traced_size — 비정사각을 경고까지 찍으면서 가로를 버렸다.

• preprocess(out_size) → preprocess(dst_w, dst_h). 정사각 오버로드를 남겨 기존 호출부 무수정
• arch_registry 에 input_w/input_h. 0 이면 옛 input_size — 완전 호환

프론트엔드 규약 (7f611da)

• mmseg_wrap.save() / mmpose_wrap.save() — .pt 와 그걸 여는 모듈 전부를 같이 쓴다.
  PYTHONPATH 가 필요 없어졌다 (mmdet 이 이미 쓰던 규약)
• forward() 가 항상 튜플. 출력 하나면 벌거벗은 Tensor 였는데 build() 는 shape 을 늘
  리스트로 줘서, 호출자가 outs[0][0] 로 두 겹 벗기면 19채널이 1채널이 됐다
• install_loader_modules 가 형제 폴더 모듈을 못 찾던 것

검증 하네스 (eb772bb, 727dfd4, b135765)

못 잰 것을 실패로 적던 자리 다섯. 전부 하네스 결함이고 모델은 멀쩡했다.

결함	영향
verify_postproc.py 상대경로 .. 2→3	허용목록 미적용 → DETR 8계열이 torch 2.6 에서 죽음
used.json 죽은 절대경로 + 조용한 폴백	래퍼 4계열이 남의 짝으로 재고 실패처럼 보임. 폴백 제거
_IMG_DIR .. 3→4	계열별 이미지 매핑 무효 → 트래커 3계열 양쪽 0건
DH 에 mmdet 누락	two-stage 전수가 첫 줄에서 죽음
detect_shapes() 정규식이 파일 포맷과 불일치	클래스 수가 언제나 80 으로 조용히 폴백

실측 (2026-09-01, fresh clone)

one-stage 박스 전수	42 / 44 (못 잼 0)
two-stage 박스 전수	40 / 45 · fpg 는 1024 에서 0.28px
배포 경로 YOLO26	박스 3개, README 와 소수점까지 동일
배포 경로 mmseg	155,648 원소, PyTorch 와 일치
배포 경로 mmpose	408,576 원소, 비정사각 256×192

남은 계열은 전부 fp16 정밀도이고 fp32 로는 통과한다. 컴파일러 결함 0.

⚠️ 이 PR 을 GTX_Compiler#14 보다 먼저 머지해야 한다 — #14 의 서브모듈 포인터가 여기 커밋을 가리킨다.