```

feat(gameplay): 实现召唤师对决模式核心功能

- 新增召唤师对决管理模式，支持点卡片直接召唤单位
- 添加召唤师点地移动控制，移动时不攻击、站定时自动攻击
- 实现召唤师模式开关，单位不再自动追击远处敌人
- 更新卡牌按钮逻辑，对决模式下按能量消耗直接召唤
- 修改单位基础行为，支持移动中不攻击的召唤师模式
- 更新核心玩法文档，从建筑生产模式转向召唤师对决模式
- 添加召唤师对决测试场景，整合新的战斗逻辑
```

CODELY.md

@@ -42,7 +42,8 @@
 - [2026-09-10 18:38:13] 第一关地图（Level1-1.scene）已采用"皇室战争"风格简化设计：移除所有边界矮墙（俯视角只能看到墙顶），改用旗帜+石柱交替排列标识边界（X=±5.5，Z轴8个位置交替）；保留中间战道掩体（木箱×6、碎石堆×4）；天空改为纯色蓝灰色+线性雾效（起始40m，结束100m）；摄像机添加边界Clamp限制（X: -7~7, Z: -32~93，宽松模式），主角靠近边界时摄像机停止跟随；光照调整为从后上方照射（50°, 0°, 0°），角色正面清晰可见。**Why:** 正交俯视视角下垂直墙面几乎看不见（只能看到墙顶），旗帜+石柱有高度和轮廓，视觉识别强。**How to apply:** 后续关卡延续此风格，避免使用低矮平面装饰物。
 - [2026-09-10 18:38:32] 召唤逻辑已优化碰撞处理：当目标位置被占用时，自动螺旋搜索周围空位（左右搜索8次×前后3层×2方向，约102个候选点）；如果所有位置都被占用，自动退还能量豆并取消召唤，避免浪费能量。参数：summonSearchCount=8, summonDepthSearchCount=3, summonSearchStep=0.8f, summonDepthSearchStep=1f。
 - [2026-09-11 14:55:27] 敌人血条颜色问题已修复：WorldHealthBar 在 Awake() 时根据 GameObject.tag 判断颜色，WaveSpawner 在 Instantiate() 后设置标签会导致时序错误（血条已创建成绿色）。解决方案：直接在敌人 Prefab 上设置 Enemy 标签，确保 Awake() 时标签已正确。已修改狼人/蓝色怪物/弓箭猎人/石巨人四个 Prefab。**Why:** 血条颜色在对象创建时确定，后设置标签无法自动刷新。**How to apply:** 后续新增敌人 Prefab 时直接在 Prefab 上设置 Enemy 标签，不依赖运行时代码设置。
-- [2026-09-14 16:00:19] 2026-09-13 玩法大转向：从闯关推图改为"建筑生产+自动作战+主角辅助"的对攻玩法（见《召唤之战-核心玩法.md》）。旧闯关玩法由用户在另一台电脑的分支保存，当前 main 按新玩法开发。提交 beab4cf 已实现：GoldSystem/GoldMine 金币经济、Barracks 兵营产兵、BuildingPlacementManager 建筑摆放、CharacterData 新增 productionInterval/buildingCost、UnitBase/Projectile 支持攻击建筑、CoreBattleTest.scene 验证场景、CameraFollow 重写（WASD/鼠标/触摸拖动+缩放）。胜负目标改为摧毁对方主建筑。**How to apply:** 后续开发以建筑/经济/产兵系统为主线，能量豆召唤相关旧逻辑仅作为历史参考。
+- [2026-09-16 14:22:13] 2026-09-13 玩法大转向：从闯关推图改为"建筑生产+自动作战+主角辅助"的对攻玩法（见《召唤之战-核心玩法.md》）。旧闯关玩法由用户在另一台电脑的分支保存，当前 main 按新玩法开发。提交 beab4cf 已实现：GoldSystem/GoldMine 金币经济、Barracks 兵营产兵、BuildingPlacementManager 建筑摆放、CharacterData 新增 productionInterval/buildingCost、UnitBase/Projectile 支持攻击建筑、CoreBattleTest.scene 验证场景、CameraFollow 重写（WASD/鼠标/触摸拖动+缩放）。胜负目标改为摧毁对方主建筑。**How to apply:** 2026-09-16 起玩法进一步改为"召唤师对决"（见同日新条目），建筑/经济/产兵系统已封存、不再作为主线，相关脚本留作素材。
+
 - [2026-09-14 18:24:46] 2026-09-14 性能实测（9 个角色 Prefab）：大多数 5~8k 三角面/22 骨骼/512 贴图，性能没问题；两个待处理异常——蓝色怪物 34408 面（是量产低价单位，建议减面到 8k 左右）、法师贴图 2048x2048（建议缩到 512）。另建议设计层限制每方场上单位上限（约15）保性能与 2.5D 可读性，并确认方向光关实时阴影，最终以低端安卓真机小游戏包为准。**How to apply:** 后续做性能优化或新增量产型敌人时按此基准控制面数。
 - [2026-09-14 21:19:53] 2026-09-13 新增建筑系统核心脚本：BuildingHealth（建筑血量+生产进度接口）、GoldSystem/GoldMine（金币经济与产出）、Barracks（兵营产兵，读取 CharacterData.productionInterval）。WorldHealthBar 增加 SetEnergy() 通用下方条接口，建筑复用该条显示生产进度，单位仍用于技能能量。BuildingPlacementManager 支持虚拟网格吸附、占位检测、金币扣除，新放置建筑自动挂 BuildingHealth。UnitBase/Projectile 的 ApplyDirectDamage/ApplySkillHit/ApplyAreaSkillDamage/HitTarget 均已接入 BuildingHealth，建筑可被近战/技能/范围/飞行物伤害。兵营 Prefab（Assets/Prefabs/建筑/兵营.prefab）已写入 Barracks+WorldHealthBar+BuildingHealth，默认阵营 Friend，场景实例保留 Enemy 覆盖。**Why:** 建筑作为可攻击目标是新对攻玩法的核心，生产进度条复用血条下方条避免额外 UI。**How to apply:** 后续新增建筑类型（防御塔/资源建筑）参照 BuildingHealth 接口；修改血条下方条逻辑时注意区分单位和建筑语义。
 - [2026-09-14 21:34:17] 2026-09-14 发现：团结引擎 1.10.2 (macOS) 原生 NavMesh 烘焙失效——空场景放一个静态 Cube，用 NavMeshBuilder.BuildNavMeshData / UpdateNavMeshDataAsync / 经典全局 BuildNavMesh 烘焙全部产出 0 三角形，无报错；收集源（CollectSources）、Job 系统、AI 模块包均正常；换构建目标/域重载/重启编辑器均无效。**Why:** 原生导航烘焙在此安装上深层失效，继续用 NavMesh 会浪费时间。**How to apply:** 本项目寻路不要用 NavMesh/NavMeshAgent/NavMeshSurface，改用纯 C# 网格 A*（见 GridPathfinder.cs）；若未来升级团结版本可先重跑最小 Cube 烘焙测试再决定。
