根据提供的code differences信息，由于没有具体的代码变更内容，我将生成一个通用的commit message模板：

```
docs(readme): 更新文档说明

- 添加项目使用指南
- 完善API接口说明
- 修正错误的配置示例
```

注意：由于您提供的code differences部分为空，以上是一个示例模板。当您有具体的代码变更时，请提供详细的变更内容以便生成更准确的commit message。

CODELY.md

@@ -28,7 +28,8 @@
 - [2026-09-29 22:28:50] 英雄复活后不寻敌问题：需要在ReviveHero()中调用unitBase.ResetAnchorPosition()重置锚点位置，否则returnToAnchorWhenIdle=true的英雄会尝试返回旧锚点位置导致卡住
 - [2026-10-01 15:45:16] UnitBase动画速度问题：攻击时会设置animator.speed来调整攻击动画速度，但攻击结束后必须在Alert状态和ReturnToAnchor中重置为1.0，否则会导致后续移动动画变慢
 - [2026-10-01 15:45:27] 投射物方向问题：使用transform.Translate(Vector3.forward)的投射物必须在Instantiate时计算正确的旋转Quaternion.LookRotation(direction)，否则会朝默认方向飞行。已在UnitBase.FireProjectile和FireSkillProjectile中修复
-- [2026-10-02 00:03:51] Do NOT manually instantiate stun VFX in skill scripts like StoneGolemSkill.cs — UnitBase.ApplyAreaStun() handles it internally when the prefab reference is set in Inspector. Keep skill scripts minimal: just call ApplyAreaSkillDamage and ApplyAreaStun
+- [2026-10-02 10:27:11] 石巨人地裂技能职责：命中帧实例化并调用 `ShockwaveRing.Play()` 播放地面扩散光圈；范围伤害与眩晕分开处理，`UnitBase.ApplyAreaStun()` 只给范围内每个敌方角色调用其自身 `StatusEffectController.ApplyStun()`，星星特效由角色状态组件生成、跟随和清理。石巨人不应直接实例化眩晕星星特效。
+
 - [2026-10-02 00:03:51] UnitBase fields: use unit.Camp (property), unit.IsAlive (property), NOT unit.camp or unit.isAlive (do not exist). StatusEffectController is private — access stun logic through public UnitBase methods only
 
 ### Project
@@ -122,6 +123,14 @@
 - [2026-10-01 22:57:06] UnitBase.IsWithinAttackReach 攻击缓冲：基础 buffer=0.2，攻击状态下再 +0.5 防状态抖动（UnitBase.cs 约530行）。buffer 过大会造成"隔空对打"——1.5 时近战实际在2.5米外就开打。
 - [2026-10-01 22:57:19] DefenseWaveLevelController 生成小怪时必须显式设置 UnitTeam.teamId=1（仅设 tag="Enemy" 不够），否则 Prefab 上默认 teamId=0 会让小怪被当成友军，双方都不交战。场景中该组件的 enemyPrefabs 列表需配 4 项：castle_blue_guard_q/castle_archer/castle_gold_guard/蓝角蛮卒。
 - [2026-10-02 00:03:51] Stone Golem stun VFX prefab path: Assets/Prefabs/特效/眩晕头顶星星/眩晕星星粒子.prefab — already exists, should be referenced in Stone Golem prefab Inspector for ApplyAreaStun to work
