| name | codemap |
| description | 代码地图，包含项目目录结构、文件用途说明、关键类位置索引。Invoke when navigating the codebase, locating files, or understanding project structure. |
代码地图
项目结构
Assets/Resources/Scripts/
│
├── BattleHeroInfo.cs # 战斗英雄信息
├── BattleHeroInfoGroup.cs # 战斗英雄信息组
├── CastleHUD.cs # 城堡血条HUD
├── ChessHUD.cs # 棋子血条HUD
├── CityDetail.cs # 城市详情
├── MainPanelManager.cs # 主面板管理器
├── MapDragHandler.cs # 地图拖拽处理
├── SideBar.cs # 侧边栏
├── Tooltip.cs # 提示框
├── WorldPieceControl.cs # 地图块控制
│
├── Combat/ # 战斗系统
│ ├── Actions/ # 战斗动作（Command模式）
│ │ ├── ChessAction.cs # 动作基类（SourceId, Tick, Doing()）
│ │ ├── AttackAction.cs # 普通攻击
│ │ ├── SkillDamageAction.cs # 技能伤害
│ │ ├── AddHpAction.cs # 血量变更
│ │ ├── CreateChessAction.cs # 创建棋子
│ │ ├── RemoveChessAction.cs # 移除棋子
│ │ ├── MoveAction.cs # 移动
│ │ ├── CreateMissileAction.cs # 创建投射物
│ │ ├── RemoveMissileAction.cs # 移除投射物
│ │ ├── AddBuffAction.cs # 添加Buff
│ │ ├── RemoveBuffAction.cs # 移除Buff
│ │ ├── CreateEffectAction.cs # 播放特效
│ │ ├── FoodCostAction.cs # 粮食消耗
│ │ ├── RoundUpdateAction.cs # 回合更新
│ ├── Buffs/ # Buff系统
│ │ ├── Buff.cs # Buff基类
│ │ ├── BuffManager.cs # Buff管理器（静态工厂+事件分发）
│ │ ├── BuffShield.cs # 护盾（百分比减伤）
│ │ ├── BuffShieldValue.cs # 护盾（固定值减伤）
│ │ ├── BuffCoolDown.cs # 冷却
│ │ ├── BuffNoAction.cs # 禁行动
│ │ ├── BuffNoMove.cs # 禁移动
│ │ ├── BuffLock.cs # 锁定
│ │ ├── BuffSuck.cs # 吸血
│ │ ├── BuffDamageAddRate.cs # 伤害加成
│ │ ├── BuffDamagedAddRate.cs# 受伤加成
│ │ ├── BuffSpeedDown.cs # 减速
│ │ └── BuffTimeDamage.cs # 持续伤害
│ ├── Skills/ # 技能系统
│ │ ├── Skill.cs # 技能基类
│ │ ├── SkillManager.cs # 技能管理器（静态工厂+事件分发）
│ │ ├── SkillAttack*.cs # 攻击型技能（7个）
│ │ ├── SkillDef*.cs # 防御型技能（4个）
│ │ ├── SkillHit*.cs # 命中触发型技能（10个）
│ │ ├── SkillAid*.cs # 辅助型技能（2个）
│ │ ├── SkillHelp*.cs # 帮助型技能（2个）
│ │ ├── SkillInit*.cs # 初始化型技能（3个）
│ │ ├── SkillModify*.cs # 修改型技能（3个）
│ │ ├── SkillAttacked*.cs # 被击触发型技能（2个）
│ │ └── SkillDumb.cs # 空技能/默认
│ ├── Effects/
│ │ └── DissolveEffect.cs # 溶解特效
│ ├── OOs/
│ │ └── IRecoverable.cs # 反序列化恢复接口
│ ├── Chess.cs # 棋子（战斗单位）
│ ├── ChessViewObj.cs # 棋子视图对象
│ ├── Missile.cs # 投射物
│ ├── MissileEffName.cs # 投射物特效名
│ ├── MissileViewObj.cs # 投射物视图对象
│ ├── SceneObj.cs # 场景对象基类
│ ├── EffectManager.cs # 特效管理器
│ ├── BattleStatManager.cs # 战斗统计（支持回放）
│ ├── BattleTopForceBar.cs # 战斗顶部队血条
│ ├── BattleTopInfo.cs # 战斗顶部信息
│ └── UnityMeshMgr.cs # 网格管理
│
├── Configs/ # 配置表系统（静态加载）
│ ├── ConfigManager.cs # 配置管理器（统一初始化）
│ ├── ArmsConfig_s.cs # 兵种配置
│ ├── BattleUnitConfig_s.cs # 战斗单位配置
│ ├── BuffConfig_s.cs # Buff配置
│ ├── CityAttrConfig_s.cs # 城市属性配置
│ ├── CityDevConfig_s.cs # 城市发展配置
│ ├── CityLevelConfig_s.cs # 城市等级配置
│ ├── ForceConfig_s.cs # 势力配置
│ ├── FormulaLearnAttrConfig_s.cs # 登用属性公式配置
│ ├── HeroAttrConfig_s.cs # 英雄属性配置
│ ├── HeroConfig_s.cs # 英雄配置
│ ├── ItemConfig_s.cs # 物品配置
│ ├── SeasonConfig_s.cs # 季节配置
│ ├── ShopConfig_s.cs # 商店配置
│ ├── SkillConfig_s.cs # 技能配置
│ └── WorldConfig_s.cs # 世界/地图配置
│
├── Controls/ # 控制层
│ ├── AI/ # AI策略系统
│ │ ├── AI.cs # AI入口（static class）
│ │ ├── AIStrategyContext.cs # AI上下文数据
│ │ ├── CityEvaluator.cs # 城市评估器
│ │ ├── CityStrategyState.cs # 城市战略状态枚举（Dev/Def/Atk）
│ │ ├── HeroDispatcher.cs # 英雄调度器
│ │ ├── HeroTaskMatcher.cs # 英雄任务匹配器
│ │ ├── StrategicDecider.cs # 战略决策器
│ │ └── TaskPriorityCalculator.cs # 任务优先级计算器
│ ├── Utils/
│ │ └── GameLog.cs # 日志系统
│ ├── BattleManager.cs # 战斗管理器（MonoBehaviour单例）
│ ├── BattleUIManager.cs # 战斗UI管理
│ ├── GameManager.cs # 游戏主管理器（MonoBehaviour单例）
│ └── PanelManager.cs # 面板管理器（信号分发中心）
│
├── Effect/
│ └── GlowBeamController.cs # 光束特效控制器
│
├── OOs/ # 接口定义
│ ├── ICityDevNode.cs # 城市发展节点接口
│ ├── IRankDetailInfo.cs # 排名详情接口
│ └── IRankDetailInfoHeader.cs # 排名详情头接口
│
├── PO/ # 纯数据对象 / 枚举
│ ├── ArmsType.cs # 兵种类型枚举
│ ├── AttrInfo.cs # 属性信息
│ ├── BattleCardData.cs # 战斗卡牌数据
│ ├── MapConfig.cs # 地图配置
│ ├── PanelEvent.cs # IPanelEvent 接口
│ ├── SignalData.cs # 信号数据基类及派生类
│ └── TurnPhase.cs # 回合阶段枚举
│
├── Panels/ # UI 面板
│ ├── BattleResultPanelManager.cs # 战斗结果面板
│ ├── CityBattlePanelManager.cs # 城市战斗面板
│ ├── CityDevPanelManager.cs # 城市发展面板
│ ├── CityPanelManager.cs # 城市主面板
│ ├── HeroInfoPanelManager.cs # 英雄信息面板
│ ├── PickPanelControl.cs # 选择面板
│ ├── PopArmySetManager.cs # 兵力设置弹窗
│ ├── PopCitySelectPanelManager.cs # 城市选择弹窗
│ ├── PopHeroBattleSelectPanelManager.cs # 战斗英雄选择弹窗
│ ├── PopHeroSelectPanelManager.cs # 英雄选择弹窗
│ ├── PopResultPanelManager.cs # 结果弹窗
│ ├── RankPanelManager.cs # 排名面板
│ ├── ReplayPanelManager.cs # 回放面板
│ ├── SystemPanelManager.cs # 系统面板
│ ├── VideoPanelManager.cs # 视频面板
│ ├── CityDevItem.cs # 城市发展项
│ ├── CityDevNodeMove.cs # 城市发展节点移动
│ ├── CityDevPanelCell.cs # 城市发展面板单元格
│ ├── ResItem.cs # 资源项
│ ├── SelectHeroArmyControl.cs # 英雄兵力选择
│ ├── SelectHeroControl.cs # 英雄选择控件
│ ├── SideArmsSelector.cs # 侧边兵种选择器
│ ├── Gismo/
│ │ └── ArmsItemControl.cs # 兵种项控件
│ └── ListItem/ # 列表项控件（17个）
│ ├── BattleResultHeroCellControl.cs
│ ├── CityBattleItem.cs
│ ├── CityCellCity.cs / CityCellHero.cs
│ ├── HeroInfoCell.cs
│ ├── PickPanelCellControl.cs
│ ├── PopCitySelectPanelCell.cs
│ ├── PopHeroBattleSelectPanelCell.cs
│ ├── PopHeroSelectPanelCell.cs
│ ├── PopResultCell.cs
│ ├── RankCellForce.cs / RankCellInfo.cs
│ ├── RankCellInfoCity.cs / RankCellInfoForce.cs
│ ├── RankCellMode.cs
│ ├── ReplayCellControl.cs
│ └── SideArmsItem.cs
│
├── SaveDatas/ # 存档数据类
│ ├── SaveData.cs # 总存档（forces, cities, heros, round）
│ ├── SaveForceData.cs # 势力存档
│ ├── SaveCityData.cs # 城市存档
│ ├── SaveHeroData.cs # 英雄存档
│ ├── WarTeamData.cs # 战争队伍数据（3英雄槽位）
│ ├── WarPlanData.cs # 战争计划数据（运行时，不序列化）
│ └── DevAssignmentData.cs # 发展指派数据
│
├── SystemTool/ # 系统工具类
│ ├── SysFormula.cs # 公式计算（核心，嵌套静态类分类）
│ ├── SystemConst.cs # 常量定义（核心，嵌套静态类分类）
│ ├── MapTool.cs # 地图工具（城市邻接、距离、前线判断）
│ ├── BattleRandom.cs # 战斗层随机数工具
│ ├── SysRandom.cs # 战略层随机数工具
│ ├── GameLog.cs # 日志系统
│ ├── BGMPlayer.cs # 背景音乐播放
│ ├── ConfigNameHelper.cs # 配置名辅助工具
│ ├── HeroAttrTool.cs # 英雄属性工具
│ ├── HeroSelectionTool.cs # 英雄选择工具
│ ├── NLCoroutineManager.cs # 非MonoBehaviour协程管理器
│ ├── SysSwitch.cs # 系统开关
│ └── SystemTip.cs # 系统提示
│
└── UIScripts/ # UI 通用脚本
├── AttrRadarChart.cs # 属性雷达图
├── NLDropDown.cs # 自定义下拉框
├── NLDropDownItem.cs # 下拉框项
├── SideBarAlphaGradient.cs # 侧边栏透明渐变
└── UIColorChanger.cs # 颜色切换器
关键类速查
| 类名 | 路径 | 职责 |
|---|
GameManager | Controls/GameManager.cs | 游戏主管理器（MonoBehaviour单例） |
BattleManager | Controls/BattleManager.cs | 战斗管理器（MonoBehaviour单例） |
PanelManager | Controls/PanelManager.cs | 面板管理器（信号分发中心） |
MainPanelManager | Scripts/MainPanelManager.cs | 主面板管理器 |
AI | Controls/AI/AI.cs | AI入口（static class） |
ConfigManager | Configs/ConfigManager.cs | 配置管理器（static class） |
SaveData | SaveDatas/SaveData.cs | 总存档 |
SaveForceData | SaveDatas/SaveForceData.cs | 势力存档 |
SaveCityData | SaveDatas/SaveCityData.cs | 城市存档 |
SaveHeroData | SaveDatas/SaveHeroData.cs | 英雄存档 |
MapTool | SystemTool/MapTool.cs | 地图工具（static class） |
SysFormula | SystemTool/SysFormula.cs | 公式计算（static class） |
SystemConst | SystemTool/SystemConst.cs | 常量定义（static class） |
BattleRandom | SystemTool/BattleRandom.cs | 战斗层随机数（static class） |
SysRandom | SystemTool/SysRandom.cs | 战略层随机数（static class） |
GameLog | SystemTool/GameLog.cs | 日志系统（static class） |
HeroAttrTool | SystemTool/HeroAttrTool.cs | 英雄属性工具 |
HeroSelectionTool | SystemTool/HeroSelectionTool.cs | 英雄选择工具 |
Chess | Combat/Chess.cs | 棋子（战斗单位） |
ChessAction | Combat/Actions/ChessAction.cs |
文件统计
| 目录 | .cs 文件数 | 说明 |
|---|
| Scripts/ (根) | 10 | 主面板管理器、HUD、地图拖拽等 |
| Combat/ (含子目录) | 51 | 战斗系统核心 |
| Combat/Actions/ | 15 | ChessAction 动作队列 |
| Combat/Buffs/ | 13 | Buff 系统及实现 |
| Combat/Skills/ | 38 | 技能基类及实现 |
| Configs/ | 17 | 配置类 + ConfigManager |
| Controls/ (含子目录) | 12 | Manager 层及 AI 系统 |
| Controls/AI/ | 8 | AI 策略系统 |
| Effect/ | 1 | 通用特效 |
| OOs/ | 3 | 接口定义 |
| PO/ | 7 | 纯数据对象、枚举 |
| Panels/ (含子目录) | 30 | UI 面板及列表项控件 |
| SaveDatas/ | 7 | 存档序列化数据类 |
| SystemTool/ | 12 | 系统工具类 |
| UIScripts/ | 5 | UI 通用组件 |
| 总计 | ~139 | |
