القائمة
MapTool地图工具规则，包含城市邻接查询、前线判断、距离计算等规范。Invoke when working with city adjacency, frontline detection, distance calculation, or map-related logic.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/realeternia/SanKingdom --skill maptoolيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | maptool |
| description | MapTool地图工具规则，包含城市邻接查询、前线判断、距离计算等规范。Invoke when working with city adjacency, frontline detection, distance calculation, or map-related logic. |
MapTool 是 SystemTool/ 下的静态工具类，统一管理所有基于 WorldConfig.WorldNearIds 的城市邻接查询逻辑。
禁止在业务代码中直接访问 WorldConfig.WorldNearIds 进行邻接判断，必须使用 MapTool 提供的方法。
| 方法 | 返回值 | 说明 |
|---|---|---|
GetAdjacentCityIds(int cityId) | List<int> | 获取某城市的所有相邻城市ID（纯配置查询，无势力参数） |
GetAdjacentFriendlyCityIds(int cityId, int forceId) | List<int> | 获取某城市相邻的同势力城市 |
GetAdjacentEnemyCityIdsForCity(int cityId, int forceId) | List<int> | 获取某城市相邻的敌对势力城市（针对单个城市） |
GetAdjacentEnemyCityIds(int forceId) | List<int> | 获取某势力所有城市的相邻敌方城市并集（HashSet 去重） |
GetOwnCityIds(int forceId) | List<int> | 获取某势力所有己方城市ID |
IsAdjacentCity(int cityId1, int cityId2) | bool | 判断两个城市是否相邻 |
IsFrontlineCity(int cityId) | bool | 判断某城市是否为前线城市（存在邻接敌方城市） |
GetFrontlineCityIds(int forceId) | List<int> | 获取某势力所有前线城市ID |
GetRearCityIds(int forceId) | List<int> | 获取某势力所有后方城市ID（非前线） |
GetRandomAdjacentCityId(int cityId) | int | 随机获取一个相邻城市ID（无邻接时返回 0） |
CalculateCityDistance(int cityId1, int cityId2) | int | 计算两城市间距离 |
GetAdjacentEnemyCityIdsForCity 带 ForCity 后缀 = 针对特定城市+势力的查询GetAdjacentEnemyCityIds 无 ForCity 后缀 = 势力级别的全局查询（遍历所有己方城市，HashSet 去重）GetAdjacentCityIds 无势力参数 = 纯配置查询，直接返回 WorldConfig.WorldNearIdsIsFrontlineCity 内部调用 GetAdjacentEnemyCityIdsForCity，判断结果 Count > 0GetFrontlineCityIds / GetRearCityIds 内部调用 IsFrontlineCityGetOwnCityIds 委托给 GameManager.Instance.GetCitiesByForce(forceId)CalculateCityDistance 委托给 SysFormula.City.CalculateDistance(cfg1.X, cfg1.Y, cfg2.X, cfg2.Y)，使用 WorldConfig 中的 X/Y 坐标GetRandomAdjacentCityId 使用 SysRandom.Range，符合战略层随机数规范GetRandomAdjacentCityId 无邻接城市时返回 0（0 不是合法 cityId，调用方需注意）new List<int>()）或 falseIsFrontlineCity 的判定标准：只要存在一个非同势力的邻接城市就算前线。即 GetAdjacentEnemyCityIdsForCity(cityId, city.forceId).Count > 0。
所有邻接关系来自 WorldConfig.WorldNearIds（配置层数组），是地图拓扑的静态配置，非运行时动态计算。
MapTool，禁止直接访问 WorldConfig.GetConfig(cityId).WorldNearIdsMapTool.IsFrontlineCity / MapTool.GetFrontlineCityIds / MapTool.GetRearCityIdsMapTool.CalculateCityDistance，SaveCityData.CalculateDistanceTo 内部已委托给它WorldConfig.WorldNearIds 进行城市邻接判断，必须使用 MapTool 的方法