docs: 발표·특허·AI영상요약 자료 및 작업기록 추가

- 발표자료(좌표투영·측점기반재생) 갱신 + 그림/PDF
- 특허 출원 초안 및 도면
- AI 영상요약 서비스 작업기록(docs/history)
- 관련 scripts 추가

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-09 11:20:03 +09:00
co-authored by Claude Opus 4.8
parent 5c8b499979
commit fe25ce00f1
78 changed files with 6186 additions and 15 deletions
@@ -0,0 +1,42 @@
# AI Video Brief — 음성 선택지 코덱 효율 반영 추천 정렬
**소요 시간**: 4분
**Context 사용량**: input 900k / output 66k tokens (추정값)
## 요청 내용
음성 목록에서 같은 상황일 때 자동으로 가장 음질 좋은 걸 "추천"으로 더 똑똑하게 골라주도록.
## 배경
기존 음성 정렬은 단순히 비트레이트(abr) 내림차순 → 코덱 효율 차이를 무시.
Opus는 AAC보다 ~1.3배 효율적이라, 105kbps Opus ≈ 130kbps AAC 수준인데도 순위에서 밀렸음.
## 구현 내용 (`ai_video_brief`)
`app/services/downloader.py`:
- `_ACODEC_INFO` / `_audio_codec()` 추가 — acodec → (표시이름, 효율계수)
- Opus 1.3, AAC 1.0, Vorbis 0.9, MP3 0.85, Dolby 1.0
- `list_formats()` 음성 파트:
- 각 항목에 `codec`(표시이름), `score`(= abr × 효율계수, 실제 체감 음질) 추가
- 중복 제거 키를 (코덱, abr)로 변경 → 같은 코덱+비트레이트만 병합, 코덱 다르면 둘 다 유지
- 정렬을 `-score, -abr` 순으로 (실제 음질 높은 순, 동점 시 비트레이트 높은 순)
`app/static/index.html`:
- 음성 항목 메타에 코덱 표시 추가: "Opus · webm · 약 45MB"
## 테스트 결과 (DJI 영상)
```
105kbps Opus(webm) 점수=136 ← 추천(맨위) ※ 예전엔 129kbps AAC가 맨위였음
129kbps AAC(m4a) 점수=129
50kbps Opus(webm) 점수=65
49kbps AAC(m4a) 점수=49
```
Opus 105kbps가 AAC 129kbps보다 위로 올라와, 실제 음질 기준으로 정확히 추천됨.
## 참고
- 최종 저장은 여전히 mp3 192kbps 재인코딩 (소스 음질이 좋을수록 mp3 결과도 좋음)
- 효율계수는 일반적 통념 기반의 근사값 (정밀 측정값 아님)