blender-cli

提供された根拠に基づく Blender CLI

Blender 固有の機能の選択、API 識別子、列挙値、パラメーターの意味、ワークフローに関する主張は、すべてこのスキルのデータに基づく必要があります。**事前学習で得た Blender の知識は、根拠として認められません。**サポートされている事実を結び付けるために、通常の言語理解、論理、Python による構成を使用してください。Blender の知識に不足がある場合、記憶している挙動で補ってはいけません。ユーザーの要件が示すのは望ましい出力やアーティスティックな選択であり、API が存在することや特定の挙動をすることの証明ではありません。

最初に確認する情報：利用可能な機能のカテゴリ

API データベースを照会したり Blender のコードを作成したりする前に、完全な機能の概要を読んでください。このレイヤーは通常の Markdown と、透過的に圧縮された JSON で構成されており、SQLite を使わずに利用できます。作成済みのルート、すべてのソース API ページのカード、ステータス、選択方法が記載されています。

ユーザーの作業分野	カタログのドメイン
シーン、オブジェクト、コレクション、トランスフォーム	scene
メッシュ、BMesh、モディファイアー	geometry
Geometry Nodes、フィールド、インスタンス	geometry-nodes
カーブ、3D テキスト、ヘアー、ポイントクラウド、ボリューム	curves-volumes
スカルプト、ブラシ、ペイント	sculpt-paint
UV マップ、画像、テクスチャベイク	uv
マテリアル、シェーダー、テクスチャ、ワールド	shading
ライト、カメラ、シャドウ	lights-shadows
レンダリング、パス、カラー、画像出力	render
コンポジティング、マスク、画像処理	compositor
動画編集、タイトル、オーディオ	video-audio
Grease Pencil、2D ストローク、Freestyle	grease-pencil-freestyle
モーショントラッキング、ムービークリップ	tracking
キーフレーム、ドライバー、リグ、コンストレイント	animation-rigging
シミュレーション、物理演算、キャッシュ	simulation
ファイル、インポート／エクスポート、ライブラリ、アセット	files-assets
Python の統合、数学、GPU、UI	integration-gpu
API ガイド、列挙値、ソースインデックス	api-guides

これらはナビゲーション用のカテゴリであり、バックグラウンドモードで実行できることを保証するものではありません。機能に関する正確な主張は、ソースにリンクされたカードに記載されています。documented_route_runtime_unverified は、ソースにルートの説明があることを意味します。api_discovery_only は、ソースページが存在し、挙動を主張する前に読む必要があることを意味します。identifier_only は、導入部のソーステキストだけでは挙動を説明する情報が不十分であることを意味します。後者のステータスを実装の保証に置き換えてはいけません。

エビデンスに基づくワークフロー

