구술편집 v2
Volcengine 전사 + AI 말실수 인식 + 웹 검토
빠른 사용
사용자: 이 구술 동영상을 편집해줘
사용자: 이 비디오를 처리해줘
출력 디렉토리 구조
output/
└── YYYY-MM-DD_동영상명/
├── 구술편집/
│ ├── 1_전사/
│ │ ├── audio.mp3
│ │ ├── volcengine_result.json
│ │ └── subtitles_words.json
│ ├── 2_분석/
│ │ ├── readable.txt
│ │ ├── auto_selected.json
│ │ └── 말실수분석.md
│ └── 3_검토/
│ └── review.html
└── 자막/
└── ...
규칙: 기존 폴더가 있으면 재사용, 없으면 새로 생성.
워크플로우
0. 출력 디렉토리 생성
↓
1. 오디오 추출 (ffmpeg)
↓
2. 업로드하여 공개 URL 획득 (uguu.se)
↓
3. Volcengine API 전사
↓
4. 단어 수준 자막 생성 (subtitles_words.json)
↓
5. AI 말실수/무음 분석, 사전 선택 목록 생성 (auto_selected.json)
↓
6. 검토 웹페이지 생성 (review.html)
↓
7. 검토 서버 시작, 사용자 웹 확인
↓
【사용자 확인 대기】→ 웹페이지에서 "편집 실행" 클릭 또는 수동 /편집
실행 단계
단계 0: 출력 디렉토리 생성
# 변수 설정 (실제 동영상에 따라 조정)
VIDEO_PATH="/path/to/동영상.mp4"
VIDEO_NAME=$(basename "$VIDEO_PATH" .mp4)
DATE=$(date +%Y-%m-%d)
BASE_DIR="output/${DATE}_${VIDEO_NAME}/구술편집"
# 하위 디렉토리 생성
mkdir -p "$BASE_DIR/1_전사" "$BASE_DIR/2_분석" "$BASE_DIR/3_검토"
cd "$BASE_DIR"
단계 1-3: 전사
cd 1_전사
# 1. 오디오 추출 (파일명에 콜론이 있으면 file: 접두사 필요)
ffmpeg -i "file:$VIDEO_PATH" -vn -acodec libmp3lame -y audio.mp3
# 2. 업로드하여 공개 URL 획득
curl -s -F "files[][email protected]" https://uguu.se/upload
# 반환: {"success":true,"files":[{"url":"https://h.uguu.se/xxx.mp3"}]}
# 3. Volcengine API 호출
SKILL_DIR="/Users/chengfeng/Desktop/AIos/편집Agent/.claude/skills/구술편집"
"$SKILL_DIR/scripts/volcengine_transcribe.sh" "https://h.uguu.se/xxx.mp3"
# 출력: volcengine_result.json
단계 4: 자막 생성
node "$SKILL_DIR/scripts/generate_subtitles.js" volcengine_result.json
# 출력: subtitles_words.json
cd ..
단계 5: 말실수 분석 (스크립트 + AI)
5.1 읽기 쉬운 형식 생성
cd 2_분석
node -e "
const data = require('../1_전사/subtitles_words.json');
let output = [];
data.forEach((w, i) => {
if (w.isGap) {
const dur = (w.end - w.start).toFixed(2);
if (dur >= 0.5) output.push(i + '|[묵' + dur + 's]|' + w.start.toFixed(2) + '-' + w.end.toFixed(2));
} else {
output.push(i + '|' + w.text + '|' + w.start.toFixed(2) + '-' + w.end.toFixed(2));
}
});
require('fs').writeFileSync('readable.txt', output.join('\\n'));
"
5.2 사용자 습관 읽기
먼저 사용자습관/ 디렉토리의 모든 규칙 파일을 읽습니다.
5.3 문장 목록 생성 (핵심 단계)
먼저 문장을 분리한 후 분석해야 합니다. 묵음에 따라 문장 목록으로 나눕니다:
node -e "
const data = require('../1_전사/subtitles_words.json');
let sentences = [];
let curr = { text: '', startIdx: -1, endIdx: -1 };
data.forEach((w, i) => {
const isLongGap = w.isGap && (w.end - w.start) >= 0.5;
if (isLongGap) {
if (curr.text.length > 0) sentences.push({...curr});
curr = { text: '', startIdx: -1, endIdx: -1 };
} else if (!w.isGap) {
if (curr.startIdx === -1) curr.startIdx = i;
curr.text += w.text;
curr.endIdx = i;
}
});
if (curr.text.length > 0) sentences.push(curr);
sentences.forEach((s, i) => {
console.log(i + '|' + s.startIdx + '-' + s.endIdx + '|' + s.text);
});
" > sentences.txt
5.4 스크립트 자동 묵음 표시 (먼저 실행해야 함)
node -e "
const words = require('../1_전사/subtitles_words.json');
const selected = [];
words.forEach((w, i) => {
if (w.isGap && (w.end - w.start) >= 0.5) selected.push(i);
});
require('fs').writeFileSync('auto_selected.json', JSON.stringify(selected, null, 2));
console.log('≥0.5s 묵음 수:', selected.length);
"
→ 출력 auto_selected.json (묵음 idx만 포함)
5.5 AI 말실수 분석 (auto_selected.json에 추가)
감지 규칙 (우선순위별):
| # | 유형 | 판단 방법 | 삭제 범위 |
|---|---|---|---|
| 1 | 반복문 | 인접 문장 시작 ≥5자 같음 | 짧은 전체 문장 |
| 2 | 한 문장 건너 반복 | 중간에 잔여문이 있을 때 앞뒤 문장 비교 | 앞 문장 + 잔여문 |
| 3 | 잔여문 | 말하다 중단 + 묵음 | 전체 잔여문 |
| 4 | 구문 내 반복 | A+중간+A 패턴 | 앞부분 |
| 5 | 더듬거림 | 저거 저거, 그러니까 그러니까 | 앞부분 |
| 6 | 재발음 교정 | 부분 반복/부정 교정 | 앞부분 |
| 7 | 감탄사 | 음, 아, 저거 | 표시만 하고 자동 삭제 안 함 |
핵심 원칙:
- 먼저 문장 분리, 그 다음 비교: sentences.txt로 인접 문장 비교
- 전체 문장 삭제: 잔여문, 반복문은 전체 문장을 삭제해야 하며, 이상한 몇 글자만 삭제하는 것이 아님
분할 분석 (반복 실행):
1. readable.txt 읽기 offset=N limit=300
2. sentences.txt와 결합하여 이 300줄 분석
3. 말실수 idx를 auto_selected.json에 추가
4. 말실수분석.md에 기록
5. N += 300, 1단계로 돌아가기
🚨 핵심 경고: 줄 번호 ≠ idx
readable.txt 형식: idx|내용|시간
↑ 이 값을 사용
줄 번호 1500 → "1568|[묵1.02s]|..." ← idx는 1568이지, 1500이 아닙니다!
말실수분석.md 형식:
## 제N 구간 (줄 번호 범위)
| idx | 시간 | 유형 | 내용 | 처리 |
|-----|------|------|------|------|
| 65-75 | 15.80-17.66 | 반복문 | "이것은 제가 편집한 예제입니다" | 삭제 |
단계 6-7: 검토
cd ../3_검토
# 6. 검토 웹페이지 생성
node "$SKILL_DIR/scripts/generate_review.js" ../1_전사/subtitles_words.json ../2_분석/auto_selected.json ../1_전사/audio.mp3
# 출력: review.html
# 7. 검토 서버 시작
node "$SKILL_DIR/scripts/review_server.js" 8899 "$VIDEO_PATH"
# 열기 http://localhost:8899
사용자가 웹페이지에서:
- 동영상 구간 재생 확인
- 삭제 항목 선택/해제
- "편집 실행" 클릭
데이터 형식
subtitles_words.json
[
{"text": "대", "start": 0.12, "end": 0.2, "isGap": false},
{"text": "", "start": 6.78, "end": 7.48, "isGap": true}
]
auto_selected.json
[72, 85, 120] // Claude 분석 생성된 사전 선택 인덱스
설정
Volcengine API Key
cd /Users/chengfeng/Desktop/AIos/편집Agent/.claude/skills
cp .env.example .env
# .env 편집하여 VOLCENGINE_API_KEY=xxx 입력