用途：为 Godot 4 项目提供数据驱动的资源采集系统，含采矿、伐木、采集等玩法。核心是按路径读取脚本清单中的文件，并区分命中/采集、离线与自动存档、矿脉/重生/世界三类场景。
主要能力：以 HarvestResourceData / HarvestToolData（.tres）配置工具枚举与等级、产出范围、可选掉落场景；harvestable_node.gd 附在 StaticBody3D 上并保持交互层为 Layer 1；需要世界持久化时把 harvest_respawn_manager.gd 注册为 Autoload 的 HarvestRespawnManager。命中流程为射线/交互后调用 apply_hit(tool_data)，信号 harvested(data, amount)、took_damage(curr, max)、interaction_failed(reason) 分别对接库存、HUD 与反馈。矿脉用 FastNoiseLite 阈值生成，并通过重生管理器持久化已耗尽 ID。工具耐久保存在 HarvestToolData 之上，命中成功后发出耐久/损坏信号。
使用方式：先编写数据资源，挂载节点脚本，再按需注册自动加载；离线收益用 Time.get_unix_time_from_system() 记录 UNIX 时间戳，自动存档用 FileAccess 写入 user://。
限制与注意：累积采集计数须用 int；连续采集速率须乘 delta 并优先放在 _physics_process；不得用 OS.get_ticks_msec() 计算离线进度；工具类型只能用枚举而非自由字符串；修改运行态前须 duplicate(true) 共享资源；不得在 VFX/SFX 完成前 queue_free()；退出时不得跳过时间戳保存；采集逻辑不得与 UI 计数器耦合；碰撞形状不得非均匀缩放。更深内容见 harvest-elite-patterns.md，离线数学、线程批处理、弹窗池与矿脉生成足够时可不加载。相关前置技能包括资源数据模式、信号架构、3D 物理与 GDScript 掌握，并可衔接库存、存档、自动加载、射线查询、补间与经济系统等技能。