refresh()

씬 InfoNode를 강제로 재스캔하고 파일 시간을 체크하여 최신 레퍼런스 데이터 리스트를 반환합니다. v2 신규 메서드입니다.

시그니처

api.refresh() -> list

반환값

[
    {
        "slot": int,
        "name": str,
        "filename": str,
        "namespace": str,
        "space_activate": bool,
        "unpack": bool,
        ...
    },
    ...
]

씬에 레퍼런스가 없으면 빈 리스트를 반환합니다.

예제

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
data = api.refresh()
active = [d for d in data if d.get('name')]
print(f"Active references: {len(active)}")

참고: get_reference_list()은 캐시 데이터를 반환하고, refresh()는 InfoNode를 직접 다시 읽습니다. 씬 상태가 외부에서 변경되었을 때(다른 스크립트로 레퍼런스를 추가한 경우 등) 강제 동기화에 사용합니다.