Communitygithub.com

batch-video-transcription

비디오 배치 파일에서 전체 타임라인 오디오를 추출하고, 타임스탬프가 포함된 중국어 자막, 화자 구분, Word 문서 및 로컬 HTML 검색 결과를 생성합니다. 명시적으로 batch-video-transcription으로 호출될 때만 사용하세요.

batch-video-transcription란 무엇인가요?

이 스킬은 배치 비디오 파일의 전체 타임라인 오디오를 추출하여 타임스탬프, 화자 구분(Speaker Diarization)이 포함된 중국어 자막, Word 문서, 로컬 HTML 검색 결과를 생성하는 전문 도구입니다. Alibaba Cloud Beijing Fun-ASR만이 구현된 인식 제공자이며, 사용자는 명시적으로 호출해야 합니다. 로컬에서 실행되며 외부 소프트웨어 설치, 오디오 업로드 또는 공개 배포를 자동으로 수행하지 않습니다. 워크플로는 미디어 범위 확인, 로컬 인터페이스 또는 CLI를 통한 배치 작업 준비, 비용 추정, API 키 입력, 결과 검증 및 복구 단계로 구성됩니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트와 함께 사용하도록 설계되었으며, 멱등성 있는 처리를 보장하고 오류 발생 시 제한된 재시도를 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/s010s/batch-video-transcription-skill/tree/HEAD

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Batch Video Transcription

명시적으로 호출된 후에만 사용하세요. Alibaba Cloud Beijing Fun-ASR만이 유일하게 구현된 인식 제공자입니다. 호출이 소프트웨어 설치, 오디오 업로드, 지출 또는 공개 배포를 허가하지 않습니다.

워크플로

  1. 정확한 미디어 범위와 독립적인 작업 폴더를 설정합니다. 원본 비디오를 보존합니다. 안정적인 다운로드, 오디오 트랙, 여유 공간, Python 3.10+, FFmpeg 및 ffprobe를 확인합니다. 설정이 필요한 경우에만 종속성을 읽고, 호환 가능한 환경을 재사용하며 설치 전 허가를 받으십시오.
  2. 로컬 인터페이스(python scripts/app.py)를 선호하여 사용자가 폴더를 선택하고 검토할 수 있도록 합니다. 기존 배치의 경우 --work '<work>'를 사용하세요. 다시 초기화하지 마십시오. 준비는 로컬에서 수행되며, 선택된 하위 집합은 절대 자동으로 확장되지 않습니다. 기본 내보내기 폴더는 <source>/Transcription-Export입니다. 이전 출력을 삭제하거나 덮어쓰지 않고 충돌을 해결하십시오. CLI 준비 및 정확한 범위 옵션은 실행을 참조하십시오.
  3. 실제 개수, 길이, 대상 및 현재 가격 추정치를 보고합니다. 이 배치의 업로드 및 총 한도에 대한 허가를 받으십시오. 이전에 발생할 수 있는 요금을 자동으로 고려하세요. 사용자에게 잔여 예산을 계산하도록 요청하지 마십시오. 예약 비용은 실제 청구 또는 사용 가능한 계정 크레딧이 아닙니다.
  4. 사용자가 로컬 마스킹 필드에 비공개로 키를 입력하고 배치를 확인하도록 합니다. 채팅, 스크린샷, DOM, 요청, 파일 또는 프로세스 메모리를 통해 키를 절대 읽지 마십시오. 관련 없는 항목을 수정하기 위해 현재 실행 중인 작업을 교체하지 말고 유지하십시오. 키가 없는 작업 상태와 출력만 관찰하십시오.
  5. 각 소스에 대해 전달된 파일을 타임스탬프 및 텍스트를 포함하여 확인합니다. 제공자가 확인한 결과 없는 단어는 정상적인 완료 출력으로 간주하고 간략한 사실 메모를 추가합니다. 이를 침묵의 증거로 간주하지 마십시오. 미해결 제출, 실제 실패 및 완료되지 않은 다운로드를 완료와 구분합니다. 요청 시 python scripts/merge_export.py --work '<work>'를 사용하여 결합된 Word 요약을 생성합니다. 표현과 비디오별 화자 ID를 보존합니다. 수행되지 않은 듣기, 재생 또는 시각적 검사가 있으면 보고하십시오.

복구

배치당 하나의 라이터를 유지하고 작업 ID, 시도 기록 및 비용 예약을 보관합니다. 알려진 ID를 조회하고 다운로드를 복구하기 위해 다시 제출하지 마십시오. 일시적 쿼리에 대해 제한된 재시도/백오프를 사용하고 해결되지 않은 항목을 분리하여 관련 없는 작업이 계속 진행될 수 있도록 합니다. 잠금을 해제하거나 오류 기록을 지워 진행을 강제하지 마십시오.

손실된 제출 응답이 요금을 발생시켰을 수 있습니다. 불확실한 시도를 보존합니다. 가능한 경우 이를 조정하거나, 제한된 새 시도 전에 중복 요금 가능성에 대한 명시적 수락을 얻고, 두 예약 모두 승인된 총액 내에 있도록 합니다. 정확히 한 번 전달을 주장하지 마십시오. 더 큰 예산은 별도의 사용자 결정입니다.

복구 작업을 제공하기 전에 사용자의 일시 중지를 존중합니다. 진행 중인 요청은 취소할 수 없습니다. 안전한 경계에서 반환된 ID를 저장하십시오. 소스/디스크 변경, 자격 증명 오류 및 할당량 실패는 진단이 필요하며, 무작정 재시도하지 마십시오. 상태 및 자격 증명 경계는 작업을, 복구 명령은 실행을 참조하십시오.

범위 및 유지보수

인터페이스를 로컬 전용으로 유지하고 세션 링크를 공유하지 마십시오. 키는 프로세스 재시작 후에도 유지되지 않습니다. 시스템 키체인 저장소 또는 테스트되지 않은 호스트/플랫폼 동작을 구현된 것으로 광고하지 마십시오.

제공자를 추가할 때만 providers를 로드하고, 호스트별 복사본을 설치하거나 배포할 때만 host-packaging을 로드하십시오. 코드 변경 후 python scripts/check_tests.py를 실행하십시오. 모의 테스트는 실제 인식을 증명하지 않습니다. 소스, 문서 및 테스트만 패키징하고, 런타임 데이터나 자격 증명은 절대 패키징하지 마십시오.

관련 스킬