一键在 Manus 中运行任何 Skill

bake-3d

星标29

分支2

更新时间2026年7月26日 01:05

3D シーンを映像素材（クリップ）として使いたいとき、3D ベイクレシピ（scene.py）を新規作成・調整・再ベイクするときに発動する。Blender ヘッドレスでレシピを mp4 に焼き、検証し、素材ライブラリ / プロジェクトへ配置するまでを担う。映像の上に重なるオーバーレイ 3D は対象外（overlay-authoring/3d.md へ）。

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

AkariLabs

AkariLabs/akari-video

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

FORBIDDEN 級ハードルール

Language: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。

ベイクを実行せずに「焼けた」と報告しない。 出力 mp4 を ffprobe で確認し、フレームを抽出して目視するまで完了扱いにしない。
scene.py に宣言済み param 以外の外部入力を持ち込まない。 環境変数・wall-clock・暗黙 seed の乱数・ネットワーク取得は禁止。同じレシピ + 同じ params + 同じ Blender バージョン → 同じ映像、を崩さない。
連番静止画を残さない。 mp4 へ直書きする。中間連番が必要だった場合は合成後に必ず削除する。
モデル・HDRI 等のアセット実体を改変しない。 調整はツマミ（param）の範囲で行う。ライセンス不明のアセットをレシピに同梱しない（harvest-asset の規律を継承）。
Blender をユーザー確認なしにインストールしない（setup-library/tools-check.md と同じ）。
node packages/schemas/bin/validate-asset.mjs を通さずにライブラリ入庫を「検証済み」と報告しない。

契約

正典: docs/contract-2026-07-14-3d-bake-recipe.md。レシピ = SSOT（scene.py + param + アセット参照）、ベイク出力 = 再生成可能キャッシュ。焼いた mp4 は edit.json の通常クリップとして扱う（エンジン・ビューワーは無改修）。

1. Blender の探索

BLENDER="${AKARI_BLENDER_BIN:-}"
[ -z "$BLENDER" ] && BLENDER="$(command -v blender || true)"
[ -z "$BLENDER" ] && BLENDER="/Applications/Blender.app/Contents/MacOS/Blender"
test -x "$BLENDER" && "$BLENDER" --version | head -1

なければ brew install --cask blender を提示して止まる（無断実行しない）。

2. scene.py の authoring 契約

参照実装: assets/3d/vintage-camera-turntable/scene.py

自己完結: レシピディレクトリ単体をプロジェクトへコピーしても動くこと。リポ内の他ファイルを import しない。アセットは os.path.dirname(os.path.abspath(__file__)) 相対で読む
引数契約（-- 以降を argparse で受ける）: --out <path>.mp4 / --profile draft|final / --fps N / --frame-start N / --frame-end N / --set key=value（複数可）
PARAM_DEFAULTS 辞書 = meta.json の knobs と 1:1。未宣言キーの --set はエラーにする
時間はフレーム番号の純関数。アニメーションはドライバの安全式サブセット（frame 変数 + 算術）または線形キーフレームで表現し、wall-clock を使わない
profile は品質 2 段: draft = EEVEE 低解像度（ツマミ調整の反復用）/ final = 出力解像度。同じ scene.py が両方を通る
Blender 5.x API 注意（5.1.2 実測）: エンジン ID は BLENDER_EEVEE（_NEXT は廃止）。動画出力は image_settings.media_type = "VIDEO" を先に立ててから file_format = "FFMPEG"（4.x に media_type は無いので hasattr で分岐）
出力名へ Blender がフレーム範囲を付けるケースに備え、レンダー後に --out の名前へ正規化する（参照実装の render() を踏襲）

3. ベイク実行

"$BLENDER" -b -P scene.py -- \
  --out bakes/<id>-draft.mp4 --profile draft \
  --fps 30 --frame-start 1 --frame-end 120 \
  --set orbit_start_deg=205

実測目安（M シリーズ Mac / EEVEE / 720p / 16 samples）: 約 0.5〜0.6 秒/フレーム。draft 4 秒素材 ≒ 1 分
ベイク出力は bakes/（git ignore 済み: *.mp4）。消してよい。final はプロジェクト書き出し直前だけ

4. 検証（必須）

ffprobe で解像度・fps・フレーム数が指定と一致することを確認する
先頭・中間・末尾のフレームを ffmpeg -ss <t> -frames:v 1 で抽出して目視する（構図・ライティング・アニメーションの向き）
ライブラリ入庫時は中間フレームから preview.png を作り、node packages/schemas/bin/validate-asset.mjs assets/3d/<id> を通す

