feat(client): 完成40250客户端核心功能1:1对齐与桥梁高度采样修复

- 桥梁与静态物体高度采样修复：
  - 严格对齐 40250 CMapOutdoor::GetHeight 与 CAttributeInstance::GetHeight
  - 解析 .mdatr 中的 AttributeHeight 网格，使用 is_in_triangle_2d 准确计算桥面多边形平面方程
  - sample_height 查询邻近区块并返回 fMAX(fObjectHeight, fTerrainHeight)，彻底解决走上桥面穿透掉入水底/河床的问题
  - 新增 test_bridge_height_parity.gd 自动化对拍测试
- 40250 怪物击杀经验动效：
  - 1:1 实现 FLY_EXP(0) / FLY_HP / FLY_SP 粒子轨迹与爆炸吸附
- 40250 客户端全系统功能对齐（Batches 1-31）：
  - 包含公会、交易、骑乘、变身、钓鱼、采矿、商城、信件、结婚、地牢等 134 套对拍系统与自动化回归测试
- 文档沉淀：
  - 新增 docs/CLIENT-PARITY-AUDIT-AND-FIX-GUIDE.md 客户端对拍缺陷发现与修复工程指南

project/fx/effect_registry.gd

@@ -22,8 +22,41 @@ var _spec_cache := {}    # abs path -> parsed spec
 # Process-wide so ids stay unique when GameScene rebuilds its registry.
 static var _next_fx_id := 0
 
+var _basename_index := {}    # lowercase basename / filename -> abs path
+var _indexed := false
+
 func setup(assets: String) -> void:
 	assets_root = assets
+	_path_cache.clear()
+	_basename_index.clear()
+	_indexed = false
+
+func _ensure_basename_index() -> void:
+	if _indexed or assets_root == "":
+		return
+	_indexed = true
+	var dirs: Array = [assets_root]
+	while not dirs.is_empty():
+		var dir: String = dirs.pop_back()
+		var da := DirAccess.open(dir)
+		if da == null:
+			continue
+		for f in da.get_files():
+			if f.ends_with(".mse"):
+				var abs_p := dir.path_join(f)
+				var fn := f.to_lower()
+				var bn := f.get_basename().to_lower()
+				if not _basename_index.has(bn):
+					_basename_index[bn] = abs_p
+				if not _basename_index.has(fn):
+					_basename_index[fn] = abs_p
+		for sub in da.get_directories():
+			if sub.begins_with("."):
+				continue
+			var sub_low := sub.to_lower()
+			if sub_low in ["map", "sound", "music", "property", "terrain", "tree", "textureset"]:
+				continue
+			dirs.append(dir.path_join(sub))
 
 # name 可为： 裸名 "xxx"（扫 **/effect/ 下 xxx.mse）· 相对 "effect/xxx.mse" · "d:/ymir work/.../xxx.mse"
 func resolve(name: String) -> String:
@@ -52,29 +85,15 @@ func _resolve_uncached(name: String) -> String:
 			var c := assets_root.path_join(sub).path_join(rel)
 			if FileAccess.file_exists(c):
 				return c
-	# 裸名：按 basename 递归找（限定 effect 目录，限量）
+	# 裸名：从快速特效索引中查找，避免递归全盘扫描造成主线程卡死
 	if not name.contains("/"):
-		var bn := rel.get_file()
-		var hit := _scan_for(assets_root, bn, 7)
-		if hit != "":
-			return hit
-	return ""
-
-func _scan_for(dir: String, basename: String, depth: int) -> String:
-	if depth < 0:
-		return ""
-	var da := DirAccess.open(dir)
-	if da == null:
-		return ""
-	for f in da.get_files():
-		if f == basename:
-			return dir.path_join(f)
-	for sub in da.get_directories():
-		if sub.begins_with("."):
-			continue
-		var r := _scan_for(dir.path_join(sub), basename, depth - 1)
-		if r != "":
-			return r
+		_ensure_basename_index()
+		var bn := rel.get_file().get_basename().to_lower()
+		if _basename_index.has(bn):
+			return _basename_index[bn]
+		var fn := rel.get_file().to_lower()
+		if _basename_index.has(fn):
+			return _basename_index[fn]
 	return ""
 
 func spec_for(name: String) -> Dictionary: