비디오 챕터 진행률 막대
사용자 흐름
- 먼저 사용자가 현재 대화에서 SRT 파일을 업로드했는지 또는 이번에 사용할 SRT 파일 경로를 명확히 제공했는지 확인합니다. 이런 출처의 자막만 직접 읽을 수 있습니다. 현재 대화에 사용자가 제공한 SRT가 없으면 반드시 다음과 같이 응답합니다: "먼저 이 동영상의 SRT 자막 파일을 업로드해 주세요. 자막을 기반으로 표 형식으로 구간 제안을 드리고, 확인 후 진행률 막대를 제작하겠습니다." 그런 다음 사용자가 제공할 때까지 기다립니다. 이때 파일 검색, 자막 읽기, 콘텐츠 분석 또는 진행률 막대 생성을 수행하지 않습니다. 로컬 컴퓨터, 현재 작업 공간, 이전 프로젝트, 다운로드 디렉토리, 다른 대화 또는 기억 속에서 SRT를 검색하지 않으며, 적합해 보이는 자막을 선택하지 않습니다. 현재 대화에서 사용자가 이미 제공한 파일은 재사용할 수 있으며, 다시 요청하지 않습니다. 여러 개가 제공되었지만 어느 것을 사용할지 지정되지 않은 경우 먼저 문의합니다. 지정된 파일을 읽을 수 없는 경우 사용자에게 다시 업로드하거나 경로를 확인하도록 요청하며, 대체 파일을 검색하지 않습니다. 사용자가 명확하게 스타일을 보거나 고정 길이 샘플을 제작해 달라고 요청하는 경우에만 내장 샘플 콘텐츠를 사용할 수 있습니다. "진행률 막대를 생성해 줘"와 같은 말은 이 예외에 해당하지 않습니다.
- 전체 SRT를 읽고, 내용 의미, 주제 전환, 비디오 길이 및 사용자 요구 사항에 따라 챕터 수를 제안합니다. 고정된 세그먼트 수 상한선은 없습니다. 사용자가 지정한 구분이 우선 적용됩니다. 먼저 "X개의 세그먼트로 나누는 것을 제안합니다"라고 설명한 후, 아래 표를 사용하여 구간 제안을 반드시 나열해야 합니다. 사용자가 확인할 때까지 기다린 후 계속 진행합니다. 사용자가 병합 또는 분할을 요청하는 경우 전체 표를 업데이트한 후 다시 확인합니다. 표를 일반 텍스트 목록으로 대체하지 말고, 사용자에게 시간 코드를 확인하도록 요구하지 않습니다.
- 구간이 확인된 후, 현재 세션에서 비디오 화면 비율이 명확하지 않은 경우 반드시 먼저 물어봐야 합니다: "동영상 화면 비율이 4:3, 16:9, 3:4 중 무엇인가요? 다른 비율도 알려주세요." 답변을 받은 후 계속 진행합니다. 자막, 이전 샘플 또는 Playground의 미리보기 크기를 기반으로 기본 비율을 가정하지 않습니다. 이미 비율이 명확하거나 원본 비디오가 있어 크기를 확인할 수 있는 경우 바로 사용하며, 다시 묻지 않습니다.
- 이 스킬의
scripts/playground_server.mjs를 실행하여 이번 시작 시 반환된progressUrl을 열고 실제 동적 샘플을 표시합니다. 시작 스크립트는 자동으로 동일한 버전의 서비스를 재사용하며, 포트가 다른 프로그램이나 이전 버전에 의해 점유된 경우 자동으로 포트를 변경합니다. 기본 포트 점유를 설치 실패로 간주하지 말고, 확인되지 않은 버전의 이전 페이지를 직접 재사용하거나 알 수 없는 프로세스를 종료하지 마십시오. 사용자가 스타일 이름을 응답하도록 하고, 애니메이션 구현이나 인코딩을 판단하도록 요구하지 않습니다. 이미 선택한 스타일은 다시 선택하지 않습니다. - 사용자가 '캐릭터 리드' 또는 '텍스트 리드'를 선택한 경우에만 캐릭터를 처리합니다. references/characters.md에 따라 로컬에 저장된 개인 기본 캐릭터를 읽습니다. 사용자가 이번에 특정 캐릭터를 지정한 경우 이번 선택을 우선합니다. 그렇지 않고 개인 기본 캐릭터가 있으면 바로 사용하고 간략히 알리며, 다시 요청하거나 생성하지 않습니다. 기록이 없는 경우 사용자 정의 이미지를 제공할지 묻고, 제공하지 않으면 내장 캐릭터를 사용합니다. 응답하지 않음은 '없음'과 같지 않습니다. 새 사용자 정의 캐릭터의 걷기 효과는 사용자 확인 후 로컬에 설치된 스킬 내
user-data/characters/에 저장되어 다음 기본값이 됩니다. 사용자가 이번에만 사용한다고 명확히 밝힌 경우 기본값을 변경하지 않습니다. 캐릭터가 없는 스타일을 선택한 경우 캐릭터에 대해 묻지 않고, 읽지 않으며, 저장하지 않습니다. 개인 원본 이미지, 동작 프레임 및 구성은 공용 assets, SKILL.md, Git 커밋 또는 GitHub에 기록하지 않습니다. 업데이트 설치 시 로컬 user-data를 유지합니다. - 확인된 비디오 비율, 챕터 및 스타일에 따라 references/rendering.md를 참조하여 구성을 저장하고, dry-run을 수행하고, 생성하고, 확인한 후 좁은 막대 ProRes 4444 MOV를 제공합니다. 자막이 제작 후에 추가, 삭제 또는 속도가 변경된 경우 다시 동기화해야 합니다.
구간 제안의 고정 출력 형식
| 단락 | 진행률 막대 짧은 제목 | 내용 요약 | 시작 원문 | 종료 원문 |
|---|---|---|---|---|
| 1 | 짧은 챕터명 | 이 단락의 내용 | SRT에서 한 글자씩 인용한 첫 문장 | SRT에서 한 글자씩 인용한 마지막 문장 |
각 단락은 한 행이며, 제목은 진행률 막대에 사용되고, 요약은 사용자가 구간 분할을 판단하는 데 도움을 주며, 원문 범위는 사용자가 위치를 찾는 데 도움을 줍니다. 표 다음에는 사용자에게 채택 여부를 확인하거나 병합, 분할, 제목 변경이 필요한 부분을 지적해 달라고 요청합니다. 원문을 요약으로 바꾸면 안 됩니다. 챕터가 너무 많아 텍스트가 들어가지 않는 경우 실제 레이아웃 문제를 설명하고 제목 단축, 글꼴 크기 조정 또는 기타 레이아웃 방안을 제시하며, 사용자가 결정합니다. 스타일에 맞추기 위해 강제로 5개 단락으로 압축하거나 이미 확인된 챕터를 임의로 병합하지 않습니다.
확인 정보는 현재 세션에서 계속 유효하며, 다시 요청하지 않습니다. 명시적인 승인 없이 원고를 수정하거나, 자막을 변경하거나, 원본 비디오를 편집하지 않습니다.
검증된 스타일
-
연한 흰색 배경 (
soft-white-green): 직각 가로 막대, 반투명 흰색 배경, 흰색 챕터 텍스트 및 세로 구분선, 채우기는 해당 시간에 따라 진행됩니다. -
캐릭터 리드 (
walking-leading): 위의 가로 막대를 계승하며, 채우기 전면에서 리드하는 캐릭터만 추가됩니다. 캐릭터는 막대와 높이가 같고, 몸체는 아래로 이동하며, 막대 바깥으로 최대 막대 높이의 절반만 노출되고 막대 위를 걷지 않습니다. -
도트 라인 (
dot-line): 가는 선과 점이 챕터 진행에 따라 색상이 변하며, 텍스트와 점 사이의 간격은 6px입니다. -
짧은 세그먼트 (
short-segments): 각 챕터마다 짧은 선이 있으며, 해당 챕터 시간에 따라 색상이 채워지고, 텍스트와 짧은 선 사이의 간격은 6px입니다. -
텍스트 리드 (
text-leading): 텍스트가 챕터 진행에 따라 색상이 변하고, 캐릭터가 전면에서 리드하며, 긴 막대 배경색이 없습니다. 작은 글꼴 크기에는 테두리가 없으며, 4배 정밀도로 그리고 단일 투명도 합성을 사용합니다.
다섯 가지 스타일 모두 RGB 채우기 색상을 임의로 수정할 수 있습니다. 새로 추가된 세 가지 스타일은 18–72px 글꼴 크기(내보내기 픽셀 기준)를 지원하며, 기본값은 각각 24, 26, 25px이고, 출력 높이는 텍스트에 따라 자동으로 조정됩니다. 녹색은 기본 색상일 뿐이며, 사용자가 Playground에서 선택한 색상 코드는 공식 구성에 기록되어야 합니다. 미리보기에서 색상을 변경했지만 내보내기에서는 여전히 녹색이어서는 안 됩니다.
규칙의 진정한 출처는 references/confirmed-rules.md이며, 등록표는 assets/progress/styles.json입니다. 검증된 스타일만 표시하고 생성합니다. 새 스타일은 사용자가 실제 샘플을 보고 승인한 후에 등록합니다.
승인 및 전달
- 스크립트는 자막 범위, 제목 레이아웃, 크기, 완전한 디코딩, 프레임 수, 길이 및 투명 픽셀을 확인합니다. Agent는 또한 연락처 시트, 실제 내보내기 프레임 및 동적 미리보기를 열어 캐릭터 루프, 크롭, 챕터 전환 및 색상을 확인해야 합니다.
- 연한 흰색 배경 1440×64; 캐릭터 리드 1440×96, 막대 높이 64, 캐릭터 최대 높이 64, 아래쪽 최대 노출 32. 새로 추가된 세 가지 스타일의 기본 크기는 각각 1440×78, 1440×70, 1440×96입니다. 텍스트 리드 캐릭터 최대 높이 64, 아래쪽 최대 노출 32. 막대 높이를 변경할 때도 동일한 비율로 계산하며, 기본적으로 전체 캔버스를 내보내지 않습니다.
- 다운로드되는 것은 좁은 막대 ProRes 4444 MOV입니다. 투명 WebM은 브라우저 미리보기용입니다.
reference-qtrle.mov는 내부 검증에만 사용되며 전달되지 않습니다. 일반 MP4를 투명 비디오 대신 사용하지 마십시오. - 막대와 캐릭터를 제외한 모든 부분은 투명해야 합니다. 미리보기 배경색, 사선 또는 체크 무늬를 파일에 굽지 마십시오.
- 사용자가 이번 좁은 막대 ProRes 4444가 캡컷에서 작동함을 확인했습니다. 새 파일도 여전히 확인해야 하며, 브라우저가 정상이거나 알파가 존재한다고 해서 모든 버전의 캡컷이 지원된다고 가정하지 마십시오.
- 절대 경로의 완성품 링크를 반환하고, 원본 비디오 위 트랙, 시작 부분 정렬, 원래 속도 유지, 너비 전체 채우기 및 최상단으로 이동에 대해 설명합니다. 샘플은 길이를 명확히 표시해야 하며, 사용자 비디오의 전체 길이 진행률 막대인 것처럼 가장할 수 없습니다.
텍스트를 기반으로 몇 초의 독립적인 짧은 애니메이션을 생성하거나 챕터 전환에는 ll-video-motion을 사용합니다. 내레이션, 전체 자막 및 연속素材 편집에는 ll-video-edit를 사용합니다.