릴리스 노트

체크포인트 일시 중지 — 파이프라인이 산출물 생성 후 체크포인트에서 멈추고 사용자 조작을 기다린 뒤 마지막으로 확인한 단계부터 계속합니다.

v5.7.3 업그레이드 후 빈 화면 문제 수정 — 분석 기능 변경 사항을 master에 병합하는 과정에서 git 자동 병합이 새 축소 JS 번들을 이전 번들의 이름 변경으로 오인하여 <<<<<<<< / >>>>>>>

생성된 비디오의 모드별 분석 — task_completed 및 task_failed GA4 이벤트가 이제 단순 비디오 태스크(t2v / i2v / ti2vid / keyframes)에 대해 mode 매개변수를 포함합

진행 패널에서 중간 산출물 표시 복원 — v5.7.0 프론트엔드 재구성 이후, 작업 실행 중에 중간 산출물(스토리, 참조 이미지, 장면 비디오, 자막 등)이 더 이상 표시되지 않았습니다. 이제 진행 패널은 작업 시작

npm publish 단계 실패: printf: --: invalid option — 릴리스 워크플로의 «Prepare npm README» 단계는 printf '---\n...'를 사용했으며, 형식 문자열이 -로

멀티 API 키 순환 및 처리량 향상 — 여러 Agnes API 키를 설정할 수 있으며(env + 설정 파일, 자동 중복 제거), 요청은 KeyRing을 통해 키 간에 순환됩니다. 429 요청 제한 시 다음 키로 즉

라이트/다크 이중 모드 — Midnight 디자인 시스템이 이제 원클릭 토글로 라이트·다크 테마를 모두 지원합니다.

Midnight 디자인 시스템 — 분위기 있는 다크 테마, 세련된 타이포그래피, 간격, 시각적 위계를 모든 작업 탭, 구성 패널, 진행 뷰에 적용한 완전한 프론트엔드 재설계.

UI 및 스크립트의 추천 링크가 이제 현재 공식 사이트 경로를 가리킵니다(더 이상 사용하지 않는 slug 제거).

22개 언어 UI — 공식 사이트에 맞춰 언어 지원을 22개 언어로 확장했습니다.

작업 폼의 프롬프트 예시 — 각 작업 유형 폼(심플/크리에이티브/원고/앵커)에 프롬프트 예시로 연결되는 가이드 링크가 표시되며, 13개 언어 모두 현지화됩니다.

web/ 라우팅 계층 — server.py를 모듈식 라우트 계층(web/routes/)으로 분리. 구조와 테스트 용이성 개선.

선택적 GA4 분석 — 사용자 작업과 오류 보고를 추적합니다. 설정 스크립트가 맞춤 측정기준과 주요 이벤트를 자동 구성합니다.

Agnes 도메인 설정(com/cn) — Agnes API 기본 도메인을 구성할 수 있습니다. .cn 도메인으로 전환하면 이전의 API_ROOT 정의되지 않음 오류 없이 작동합니다.

imageio-ffmpeg 종속성을 명시적으로 선언했습니다. npm README에 ffmpeg 설정이 문서화되었습니다.

imageio-ffmpeg가 이제 명시적 종속성이 되었고, npm README에 ffmpeg 설정이 문서화되어 npm install -g free-short-video 후 비디오 연결이 작동합니다.

Docker / npm 페이지의 빠른 시작 — Docker Hub 개요와 npm README 모두 빠른 시작(pull / run / npx free-short-video)으로 시작하고 그 뒤에 현재 릴리스의 "새로운

Docker Hub 개요 업데이트가 100바이트 짧은 설명 제한을 준수하므로 페이지 제목과 설명이 올바르게 게시됩니다.

제품 브랜딩을 일관되게 하기 위해 레지스트리 페이지 제목(GHCR / Docker Hub)이 Free Short Video로 변경되었습니다.

릴리스 워크플로: npm publish가 이제 셸 검사로 단계 내부에서 보호됩니다. NPM_TOKEN이 없으면 npm publish만 건너뛰며 Docker 이미지 릴리스를 절대 차단하지 않습니다.

릴리스 워크플로: npm 버전이 npm pkg set을 통해 동기화되므로(detached HEAD에서 git 커밋 없음), npx free-short-video 버전이 태그와 일치하게 유지됩니다.

단어 수준 자막 타임라인 (v2.0) — 자막이 이제 edge_tts의 단어 수준 큐(정확한 진실 소스)에 정렬됩니다. WhisperX 외부 종속성을 제거하여 자막 타이밍을 정밀하고 자체 포함적으로 만들었습니다.

모든 언어의 자막이 일관된 렌더링을 위해 이제 두 줄로 제한됩니다.

