リリースノート

チェックポイントでの一時停止 — パイプラインは成果物生成後にチェックポイントで停止し、操作を待って、最後に確認した段階から続行します。

v5.7.3 アップグレード後の白画面を修正 — 分析機能の変更を master にマージする際、git の自動マージが新しいミニファイ済みJSバンドルを古いもののリネームと誤認し、出荷バンドルに <<<<<<<< / >>>>>>>> の

生成動画のモード別分析 — task_completed と task_failed のGA4イベントに、シンプル動画タスク（t2v / i2v / ti2vid / keyframes）向けの mode パラメータが追加されました。cre

進捗パネルで中間成果物の表示が復活 — v5.7.0 のフロントエンド再構築以降、タスク実行中に中間成果物（ストーリー、参照画像、シーンビデオ、字幕など）が表示されなくなりました。進捗パネルはタスク開始時に成果物を読み込み、ポーリング中に各

npm publish ステップが失敗：printf: --: invalid option — リリースワークフローの「Prepare npm README」ステップは printf '---\n...' を使用しており、そのフォーマット

複数 API キーのローテーションとスループット向上 — 複数の Agnes API キーを設定可能（env + 設定ファイル、自動重複排除）。リクエストは KeyRing でキー間をローテーションし、429 レート制限時は即座に次のキーへ

ライト/ダークデュアルモード — Midnight デザインシステムがワンクリックの切り替えでライト・ダーク両テーマに対応しました。

Midnight デザインシステム — 雰囲気のあるダークテーマ、洗練されたタイポグラフィ、間隔、視覚階層を全タスクタブ・設定パネル・進捗ビューに採用した完全なフロントエンド再設計。

UI とスクリプトの紹介リンクが現在の公式サイトパスを指すようになりました（非推奨スラッグを削除）。

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 commit を実行しないため）、npx free-short-video のバージョンがタグと一致し続けます。

単語レベルの字幕タイムライン (v2.0) — 字幕は edge_tts の単語レベルのキュー（正確な真実の情報源）に合わせられます。WhisperX の外部依存関係を削除し、字幕タイミングを正確かつ自己完結にしました。

全言語の字幕が一貫したレンダリングのため 2 行に制限されるようになりました。

モデルセレクター — 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.

Docker ビルドはデフォルトで公式 PyPI ソースを使用するようになりました。中国本土内のビルドでは、ビルド引数によってローカルミラーを選択できます。

リソースナビゲーションバー — ヘッダー下のクイックアクセスリンク（デモ、ホーム、ガイド、FAQ、GitHub）。

詩動画タスクタイプ — 新設の POST /api/tasks/poetry: LLMが詩を複数のシーン（原句 | 映像の説明形式）に分割し、各行をTTSナレーションで読み上げ、シーンをt2vクリップとして生成、字幕をナレーションに時間同期

中間成果物ビューア — タスク詳細パネルで各ステップの中間出力（プロンプト/画像/動画）を表示。モード（クリエイティブ/原稿/アンカー）で絞り込み可能。カスケード削除は対応する状態フィールドをクリアし、下流ステップをリセットし、ファイルをク

6 つの新しい UI 言語 — ドイツ語 (Deutsch)、フランス語 (Français)、オランダ語 (Nederlands)、スペイン語 (Español)、ポルトガル語 (Português)、イタリア語 (Italiano) が

動画ウォーターマーク — 生成動画に自動でウォーターマークを重ね合わせ。言語検出とUIトグルに対応。

構造化シーン設定 — 自由テキストの user_requirement を明示的なパラメータに置き換え：duration_source（手動 / アイデア説明から抽出）、scene_count、uniform_duration / scen

バイリンガル脚本 — 全 14 個の脚本メタプロンプトが中国語/英語の切り替えに対応。

マルチワークスペース管理 — Web UI から直接、複数の作業ディレクトリを追加・切り替え・管理可能。各ワークスペースは生成した動画、アップロード、設定を独自に保持します。

マルチタスク並行制御 — 重み付きセマフォにより複数のタスクが自動的にキューイングされながら並行実行されます。新しいタスクは UI をブロックせず待機列に入ります。

字幕とナレーションの独立制御 — SubtitleConfig を AudioConfig と同格に昇格し、それぞれ独立した enabled スイッチを用意。4 つの組み合わせモード（ナレーション+字幕、ナレーションのみ、字幕のみ、無音）に

i2i終端フレームパイプライン — 画像モデルを agnes-image-2.1-flash に統一。i2i配列API。キャラクター参照画像のサイズ正規化。プログラム的なプロンプト注入でシーン間のキャラクター外観を保持。複数画像による終端フ

APIキーのクリア/リセット — Web UI でキーを完全にクリアできるようになりました（上書きだけでなく）。

共通基盤を持つ3つのタスクタイプ — シンプル動画（単一プロンプト→Agnes Video APIで1本の動画、t2v/i2v/ti2vid/keyframes）、クリエイティブ動画（AI脚本家→ストーリーボード→シーン別動画→edge_t

Web UI — ワンクリック起動、すべてブラウザ上で操作、コマンドラインは不要。