Merge pull request 'revert d671e4d3117ae8d902cb15a43a1c1d9c30fc8e27' (#14) from moyin-patch-1 into main

Reviewed-on: #14

claude.md

@@ -2,7 +2,7 @@
 
 ## 1. Project Vision & Context
 - **Project**: "WhaleTown" - A 2D top-down pixel art RPG.
-- **Engine**: Godot 4.2+ (Strictly NO Godot 3.x syntax).
+- **Engine**: Godot 4.5+ (Strictly NO Godot 3.x syntax).
 - **Architecture**: Strictly layered: `_Core` (Framework), `Scenes` (Gameplay), `UI` (Interface).
 - **Core Principle**: "Signal Up, Call Down". High decoupling via `EventSystem`.
 
@@ -46,28 +46,31 @@
   const PLAYER_MOVED = "player_moved"
   const INTERACT_PRESSED = "interact_pressed"
   const NPC_TALKED = "npc_talked"
-Singletons: Only GameManager, SceneManager, EventSystem allowed as Autoloads.
-Decoupling: Low-level entities MUST NOT reference GameManager. Use events.
-6. 🏗 Implementation Details
-Player: CharacterBody2D. Must include Camera2D with position_smoothing_enabled = true.
-NPC/Interactables: Use Area2D named InteractionArea. Trigger via EventSystem.
-TileMap Layers:
-Layer 0: Ground (No collision).
-Layer 1: Obstacles (Physics Layer enabled).
-Layer 2: Decoration (Y-Sort enabled).
-Camera: Must auto-calculate limits via TileMap.get_used_rect().
-7. 🧪 Testing Requirements (MANDATORY)
-Coverage: Every Manager/System in _Core/ MUST have a GUT test.
-Naming: Test files must start with test_ and extend GutTest.
-Example:
-code
-Gdscript
-extends GutTest
-func test_event_emission():
+  ```
+- **Singletons**: Only GameManager, SceneManager, EventSystem allowed as Autoloads.
+- **Decoupling**: Low-level entities MUST NOT reference GameManager. Use events.
+
+## 6. 🏗 Implementation Details
+- **Player**: CharacterBody2D. Must include Camera2D with `position_smoothing_enabled = true`.
+- **NPC/Interactables**: Use Area2D named InteractionArea. Trigger via EventSystem.
+- **TileMap Layers**:
+  - Layer 0: Ground (No collision).
+  - Layer 1: Obstacles (Physics Layer enabled).
+  - Layer 2: Decoration (Y-Sort enabled).
+- **Camera**: Must auto-calculate limits via `TileMap.get_used_rect()`.
+
+## 7. 🧪 Testing Requirements (MANDATORY)
+- **Coverage**: Every Manager/System in `_Core/` MUST have a GUT test.
+- **Naming**: Test files must start with `test_` and extend GutTest.
+- **Example**:
+  ```gdscript
+  extends GutTest
+  func test_event_emission():
       var sender = Node.new()
       watch_signals(EventSystem)
       EventSystem.emit_event(EventNames.PLAYER_MOVED, {})
       assert_signal_emitted(EventSystem, "event_raised")
+  ```
 
 ## 🔄 8. Standard Development Workflow (MANDATORY)
 
@@ -130,14 +133,14 @@ See `docs/02-开发规范/命名规范.md` for complete details.
 
 **Remember**: Consistency through automation. Use `/whaletown-developer` to ensure no steps are missed.
 
-9. 🧘 The Zen of Development
-Juice or Death: Every interaction (UI popup, NPC talk) MUST have a Tween placeholder.
-Zero Magic Numbers: All speeds/timers MUST be @export or defined in Config/.
-Simplicity: If a function does two things, split it.
-Back of the Fence: Hidden logic (like ResponseHandler.gd) must be as clean as the HUD.
-9. 📝 Code Template (Entity Pattern)
-code
-Gdscript
+## 9. 🧘 The Zen of Development
+- **Juice or Death**: Every interaction (UI popup, NPC talk) MUST have a Tween placeholder.
+- **Zero Magic Numbers**: All speeds/timers MUST be `@export` or defined in `Config/`.
+- **Simplicity**: If a function does two things, split it.
+- **Back of the Fence**: Hidden logic (like ResponseHandler.gd) must be as clean as the HUD.
+
+## 10. 📝 Code Template (Entity Pattern)
+```gdscript
 extends CharacterBody2D
 class_name Player