1

CODELY.md

@@ -19,6 +19,7 @@
 - [2026-09-09 12:11:59] 当用户明确指出现象和修复目标时，优先按用户给出的事实做针对性修改，不继续进行冗长排查。**Why:** 用户明确指出法师没有生成火球，并要求直接给新建火球 Prefab 补脚本。**How to apply:** 先读取目标资产确认，再执行最小必要修改；只有修改仍失败时才扩大排查范围。
 - [2026-09-09 13:43:50] 能量恢复速度应该更慢一些，用户建议改为 3 秒恢复 1 格。**Why:** 1 秒 1 格太快，不利于战斗节奏控制。**How to apply:** 召唤系统能量恢复速率应偏慢，给玩家资源压力。
 - [2026-09-09 20:37:24] 用户希望提前实现数据架构而非临时方案，即使当前阶段功能简单。**Why:** 用户有 10 年后端开发经验，理解数据分层的重要性，希望逐步完善而非推倒重来。**How to apply:** 对于有明确扩展方向的功能（升级、存档、联网），优先设计可扩展架构并临时写死数据，而非等需求明确后再重构。
+- [2026-09-10 18:38:45] 正交俯视视角（38-43°）下，垂直墙面几乎看不见（只能看到墙顶），因为墙面平行于视线方向被自身遮挡。适合的装饰物：高耸物体（旗帜、石柱）、有明显剪影的物体（木箱、碎石堆）、对比色强的物体；不适合：低矮平面物（矮墙、栅栏）、细长水平物（绳索）。**Why:** 这是正交俯视视角的固有盲区，无法通过调整角度完全解决（角度太平会牺牲战场全局视野）。**How to apply:** 场景装饰设计时优先使用垂直高度≥2米的物体，避免依赖水平或低矮结构。
 
 ### Project
 - [2026-08-28 14:26:56] 弓箭手远程箭矢的设计要求：保持发射时高度水平飞行，命中目标后直接结算伤害并销毁，不产生实体物理击退。**Why:** 当前玩法希望远程攻击是命中判定而非物理推动。**How to apply:** 后续调整箭矢、Projectile 或弓箭手攻击逻辑时保持这一行为。
@@ -36,6 +37,9 @@
 
 - [2026-09-09 20:37:24] 玩家角色数据架构已完成：CharacterData 存储基础属性（1级）和成长值（每级加成），PlayerCharacterData 存储玩家角色等级和星级，PlayerDataManager 单例管理玩家拥有的角色和当前卡组（临时写死）。召唤时从 CharacterData + PlayerCharacterData 计算最终属性并传递给 UnitBase.InitializeFromPlayerData()。升级系统正常工作（1级 100血/50攻，3级 120血/60攻）。后续扩展：存档系统、卡组配置界面、升级界面、角色解锁、后端接口。
 - [2026-09-09 22:17:58] 第一关地图重新设计已完成：地图扩展到120单位（Z: -24到96），创建3个波次生成器（WaveSpawner）在Z=25/55/85，添加视觉标识物（旗帜、石柱、石墙）标记战斗区域。摄像机修正：旋转(43,0,0)位置(0,18,-5)，朝向+Z方向与主角前进方向一致。召唤系统优化：初始状态无冷却遮罩，冷却时间从5秒改为1秒（能量已控制召唤频率）。
+- [2026-09-10 11:03:00] 第一章第一关地图（Level1-1.scene）已完成：120单位长地图（Z: -24到96），使用用户自制的6类真实3D模型装饰（石墙/木栅栏/旗帜/木箱/石柱/碎石堆），共34个物体分布在左右装饰带和3个波次标记位置。摄像机设置为2.5D视角（位置0,18,-5，旋转43°）。**Why:** 地图基础结构已完成，可以开始添加战斗逻辑和敌人生成器。**How to apply:** 后续关卡可复制此场景作为模板，调整装饰布局即可。
+- [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。
 
 ### Reference
 - [2026-09-09 12:23:17] 飞行物脚本 Projectile.cs 负责锁敌追踪、碰撞检测和伤害结算。箭矢预制体 ArrowProjectile_White.prefab 已配置 Projectile 组件和 CapsuleCollider（Is Trigger）。远程单位需在攻击动画松弦帧添加 OnAttackEffect Event，并在 UnitBase 中设置 attackType=RangedProjectile、projectilePrefab、projectileSpawnPoint。