```

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

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

召唤之战-核心玩法.md

@@ -1,288 +1,213 @@
 # 召唤之战-核心玩法
 
-> 当前版本：核心玩法草案
+> 当前版本：召唤师对决玩法（2026-09-16 定稿）
 >
-> 目标：围绕“建筑生产 + 自动作战 + 主角辅助”的对攻玩法，先确定单局战斗的基本规则，再逐步扩展角色、装备、养成和对战模式。
+> 目标：两个召唤师在三分屏战场上通过召唤单位进行对决，摧毁敌方召唤师获胜。玩家手动操控召唤师，单位自动作战。
+>
+> 旧版"建筑生产 + 自动作战 + 主角辅助"方案已由 git 提交存档（e847318 及更早），相关脚本封存不删除，见"八、与现有系统的衔接"。
 
 ## 一、核心定位
 
-《召唤之战》是一款以**召唤和建筑生产**为核心的实时策略战斗游戏。
+《召唤之战》是一款**召唤师对决**实时策略游戏。
 
-玩家通过金币建造金矿和兵营，兵营持续生产角色单位。己方单位自动寻找目标并向敌方推进，玩家主要通过经济投入、建筑选择、兵种组合和主角技能影响战局。
+一句话规则：手动操控召唤师 + 消耗能量召唤单位 + 击杀敌方召唤师获胜。
 
-核心决策是：
-
-- 先建造金矿，发展经济；
-- 还是先建造兵营，尽快形成战斗压力；
-- 选择哪种角色建筑；
-- 建筑放在哪里，如何避免堵塞和被快速摧毁；
-- 什么时候操作主角移动或释放技能。
+- 单位由 AI 自动作战，玩家不微操单位；
+- 玩家的全部操作只有三类：**点地移动召唤师、点卡片召唤单位、释放召唤师技能**；
+- 与同类游戏（皇室战争）的核心差异：召唤师可手动操控且是胜负目标本身、召唤师半场限制、混沌裂缝随机事件。
 
 ## 二、单局战斗结构
 
-### 2.1 地图
+### 2.1 三分屏战场
 
-- 地图长度比当前第一版长地图明显缩短，避免玩家长时间赶路。
-- 每个小关使用一个独立场景，同时复用通用建筑、角色、UI 和特效资源。
-- 地图保留主题变化，例如城堡、荒野、沼泽、矿坑、雪山等。
-- 地图中间设置少量障碍物，用来分割进攻路径。
-- 进攻路线根据关卡设计分为 1 路、2 路或 3 路。
-- 单位从己方区域向敌方区域推进，并在路线上寻找最近的有效目标。
+竖屏横向三条带，整场尽收眼底：
 
-### 2.2 寻路（已实现 ✅）
+| 区域 | 位置 | 规则 |
+|---|---|---|
+| 己方区 | 下 1/3 | 召唤师唯一活动区；出兵落点（召唤师身边）；己方单位可自由出入 |
+| 交战区 | 中 1/3 | 双方单位交战主战场；后期混沌裂缝的刷新舞台 |
+| 敌方区 | 上 1/3 | 敌方召唤师活动区 |
 
-**当前状态：**
-- 已接入 Unity NavMesh 自动寻路系统
-- 单位可以自动绕过障碍物和地形
-- 支持左右两路地图布局
-- 寻路性能已优化（路径更新频率限制为 0.5 秒/次）
+**区域规则：**
 
-**寻路规则：**
-- 单位自动寻找距离最近的敌方单位或建筑
-- 遇到障碍物时自动绕行
-- 攻击时停止移动，避免边打边漂移
-- 单位之间可以轻微重叠（无物理碰撞），避免密集战斗时卡位
-- NavMeshAgent 提供基础避让，但不保证完全不重叠
+- 只限制召唤师：双方单位全场自由移动（单位必须能进入敌方区攻击敌方召唤师）；
+- 召唤师位置 clamp 在己方区内（实现同摄像机边界 clamp 思路）；
+- 边境线有战术价值：召唤师站己方区前沿可以用射程够到交战区的敌人——压线 = 高风险高输出，缩后排 = 安全，站位深度自动产生；
+- 地图总长 45~60 单位（双方召唤师间距约 40），比旧版 120 单位长图明显缩短。
 
-**技术细节：**
-- 使用 NavMeshAgent 替代 CharacterController 移动
-- 攻击时禁用 NavMeshAgent，防止漂移
-- 移动时重新启用 NavMeshAgent
-- 攻击距离判定增加 1.5 米缓冲，避免单位互相顶到才攻击
+### 2.2 相机
 
-### 2.3 伤害数字反馈（已实现 ✅）
+- 固定正交 2.5D 视角俯瞰全场（沿用现有机位思路，约 43°）；
+- 不拖动、不跟随，整场可见是点地移动精确性的前提；
+- 输入只有三层：点地（移动召唤师）、卡片（召唤单位）、技能按钮，互不冲突（地面点击用射线过滤 UI）。
 
-**当前状态：**
-- 单位受击时头顶弹出伤害数字
-- 8 方向黑色描边 + 彩色主字，清晰可见
-- 根据受击者阵营显示不同颜色和浮动方向
+### 2.3 寻路（已实现 ✅，保留）
 
-**显示规则：**
+- 已接入 Unity NavMesh 自动寻路，单位自动绕过障碍物；
+- 单位自动寻找距离最近的敌方单位或敌方召唤师；
+- 攻击时禁用 NavMeshAgent 防止漂移，移动时重新启用；
+- 路径更新频率 0.5 秒/次；
+- 单位之间可轻微重叠，攻击距离判定增加 1.5 米缓冲。
+
+### 2.4 伤害数字（已实现 ✅，保留）
 
 | 情况 | 数字颜色 | 浮动方向 | 说明 |
 |------|---------|---------|------|
-| 友方单位受伤 | 红色 | 向下 | 玩家的士兵被敌人攻击 |
-| 敌方单位受伤 | 白色 | 向上 | 敌人被玩家的士兵攻击 |
+| 友方单位受伤 | 红色 | 向下 | 召唤师或己方单位被敌人攻击 |
+| 敌方单位受伤 | 白色 | 向上 | 敌人被己方攻击 |
 | 任何单位治疗 | 绿色 | 向上 | 单位被治疗恢复生命值 |
 
-**技术细节：**
-- 每个伤害数字由 9 个 TextMesh 组成（1 个彩色主字 + 8 个黑色描边）
-- 描边宽度统一为 0.025，所有角色一致
-- 伤害数字持续 0.8 秒，带缩放和淡出动画
-- 同时最多显示 60 个伤害数字，防止极端情况刷屏
+技术细节不变：8 方向黑描边 + 彩色主字，描边宽 0.025，持续 0.8 秒，全场并发上限 60。
 
-## 三、主角定位
+## 三、召唤师
 
-主角保留，并作为己方单位加入战场，而不是单纯的 UI 指挥官。
+### 3.1 操控
 
-### 3.1 主角职责
+- **手动操控**（这是整个玩法的灵魂，参与感来源）；
+- **点地移动**，不用摇杆：点一下走一段，可连续点更新目标；
+- **移动时不攻击，站定时自动攻击射程内最近敌人**——防风筝设计，召唤师是"重型单位"，走位决策 = 什么时候敢站定输出；
+- 摇杆留作后续升级项（如"按住拖动连续转向"），等实测确认需要躲弹幕级微操再加。
 
-- 主角可以普通攻击；
-- 主角全程由 AI 自动控制，不支持点击地面手动移动（避免与拖动屏幕、建筑放置的输入冲突）；
-- 没有敌人时，主角在己方主建筑周围小范围来回巡逻；
-- 索敌范围较小：只有敌人进入主角附近一定范围内才会被发现并攻击，不主动远离基地寻找敌人；
-- 巡逻和追击都被限制在基地附近区域，主角不能完全离开基地；
-- 主角可以手动释放技能（通过 UI 技能按钮，不占用地面点击操作）；
-- 主角技能冷却较长，主要用于辅助、补刀和改变局部战况；
-- 主角不是主要战斗力，不能替代建筑生产的军队；
-- 主角的价值是提升玩家参与感，并在关键时刻提供战术干预。
+### 3.2 生存性（防一波带走）
 
-### 3.2 主角装备
+召唤师比塔脆，需要底线手段防止死亡螺旋：
 
-主角可以装备不同武器或装备。装备可改变主角的普通攻击方式和技能效果。
+- 基础血量约为普通单位的 3~4 倍；
+- 脱战回血：数秒未受伤害后缓慢回复；
+- 召唤的单位天然优先攻击最近敌人，自动充当召唤师护卫；
+- 开局短暂保护（如 3 秒保护期），防止开局被冲脸秒杀。
 
-初步装备方向：
+### 3.3 召唤师技能
 
-| 装备 | 普攻方向 | 技能方向 | 定位 |
-|---|---|---|---|
-| 法杖/魔杖 | 远程魔法攻击 | 范围伤害、控制或增益 | 远程辅助 |
-| 弓箭 | 远程物理攻击 | 多重射击、点杀或穿透 | 远程输出辅助 |
-| 大剑 | 近战攻击 | 范围斩击、击退或短时强化 | 近战辅助 |
+- 每位召唤师装备 1 个召唤师技能，冷却较长，不占用点地操作；
+- 首发做 3~4 种，至少一个保命向：
+  - **闪现**：向指定方向瞬移一段距离（保命/进场）；
+  - **治疗**：恢复自身或附近血量（续航）；
+  - **护盾**：短时减伤或格挡（抗压）；
+  - 预留一个功能向（如加速/嘲讽），以测试手感定；
+- 技能释放为点击目标式（点敌人/点地面），不用摇杆瞄准。
 
-装备技能冷却较长，主要是锦上添花，不应让主角单独决定整场胜负。
+## 四、出兵系统
 
-装备获取、稀有度和具体数值暂不实现，后续可与抽卡系统关联。
+### 4.1 能量
 
-## 四、建筑系统
+- 战斗内唯一资源为能量，自动回复（沿用 ManaSystem，约 3 秒 1 点，具体以测试平衡为准）；
+- 能量上限沿用现有 10 点方案；
+- 单位费用分 1~6 档，高强度角色费用更高；
+- **金币不进入战斗内**，只用于账户养成，避免双货币混淆。
 
-### 4.1 建筑类型
+### 4.2 卡片
 
-首版至少包含以下建筑：
+- 出战卡组 5 张（沿用现有 5 卡底栏 UI 和 SummonCardButton）；
+- 点卡片消耗能量，**单位在召唤师身边生成**（"召唤师施法召出单位"，主题自洽，天然落在己方区）；
+- 场上单位上限：每方约 15（性能与 2.5D 可读性）。
 
-| 建筑 | 主要作用 |
-|---|---|
-| 主建筑 | 己方核心建筑，负责承受攻击并作为重要胜负目标 |
-| 金矿 | 持续产生金币，支持后续建造 |
-| 兵营 | 按固定间隔持续生产指定角色单位 |
+### 4.3 单位规则
 
-除了主建筑外，金矿和兵营都需要消耗金币建造。
+- 单位出生后自动寻找最近有效目标（敌方单位或敌方召唤师）；
+- 单位可自由进入任意区域，包括敌方区；
+- 单位既是进攻手段，也是召唤师的护卫。
 
-后续可以增加防御塔、特殊功能建筑或不同生产类型的建筑，但不作为首版核心要求。
+## 五、胜负规则
 
-### 4.2 建筑摆放
+### 5.1 主要胜负
 
-采用“隐藏粗网格 + 视觉上不显示网格线 + 建筑自动吸附”的方案。玩家看到的是自然地面，不需要操作可见的密集网格；只有建筑放置位置受到隐藏网格约束。
+- 敌方召唤师死亡 → 立即胜利；
+- 己方召唤师死亡 → 立即失败。
 
-首版不制作复杂的六边形网格编辑器，也不要求玩家精确调整每个建筑的连续坐标。建筑放置系统负责将建筑吸附到最近的合法位置，同时保留一定的布局自由度。
+### 5.2 毒圈强制终局
 
-#### 基本规则
+- 正常对局约 3 分钟；
+- 超时后毒圈从全场范围开始收缩（约 90 秒），圈外伤害递增（示意 5% → 20% 最大生命/秒，以测试为准）；
+- **毒圈吞掉己方区后，"召唤师半场限制"自然解除**——前期分区限制是保险，毒圈负责拆掉保险，后期召唤师被逼进交战区正面相遇，比赛必有结局；
+- 毒圈完全闭合仍分不出胜负时，比较双方召唤师血量百分比（兜底）。
 
-- 建筑只能放置在允许的己方区域内；
-- 建筑移动预览时自动吸附到最近的粗网格位置；
-- 建筑之间不能重叠；
-- 建筑之间需要保持最小安全间距；
-- 建筑不能超出地图边界；
-- 建筑不能堵住主建筑、主角或己方单位的主要出口；
-- 建筑不能完全封死己方主要进攻路线；
-- 非法位置不能确认建造。
+## 六、混沌裂缝事件（差异点）
 
-#### 建筑占格建议
+- 单局中期随机在交战区刷出混沌裂缝；
+- 裂缝出现 1 只超级英雄：同档位 3~4 种、互有克制、强度可控；
+- 争夺归属而非纯随机赠送（PVE 阶段可先用简单交替归属验证手感：第一只归甲方、第二只归乙方）；
+- PVE 先上验证手感；PVP 阶段改为双方同时获得同档英雄，消除运气差；
+- 裂缝是单次事件，运气被限制在单局内的一次波动，不影响底盘公平性。
 
-- 金矿：暂定占用 2×2 格；
-- 兵营：暂定占用 2×2 格；
-- 主建筑：暂定占用 3×3 或 4×4 格；
-- 建筑之间至少保留一格缓冲距离，避免建筑虽然没有重叠，但互相贴近导致单位无法通过。
+## 七、养成系统
 
-具体网格尺寸和建筑占格数量以实际地图比例和单位体型测试结果为准。
+### 7.1 资源分层
 
-#### 放置预览
+| 层 | 资源 | 用途 |
+|---|---|---|
+| 战斗内 | 能量（自动回复） | 只影响单局，召唤单位 |
+| 账户外 | 金币 | 角色升级 |
+| 账户外 | 抽奖券（对战奖励） | 免费抽卡渠道 |
+| 账户外 | 钻石（付费） | 抽卡加速、外观 |
 
-玩家选择金矿或兵营后，进入建筑放置状态：
+### 7.2 角色收集与升级
 
-1. 显示半透明的建筑预览；
-2. 预览自动吸附到最近的粗网格位置；
-3. 建筑底部显示放置边框；
-4. 合法位置显示绿色边框，并允许确认建造；
-5. 非法位置显示红色边框，并禁止确认建造；
-6. 点击确认后扣除金币并生成正式建筑；
-7. 点击取消或右键退出放置状态。
+- 稀有度 4 档：N / R / SR / SSR；
+- 获取渠道：关卡首通奖励 + 抽奖券抽卡 + 商店；
+- 升级消耗：金币 + 同名卡片；
+- 等级提升基础属性（沿用 CharacterData 基础属性 + growth 成长值架构）；
+- 关键等级节点（Lv5 / Lv10）解锁技能强化。
 
-绿色/红色边框需要让玩家明确知道当前位置是否能够放置，而不显示完整网格线。
+### 7.3 卡组
 
-#### 合法性检查
+- 出战卡组 5 张，从已收集角色池中配置；
+- 卡池随收集扩大。
 
-建筑位置校验至少需要考虑：
+### 7.4 召唤师养成
 
-1. 建筑自身占用范围；
-2. 与其他建筑的安全间距；
-3. 建筑与地图边界的距离；
-4. 主角和生产单位的出生点；
-5. 己方主要进攻通道是否仍然可通行；
-6. 建筑被摧毁后是否仍会留下阻挡；
-7. 建筑是否处于可建造地面。
+- 召唤师等级单独养成，影响召唤师基础属性与召唤师技能强度；
+- 召唤师技能在配置界面选择装配（3~4 选 1）；
+- 武器/装备方向（法杖/弓/大剑）作为后续扩展，可对应不同召唤师技能形态。
 
-实现上可以组合使用隐藏网格占用判断、碰撞范围检测和进攻路线通行检查，而不只依赖单个 Collider。
+### 7.5 进度与模式
 
-#### 视觉与资源复用
+- PVE 章节：AI 召唤师当 BOSS，关卡差异 = 敌方召唤师技能 + 初始兵种 + 裂缝事件开关；
+- 混沌裂缝在第 2~3 章作为机制教学登场；
+- PVP 竞技场段位后置，依赖后端接口（Java 服务）。
 
-- 兵营和金矿使用统一的正方形底座规格；
-- 兵营通过顶部站立的对应角色模型表现生产兵种；
-- 金矿通过明显的金色矿脉、矿井入口和采矿收集装置表现功能；
-- 主建筑使用更大的独立底座和召唤核心突出重要性；
-- 运行时角色展示、生产进度条和放置边框不烘焙进建筑贴图。
+### 7.6 数值红线
 
-如果隐藏粗网格仍无法稳定解决卡位问题，再考虑使用预设建筑槽位。主角和战斗单位仍使用真实世界坐标移动，只有建筑放置使用隐藏网格。
+- 稀有度影响强度上限与获取成本，但同级数值压制必须有策略解法；
+- 付费点 = 抽卡、外观，不直接卖数值，避免稀有度造成无法通过策略弥补的碾压。
 
-## 五、兵营生产
+## 八、与现有系统的衔接
 
-### 5.1 基本规则
+### 8.1 直接复用
 
-- 角色对应的兵营建造完成后，开始生产该角色；
-- 兵营每隔若干秒自动产出一个单位；
-- 生产出的单位从兵营附近的出生位置出现；
-- 单位出现后自动寻找目标并参与战斗；
-- 兵营被摧毁后停止生产；
-- 生产间隔、建筑血量和角色费用由角色与建筑配置决定。
+- UnitBase 全套战斗/寻路（NavMeshAgent、移动/攻击状态机——"移动不攻击/站定攻击"与现有状态机同构）；
+- MainCharacterCombat（召唤师战斗逻辑基础）；
+- ManaSystem 能量、SummonCardButton 卡片 UI、伤害数字、WorldHealthBar；
+- CameraFollow 的边界 clamp 思路用于召唤师半场限制。
 
-### 5.2 建筑表现
+### 8.2 新增
 
-首版尽量复用同一个兵营模型：
+- 召唤师点地移动输入与半场 clamp；
+- 召唤师专属血条 / HUD；
+- 毒圈（收缩圆环 + 距离判定伤害）；
+- 胜负判定改为"召唤师死亡"；
+- 召唤师技能 3~4 种。
 
-- 所有角色兵营使用统一的兵营建筑模型；
-- 兵营顶部或正面显示对应角色的小头像；
-- 头像外显示绿色生产进度条；
-- 进度条从空逐渐增长，完成后生产一个单位并重新开始；
-- 金矿可以暂时复用统一的建筑表现；
-- 建筑外观差异主要通过头像、颜色和 UI 标识体现。
+### 8.3 封存不删
 
-这样可以先验证玩法，不把开发成本集中在大量建筑模型上。后续玩家数量和内容规模确定后，再增加建筑皮肤或主题外观。
+- BuildingPlacementManager / Barracks / GoldMine / GoldSystem / 主基地相关逻辑；
+- 留作后续"限时建筑卡"内容或 PVE 特殊关卡素材。
 
-## 六、经济系统
+## 九、落地优先级
 
-- 金币是建造金矿和兵营的主要资源；
-- 金矿持续产生金币；
-- 兵营和其他功能建筑消耗金币；
-- 玩家需要在经济发展和即时战力之间做选择；
-- 高稀有度或高强度角色可以设置更高的建筑/生产成本，但不能只依靠数值碾压普通角色；
-- 金币初始值、金矿产出速度、建筑费用和单位生产间隔需要通过单局测试平衡。
+1. 召唤师点地移动 + 半场 clamp；
+2. 胜负判定改为召唤师死亡 + 召唤师专属血条；
+3. 能量直购出兵（召唤师身边生成）；
+4. 毒圈强制终局；
+5. 召唤师技能 3~4 种；
+6. PVE AI 召唤师 + 混沌裂缝事件；
+7. 养成系统 UI（收集 / 升级 / 卡组配置）；
+8. PVP + 后端接口。
 
-## 七、自动战斗规则
+## 十、当前明确不做
 
-- 己方和敌方单位均由 AI 控制；
-- 单位优先寻找距离最近的有效目标；
-- 有效目标包括敌方单位和敌方建筑；
-- 单位进入攻击范围后停止移动并进行普通攻击；
-- 角色技能按各自规则自动释放；
-- 主角与普通单位一样属于战场单位，但拥有玩家手动移动和手动技能操作；
-- 主角没有主动指令时，按照自动巡逻和自动攻击规则行动。
-
-## 八、胜负规则
-
-### 8.1 当前确定规则
-
-- 摧毁对方主建筑作为主要胜利目标；
-- 己方主建筑被摧毁时，立即失败；
-- 对方主建筑被摧毁时，立即胜利；
-- 摧毁金矿和兵营可以削弱对方经济与持续生产能力，但暂不直接作为立即胜负条件。
-
-### 8.2 限时结束
-
-如果时间结束时双方主建筑都没有被摧毁，具体判定方式暂未最终确定。
-
-待评估方案：
-
-1. 比较双方主建筑剩余生命值百分比；
-2. 比较双方被摧毁建筑价值或建筑得分；
-3. 比较双方场上剩余战力；
-4. 平局后进入短时间加时，先摧毁建筑的一方获胜。
-
-当前倾向优先测试“建筑摧毁得分”或“主建筑剩余生命值”方案，最终以实际对战体验为准。
-
-## 九、角色与养成方向
-
-角色是玩家收集和配置的战斗单位。每个角色可以对应一种兵营生产方案。
-
-后续养成方向：
-
-- 角色通过抽卡或其他收集方式获得；
-- 每次对战后获得抽奖券，作为免费获取渠道；
-- 角色卡片可以升级；
-- 普通等级提升基础属性；
-- 在关键等级节点改变或强化技能；
-- 角色具有稀有度；
-- 稀有角色可以拥有更强或更特殊的能力，同时承担更高的金币消耗或生产成本；
-- 需要避免稀有度直接造成无法通过策略弥补的数值碾压。
-
-抽卡概率、碎片来源、金币消耗、升级节点和付费方案属于长期系统，暂不影响首版核心战斗验证。
-
-## 十、首版验证优先级
-
-1. 缩短地图并制作 1～2 条进攻路线；
-2. 实现少量障碍物和基本自动寻路；
-3. 保留主角的普通攻击、手动移动和一个手动技能；
-4. 实现金矿产出金币；
-5. 实现统一兵营模型和角色头像；
-6. 实现兵营生产单位和绿色生产进度条；
-7. 实现建筑不能重叠、不能过近和不能堵住出生点的摆放校验；
-8. 实现攻击建筑和摧毁主建筑的胜负逻辑；
-9. 通过单机对战或简单 AI 验证“发展经济还是快速建兵”的选择是否有趣；
-10. 核心战斗成立后，再加入更多角色、装备、养成和对战模式。
-
-## 十一、当前明确不做的内容
-
-- 首版不制作复杂的完整 RTS 网格编辑系统；
-- 首版不制作大量不同兵营模型；
-- 首版不让主角成为主要输出核心；
-- 首版不先实现完整抽卡、充值和联网对战；
-- 首版不先扩展大量角色和装备；
-- 首版不在限时胜负规则未验证前绑定复杂的排名和奖励系统。
+- 摇杆操控（留作实测后的升级项）；
+- 防御塔、永久建筑、限时建筑卡（首版一律不做）；
+- 金矿、兵营等战斗内经济建筑（封存，不参与新玩法）；
+- 抽卡概率与付费数值设计（先验证核心战斗）；
+- 排名、段位等复杂外圈系统（依赖 PVP 后置）。