yd-session-recording

세션 실시간 녹음·요약 (강의·회의·교육)

whisper-stream으로 마이크 입력을 실시간 전사하고, ffmpeg로 오디오 원본(session.m4a)을 병행 저장하며, 10분 간격 루프로 누적 요약과 질문 후보를 갱신한다. 회차 산출물은 전부 작업 디렉터리 아래 session-<YYYY-MM-DD_HHMM>/ 안에 모은다 (기존 자료가 lecture-<날짜>/ 관례를 쓰는 레포면 그 관례를 따른다).

전제 조건

• whisper-stream 바이너리(whisper.cpp의 stream 예제)와 한국어 지원 모델이 설치돼 있어야 한다. 시작 전에 한 번 확인하고, 없으면 사용자에게 설치 여부를 먼저 묻는다 — 임의로 대용량 모델을 다운로드하지 않는다.
  • 바이너리: command -v whisper-stream (macOS는 brew install whisper-cpp 계열로 설치 가능)
  • 세 도구를 한 번에 점검하는 명령: python3 <스킬경로>/scripts/session_ctl.py check-tools. whisper-stream 이나 모델이 없으면 exit 1 이다. ffmpeg 만 없으면 exit 0 으로 두고 전사만 진행하라고 안내한다.
  • 모델: ~/models/whisper/ggml-large-v3-turbo.bin (기본 가정 경로 — 다르면 사용자에게 확인)
• 오디오 원본 저장에는 ffmpeg 가 필요하다 (command -v ffmpeg, macOS 는 brew install ffmpeg). 없으면 사용자에게 설치 여부를 묻고, 설치를 원치 않으면 전사만으로 진행한다 — 오디오 저장이 없으면 부정확한 구간을 재청취·재전사할 수 없다는 점을 한 줄 알린다.
• 용어집(glossary) — 고유명사 오인식을 줄이는 2층 사전 구조를 쓴다:
  • 스킬 내장 공용 사전: resources/glossary.d/00-common-it.txt (도메인 무관 IT 용어. 프로젝트·회사 고유명사를 여기에 커밋하지 않는다 — 공개 레포다)
  • 로컬 사전: ~/.config/session-recording/glossary.d/*.txt (개인 전역) 와 작업 디렉터리의 glossary.txt (프로젝트별). 둘 다 없으면 "용어집 없이 시작할까요?" 를 한 번 묻는다.
  • 형식은 한 줄 한 항목 정식표기 | 오인식1, 오인식2 | 비고 ('#' 줄과 빈 줄 무시).
• 이미 설치돼 있으면 재설치·재다운로드하지 않는다.

트리거

시작 절차

1. 세션(강의·회의) 제목·주제를 한 줄 묻는다. 요약 헤더와 교정 프롬프트의 도메인 맥락으로 쓴다. 이미 대화에서 알 수 있으면 묻지 않는다.

2. 회차 디렉터리 생성, 입력 볼륨 설정, whisper-stream 기동 순서다 (프로젝트 루트 기준). session_ctl.py 가 디렉터리 이름 짓기, 용어집 병합, PID 기록을 맡는다:

   CTL="python3 <스킬경로>/scripts/session_ctl.py"
   SESSION=$($CTL new .)   # session-<YYYY-MM-DD_HHMM>, 같은 분에 또 만들면 -2 를 붙인다
   osascript -e 'set volume input volume 70'   # macOS
   # 용어집 병합 → 정식표기만 뽑아 프롬프트로 (내장 공용 + 로컬 전역 + 프로젝트)
   $CTL run "$SESSION" whisper -- whisper-stream \
     -m ~/models/whisper/ggml-large-v3-turbo.bin \
     -l ko -t 8 --step 3000 --length 10000 \
     --prompt "다음 용어가 등장하는 회의: $($CTL glossary)" \
     -f transcript.txt