用途：为 MSW 中世界精灵组件 SpriteRendererComponent.SpriteRUID 与 UI 组件 SpriteGUIRendererComponent.ImageRUID 分配 RUID，实现精灵或动画片段直接播放，无需额外动画器组件。
主要能力：两个组件均原生支持 sprite 与 animationclip 类型 RUID。世界侧 SpriteRUID 为普通字符串；UI 侧 ImageRUID 是 DataRef，运行时 .mlua 中写作 DataRef(ruid)，仅在 .ui / .model JSON 或 builder patch 数据里使用 { DataId: ruid } 形式。
用法示例：世界侧 self.Entity.SpriteRendererComponent.SpriteRUID = ruid；UI 侧 self.Entity.SpriteGUIRendererComponent.ImageRUID = DataRef(ruid)。
thumbnail:// 前缀：在 RUID 前加 thumbnail:// 可把任意资源渲染为静态缩略图，格式 thumbnail://<32位十六进制RUID>，接受 sprite、animationclip、skeleton、avataritem。典型用途是 avataritem 图标，例如 slotEntity.SpriteGUIRendererComponent.ImageRUID = DataRef("thumbnail://" .. avatarItemRuid)。avataritem RUID 不加前缀无法渲染。
动画片段：单一循环动画（背景装饰、待机特效、道具）直接赋 animationclip RUID；多状态（站立/移动/攻击/受击/死亡）需用 StateAnimationComponent 加 ActionSheet。
限制与陷阱：skeleton 或 avataritem 不加前缀直接赋给 SpriteRUID / ImageRUID 会静默失败、不渲染；thumbnail:// 只生成静态图，要实时动画需直接赋 animationclip RUID；运行时 .mlua 必须用 DataRef("...")，表形式会被 LSP 判为类型不匹配；CostumeManagerComponent.Custom*Equip、StateAnimationComponent.ActionSheet、SkeletonRendererComponent.SkeletonRUID 不接受 thumbnail://；已从 msw-search 取得缩略图或图标 RUID 时不要再加前缀。查找 RUID 使用 msw-search 技能：searchAvatarItems 查 avataritem，searchResources 查其他资源。