5. ライブラリ入庫 / プロジェクト採用

入庫基準は素材ライブラリ契約と同じ: シーン構築・ライティング・カメラワークの設計コストが高いレシピだけを入れる
meta.json は knobs を param で宣言し、requires: ["blender"]。provenance にアセットの取得元・ライセンス・梱包手順を書く
プロジェクト採用 = レシピ一式を <project>/assets/3d/<id>/ へ複製 → params 上書き → ベイク → mp4 を edit.json にクリップ配置。provenance にレシピ id / 版 / params / Blender バージョンを記録する

よくある間違い

EEVEE ヘッドレスの動作を検証せず「焼ける」と報告する（GPU 環境依存。必ず実行する）
THREE.Clock 的発想で wall-clock や random() に依存したアニメーションを書く
ツマミを cssVar で宣言する（ベイクレシピは param。cssVar はオーバーレイ素材用）
fragment.html と scene.py を同じ素材ディレクトリに同居させる（validate-asset.mjs が拒否する）
.blend にテクスチャをパックして肥大化させる / 連番 EXR を残してディスクを焼く
draft で確認せずいきなり final を焼いて反復時間を溶かす

同仓库更多 Skills

同仓库

edit-plan

AkariLabs/akari-video

analyze-project が作る分析レポート（interpretation.json + analysis-report.html）を一次証拠として読み、方針・素材計画・実行をチャットの明示承認で確定したうえで edit.json v0 とオーバーレイ HTML へ落とすスキル。複数素材の編集計画、素材ゼロからの生成計画（質問対話 → plan.json の仮枠タイムライン確定）、分析結果からカットや BGM・SFX・B ロールを決める依頼で使う。

2026-07-2629

generate-narration

AkariLabs/akari-video

原稿テキストから VOICEVOX（ローカル・ゼロ円の既製声）または fal Qwen3-TTS（自声クローン）でナレーション音声を生成し、edit.json の audio.narration[] へ書き込むスキル。ナレーションを作ってほしいと頼まれたとき、仮ナレ（下書き試聴）が欲しいとき、声プロファイルを新規に作りたいとき、または既存のナレーションをエンジンや声で差し替えたいときに使う。

2026-07-2629

address-review

AkariLabs/akari-video

review.json の open チケット（annotation）を edit.json への実対応 → edit-lint → チケット更新まで型どおりに執行するスキル。「a-0002 と a-0003 に対応して」「open チケット全部に対応して」で発動する。状態機械（open → addressed + response 必須・resolved 不可侵・黙殺禁止）を bin/respond.mjs が原子的に守る QA ループの消費側。

2026-07-2629

analyze-footage

AkariLabs/akari-video

動画素材 1 本から 720p プロキシ、ローカル既定の文字起こし（Mac は macOS SpeechAnalyzer / 共通は whisper.cpp・クラウドは承認制）、視認済みキーフレーム、編集イベント、人物関連トラックを作り、analysis.json v0 にまとめるスキル。新しい撮影素材を取り込むとき、素材単体の編集前分析を頼まれたとき、または edit-plan の前処理として素材ごとの分析が必要なときに使う。

2026-07-2629

analyze-project

AkariLabs/akari-video

プロジェクト内の素材群（analysis.json）と周辺プロジェクト文脈（intake.json・edit.json・planning/・README・過去 PJ）を読み合わせて interpretation.json（解釈層）を作り、事実 + 素材の読みに限定した読み取り専用の分析レポートを描画するスキル。複数素材プロジェクトの内容を素材横断で把握したいとき、analyze-footage が素材ごとの分析を終えたあとの統合、方向性を決める前に一次情報の欠落（取材質問）を洗い出したいときに使う。edit-plan は方針決めの前提としてこのスキルの出力を読む。

2026-07-2629

render-cut

AkariLabs/akari-video

承認済み edit.json と edit-lint PASS を入力に、最終 MP4 の計画、明示承認、ローカル書き出し、ffprobe 検証、キーフレーム視認を完了する。編集が承認済みで、納品用動画の書き出しや最終レンダーを求められたときに使う。

2026-07-2629

name

bake-3d

description

FORBIDDEN 級ハードルール

Language: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。