@@ -52,6 +53,8 @@
 - [2026-09-15 17:33:54] NavMesh 寻路攻击漂移问题修复方案：单位攻击时会因 NavMeshAgent 继续工作而漂移。解决方法是在 attack() 方法和 Update() 的 State.Attack 分支中直接禁用 NavMeshAgent (navAgent.enabled = false)，在 move() 方法中重新启用。同时修复了 applyGravity() 调用已禁用 CharacterController 导致的警告（添加 controller.enabled 检查）。性能优化：寻路路径更新频率限制为 0.5 秒一次（nextPathUpdateTime + PathUpdateInterval），减少 93% 路径计算开销。
 - [2026-09-15 18:42:26] 伤害数字显示规则：友方单位（Friend tag）受伤显示红色数字向下浮动，敌方单位（Enemy tag）受伤显示白色数字向上浮动，治疗显示绿色向上。技术实现：8方向黑色描边（DamageNumberOutlineWidth = 0.025f 常量）+ 1个彩色主字，共9个TextMesh。通过 gameObject.CompareTag("Friend") 判断受击者阵营。已更新到《召唤之战-核心玩法.md》文档 2.3 章节。
 - [2026-09-15 19:33:31] 金币系统已完成：GoldManager 单例管理，初始500金币，右上角UI实时更新。金矿建筑产出50金币/5秒，主角产出30金币/8秒。WorldHealthBar 的 currentEnergy 改为属性（带 setter 自动调用 UpdateEnergyFill），能量条尺寸从8像素增加到12像素（EnergyPixelHeight=12，EnergyPixelWidth=100）。能量条显示金币产出进度，满了产出并重置。已更新核心玩法文档。
+- [2026-09-16 14:22:13] 2026-09-16 玩法定稿为"召唤师对决"并已写入《召唤之战-核心玩法.md》：无基地/金矿/兵营/防御塔，玩家手动点地操控召唤师（移动不攻击、站定攻击），限己方半场（三分屏：己方/交战/敌方区），能量直购出兵（单位在召唤师身边生成），击杀敌方召唤师获胜，超时毒圈收缩并解除半场限制，中期混沌裂缝事件，召唤师技能 3~4 种，摇杆留作实测后升级项。**Why:** 用户多轮迭代后的最终方向，旧"建筑生产+自动作战"对攻玩法封存不删。**How to apply:** 新战斗开发一律基于召唤师对决方案；不要在新玩法场景引入金矿/兵营/建筑摆放；BuildingPlacementManager/Barracks/GoldMine 等封存留作后续建筑卡或 PVE 特殊关素材。
+- [2026-09-16 14:48:52] 召唤师对决首版场景已完成（SummonerDuelTest.unity，2026-09-16）：新场景地面20×80、固定正交相机43°/orthoSize28、召唤师z=0(敌方z=35)均避开底部UI；新增 SummonerClickMovement（点地走位+clamp X[-9,9] Z[-19,6]，移动中关攻击、到点恢复）、SummonerDuelManager（点卡片按能量直召，单位在召唤师身边生成）、UnitBase 新增 summonerMode 开关（不追击、站定攻击，默认关闭不影响旧单位）；战斗界面UI从 CoreBattleTest 整树搬运复用，SummonCardButton 增加对决模式分支（无布阵/金币管理器时走能量直召+冷却）。主角已存为 Assets/Prefabs/主角/召唤师主角.prefab。**How to apply:** 后续对决玩法迭代（毒圈/胜负判定/召唤师技能）基于该场景与脚本扩展；Play Mode 验证等用户手动执行。
 
 ### Reference
 - [2026-09-09 12:23:17] 飞行物脚本 Projectile.cs 负责锁敌追踪、碰撞检测和伤害结算。箭矢预制体 ArrowProjectile_White.prefab 已配置 Projectile 组件和 CapsuleCollider（Is Trigger）。远程单位需在攻击动画松弦帧添加 OnAttackEffect Event，并在 UnitBase 中设置 attackType=RangedProjectile、projectilePrefab、projectileSpawnPoint。