모델 선택기 — UI에서 텍스트 / 이미지 / 비디오 모델을 직접 선택합니다. 새 agnes-2.5-flash 모델에는 테스트 중(베타) 알림이 표시됩니다.

Docker Hub 페이지는 간결한 설명과 완전한 README 기반 개요를 표시하며, 릴리스 때마다 자동으로 갱신됩니다.

Docker Hub 개요 업데이트가 이제 100바이트 짧은 설명 API 제한을 준수하여 설명과 README가 올바르게 게시됩니다.

GHCR 풀 경로가 ghcr.io/lcy362/free-short-video:<version>으로 수정되었습니다. 잘못된 orphan-cleanup 단계가 제거되었습니다.

릴리스 워크플로: 고아 정리 단계가 더 이상 if 조건에서 시크릿을 참조하지 않아 멀티아키텍처 이미지 게시가 안정적으로 유지됩니다.

GHCR 이미지가 이제 GITHUB_TOKEN으로 푸시되어 패키지를 이 저장소에 연결하고 멀티아키텍처 풀 명령이 안정적으로 작동하게 됩니다.

Docker 데이터 영속성 — 이미지가 이제 /app/.working_dir 및 /app/.agnes_config에 VOLUME을 선언합니다. 원커맨드 실행과 바인드 마운트 실행 방법을 문서화하여 출력물과 설정이 컨

릴리스 노트에 이제 GHCR과 Docker Hub의 풀 명령이 모두 표시됩니다. GHCR 태그 형식이 v 접두어를 제거하도록 수정되었습니다(예: ghcr.io/lcy362/free-short-video:4.7.2).

Docker 빌드가 이제 기본적으로 공식 PyPI 소스를 사용합니다. 중국 본토 내 빌드는 빌드 인수를 통해 로컬 미러를 선택할 수 있습니다.

리소스 탐색 모음 — 헤더 아래의 빠른 접근 링크(데모, 홈, 가이드, FAQ, GitHub).

시(詩) 영상 태스크 유형 — 새 POST /api/tasks/poetry: LLM이 시를 여러 장면(원문 줄 | 화면 설명 형식)으로 나누고, 각 줄을 TTS 내레이션으로 읽으며, 장면을 t2v 클립으로 생성하고,

중간 산출물 뷰어 — 작업 상세 패널이 각 단계의 중간 출력(프롬프트/이미지/비디오)을 표시하며, 모드(크리에이티브/원고/앵커)로 필터링할 수 있습니다. 캐스케이드 삭제는 해당 상태 필드를 지우고, 하위 단계를 초기

새로운 UI 언어 6개 — 독일어(Deutsch), 프랑스어(Français), 네덜란드어(Nederlands), 스페인어(Español), 포르투갈어(Português), 이탈리아어(Italiano)가 추가되어 완

비디오 워터마크 — 생성된 비디오에 자동 워터마크 오버레이. 언어 감지와 UI 토글 지원.

구조화된 장면 구성 — 자유 텍스트 user_requirement를 명시적 매개변수로 대체: duration_source(수동 / 아이디어 설명에서 추출), scene_count, uniform_duration /

이중 언어 시나리오 — 14개 시나리오 메타 프롬프트 모두 중국어/영어 전환을 지원합니다.

다중 작업 영역 관리 — 웹 UI에서 직접 여러 작업 디렉터리를 추가, 전환, 관리합니다. 각 작업 영역은 자체 생성된 동영상, 업로드, 설정을 유지합니다.

다중 작업 동시성 제어 — 가중치 세마포어로 여러 작업을 자동 대기열과 함께 동시 실행할 수 있습니다. 새 작업은 UI를 차단하지 않고 대기열에 들어갑니다.

자막과 내레이션 독립 제어 — SubtitleConfig를 AudioConfig와 동급으로 승격하고 각각 독립된 enabled 토글을 제공합니다. 4가지 조합 모드(내레이션+자막, 내레이션만, 자막만, 무음)를 지원

i2i 엔드 프레임 파이프라인 — 이미지 모델을 agnes-image-2.1-flash로 통일. i2i 배열 API. 캐릭터 참조 이미지 크기 정규화. 프로그램 방식 프롬프트 주입으로 장면 간 캐릭터 외형 유지. 다

API 키 지우기/리셋 — Web UI에서 키를 덮어쓰기만 하는 대신 완전히 지울 수 있습니다.

공통 기반을 가진 세 가지 태스크 유형 — 심플 비디오(단일 프롬프트→Agnes Video API로 단일 비디오, t2v/i2v/ti2vid/keyframes), 크리에이티브 비디오(AI 시나리오 작가→스토리보드→씬

Web UI — 원클릭 실행, 전부 브라우저에서 작업, 명령줄 불필요.