ChenShuo2004/cs-board

📽️ cs‑board – ローカルAIホワイトボード動画制作ワークステーション

一言で言うと

中文のテキスト、参照音声、およびオプションのスタイル/キャラクター画像を、ワンクリックで音声合成、イラスト、手書きアニメーション、字幕、音声・映像同期のMP4ホワイトボードアニメーションに変換します。

---

🎯 コアコンセプト

• ローカル実行 – 音声、モデル呼び出し、生成された素材すべてがローカルに保存され、プライバシーとセキュリティを確保。
• エンドツーエンドのパイプライン – 音声クローン → テキスト分割 → イラスト生成 → 手書きアニメーション → 字幕/合成 → MP4エクスポートまで、すべて自動化。
• オプションのクラウドサービス – MiniMax H3、OpenLux などの OpenAIプロトコル互換APIを介してテキスト・画像モデルを呼び出し、IndexTTS（Gradio/FastAPI）を自前でデプロイしてローカル音声クローンも可能。
• ローカルネットワーク協働 – 複数のPCが同一の作業キューを共有し、同一ネットワーク内でチームで協働可能。

---

🛠️ 主な機能

機能	説明
ローカル音声クローン	自前で構築した IndexTTS サービスに接続。参照音声は本機内に留まり、人物・ブランド専用のナレーションを実現。
12種類のビジュアルテンプレート	極簡ホワイトボードからサイバーネオン、中国風カートゥーン、3Dクレイまで、各テンプレートには独自のカラーパレット、線のスタイル、構図の提案が付属。
カスタムキャラクター/画風	最大5人のキャラクターを登録可能。各キャラクターに1〜3枚の参照画像、または1枚の全体的なスタイル画像をアップロード。システムが全編で一貫したスタイルを維持。
動的インフォグラフィック	ナレーションのリアルタイム軸に基づき、一文ずつ出現する知識カードを自動生成。画面がナレーションを先取りするのを防ぐ。
中国語キーワードのオーバーレイ	4〜10文字の中国語キーフレーズをローカルでレンダリング。一般的な中国語の文字化け問題を回避可能。いつでも無効化可能。
コントロール可能なリズム	字幕のオン/オフ、筆圧の調整、4段階の描画量選択、1枚の画像に1〜4つのシーンを収容。動画のリズムを柔軟に制御。
タスクの再利用/復元	ナレーション、シーン分割、画像、動画セグメントにチェックポイントを設け、ローカルレンダリング設定を変更してもモデルの再呼び出し不要。
ローカルネットワーク協働	同一LAN内のマシンが共有キュー、進捗、履歴を確認可能。個人の設定は各ブラウザに保存される。

---

🚀 素早く始める（5分で開始）

1. 環境準備 – Windows 10/11、macOS 15+、Python 3.11+、Node 22.13+、PATHにFFmpeg/FFprobeが設定済み。IndexTTS 2.5 サービスにアクセス可能で、OpenLux API Key（テキスト＋画像モデル権限）が必要。
2. インストール（macOSを例に）

   brew install python@3.13 node ffmpeg
   python3.13 scripts/prepare_env.py
   .venv/bin/python -m pip install -r webapp/requirements.txt
   (cd web && npm ci)
   

3. 起動

   ./start-webapp.sh   # Windowsはstart-webapp.ps1を使用
   

   ブラウザが自動で http://127.0.0.1:13000/ を開きます。
4. API設定 – 右上隅の API設定 にOpenLux API Key、テキストモデル（デフォルト gpt-5）、画像モデル（デフォルト gpt-image-2）、IndexTTSアドレスを入力。Testをクリックして接続確認。
5. 動画作成 – 10〜30秒の参照音声をアップロード、中文テキストを貼り付け、制作モード（標準/カスタム/動的インフォグラフィック）とビジュアルテンプレートを選択、開始をクリックするだけで完了。

---

📚 利用シーン

モード	推奨される使用状況
標準制作	知識解説、ストーリー口述、講座宣伝 – シーン分割、イラスト生成、ホワイトボードアニメーションを自動生成。
カスタム参照	ブランド動画、固定IP、シリーズコンテンツ – スタイル画像とキャラクター参照をアップロードし、一貫したキャラクターと画風を実現。
動的インフォグラフィック	商業分析、意見表明、講義コンテンツ – ナレーションと同期して出現する動的カードで、視聴者が「聞くと同時に理解」できるように支援。

---

📁 プロジェクト構造概要

assets/          # ペン、テンプレート素材
docs/            # 動的インフォグラフィックワークフロー文書
examples/        # デモGIF/動画
scripts/         # レンダリング、タイムライン、メンテナンススクリプト
tests/           # ユニット/統合テスト
video_renderer/  # Remotion（Reactベース）動画レンダラー
web/             # Reactフロントエンド
webapp/          # FastAPIバックエンド
start‑webapp.*   # 1クリック起動スクリプト（Windows/Unix）

---

🧪 開発/テストガイド

• フロントエンド：(cd web && npm test)
• バックエンドタスクキューとチェックポイント復元：python -m unittest discover -s tests -v
• Remotionの型チェック：(cd video_renderer && npm run build)

---

🤝 貢献とライセンス

• 貢献 – IssueまたはPull Requestを提出。レンダリングロジックの変更は、実際の素材を用いたタイミング、マスク、完成映像の検証を添えてください。
• ライセンス – MIT License。

---

📢 スポンサー

MiniMax H3 動画生成API（ミーダテクノロジー）は低価格の768p/2K動画生成を提供。OpenAIプロトコル互換でComfyUIもサポート。専用リンクを使用するとクレジットを獲得可能。

---

要するに：cs‑boardは「テキスト＋音声」を「手書きホワイトボードアニメーション」に変換するエンドツーエンドツール。個人クリエイターおよび小規模チームがローカルで高品質な中国語動画を迅速に制作でき、カスタムスタイルとローカルネットワーク協働もサポートします。