+- [2026-10-02 15:21:34] 2026-10-02 DefenseTest 人类士兵不移动的根因是 UnitBase 技能状态可能因 Animator 状态名不匹配而永久停在 State.Skill，导致 target=null、NavMeshAgent 无路径。UnitBase.PlaySkillAnimation/CheckSkillAnimationFinished 已加入技能超时兜底：动画正常结束或超过技能时长+缓冲都会恢复 Alert、清理回调并恢复 Animator 速度。
+- [2026-10-03 12:29:08] 2026-10-03 卡牌稀有度系统：CharacterData 有 CharacterRarity（Blue/Orange/Purple/Red），HeroCardUI 通过 BattleFormationSpawner 绑定 CharacterData 后选择对应边框；DefenseTest 五张卡片各有 RarityFrame Image，四种边框 Sprite 已绑定到 HeroCardUI 字段，RectTransform 保持卡片尺寸、可由用户自行调整。初始资源设定：荒野之王 Red；法师、狂暴狼人、盾卫、石巨人、精锐士兵、荒野祭司 Purple；其余现有角色 Blue；Orange 暂未分配。
+- [2026-10-03 23:38:14] DefenseTest场景已改造为开局布阵模式：玩家开局拖动英雄卡到3行6列后三排网格（BackZ=-15），点击开始战斗按钮后开始波次，每波结束英雄回到初始位置。不再预先配置阵容到JSON。已创建DefenseGameFlowController和GridLineVisualizer（红线可视化网格，Y=0.5）。StartBattleButton在BottomUI下。
+- [2026-10-04 09:28:04] 2026-10-04 DefenseTest 开局卡牌拖动修复完成：根本原因是 BattleFormationSpawner 在 Start() 时自动生成英雄（法师/弓箭手），DefenseGameFlowController.InitializeCardDrag() 需要的 HeroRoster.asset 因损坏无法加载。修复方案：1) 重新创建 HeroRoster.asset 包含5个英雄并正确设置 unitPrefab 引用；2) 在场景中禁用 BattleFormationSpawner 组件，塔防版不需要自动生成初始英雄；3) DefenseGameFlowController.roster 字段在场景中配置 HeroRoster 引用。现在开局场上无单位，5张卡片均可拖动，HeroCardDrag 组件和 CanvasGroup 已自动配置。
+- [2026-10-04 10:15:39] 2026-10-04 DefenseTest 布阵拖拽系统重做完成。DeployGrid 常量改为 6列×5行、ColStep=2.8、RowStep=3.0、BackZ=-9（旧值 -15 落在 NavMesh 之外，单位会卡住）。战场/部署网格 的30个格位由 DefenseGameFlowController.AlignGridCells 按命名「格位_行_列」自动摆到 DeployGrid 坐标，布阵阶段显示、开战隐藏。新增 DeployHighlight（绿=可放/红=已占用，公开 IsVisible/IsBlocked/ShownCell），HeroCardDrag 重写为「生成半透明英雄幽灵跟随指针 + 平面射线吸附格位」，DefenseGameFlowController 增加 Instance/IsDeployPhase/PlaceHeroFromCard/IsCellOccupied/IsCardPlaced/RemoveHeroAt，点击已放置英雄可撤回（Update 里 Physics.Raycast 命中 UnitBase）。场景新增 StartBattleButton（Canvas 根、bottom-center、y=360、圆角绿底），deploymentUI 必须保持 null——英雄卡面板战斗中要一直显示血量/复活。血条隐藏要操作 WorldHealthBar.Awake 生成的子物体 "WorldHealthBar"，不是组件所在的对象。
+- [2026-10-04 11:15:47] 2026-10-04 DefenseTest 布阵区域改为 4×4 并与用户新建的 Plane 完全重合。DeployGrid 常量：Cols=4、Rows=4、ColStep=2.875、RowStep=2.8、BackZ=-14.2、CellWidth=2.815、CellDepth=2.74、GridY=0.115、UnitY=0.10（对齐重烘后的 NavMesh）。Plane 原在 y=0.5 会挡住单位，已降到 y=0.09 并放入 Buildings 层(layer 8)排除烘焙；NavMeshSurface 体积改为 center=(0,1,12) size=(28,12,62) 重烘，NavMesh 高度由 0.16 变 0.095，DefenseWaveLevelController.spawnY 同步改为 0.1。开始游戏按钮改为顶部居中（anchor 上中、anchoredPosition y=-170、420×120）。注意：BattlePlatform 实际只覆盖 Z -22.8..17.2，所以 NavMesh 远端也就到 ~16.9，敌人 spawnZ=20 本身在地面之外（靠 NavMeshAgent 自动吸附），这是既有行为。
+- [2026-10-04 13:12:11] 2026-10-04 英雄打完归位改为"走回去"（正常速度），去掉瞬移。关键坑：UnitBase.Start 里 `navAgent.stoppingDistance = attackRange*0.95` 会让 agent 在到达锚点前就认为"已到达"而停住（法师 5.7 米、盾卫 0.95 米都远大于 anchorArrivalDistance 0.35），所以"走回锚点"以前根本走不到——这正是当初只能瞬移的原因。修法：ReturnToAnchor 里把 stoppingDistance 设 0，RestoreIdleSpeed/move() 里恢复 NormalStoppingDistance。另新增 useAnchorLeash/anchorLeashDistance（英雄设为 10 米，DefenseGameFlowController.heroLeashDistance 控制），目标距锚点超过上限就不追，避免一路推到 Z≈16。DefenseGameFlowController.ResetHeroPositions 现在只清 target 让 UnitBase 自己走回，仅当 NavMesh.SamplePosition 找不到落脚点（真卡住）才瞬移兜底。
+- [2026-10-04 14:12:16] 2026-10-04 DefenseTest 两处修正：1) 阵位守护距离不再单开字段，直接用 UnitBase.detectionRange（已删除 anchorLeashDistance / heroLeashDistance；DefenseGameFlowController 只留开关 heroGuardPost=true，新 bool 字段在旧场景里会反序列化成 false，必须显式写进场景）。出战 5 个英雄 Prefab 的 detectionRange 已从 30/50 调到 10（弓箭手 12）。2) 底部英雄卡的角色改回从 PlayerData.json 的 currentDeck 读（站位不再读），卡面(头像/名字/稀有度)用同一份 CharacterData 刷新（新增 HeroCardUI.SetCharacterInfo，区别于绑定单位的 SetHero），否则会出现「卡面显示人类士兵、拖出来却是法师」的不一致；PlayerData 读不到时兜底用 HeroRoster。注意 CharacterData 里有些角色（荒野之王/荒野流寇等）unitPrefab 为空，不能出战，取阵容时要跳过。
 
 ### Reference
 - [2026-09-09 12:23:17] 飞行物脚本 Projectile.cs 负责锁敌追踪、碰撞检测和伤害结算。箭矢预制体 ArrowProjectile_White.prefab 已配置 Projectile 组件和 CapsuleCollider（Is Trigger）。远程单位需在攻击动画松弦帧添加 OnAttackEffect Event，并在 UnitBase 中设置 attackType=RangedProjectile、projectilePrefab、projectileSpawnPoint。