v1 → v2 移行ガイド — Fast Ref API

v1 から v2 への移行方法を説明します。既存コードの多くはそのまま動作します。変更が必要なのは次のとおりです。(1) Import 方式、(2) slot 型ルール、(3) 削除された select_* → get_*(select=1) への置換。

1. Import 方式の変更（必須）

v2（1 行）

from os_fast_ref.api import FastRefAPI

v2 .mzp インストール時に startup スクリプト（fast_ref_register_path.ms）が自動登録され、Max 起動直後からパス設定なしで import できます。

注意: v2 .mzp で再インストールしないと 1 行 import は動作しません。必ず最新 MZP で再インストールしてください。

2. slot 型ルールの強化（要確認）

v2 では slot 引数に int のみ許可されます。bool、str、float などは即 TypeError になります。

3. 新規メソッド（任意）

メソッド	説明
`get_outdated_references()`	OUTDATED リファレンス一覧のみ返す
`reload_outdated_references()`	OUTDATED のみリロード
`refresh()`	InfoNode を強制再スキャン
`get_all_objects` / `get_skin_meshes` / `get_skin_bones` / `get_all_skin_objects` / `get_duplicate_nodes` / `get_biped_com` / `get_biped_nodes`	Get Nodes 取得 API（`select=0\|1`）

既存コードで使わなくても問題ありません。ただし旧 select_* を使っていた場合はセクション 6 を必須で確認してください。

After（v2）

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
api.reload_outdated_references()          # OUTDATED のみリロード
api.export_fbx_all(
    output_folder=r"J:\output",
    preset="Unreal_Ani"                   # プリセット名で指定
)
api.update_ui()

6. 削除された select_ → get_(select=1)（該当する場合は必須）

旧 select_reference_nodes / select_duplicate_nodes / select_skin_mesh / select_skin_bones は完全削除されました（shim なし）。呼び出すと AttributeError になります。

削除済み	代替
`select_reference_nodes(...)`	`get_all_objects(slot=..., select=1)`
`select_duplicate_nodes(...)`	`get_duplicate_nodes(slot=..., select=1)`
`select_skin_mesh(...)`	`get_skin_meshes(slot=..., select=1)`
`select_skin_bones(...)`	`get_skin_bones(slot=..., select=1)`

取得だけなら select=0（既定）を使ってください。共通契約・例外は Get Nodes 概要ページを参照してください。

# Before（削除済み — AttributeError）
# api.select_skin_mesh(slot=0)

# After
api.get_skin_meshes(slot=0, select=1)