Vfp.rebuild_caches()
asset.rebuild_caches(output_path, *, include_preview=None,
include_runtime_caches=True, include_render_cache=False,
include_animation_cache=True, include_thumbnail=None,
thumbnail_size=256, thumbnail_background="transparent") -> Vfp
从已验证的 VOX0/PAL0 创建新 VFP,并重建派生缓存。不会覆盖源文件,也不会复制旧 MSH0、VBUF、PMSH、RND0、ANM0、PRVW 或 THMB;SCNE 原样保留。
| 参数 | 默认值 | 说明 |
|---|---|---|
output_path | 必填 | 新 VFP 路径。 |
include_preview | None | None 沿用输入 PRVW 是否存在。 |
include_runtime_caches | True | 重建 VBUF/PMSH。 |
include_render_cache | False | 重建 RND0。 |
include_animation_cache | True | 重建 ANM0。 |
include_thumbnail | None | None 沿用输入 THMB 是否存在。 |
thumbnail_size | 256 | 新 THMB 尺寸。 |
thumbnail_background | transparent | 新 THMB 背景。 |
先重算并比较 Header 和 META source hash;不匹配时抛出 VfpError。成功返回新 Vfp。