用途：为 Godot 项目提供一套收集循环系统，覆盖收集品标识、寻物解谜、完成度档案、罗盘指引与持久化进度。
主要能力：collectible_item.gd 作为拾取物，导出稳定 item_id 与 collection_id，并做一次性 Area 拾取；collection_manager.gd 作为权威进度中心，通过 start_collection(id, item_ids) 与 register_item(id, item_id) 管理已收集 ID 集合并提供 get_remaining_ids()；collection_compass.gd 查询剩余 ID 并指向最近目标；hidden_item_spawner.gd 用 Marker3D 等设计点做概率生成；collection_loop_patterns.gd 提供高级循环辅助。可选配合保存系统持久化已收集 ID 集合（PackedStringArray，经 get_collected_ids()/restore_collected_ids()），重载时管理器恢复集合、收集品自行禁用。档案 UI 用图标网格以 silhouette 显示未收集项。
使用方式：按 Golden Path 依次接入 collectible_item、collection_manager、collection_compass，再用 godot-save-load-systems 持久化 ID。寻物解谜必须保存 ID 而非 NodePath；Area 重叠需防重复计数；不可软锁最后一件；进度不可只存场景局部节点；先提交 ID 信号再做 VFX 与 queue_free；碰撞形状勿非均匀缩放；生成点用 Marker3D 而非硬编码；UI 只镜像管理器状态；大关卡加载用 ResourceLoader 线程化，勿在工作线程操作 SceneTree。
适用场景：收集品、寻宝、完成率档案、罗盘引导搜寻。限制：未提供具体价格、平台或效果信息；高级线程、MainLoop 与档案深度需参考 collection-loop-advanced.md，简单固定 ID 寻物无需加载该文档。