用途：为 Godot 引擎中的解谜类游戏提供架构与实现规范，覆盖逻辑解谜、物理解谜、三消等类型。核心循环为观察、假设、提交移动、校验、必要时撤销或重置。
主要能力：使用 Godot 内置 UndoRedo 作为唯一撤销权威；以 Vector2i 维护独立于 SceneTree 的网格真值；提交移动时触发胜利与软锁校验；提供网格吸附输入、Tween 位移动画、三消消解与连锁、AStarGrid2D 提示路径、关卡快照序列化等模块化脚本；强调非语言教程与即时无歧义的视觉反馈。
必要用法：实现前须先阅读 scripts/puzzle_undo_manager.gd、grid_manager.gd、puzzle_state_validator.gd；按流派组合脚本，如推箱子需 grid_manager、grid_tween_mover、puzzle_undo_manager、puzzle_state_validator，三消需 match_three_logic、grid_tween_mover、puzzle_undo_manager。网格坐标只用 Vector2i，避免浮点漂移；校验仅在移动提交时进行，不在 _process 中执行；不要加载已被取代的 command_undo_redo.gd。
限制：资料未提供具体的价格、平台、安装命令或性能数据。