[utagestudio]

Closes #152

#153（#151）の上に積んだ PR です。#153 をマージしたら、base を release/1.12.0 に付け替えます。

変更内容

読み込む単位 Scenes / Prefabs に「Skip Unused Parts」（既定 ON）を追加した。ON のときは、prefab・シーンが使っていない FBX の部品（#58 / #151 で隠していたもの）を読み込まない。OFF のときは、今までどおり読み込んで隠す。

• Scenes: 最初に読み込んだモデルから使わない部品を消してからテンプレートを作るので、以後の配置では必要な分だけを複製する。テンプレートを使い回すキーに、Renderer から作った配置かどうかとメッシュ参照の fileID を加えた
• 消すものの決め方（core/scene_import.parts_to_remove）: 使う部品を子孫に持つものは、親子関係と位置を保つため残して隠す。子がすべて消えた Empty・アーマチュアは消す
• データ: 消したオブジェクトだけが使っていたメッシュ・アーマチュアのデータも消す。マテリアルは同じ回の別のモデルと共有するので消さない
• 警告: 件数を「… were not imported (turn off 'Skip Unused Parts' to import them hidden)」で出す
• UI: 選択ダイアログの Scenes / Prefabs タブに「Unused Parts」のトグルを追加した。オペレーターには skip_unused_parts を追加した
• テスト: 統合テストに absent（オブジェクトが無いこと）を追加し、OFF を確かめる期待値を Scenes / Prefabs に 1 つずつ足した（CI にも登録）
• バージョン: 1.12.0-dev.2 にした

確認

Japanese Train Station PBR Pack / DemoScene	OFF	ON
読み込み	34.2 秒	3.4 秒
オブジェクト数	31,290	1,167
メッシュのデータ	2,324	55
.blend の保存	1.7 秒	0.1 秒

• 表示されるメッシュは、DemoScene（555 個）、Japanese Street の Day_Showcase（2,118 個）と Prefabs（431 個）、Japanese Apartment（283 個）のどれでも、名前とワールド行列が OFF と一致した
• OFF のときの警告と件数は、変更前と同じだった
• 単体テスト、合成パッケージの統合テスト 13 ファイル、Yumeka 1.0.4 の統合テストがすべて通過

追加の修正（ほかの実パッケージで比べて見つけたもの）

手元の実パッケージ 14 個を ON と OFF で読み込み比べたところ、Gothic Lights で次の 2 つが見つかったので、このブランチで直した（1.12.0-dev.3 / dev.4）。

• 共有メッシュの消し方: FBX の読み込み直後は、5 つのオブジェクトが共有するメッシュでも users が 1 のことがある。そのため、1 つ目を消したときにメッシュのデータまで消え、共有していた残りのオブジェクトも消えて、StructRNA of type Object has been removed で読み込みが止まっていた。オブジェクトを先にすべて消し、残したオブジェクトが使っていないデータだけを消すようにした。
• 読み込む単位 Prefabs で、prefab が使っていない FBX の部品が表示されたまま読み込まれる #151 の判定: FBX のノード名がもともと連番付き（Base-Ring.001）だと、2 回目の読み込みで Blender が .002 に付け替える。表の名前の側の連番を外していなかったため、使っている部品を使われていないと判定していた（OFF なら隠れ、ON なら消える）。Scenes 単位と同じく、表の名前の連番も外して比べるようにした。Gothic Lights の Prefabs で表示されるメッシュは 249 → 278 になった。

修正後、比較した 9 パッケージ（Train Station、Street、UnityJapanOffice、Apartment、Gothic Lights、SUPER CUB、ずん子 PC / Quest、KizunaAI）の Scenes / Prefabs と Shibuya の Prefabs で、表示されるメッシュの名前と位置が ON と OFF で一致した。

同じ名前の付け替えで prefab のマテリアルが当たらない、以前からある不具合は #155 で別に直す。

手動確認の手順

1. Japanese Train Station PBR Pack を読み込み、Scenes タブで DemoScene を選ぶ。「Unused Parts」のトグルが ON になっていることを確認して Import する
2. アウトライナーに非表示のメッシュがほとんど無く、駅が今までどおり表示されていること
3. UPI タブの警告に「28015 object(s) … were not imported」が出ていること
4. トグルを OFF にして読み込み直すと、今までどおり 28,015 個が非表示で読み込まれること
5. Prefabs タブでも同じように、ON なら prefab が使う部品だけが読み込まれること

🤖 Generated with Claude Code