CD
3d3f74b082
- 5단계 파이프라인: 다운로드 → 프레임 추출 → 패턴 감지 → 중복 제거 → PDF 생성 - 3가지 패턴 지원: overlay, split, scroll - MSE 기반 픽셀 비교 프레임 중복 제거 - split 모드: 42% 크롭 + 밝기 필터 + Tab 라인 검증 - overlay 모드: 320x120 정규화 + 슬라이딩 윈도우 비교 - 프로젝트 문서 초기 작성 (architecture, tech-stack, STATUS, known-issues)
57 lines
2.6 KiB
Markdown
57 lines
2.6 KiB
Markdown
# Known Issues & Lessons Learned
|
||
|
||
> **이 파일은 SSOT(Single Source of Truth)입니다.**
|
||
> 디버깅이나 구현 전에 **반드시** 이 파일을 확인하세요.
|
||
> 세션 종료 시 새로 발견된 이슈를 이 파일에 추가합니다.
|
||
|
||
---
|
||
|
||
## 포맷
|
||
|
||
각 항목은 아래 형식을 따릅니다:
|
||
|
||
```markdown
|
||
### [날짜] [키워드] — 한줄 요약
|
||
- **증상**: 무엇이 잘못되었는가
|
||
- **원인**: 근본 원인
|
||
- **해결**: 올바른 해결 방법
|
||
- **주의**: 재발 방지를 위한 교훈
|
||
```
|
||
|
||
---
|
||
|
||
## 공통 이슈
|
||
|
||
### [2026-03-08] PowerShell curl — Invoke-WebRequest 충돌
|
||
- **증상**: `curl` 명령이 예상과 다른 응답 형식을 반환
|
||
- **원인**: PowerShell에서 `curl`은 `Invoke-WebRequest`의 별칭
|
||
- **해결**: **`curl.exe`**를 명시적으로 사용
|
||
- **주의**: HTTP 관련 모든 명령에서 `curl.exe` 사용 필수
|
||
|
||
### [2026-03-08] PowerShell npm — 실행 정책 오류
|
||
- **증상**: `npm run` 명령이 `실행 정책` 관련 오류로 실패
|
||
- **원인**: PowerShell 스크립트 실행 정책이 제한적으로 설정됨
|
||
- **해결**: `cmd /c npm run dev` 형식으로 cmd를 통해 실행
|
||
- **주의**: npm 관련 명령은 항상 `cmd /c` 접두어 사용 권장
|
||
|
||
---
|
||
|
||
## 프로젝트별 이슈
|
||
|
||
### [2026-03-24] 히스토그램 비교 — Tab 프레임 구분 불가
|
||
- **증상**: 서로 다른 Tab 페이지가 "동일"로 판정되어 프레임 수가 과소 추출
|
||
- **원인**: 히스토그램 상관관계는 밝기 분포만 비교 — Tab 용지 배경이 같으면 다른 내용도 동일로 판정
|
||
- **해결**: MSE 픽셀 비교로 전환 (320px 리사이즈, factor 8)
|
||
- **주의**: MSE scaling factor는 영상 타입에 따라 다르게 동작할 수 있음
|
||
|
||
### [2026-03-24] split 감지 — 밝은 배경 오분류
|
||
- **증상**: 밝은 배경 기타 연주 영상(空奏列車)이 split으로 오분류
|
||
- **원인**: 흰 셔츠/밝은 배경이 상단 밝기 조건 통과, 기타줄이 _has_tab_lines 통과
|
||
- **해결**: split 검증 강화 (top>180, bottom<100, diff>80, 4+ lines) + overlay 우선 검사
|
||
- **주의**: 패턴 감지 순서는 반드시 overlay → split → scroll 유지
|
||
|
||
### [2026-03-24] overlay 크롭 크기 불일치
|
||
- **증상**: overlay 프레임 비교 시 모든 프레임이 "다르다"로 판정 (1000+개 추출)
|
||
- **원인**: _detect_tab_overlay가 프레임마다 다른 크기의 바운딩박스 반환 (69~360px)
|
||
- **해결**: 320×120 흰색 캔버스에 정규화 후 비교 + 슬라이딩 윈도우(5프레임)
|
||
- **주의**: overlay 프레임 수 최적화는 아직 진행 중 (추가 튜닝 필요) |