ベイクを実行せずに「焼けた」と報告しない。 出力 mp4 を ffprobe で確認し、フレームを抽出して目視するまで完了扱いにしない。
scene.py に宣言済み param 以外の外部入力を持ち込まない。 環境変数・wall-clock・暗黙 seed の乱数・ネットワーク取得は禁止。同じレシピ + 同じ params + 同じ Blender バージョン → 同じ映像、を崩さない。
連番静止画を残さない。 mp4 へ直書きする。中間連番が必要だった場合は合成後に必ず削除する。
モデル・HDRI 等のアセット実体を改変しない。 調整はツマミ（param）の範囲で行う。ライセンス不明のアセットをレシピに同梱しない（harvest-asset の規律を継承）。
Blender をユーザー確認なしにインストールしない（setup-library/tools-check.md と同じ）。
node packages/schemas/bin/validate-asset.mjs を通さずにライブラリ入庫を「検証済み」と報告しない。

契約

1. Blender の探索

BLENDER="${AKARI_BLENDER_BIN:-}"
[ -z "$BLENDER" ] && BLENDER="$(command -v blender || true)"
[ -z "$BLENDER" ] && BLENDER="/Applications/Blender.app/Contents/MacOS/Blender"
test -x "$BLENDER" && "$BLENDER" --version | head -1

なければ brew install --cask blender を提示して止まる（無断実行しない）。

2. scene.py の authoring 契約

参照実装: assets/3d/vintage-camera-turntable/scene.py

自己完結: レシピディレクトリ単体をプロジェクトへコピーしても動くこと。リポ内の他ファイルを import しない。アセットは os.path.dirname(os.path.abspath(__file__)) 相対で読む
引数契約（-- 以降を argparse で受ける）: --out <path>.mp4 / --profile draft|final / --fps N / --frame-start N / --frame-end N / --set key=value（複数可）
PARAM_DEFAULTS 辞書 = meta.json の knobs と 1:1。未宣言キーの --set はエラーにする
時間はフレーム番号の純関数。アニメーションはドライバの安全式サブセット（frame 変数 + 算術）または線形キーフレームで表現し、wall-clock を使わない
profile は品質 2 段: draft = EEVEE 低解像度（ツマミ調整の反復用）/ final = 出力解像度。同じ scene.py が両方を通る
Blender 5.x API 注意（5.1.2 実測）: エンジン ID は BLENDER_EEVEE（_NEXT は廃止）。動画出力は image_settings.media_type = "VIDEO" を先に立ててから file_format = "FFMPEG"（4.x に media_type は無いので hasattr で分岐）
出力名へ Blender がフレーム範囲を付けるケースに備え、レンダー後に --out の名前へ正規化する（参照実装の render() を踏襲）

3. ベイク実行

"$BLENDER" -b -P scene.py -- \
  --out bakes/<id>-draft.mp4 --profile draft \
  --fps 30 --frame-start 1 --frame-end 120 \
  --set orbit_start_deg=205

実測目安（M シリーズ Mac / EEVEE / 720p / 16 samples）: 約 0.5〜0.6 秒/フレーム。draft 4 秒素材 ≒ 1 分
ベイク出力は bakes/（git ignore 済み: *.mp4）。消してよい。final はプロジェクト書き出し直前だけ

4. 検証（必須）

ffprobe で解像度・fps・フレーム数が指定と一致することを確認する
先頭・中間・末尾のフレームを ffmpeg -ss <t> -frames:v 1 で抽出して目視する（構図・ライティング・アニメーションの向き）
ライブラリ入庫時は中間フレームから preview.png を作り、node packages/schemas/bin/validate-asset.mjs assets/3d/<id> を通す

5. ライブラリ入庫 / プロジェクト採用

入庫基準は素材ライブラリ契約と同じ: シーン構築・ライティング・カメラワークの設計コストが高いレシピだけを入れる
meta.json は knobs を param で宣言し、requires: ["blender"]。provenance にアセットの取得元・ライセンス・梱包手順を書く
プロジェクト採用 = レシピ一式を <project>/assets/3d/<id>/ へ複製 → params 上書き → ベイク → mp4 を edit.json にクリップ配置。provenance にレシピ id / 版 / params / Blender バージョンを記録する

よくある間違い

EEVEE ヘッドレスの動作を検証せず「焼ける」と報告する（GPU 環境依存。必ず実行する）
THREE.Clock 的発想で wall-clock や random() に依存したアニメーションを書く
ツマミを cssVar で宣言する（ベイクレシピは param。cssVar はオーバーレイ素材用）
fragment.html と scene.py を同じ素材ディレクトリに同居させる（validate-asset.mjs が拒否する）
.blend にテクスチャをパックして肥大化させる / 連番 EXR を残してディスクを焼く
draft で確認せずいきなり final を焼いて反復時間を溶かす