1. クエリを実行する前に調査します。 概要を読み、そこからリンクされている関連ドメインファイルを確認します。python3 scripts/features.py match "the user request" は、SQLite を開かずに、用意されたベトナム語／英語の別名を検索します。各候補を features.py show ID で読み、choose_when、エビデンスの抜粋、ギャップを比較します。同じキーワードが含まれているだけでは、選択の根拠として不十分です。文書化されたルートが複数残る場合は、出力を明確にします。
2. 不明点を明示的に扱います。 作成済みのルートが適合しない場合は、features.py pages DOMAIN と features.py symbols TEXT を使い、データベース外にあるソース提供の名前や説明を調べます。api:... のページカードは、調査の手順としてのみ選択します。要求された動作を裏付けるソースがない場合は、insufficient_skill_evidence を返し、不足している情報を明記します。記憶を頼りに、Blender の英語用語、API、パラメーター、レシピを捏造しないでください。外部検索を暗黙の代替手段にしてはいけません。新しい資料をタスクのエビデンスとして使えるのは、出典情報とともにスキルへ組み込んだ後だけです。
3. 選択内容をレビュー可能にします。 features.py plan --request "..." --feature ID --output /absolute/path/plan.json でプランを作成します。複数の機能を組み合わせる場合は、--feature を繰り返します。最初の API クエリは推測した識別子ではなく、選択したカードから直接生成されます。
4. API のエビデンスを読みます。 カードの next_queries を使って、docs.py read REF --plan /absolute/path/plan.json を実行します。プランには、実際のソースハッシュと表示された行範囲が記録されます。選択した関連箇所がすべて揃うまでページネーションを続けます。読み取りエビデンスで実際に提示されたリンクをたどるか、追加のコンテキストが必要な場合は、別の文書化済み機能／カードを選択します。docs.py search／symbol は、提供されたコンテキストですでに見つかった用語の精査に使用できます。検索結果や一致する識別子を、動作の証明として扱ってはいけません。
5. 裏付けのある操作だけを実装します。 各 Blender 操作のソースと、そのソースが裏付ける内容をプランの bindings に記録し、不足している情報は unresolved に残します。型／デフォルト値のみが記載されたプロパティが裏付けるのは、その限定的な仕様だけであり、文書化されていないレンダラーの効果ではありません。ソースで明示されていない場合は、ノードソケットのラベル、動的な列挙値、オペレーターのコンテキストを確認する必要があります。Blender 固有の記述を根拠づけずに、よく知られたレシピを再利用してはいけません。正確なプラン形式については、エビデンスに基づくワークフローを参照してください。
6. 選択したランタイムを検証します。 CLI ワークフローに従います。付属のプローブで、観測された RNA／バージョンデータを収集できますが、不足している概念的なワークフローの意味までは補えません。ランタイムでの観測は記録した場合に限りタスクのエビデンスとなり、新たに使う Blender の事実は、引き続きその観測情報および／または提供されたソースに基づいて説明する必要があります。文書化されていない場合は、その事実に依存する操作を中止してください。実行ファイルが見つからない場合や、ランタイムの事実が未解決の場合は、明示したままにします。
7. バインド、実行、検証します。 evidence.py inspect はレビュー対象の操作を一覧表示し、evidence.py seal は記録された読み取り／バインディングを検証して、スクリプトのハッシュをバインドします。run_blender.py --plan ... は、不足または古いプラン、未解決の事実、記録されていない引用、操作行のカバー漏れがある場合に実行を拒否します。付属のプローブのみ例外です。実際の結果を読み、重要な保存データを開き直し、成功を主張する前に視覚的な出力を確認します。これらのチェックはトレーサビリティを担保しますが、任意のコードの意味や、モデルの内部知識が一切活性化されなかったことまでは証明できません。

コマンド

以下のパスは、ユーザーのプロジェクトではなく、このインストール済みスキルを基準とします。ホストヘルパーは Python 3.10 以降と標準ライブラリを使用します。API を検索するには SQLite FTS5 も必要です。別の場所で作業する場合は、スクリプトに絶対パスを使用してください。

python3 scripts/features.py overview
python3 scripts/features.py match "text strip shadow"
python3 scripts/features.py show FEATURE_ID
python3 scripts/features.py pages lights-shadows
python3 scripts/features.py plan --request "..." --feature FEATURE_ID --output /tmp/blender-plan.json
python3 scripts/docs.py read SOURCE_REF --plan /tmp/blender-plan.json
python3 scripts/evidence.py inspect --script /absolute/path/task.py
python3 scripts/evidence.py seal --plan /tmp/blender-plan.json --script /absolute/path/task.py
python3 scripts/run_blender.py --script /absolute/path/task.py --plan /tmp/blender-plan.json --timeout 900 -- --output /absolute/path/result.blend

カタログから返された実際の ID／参照を使用してください。ランナーは Blender をインストールせず、自動保存も行いません。また、ドキュメントに記載されていない操作が有効になるわけでもありません。生の CLI、記憶に頼ったスニペット、古いフォワードテストの例、捏造したバインディングを使って、このエビデンスワークフローを回避しないでください。引用は、それに関連付けられた記述を裏付ける必要があります。有効なハッシュであるだけでは不十分です。

データの範囲とメンテナンス

付属のスナップショットは API 5.2 とインベントリプロジェクト Blender 5.2.1 LTS Python API を識別します。ただし、インストール済みのバージョンを証明するものではありません。カタログのカバレッジでは、作成済みの機能ルート、すべてのソースページカード、未解決の説明の不足箇所を区別しています。references/api/api.sqlite3 は、API テキスト、アンカー、リンク、シンボル、検索、カバレッジメタデータのパッケージ化された信頼できる情報源です。詳しくはコーパスガイドを参照してください。

インデックス化されたリファレンスは、オフラインでエビデンスを参照できるよう、意図的にパッケージ化されています。タスクでは、選択したエビデンスのみを読み取ってください。カタログは SQLite から構築されており、埋め込みやモデルの記憶から構築されたものではありません。生の HTML／アセット、Blender Manual、上流リポジトリ、拡張機能のページはパッケージに含まれていません。再構築／更新の手順はコーパスガイドに記載されています。意味的なソース内容を更新すると、以前のエビデンス計画は無効になり、影響を受ける機能の主張を見直す必要があります。