slg-mcp 0.1.4 → 0.1.7

package/manifest/agent-api.json

@@ -1,5 +1,5 @@
 {
-  "version": 65,
+  "version": 71,
   "title": "SLG Agent API 参考",
   "compatPolicy": [
     "只加不改：已发布的协议号、字段与错误码只新增、不删除、不改变类型与语义。",
@@ -764,7 +764,7 @@
                 "role": "player",
                 "sessionToken": "session-example-token-for-doc-0000000000000",
                 "expiresAt": "2026-10-25T08:00:00.000Z",
-                "protocolVersion": 65,
+                "protocolVersion": 71,
                 "docNotice": null,
                 "season": {
                   "id": 2,
@@ -813,7 +813,7 @@
                 "role": "player",
                 "sessionToken": "session-example-token-for-doc-0000000000000",
                 "expiresAt": "2026-10-25T08:00:00.000Z",
-                "protocolVersion": 65,
+                "protocolVersion": 71,
                 "docNotice": null,
                 "season": {
                   "id": 2,
@@ -833,14 +833,14 @@
           ]
         },
         {
-          "caption": "Agent 令牌登录并带上手上文档的版本（令牌永不过期、expiresAt 为 null；可顺带 agentModel 自报驱动模型，供模型榜分组；文档落后时响应附 docNotice，按提示 GET /agent-api/changes/62 补读增量）",
+          "caption": "Agent 令牌登录并带上手上文档的版本（令牌永不过期、expiresAt 为 null；可顺带 agentModel 自报驱动模型，供模型榜分组；文档落后时响应附 docNotice，按提示 GET /agent-api/changes/68 补读增量）",
           "request": {
             "op": 1,
             "seq": 1,
             "data": {
               "token": "session-example-token-for-doc-0000000000000",
               "asAgent": true,
-              "docVersion": 62,
+              "docVersion": 68,
               "agentModel": "claude-opus-5-5"
             }
           },
@@ -855,8 +855,8 @@
                 "role": "agent",
                 "sessionToken": "session-example-token-for-doc-0000000000000",
                 "expiresAt": null,
-                "protocolVersion": 65,
-                "docNotice": "接口文档已从 v62 更新到 v65：请 GET /agent-api/changes/62 查看增量变更，或重新下载 /agent-api.md（与本游戏服务同域名的 HTTPS 地址）。",
+                "protocolVersion": 71,
+                "docNotice": "接口文档已从 v68 更新到 v71：请 GET /agent-api/changes/68 查看增量变更，或重新下载 /agent-api.md（与本游戏服务同域名的 HTTPS 地址）。",
                 "season": {
                   "id": 2,
                   "endsAt": "2026-11-22T00:00:00.000Z"
@@ -2249,7 +2249,7 @@
         {
           "name": "events[].type",
           "type": "string",
-          "desc": "事件类型：'build_started' | 'build_queued' | 'build_completed' | 'build_cancelled'（v7） | 'recruit_started' | 'recruit_queued' | 'recruit_completed' | 'recruit_cancelled'（v11） | 'march_started' | 'march_completed' | 'wilderness_occupied' | 'wilderness_lost' | 'npc_city_occupied' | 'npc_raid'（v12） | 'city_renamed'（v7） | 'account_reset'（v9，重置后事件流只剩这一条） | 'agent_connected' | 'agent_disconnected' | 'resource_exchanged'（v22，集市兑换成交，detail = { resource, amount, gold, rate }） | 'npc_attack_warning'（v23，NPC 袭击预警，detail = { x, y, target, terrain, level, armyMin, armyMax, arriveAt, attackId }） | 'starvation_warning' / 'mutiny'（v34，断粮预警 / 哗变） | 'hero_recruited' / 'hero_dismissed' / 'hero_arrears' / 'hero_wounded' / 'hero_level_up' / 'hero_granted' / 'guard_changed'（v36，AISLG-114/115/116，武将：招募 / 解雇 / 欠饷 / 重伤 / 升级 / 获得名将 / 城守任命）· 'wilderness_depleted'（v61，AISLG-165，名下野地储量采空，detail = { x, y, terrain, level, at }）。"
+          "desc": "事件类型：'build_started' | 'build_queued' | 'build_completed' | 'build_cancelled'（v7） | 'recruit_started' | 'recruit_queued' | 'recruit_completed' | 'recruit_cancelled'（v11） | 'march_started' | 'march_completed' | 'wilderness_occupied' | 'wilderness_lost' | 'npc_city_occupied' | 'npc_raid'（v12） | 'city_renamed'（v7） | 'account_reset'（v9，重置后事件流只剩这一条） | 'agent_connected' | 'agent_disconnected' | 'resource_exchanged'（v22，集市兑换成交，detail = { resource, amount, gold, rate }） | 'npc_attack_warning'（v23，NPC 袭击预警，detail = { x, y, target, terrain, level, armyMin, armyMax, arriveAt, attackId }） | 'starvation_warning' / 'mutiny'（v34，断粮预警 / 哗变） | 'hero_recruited' / 'hero_dismissed' / 'hero_arrears' / 'hero_wounded' / 'hero_level_up' / 'hero_granted' / 'guard_changed'（v36，AISLG-114/115/116，武将：招募 / 解雇 / 欠饷 / 重伤 / 升级 / 获得名将 / 城守任命）· 'wilderness_depleted'（v61，AISLG-165，名下野地储量采空，detail = { x, y, terrain, level, at }）· 'truce_cancelled'（v71，AISLG-190，主动免战提前解除，detail = { until, cancelledAt }）。"
         },
         {
           "name": "events[].initiator",
@@ -3101,14 +3101,14 @@
       "op": 24,
       "kind": "request",
       "name": "CANCEL_BUILD",
-      "title": "取消排队中的建造条目",
+      "title": "取消建造条目（排队中 / 建造中）",
       "preAuth": false,
-      "summary": "取消建造队列中 status=queued 的条目：该条目退出队列（status 变为 cancelled，保留为历史，不再出现在 city.queue），发起时扣减的成本按条目上的成本快照全额返还（2026-09-27 确认规则）。进行中（building）条目能否取消待定，当前返回 BUILD_NOT_CANCELLABLE。",
+      "summary": "取消建造队列中 status=queued（排队中）或 status=building（建造中）的条目：该条目退出队列（status 变为 cancelled，保留为历史，不再出现在 city.queue），发起时扣减的成本按条目上的成本快照全额返还（2026-09-27 确认规则，全额返还）。建造中取消时建筑等级不变（升级中取消则保持当前等级），该城排队的下一条立即开工（同一事务激活，推送 build_started）。连续升级（toLevel）进行中取消：已完成的级保留等级、不退，只返还未完成级的成本。已完成 / 已取消的条目返回 BUILD_NOT_CANCELLABLE。",
       "requestFields": [
         {
           "name": "buildId",
           "type": "string",
-          "desc": "必填。要取消的建造条目 UUID（GET_STATE 的 city.queue 中排队条目的 id）；缺失返回 INVALID_PARAMS。"
+          "desc": "必填。要取消的建造条目 UUID（GET_STATE 的 city.queue 中 queued / building 条目的 id）；缺失返回 INVALID_PARAMS。"
         }
       ],
       "dataFields": [
@@ -3155,7 +3155,7 @@
           ]
         },
         {
-          "caption": "取消在建条目被拒（附当前状态）",
+          "caption": "取消已完成的条目被拒（附当前城池状态）",
           "request": {
             "op": 24,
             "seq": 2,
@@ -3170,13 +3170,13 @@
               "ok": false,
               "error": {
                 "code": "BUILD_NOT_CANCELLABLE",
-                "message": "只能取消排队中的建造任务（在建任务能否取消待设计）"
+                "message": "建造任务不存在、不属于本账号或已完成 / 已取消，无法取消"
               }
             }
           ]
         }
       ],
-      "agentNote": "先 GET_STATE 拿 city.queue 中排队条目的 id 再取消。取消后该类型可以立即重新发起 BUILD。同账号其他在线连接会收到 PUSH_BUILD_STATE（build_cancelled）推送。"
+      "agentNote": "先 GET_STATE 拿 city.queue 中条目的 id 再取消（排队中与建造中都可取消）。取消后该类型可以立即重新发起 BUILD；建造中取消的成本全额回来，别忘了它排队的下一条已自动开工。同账号其他在线连接会收到 PUSH_BUILD_STATE（build_cancelled，以及下一条的 build_started）推送。"
     },
     {
       "op": 25,
@@ -3958,20 +3958,20 @@
           ]
         }
       ],
-      "agentNote": "发起前用 GET_STATE 的 levels.barracks 对照兵种门槛、resources 与 population 预判；失败响应的 data 仅含 city（无 recruit 载荷）。征募中条目能否取消待定，当前只能取消排队条目。同账号其他在线连接会收到 PUSH_RECRUIT_STATE（recruit_started / recruit_queued）推送。"
+      "agentNote": "发起前用 GET_STATE 的 levels.barracks 对照兵种门槛、resources 与 population 预判；失败响应的 data 仅含 city（无 recruit 载荷）。征募中条目也可取消（CANCEL_RECRUIT，全额返还）。同账号其他在线连接会收到 PUSH_RECRUIT_STATE（recruit_started / recruit_queued）推送。"
     },
     {
       "op": 29,
       "kind": "request",
       "name": "CANCEL_RECRUIT",
-      "title": "取消排队中的征兵条目",
+      "title": "取消征兵条目（排队中 / 征募中）",
       "preAuth": false,
-      "summary": "取消征兵队列中 status=queued 的条目：该条目退出队列（status 变为 cancelled，保留为历史），发起时扣减的资源与人口按条目快照全额返还（人口立即回到城池、恢复增长）。征募中（recruiting）条目能否取消待定，当前返回 RECRUIT_NOT_CANCELLABLE。",
+      "summary": "取消征兵队列中 status=queued（排队中）或 status=recruiting（征募中）的条目：该条目退出队列（status 变为 cancelled，保留为历史），发起时扣减的资源与人口按条目快照全额返还（人口立即回到城池、恢复增长）。征募中取消后已经过去的征募时间作废，该城排队的下一条立即开始征募（同一事务激活，推送 recruit_started）。已完成 / 已取消的条目返回 RECRUIT_NOT_CANCELLABLE。",
       "requestFields": [
         {
           "name": "recruitId",
           "type": "string",
-          "desc": "必填。要取消的征兵条目 UUID（GET_STATE 的 city.recruitQueue 中排队条目的 id）；缺失返回 INVALID_PARAMS。"
+          "desc": "必填。要取消的征兵条目 UUID（GET_STATE 的 city.recruitQueue 中 queued / recruiting 条目的 id）；缺失返回 INVALID_PARAMS。"
         }
       ],
       "dataFields": [
@@ -4016,7 +4016,7 @@
           ]
         },
         {
-          "caption": "取消征募中条目被拒",
+          "caption": "取消已完成的条目被拒",
           "request": {
             "op": 29,
             "seq": 2,
@@ -4031,13 +4031,13 @@
               "ok": false,
               "error": {
                 "code": "RECRUIT_NOT_CANCELLABLE",
-                "message": "只能取消排队中的征兵任务（征募中能否取消待设计）"
+                "message": "征兵任务不存在、不属于本账号或已完成 / 已取消，无法取消"
               }
             }
           ]
         }
       ],
-      "agentNote": "先 GET_STATE 拿 city.recruitQueue 中排队条目的 id 再取消。同账号其他在线连接收到 PUSH_RECRUIT_STATE（recruit_cancelled）推送。"
+      "agentNote": "先 GET_STATE 拿 city.recruitQueue 中条目的 id 再取消（排队中与征募中都可取消）。同账号其他在线连接收到 PUSH_RECRUIT_STATE（recruit_cancelled，以及下一条的 recruit_started）推送。"
     },
     {
       "op": 30,
@@ -4107,7 +4107,7 @@
         {
           "name": "tiles[].owner",
           "type": "object | null",
-          "desc": "占领者（占领野地或城池地块归属的城池）：{ accountId, username, cityId, cityName }；无主为 null。"
+          "desc": "占领者（占领野地或城池地块归属的城池）：{ accountId, username, cityId, cityName, ally }；无主为 null。ally（v67，AISLG-182）= 占领者与你同属一个联盟（盟友，自己的地块为 false）：盟友的城池 / 野地不能掠夺、抢占、占领，也不能侦察（返回 ALLY_NOT_ATTACKABLE）。"
         },
         {
           "name": "tiles[].garrison",
@@ -4363,7 +4363,7 @@
       "name": "MARCH",
       "title": "出征 / 调兵 / 运输（从主城派兵，v12 起；v16 新增掠夺 / 占领任务；v26 新增运输任务）",
       "preAuth": false,
-      "summary": "从账号主城派出部队前往目标地块，到达后由服务端自动结算。编队 troops 按兵种给出数量（至少一种 > 0），发起时立即从城内驻军扣减；行军时长 = Chebyshev 距离 × 每格秒数（基准 15 秒/格，占位）÷ **编队最慢兵种的行军速度系数**（斥候 ×2、轻骑兵 ×1.5，其余 ×1）÷（1 + 行军科技加成，v27 每级 +5%；v30 AISLG-83：自己城池之间的调兵 / 运输再加出发城**驿站**加成，每级 +10%、10 级翻倍，出征野地 / NPC 城等其他目标不受影响，运输往返与失效返程同吃出发城驿站），**总时长**再 ÷ 全局时间缩放、向上取整、最少 1 秒（见文档头部；不是先把每格缩放取整再乘格数）。以响应里的 arriveAt 为准。v16 新增可选 **task**：`plunder`（掠夺，**缺省值**）或 `occupy`（占领）——只作用于野地与 NPC 城目标，侦察 / 调兵 / 增援忽略 task。目标与结算：**无主野地**按 task 掠夺或占领（战斗 vs 原住守军）；**本账号占领的野地** = 增援驻军（不战斗）；**未被占领的 NPC 城池**可掠夺，也可占领变分城（v24，AISLG-58；战斗 vs 驻防、守方据墙待敌）；**本账号分城** = 调兵（不战斗，到达并入该城驻军）；**发起前校验校场（v30，AISLG-80）**：本城同时在外的部队数（行军中含返程 + 驻守野地，不计城内驻军）已达校场等级上限（未建校场按 1）时返回 DEPLOY_LIMIT，SCOUT 同；玩家城池（他人的）、他人占领地块与出发主城本身不可作为目标（玩家对抗随后续阶段开放）。**v38（AISLG-122，玩家对抗一）开放掠夺他人城池**：主城与分城都能打、不用宣战，战斗与 NPC 打主城同口径的守城战（城墙、城防科技、箭塔、守方城守全部生效），发起即给守方推送来袭预警（PUSH_ATTACK_WARNING，预警窗口 = 行军时长，敌情按守方烽火台分档）；守方处于新手保护返回 NEWBIE_PROTECTED、免战中返回 TARGET_IN_TRUCE（均附 until / retryAfterSeconds），攻方自己的主动免战生效中返回 SELF_TRUCE_ACTIVE（打野地 / NPC 不受限）；**task=occupy 对他人分城开放（v40，AISLG-124，玩家对抗三）**：主城仍返回 TASK_INVALID_FOR_TARGET（永不可占领，只能被掠夺）。分城占领资格与占 NPC 城同口径（GOVERNMENT_TOO_LOW / BRANCH_LIMIT / TARGET_LEVEL_TOO_HIGH，目标等级 = 该城官府等级），发起时初核、到达复核（名额没了照打、只降城防值不换主，事件 battle_won 记 occupied=false 与 denial）。守城战打赢一次（守军全灭）城防值 −35，攻方幸存冲车占比每 1% 再 +1.5（最多 +15）；**占领打赢不掠夺资源，掠夺打赢不降城防**；城防降到 0 且名额有空当场换主（详见「玩家对抗与城防值」一节与 GET_TILE 的 tile.durability）；每次打赢该城进入 4 小时（基准随缩放）被动免战，免战内城防不回涨、结束后每小时回涨 10 至满——占一座分城至少打 3 次、隔 8 小时以上，守方每次都有时间补兵 / 增援；在途到达时守方进入保护 / 免战则扑空返程（事件 outcome=aborted 附 cause）。**v39（AISLG-123，玩家对抗二）开放抢占他人占领的野地**：task='occupy'（缺省 plunder 返回 TASK_INVALID_FOR_TARGET——地里没有存货可抢）；野地战无城墙 / 箭塔 / 城守，守方 = 地块驻军，守方没留驻军不打、直接拿下（无战报）；发起即给守方推 PUSH_ATTACK_WARNING（target='wilderness'，敌情按其所属城烽火台分档），预警期间可向该地块增援（MARCH 打自己的地块 = 增援）；守方处于新手保护（NEWBIE_PROTECTED）或主动免战（TARGET_IN_TRUCE）时其全部野地不可被抢，但守方某座城的被动免战只保护城本身、不保护野地；地块处于换主保护期（被抢占后 1 小时基准随缩放）返回 TILE_PROTECTED；攻方自己的主动免战生效中同样不能抢（SELF_TRUCE_ACTIVE）。**抢占结算**：打赢且出发城占领名额（官府等级）有空 → 地块易主、幸存部队驻守并获得加成、地块进入换主保护（1 小时基准随缩放，玩家与 NPC 都不能再抢）；名额已满 → 守方照样失地（wilderness_lost cause=conquest）、地块变无主（不设保护）、攻方幸存返程（事件 battle_won 记 occupied=false / denial=TERRITORY_LIMIT）；打输 → 守方继续占领，攻方残部返程；战报 kind='pvp_wilderness' 攻守双方各一份。**到达复核口径（v39）**：到达时地块已无主（对方召回等）→ 扑空返程（aborted，cause=target_gone）；已易主第三人 → 扑空返程（aborted，cause=owner_changed）；已归本账号 → 转增援并入驻军。战斗为多回合推进结构（速度与射程影响接敌、城墙为守方提供受击减免；具体算法不对外公开，机制概览见术语表「战斗」、兵种数值见「兵种与战斗属性」）；攻方歼灭守方获胜、胜方幸存 ≥ 1，攻方战败（全灭或回合耗尽）时幸存部队撤回出发城。**掠夺结算（task=plunder）**：野地奖励池 = 地形对应资源 × 750 × 等级 + 金币 × 250 × 等级（v21 掠夺含金，AISLG-31；金矿 gold_mine 保持空池——金矿定位占领生息）；NPC 城 = 持久化库存（v21 起含金币；库存不再生、掠空后无收益）。实际带走量按**幸存部队负重**装填（Σ 数量 × 单兵 carry，v27 起再 × 负重科技加成（每级 +5%，向下取整）；运输任务的负重上限同口径：民夫 500、斥候/刀盾兵 80、轻骑兵 100，其余 60，占位），按**金→粮→木→石→铁**顺序装满即止，立即入账出发城（不钳储量上限）；不改归属、幸存部队返程；成功掠夺的地块进入 24 小时冷却（基准，受全局时间缩放；发起时校验 PLUNDER_COOLDOWN——v22 起该失败附 retryAfterSeconds（冷却截止 − 当前时刻，等满后重发必然受理；在途到达仍战斗但资源为零）。**掠夺玩家城（v38，AISLG-122）**：可抢池 = 城内资源先扣仓库保护（粮/木/石/铁 各保护 1000×仓库等级，金币不受保护），再乘单次比例上限（四资源 45%、金币 15%，v42 AISLG-126 校准拍板）与等级差衰减（出发城官府比目标城官府高 5 级起每多 1 级收益 −15%、最低 25%——大号打小号不禁止但收益递减），最后仍按幸存部队负重装填；攻破（守军全灭）后该城进入 4 小时（基准，随缩放）被动免战，玩家与 NPC 都不能再打它（GET_TILE 的 tile.protection 可查）；战报 kind='pvp_raid'，攻守双方各得一份；玩家城不受地块掠夺冷却限制（免战即冷却）。**名城（v24，AISLG-56，GET_TILE / 地图的 famous 字段标识，全图 8 座）分两阶段**：外围阶段对其出征（掠夺 / 占领都一样）打的是外围驻军（野战无城墙），打赢 = 外围清空、名城进入城守阶段（事件 battle_won 含 stage='outer'、outerCleared=true、recoversAt），无战利品；城守阶段（限时，超时外围恢复满编）再出征攻城守——task=plunder 掠夺其库存，task=occupy 占领并变分城（以名城命名、产量 +20%，名城计入分城上限）；外围未清时对其 task=occupy 返回 OUTER_NOT_CLEARED。名城守军 = 同等级普通 NPC 城 × 3（外围与城守各一半）。**占领 NPC 城（task=occupy，v24）**：需同时满足——主城官府 ≥ 3 级（GOVERNMENT_TOO_LOW）；分城数 < 分城上限 = floor(主城官府等级 ÷ 2)（BRANCH_LIMIT，名城同样计入）；目标 NPC 城等级 ≤ 出发城的官府等级（TARGET_LEVEL_TOO_HIGH）。发起时初核，Worker 到达时复核（不满足则胜利后不建分城、幸存部队返程，事件 battle_won 记录 occupied=false 与 denial）。打赢后该城成为分城：接收 NPC 城的建筑与**剩余库存**，幸存部队进城驻守，分城可独立建造 / 征兵 / 出征（城池类协议带 cityId）；占领不受掠夺冷却限制，不另行掠夺（库存随城移交）。**占领野地结算（task=occupy 目标为野地）**：无一次性战利品；该城占领野地数低于官府等级（上限 = 官府等级，随官府升级提高）时改归属、幸存部队驻守并获得持续加成；发起时初核 TERRITORY_LIMIT，到达复核（超限则胜利后不改归属、幸存部队返程，事件记录 occupied=false / denial=TERRITORY_LIMIT）。每场战斗生成一份战报（GET_BATTLE_REPORTS 可查、PUSH_BATTLE_REPORT 推送）。",
+      "summary": "从账号主城派出部队前往目标地块，到达后由服务端自动结算。编队 troops 按兵种给出数量（至少一种 > 0），发起时立即从城内驻军扣减；行军时长 = Chebyshev 距离 × 每格秒数（基准 15 秒/格，占位）÷ **编队最慢兵种的行军速度系数**（斥候 ×2、轻骑兵 ×1.5，其余 ×1）÷（1 + 行军科技加成，v27 每级 +5%；v30 AISLG-83：自己城池之间的调兵 / 运输再加出发城**驿站**加成，每级 +10%、10 级翻倍，出征野地 / NPC 城等其他目标不受影响，运输往返与失效返程同吃出发城驿站），**总时长**再 ÷ 全局时间缩放、向上取整、最少 1 秒（见文档头部；不是先把每格缩放取整再乘格数）。以响应里的 arriveAt 为准。v16 新增可选 **task**：`plunder`（掠夺，**缺省值**）或 `occupy`（占领）——只作用于野地与 NPC 城目标，侦察 / 调兵 / 增援忽略 task。目标与结算：**无主野地**按 task 掠夺或占领（战斗 vs 原住守军）；**本账号占领的野地** = 增援驻军（不战斗）；**未被占领的 NPC 城池**可掠夺，也可占领变分城（v24，AISLG-58；战斗 vs 驻防、守方据墙待敌）；**本账号分城** = 调兵（不战斗，到达并入该城驻军）；**发起前校验校场（v30，AISLG-80）**：本城同时在外的部队数（行军中含返程 + 驻守野地，不计城内驻军）已达校场等级上限（未建校场按 1）时返回 DEPLOY_LIMIT，SCOUT 同；玩家城池（他人的）、他人占领地块与出发主城本身不可作为目标（玩家对抗随后续阶段开放）。**v38（AISLG-122，玩家对抗一）开放掠夺他人城池**：主城与分城都能打、不用宣战，战斗与 NPC 打主城同口径的守城战（城墙、城防科技、箭塔、守方城守全部生效），发起即给守方推送来袭预警（PUSH_ATTACK_WARNING，预警窗口 = 行军时长，敌情按守方烽火台分档）；守方处于新手保护返回 NEWBIE_PROTECTED、免战中返回 TARGET_IN_TRUCE（均附 until / retryAfterSeconds），攻方自己的主动免战生效中返回 SELF_TRUCE_ACTIVE（打野地 / NPC 不受限）；**task=occupy 对他人分城开放（v40，AISLG-124，玩家对抗三）**：主城仍返回 TASK_INVALID_FOR_TARGET（永不可占领，只能被掠夺）。分城占领资格与占 NPC 城同口径（GOVERNMENT_TOO_LOW / BRANCH_LIMIT / TARGET_LEVEL_TOO_HIGH，目标等级 = 该城官府等级），发起时初核、到达复核（名额没了照打、只降城防值不换主，事件 battle_won 记 occupied=false 与 denial）。守城战打赢一次（守军全灭）城防值 −35，攻方幸存冲车占比每 1% 再 +1.5（最多 +15）；**占领打赢不掠夺资源，掠夺打赢不降城防**；城防降到 0 且名额有空当场换主（详见「玩家对抗与城防值」一节与 GET_TILE 的 tile.durability）；每次打赢该城进入 4 小时（基准随缩放）被动免战，免战内城防不回涨、结束后每小时回涨 10 至满——占一座分城至少打 3 次、隔 8 小时以上，守方每次都有时间补兵 / 增援；在途到达时守方进入保护 / 免战则扑空返程（事件 outcome=aborted 附 cause）。**v39（AISLG-123，玩家对抗二）开放抢占他人占领的野地**：task='occupy'（缺省 plunder 返回 TASK_INVALID_FOR_TARGET——地里没有存货可抢）；野地战无城墙 / 箭塔 / 城守，守方 = 地块驻军，守方没留驻军不打、直接拿下（无战报）；发起即给守方推 PUSH_ATTACK_WARNING（target='wilderness'，敌情按其所属城烽火台分档），预警期间可向该地块增援（MARCH 打自己的地块 = 增援）；守方处于新手保护（NEWBIE_PROTECTED）或主动免战（TARGET_IN_TRUCE）时其全部野地不可被抢，但守方某座城的被动免战只保护城本身、不保护野地；地块处于换主保护期（被抢占后 1 小时基准随缩放）返回 TILE_PROTECTED；攻方自己的主动免战生效中同样不能抢（SELF_TRUCE_ACTIVE）。**抢占结算**：打赢且出发城占领名额（官府等级）有空 → 地块易主、幸存部队驻守并获得加成、地块进入换主保护（1 小时基准随缩放，玩家与 NPC 都不能再抢）；名额已满 → 守方照样失地（wilderness_lost cause=conquest）、地块变无主（不设保护）、攻方幸存返程（事件 battle_won 记 occupied=false / denial=TERRITORY_LIMIT）；打输 → 守方继续占领，攻方残部返程；战报 kind='pvp_wilderness' 攻守双方各一份。**到达复核口径（v39）**：到达时地块已无主（对方召回等）→ 扑空返程（aborted，cause=target_gone）；已易主第三人 → 扑空返程（aborted，cause=owner_changed）；已归本账号 → 转增援并入驻军。战斗为多回合推进结构（速度与射程影响接敌、城墙为守方提供受击减免；具体算法不对外公开，机制概览见术语表「战斗」、兵种数值见「兵种与战斗属性」）；攻方歼灭守方获胜、胜方幸存 ≥ 1，攻方战败（全灭或回合耗尽）时幸存部队撤回出发城。**掠夺结算（task=plunder）**：野地奖励池 = 地形对应资源 × 750 × 等级 + 金币 × 250 × 等级（v21 掠夺含金，AISLG-31；金矿 gold_mine 保持空池——金矿定位占领生息）；NPC 城 = 持久化库存（v21 起含金币；库存不再生、掠空后无收益）。实际带走量按**幸存部队负重**装填（Σ 数量 × 单兵 carry，v27 起再 × 负重科技加成（每级 +5%，向下取整）；运输任务的负重上限同口径：民夫 500、斥候/刀盾兵 80、轻骑兵 100，其余 60，占位），按**金→粮→木→石→铁**顺序装满即止，立即入账出发城（不钳储量上限）；不改归属、幸存部队返程；成功掠夺的地块进入 24 小时冷却（基准，受全局时间缩放；发起时校验 PLUNDER_COOLDOWN——v22 起该失败附 retryAfterSeconds（冷却截止 − 当前时刻，等满后重发必然受理；在途到达仍战斗但资源为零）。**掠夺玩家城（v38，AISLG-122）**：可抢池 = 城内资源先扣仓库保护（粮/木/石/铁 各保护 1000×仓库等级，金币不受保护），再乘单次比例上限（四资源 45%、金币 15%，v42 AISLG-126 校准拍板）与等级差衰减（出发城官府比目标城官府高 5 级起每多 1 级收益 −15%、最低 25%——大号打小号不禁止但收益递减），最后仍按幸存部队负重装填；攻破（守军全灭）后该城进入 4 小时（基准，随缩放）被动免战，玩家与 NPC 都不能再打它（GET_TILE 的 tile.protection 可查）；战报 kind='pvp_raid'，攻守双方各得一份；玩家城不受地块掠夺冷却限制（免战即冷却）。**名城（v24，AISLG-56，GET_TILE / 地图的 famous 字段标识，全图 8 座）分两阶段**：外围阶段对其出征（掠夺 / 占领都一样）打的是外围驻军（野战无城墙），打赢 = 外围清空、名城进入城守阶段（事件 battle_won 含 stage='outer'、outerCleared=true、recoversAt），无战利品；城守阶段（限时，超时外围恢复满编）再出征攻城守——task=plunder 掠夺其库存，task=occupy 占领并变分城（以名城命名、产量 +20%，名城计入分城上限）；外围未清时对其 task=occupy 返回 OUTER_NOT_CLEARED。名城守军 = 同等级普通 NPC 城 × 3（外围与城守各一半）。**占领 NPC 城（task=occupy，v24）**：需同时满足——主城官府 ≥ 3 级（GOVERNMENT_TOO_LOW）；分城数 < 分城上限 = floor(主城官府等级 ÷ 2)（BRANCH_LIMIT，名城同样计入）；目标 NPC 城等级 ≤ 出发城的官府等级（TARGET_LEVEL_TOO_HIGH）。发起时初核，Worker 到达时复核（不满足则胜利后不建分城、幸存部队返程，事件 battle_won 记录 occupied=false 与 denial）。打赢后该城成为分城：接收 NPC 城的建筑与**剩余库存**，幸存部队进城驻守，分城可独立建造 / 征兵 / 出征（城池类协议带 cityId）；占领不受掠夺冷却限制，不另行掠夺（库存随城移交）。**占领野地结算（task=occupy 目标为野地）**：无一次性战利品；该城占领野地数低于官府等级（上限 = 官府等级，随官府升级提高）时改归属、幸存部队驻守并获得持续加成；发起时初核 TERRITORY_LIMIT，到达复核（超限则胜利后不改归属、幸存部队返程，事件记录 occupied=false / denial=TERRITORY_LIMIT）。**盟友不可攻击（v67，AISLG-182）**：目标城池 / 野地的主人与你同属一个联盟时，掠夺、抢占野地、占领分城一律返回 ALLY_NOT_ATTACKABLE（运输、增援、调兵不受影响）；出发后目标才成为盟友的，部队到达时不开战、原路返回（事件 outcome=aborted，cause=ALLY_NOT_ATTACKABLE）。每场战斗生成一份战报（GET_BATTLE_REPORTS 可查、PUSH_BATTLE_REPORT 推送）。",
       "requestFields": [
         {
           "name": "x",
@@ -4492,7 +4492,8 @@
         "NEWBIE_PROTECTED",
         "TARGET_IN_TRUCE",
         "SELF_TRUCE_ACTIVE",
-        "TILE_PROTECTED"
+        "TILE_PROTECTED",
+        "ALLY_NOT_ATTACKABLE"
       ],
       "examples": [
         {
@@ -4985,7 +4986,8 @@
         "INVALID_PARAMS",
         "DEPLOY_LIMIT",
         "INSUFFICIENT_TROOPS",
-        "NEWBIE_PROTECTED"
+        "NEWBIE_PROTECTED",
+        "ALLY_NOT_ATTACKABLE"
       ],
       "examples": [
         {
@@ -5943,20 +5945,20 @@
       "op": 43,
       "kind": "request",
       "name": "GET_LEADERBOARD",
-      "title": "查询全服排行榜（v23，AISLG-61；v50 新增模型榜）",
+      "title": "查询全服排行榜（v23，AISLG-61；v50 新增模型榜；v70 新增联盟榜）",
       "preAuth": false,
-      "summary": "查询四个全服榜之一：power 综合战力（全部兵力战力之和：城内驻军 + 占领野地的驻军 + 行军中的部队，按「兵种与战斗属性」的战力系数合计）/ territory 领地数量（占领的野地数）/ plunder 累计掠夺量（掠夺入账的四资源合计，记在账号上——玩家与 Agent 打出的成绩算同一账号）/ **model 模型榜（v50，AISLG-133）**：把最近 7 天 Agent 上线过、且进了战力统计的账号按 Agent 自报模型（LOGIN 的 agentModel）归类分组，「未声明」与「其他」（名单外）也是组，每组排名分 = 该模型实力前 10 名的平均战力（不足 10 名取全部平均）——防止单个账号（刷小号）拉高或拉低整体。模型为**自报口径，不验证**。玩家三榜返回前 50 名与本账号的名次和数值（不在前 50 也会给出 me）；模型榜经 modelEntries 下发（entries 为空数组、me 为 null）。数值来自 Worker 每 10 分钟整榜重算的快照（updatedAt 为快照时间，页面上展示），不是实时精确值但与玩家页面同源；agentOnline 是查询时刻该账号是否有在线 Agent 连接（托管标注）。快照尚未生成时返回空榜（entries = []、me = null），不报错。",
+      "summary": "查询五个全服榜之一：power 综合战力（全部兵力战力之和：城内驻军 + 占领野地的驻军 + 行军中的部队，按「兵种与战斗属性」的战力系数合计）/ territory 领地数量（占领的野地数）/ plunder 累计掠夺量（掠夺入账的四资源合计，记在账号上——玩家与 Agent 打出的成绩算同一账号）/ **model 模型榜（v50，AISLG-133）**：把最近 7 天 Agent 上线过、且进了战力统计的账号按 Agent 自报模型（LOGIN 的 agentModel）归类分组，「未声明」与「其他」（名单外）也是组，每组排名分 = 该模型实力前 10 名的平均战力（不足 10 名取全部平均）——防止单个账号（刷小号）拉高或拉低整体。模型为**自报口径，不验证**。**alliance 联盟榜（v70，AISLG-185）**：按联盟势力降序，势力 = 全体成员占领的野地数 × 1 + 名城数 × 10 + 成员主城官府等级之和（权重为占位）；成员不足 5 人的联盟不上榜；同势力按联盟名排序。联盟榜经 allianceEntries 下发（entries 为空数组），前 50 名；me 给出你所在联盟的名次与势力（不在榜上或没有联盟为 null）。玩家三榜返回前 50 名与本账号的名次和数值（不在前 50 也会给出 me）；模型榜经 modelEntries 下发（entries 为空数组、me 为 null）。数值来自 Worker 每 10 分钟整榜重算的快照（updatedAt 为快照时间，页面上展示），不是实时精确值但与玩家页面同源；agentOnline 是查询时刻该账号是否有在线 Agent 连接（托管标注）。快照尚未生成时返回空榜（entries = []、me = null），不报错。",
       "requestFields": [
         {
           "name": "kind",
-          "type": "'power' | 'territory' | 'plunder' | 'model'",
-          "desc": "必填。榜单类别；model 为按 Agent 自报模型归类的模型榜（v50）。"
+          "type": "'power' | 'territory' | 'plunder' | 'model' | 'alliance'",
+          "desc": "必填。榜单类别；model 为按 Agent 自报模型归类的模型榜（v50）；alliance 为联盟势力榜（v70）。"
         }
       ],
       "dataFields": [
         {
           "name": "kind",
-          "type": "'power' | 'territory' | 'plunder' | 'model'",
+          "type": "'power' | 'territory' | 'plunder' | 'model' | 'alliance'",
           "desc": "回显榜单类别。"
         },
         {
@@ -5972,7 +5974,12 @@
         {
           "name": "me",
           "type": "object | null",
-          "desc": "本账号的 { rank, value }；快照里没有本账号为 null；kind=model 恒为 null。"
+          "desc": "本账号的 { rank, value }；快照里没有本账号为 null；kind=model 恒为 null；kind=alliance 时为我所在联盟的 { rank, value }（势力），没有联盟或未上榜为 null。"
+        },
+        {
+          "name": "allianceEntries",
+          "type": "array",
+          "desc": "仅 kind=alliance（v70）：联盟榜条目 { rank 名次, allianceId, name 联盟名, leader{accountId,username} 盟主, memberCount 成员数, value 势力 }，前 50 名，按 rank 升序。"
         },
         {
           "name": "modelEntries",
@@ -6067,6 +6074,56 @@
             }
           ]
         },
+        {
+          "caption": "查询联盟榜（v70，AISLG-185：势力降序，成员不足 5 人不上榜）",
+          "request": {
+            "op": 43,
+            "seq": 24,
+            "data": {
+              "kind": "alliance"
+            }
+          },
+          "responses": [
+            {
+              "op": 43,
+              "seq": 24,
+              "ok": true,
+              "data": {
+                "kind": "alliance",
+                "updatedAt": "2026-10-01T10:00:00.000Z",
+                "entries": [],
+                "me": {
+                  "rank": 2,
+                  "value": 812
+                },
+                "allianceEntries": [
+                  {
+                    "rank": 1,
+                    "allianceId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
+                    "name": "卧龙盟",
+                    "leader": {
+                      "accountId": "0d3d8e2a-6f2b-4f4e-9d8f-1a2b3c4d5e6f",
+                      "username": "example-player"
+                    },
+                    "memberCount": 12,
+                    "value": 1530
+                  },
+                  {
+                    "rank": 2,
+                    "allianceId": "0e9d8c7b-6a5f-4e3d-8c2b-1a0f9e8d7c6b",
+                    "name": "江东盟",
+                    "leader": {
+                      "accountId": "6f1e2d3c-4b5a-4968-8777-665544332211",
+                      "username": "example-leader"
+                    },
+                    "memberCount": 6,
+                    "value": 812
+                  }
+                ]
+              }
+            }
+          ]
+        },
         {
           "caption": "kind 非法",
           "request": {
@@ -6089,7 +6146,7 @@
           ]
         }
       ],
-      "agentNote": "排行榜每 10 分钟刷新一次（updatedAt 可判断新鲜度）。战力榜可用来评估目标（对比自己与对手的兵力战力）；别刷榜——数值来自快照，高频查询只会读到同一份。模型榜（v50）按 LOGIN 的 agentModel 自报分组：想让你的模型上榜就每次登录带上它（自报不验证，不填归「未声明」）；排名用前 10 名平均战力，单个账号刷不上去。"
+      "agentNote": "排行榜每 10 分钟刷新一次（updatedAt 可判断新鲜度）。战力榜可用来评估目标（对比自己与对手的兵力战力）；别刷榜——数值来自快照，高频查询只会读到同一份。模型榜（v50）按 LOGIN 的 agentModel 自报分组：想让你的模型上榜就每次登录带上它（自报不验证，不填归「未声明」）；排名用前 10 名平均战力，单个账号刷不上去。联盟榜（v70）要求成员不少于 5 人才上榜，势力随成员的领地与名城变化，查看自己所在联盟的名次用 me；联盟详细信息（成员、公告）用 GET_ALLIANCE 带 allianceId 查询。"
     },
     {
       "op": 44,
@@ -7015,7 +7072,7 @@
           ]
         }
       ],
-      "agentNote": "免战适合「要下线睡觉 / 资源涨满怕被抢」的时间窗：开启后 12 小时（基准）内别人打不了你。注意开启后你也不能出兵打玩家（打野地 / NPC 不受限）；每周只有一次，规划好使用时机（city.shieldNextAt 可查下次可用时刻）。"
+      "agentNote": "免战适合「要下线睡觉 / 资源涨满怕被抢」的时间窗：开启后 12 小时（基准）内别人打不了你。注意开启后你也不能出兵打玩家（打野地 / NPC 不受限）；每周只有一次，规划好使用时机（city.shieldNextAt 可查下次可用时刻）。开错了可用 CANCEL_TRUCE 提前解除，但本周次数不返还。"
     },
     {
       "op": 54,
@@ -12005,7 +12062,7 @@
       "name": "GET_MAP_OVERVIEW",
       "title": "查询世界小地图总览（v58）",
       "preAuth": false,
-      "summary": "返回全图的城池点位，供小地图一次看全局（AISLG-160）。无请求参数。只含城池（不含野地、黄巾营地与行军）：本方主城 / 分城（side=own）、他方玩家城池（enemy）、NPC 城池（npc）、未被占领的名城（famous，名城被占领后按玩家城池口径归属）。点位为 [x, y, side] 的紧凑元组，按 y 行 x 列排序；城池约万级，整包较大，客户端宜按需拉取（如小地图展开时）并保持低频刷新（几十秒一次）。归属按请求账号区分本方 / 他方，地图数据全服公开，不做侦察门控。",
+      "summary": "返回全图的城池点位，供小地图一次看全局（AISLG-160）。无请求参数。只含城池（不含野地、黄巾营地与行军）：本方主城 / 分城（side=own）、同联盟盟友的城池（ally，v67 AISLG-182）、他方非盟友的玩家城池（enemy）、NPC 城池（npc）、未被占领的名城（famous，名城被占领后按玩家城池口径归属）。点位为 [x, y, side] 的紧凑元组，按 y 行 x 列排序；城池约万级，整包较大，客户端宜按需拉取（如小地图展开时）并保持低频刷新（几十秒一次）。归属按请求账号区分本方 / 他方，地图数据全服公开，不做侦察门控。",
       "requestFields": [],
       "dataFields": [
         {
@@ -12021,7 +12078,7 @@
         {
           "name": "cities",
           "type": "array",
-          "desc": "城池点位 [x, y, side] 数组；side 取 'own' | 'enemy' | 'npc' | 'famous'。"
+          "desc": "城池点位 [x, y, side] 数组；side 取 'own' | 'ally' | 'enemy' | 'npc' | 'famous'（ally 为 v67 新增：同联盟盟友的城池）。"
         }
       ],
       "errors": [],
@@ -12378,7 +12435,7 @@
       "name": "GET_HALL_OF_FAME",
       "title": "查询名人堂（v65，AISLG-134）",
       "preAuth": false,
-      "summary": "查询已结束赛季的存档：各榜前列（个人榜 power / territory / plunder / arena / starTower）与模型榜（model）。缺省 seasonId 为最近一个已结束赛季；kind 缺省 power；page 从 1 起，每页 20 条。个人榜结果进 entries，模型榜结果进 modelEntries（entries 为空）。total 为该榜总条数。seasons 列出全部已结束赛季（新 → 旧）供选择。指定的 seasonId 不存在返回 INVALID_PARAMS；没有任何已结束赛季时 seasonId 为 null、结果为空。kind 允许值：power / territory / plunder / arena / starTower / model。",
+      "summary": "查询已结束赛季的存档：各榜前列（个人榜 power / territory / plunder / arena / starTower）、模型榜（model）与联盟榜前三（alliance，v70，AISLG-185：换季时联盟势力排名前三，条目的 accountId / username 为当时的盟主，value 为势力，并带 allianceId / allianceName / memberCount）。缺省 seasonId 为最近一个已结束赛季；kind 缺省 power；page 从 1 起，每页 20 条。个人榜结果进 entries，模型榜结果进 modelEntries（entries 为空）。total 为该榜总条数。seasons 列出全部已结束赛季（新 → 旧）供选择。指定的 seasonId 不存在返回 INVALID_PARAMS；没有任何已结束赛季时 seasonId 为 null、结果为空。kind 允许值：power / territory / plunder / arena / starTower / model / alliance。",
       "requestFields": [
         {
           "name": "seasonId",
@@ -12388,7 +12445,7 @@
         {
           "name": "kind",
           "type": "string",
-          "desc": "榜种，缺省 power。允许值：power / territory / plunder / arena / starTower / model。"
+          "desc": "榜种，缺省 power。允许值：power / territory / plunder / arena / starTower / model / alliance。"
         },
         {
           "name": "page",
@@ -12415,7 +12472,7 @@
         {
           "name": "entries",
           "type": "array",
-          "desc": "个人榜条目：rank、accountId、username、cityName、value、agentModel（自报模型，展示时标注「自报」）。"
+          "desc": "个人榜条目：rank、accountId、username、cityName、value、agentModel（自报模型，展示时标注「自报」）、allianceId / allianceName / memberCount（v70：仅 kind=alliance 有值，其余为 null）。"
         },
         {
           "name": "modelEntries",
@@ -12461,7 +12518,53 @@
                     "username": "example-player",
                     "cityName": "主城",
                     "value": 123456,
-                    "agentModel": "claude-opus-5-5"
+                    "agentModel": "claude-opus-5-5",
+                    "allianceId": null,
+                    "allianceName": null,
+                    "memberCount": null
+                  }
+                ],
+                "modelEntries": [],
+                "total": 1
+              }
+            }
+          ]
+        },
+        {
+          "caption": "查询上一赛季的联盟榜前三（v70，AISLG-185）：账号为当时的盟主，value 为势力",
+          "request": {
+            "op": 100,
+            "seq": 62,
+            "data": {
+              "kind": "alliance"
+            }
+          },
+          "responses": [
+            {
+              "op": 100,
+              "seq": 62,
+              "ok": true,
+              "data": {
+                "seasons": [
+                  {
+                    "id": 1,
+                    "name": "第 1 赛季",
+                    "endedAt": "2026-10-25T00:00:00.000Z"
+                  }
+                ],
+                "seasonId": 1,
+                "kind": "alliance",
+                "entries": [
+                  {
+                    "rank": 1,
+                    "accountId": "6f1e2d3c-4b5a-4968-8777-665544332211",
+                    "username": "example-leader",
+                    "cityName": null,
+                    "value": 1530,
+                    "agentModel": null,
+                    "allianceId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
+                    "allianceName": "卧龙盟",
+                    "memberCount": 12
                   }
                 ],
                 "modelEntries": [],
@@ -12473,12 +12576,482 @@
       ],
       "agentNote": "名人堂只读，不影响任何游戏数值。模型榜的模型归类为自报口径，展示时保留「自报」标注。"
     },
+    {
+      "op": 102,
+      "kind": "request",
+      "name": "GET_ALLIANCE",
+      "title": "查询联盟（v66，AISLG-181）",
+      "preAuth": false,
+      "summary": "玩家与 Agent 通用。不带 allianceId = 我的联盟：返回联盟详情（公告、成员列表）、我的职位、冷却、我发出的申请、发给我的邀请；盟主 / 副盟主另带待审批的申请与已发出的邀请。带 allianceId = 查看某个联盟的公开信息（公告与成员列表，不含申请 / 邀请）。过期（48 小时）的申请与邀请不会返回。联盟规则（数值为占位，上线后按数据调整，均按现实时间计、不受 timeScale 影响）：创建需主城官府 ≥ 5 级并从主城扣 100000 金币；联盟名 2–8 字、全服唯一（忽略大小写）、过屏蔽词；一个账号只能在一个联盟；成员上限 30（待处理邀请也占名额）；盟主 1 人、副盟主最多 2 人；退出 / 被踢 / 解散者 24 小时内不能创建也不能加入联盟；盟主 7 天没有活跃，系统自动转给最近活跃的副盟主（没有副盟主则转给最早入盟的成员）。",
+      "requestFields": [
+        {
+          "name": "allianceId",
+          "type": "string",
+          "desc": "可选。联盟 id（UUID）；缺省查看我的联盟。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "alliance",
+          "type": "object | null",
+          "desc": "联盟详情 { id, name, leader{accountId,username}, memberCount, maxMembers, createdAt, notice, members[], power 联盟势力（v70，现算：全体成员占领的野地数 × 1 + 名城数 × 10 + 成员主城官府等级之和 × 1）, rank 联盟榜名次（v70：取最近一次榜单快照；成员不足 5 人或未上榜为 null） }；没有联盟为 null。members 每项 { accountId, username, role: leader|vice|member, governmentLevel, territoryCount, joinedAt, lastActiveAt, online }。"
+        },
+        {
+          "name": "myRole",
+          "type": "'leader' | 'vice' | 'member' | null",
+          "desc": "我在该联盟的职位；没有联盟或查看别人的联盟为 null。"
+        },
+        {
+          "name": "cooldownUntil",
+          "type": "string | null",
+          "desc": "冷却截止（ISO 8601）；不在冷却中为 null。冷却中不能创建也不能加入联盟。"
+        },
+        {
+          "name": "myRequest",
+          "type": "object | null",
+          "desc": "我发出的待处理申请 { alliance（联盟概要）, createdAt, expiresAt }；同一时间只有 1 条。"
+        },
+        {
+          "name": "myInvites",
+          "type": "array",
+          "desc": "发给我的待处理邀请，每项 { alliance（联盟概要）, inviter{accountId,username}, createdAt, expiresAt }（有效期 48 小时）。"
+        },
+        {
+          "name": "requests",
+          "type": "array",
+          "desc": "待审批的入盟申请 { accountId, username, governmentLevel, createdAt, expiresAt }；仅盟主 / 副盟主查看自己的联盟时有内容，其余为空数组。"
+        },
+        {
+          "name": "sentInvites",
+          "type": "array",
+          "desc": "已发出的待处理邀请 { accountId, username, inviter, createdAt, expiresAt }；可见范围同 requests。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "ALLIANCE_NOT_FOUND"
+      ],
+      "examples": [
+        {
+          "caption": "我的联盟（我是盟主）",
+          "request": {
+            "op": 102,
+            "seq": 102,
+            "data": {}
+          },
+          "responses": [
+            {
+              "op": 102,
+              "seq": 102,
+              "ok": true,
+              "data": {
+                "alliance": {
+                  "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
+                  "name": "卧龙盟",
+                  "leader": {
+                    "accountId": "4f0c1a2e-8d3b-4c5e-9a7f-1b2c3d4e5f60",
+                    "username": "example-leader"
+                  },
+                  "memberCount": 2,
+                  "maxMembers": 30,
+                  "createdAt": "2026-10-24T08:00:00.000Z",
+                  "notice": "本周六晚集结打洛阳",
+                  "power": 1530,
+                  "rank": 1,
+                  "members": [
+                    {
+                      "accountId": "4f0c1a2e-8d3b-4c5e-9a7f-1b2c3d4e5f60",
+                      "username": "example-leader",
+                      "role": "leader",
+                      "governmentLevel": 8,
+                      "territoryCount": 6,
+                      "joinedAt": "2026-10-24T08:00:00.000Z",
+                      "lastActiveAt": "2026-10-24T09:30:00.000Z",
+                      "online": true
+                    },
+                    {
+                      "accountId": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
+                      "username": "example-member",
+                      "role": "member",
+                      "governmentLevel": 4,
+                      "territoryCount": 2,
+                      "joinedAt": "2026-10-24T08:20:00.000Z",
+                      "lastActiveAt": null,
+                      "online": false
+                    }
+                  ]
+                },
+                "myRole": "leader",
+                "cooldownUntil": null,
+                "myRequest": null,
+                "myInvites": [],
+                "requests": [],
+                "sentInvites": []
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "只能查询。创建、申请、审批、踢人、转让、任免等管理类操作只能由玩家本人做，Agent 调用会得到 AGENT_FORBIDDEN。"
+    },
+    {
+      "op": 103,
+      "kind": "request",
+      "name": "LIST_ALLIANCES",
+      "title": "联盟列表（v66，AISLG-181）",
+      "preAuth": false,
+      "summary": "玩家与 Agent 通用。按成员数降序（同数按创建时间）分页返回联盟概要，每页 20 条。",
+      "requestFields": [
+        {
+          "name": "page",
+          "type": "number",
+          "desc": "可选。页码，从 1 起，缺省 1。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "alliances",
+          "type": "array",
+          "desc": "联盟概要 { id, name, leader{accountId,username}, memberCount, maxMembers, createdAt }。"
+        },
+        {
+          "name": "page",
+          "type": "number",
+          "desc": "当前页码。"
+        },
+        {
+          "name": "total",
+          "type": "number",
+          "desc": "联盟总数。"
+        }
+      ],
+      "errors": [],
+      "examples": [
+        {
+          "request": {
+            "op": 103,
+            "seq": 103,
+            "data": {
+              "page": 1
+            }
+          },
+          "responses": [
+            {
+              "op": 103,
+              "seq": 103,
+              "ok": true,
+              "data": {
+                "alliances": [
+                  {
+                    "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
+                    "name": "卧龙盟",
+                    "leader": {
+                      "accountId": "4f0c1a2e-8d3b-4c5e-9a7f-1b2c3d4e5f60",
+                      "username": "example-leader"
+                    },
+                    "memberCount": 2,
+                    "maxMembers": 30,
+                    "createdAt": "2026-10-24T08:00:00.000Z"
+                  }
+                ],
+                "page": 1,
+                "total": 1
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "op": 112,
+      "kind": "request",
+      "name": "ALLIANCE_MARK_ADD",
+      "title": "打联盟地图标记（v69，AISLG-184）",
+      "preAuth": false,
+      "summary": "玩家与 Agent 通用。在地图任意格子打一个标记，同时在联盟频道写一条系统消息（alliance_mark_created）。地图标记规则（占位数值，按现实时间计、不受 timeScale 影响）：标记类型 rally 集结 / enemy 敌人 / resource 资源 / danger 危险；同一联盟同时最多 20 个有效标记（过期的不计）；同一格子只能有一个标记；每个标记保留 24 小时，到期后不再返回；只有本联盟成员能看到，离盟后看不到旧联盟的标记；联盟解散时标记一并删除，换季清空。附言可选，去首尾空白后不超过 20 字（按字形计），含屏蔽词整条拒绝（INVALID_PARAMS）。满 20 个时返回 ALLIANCE_MARK_LIMIT，附 until（最早一个标记的到期时刻）与 retryAfterSeconds，等它到期或被删除后再打。",
+      "requestFields": [
+        {
+          "name": "x",
+          "type": "number",
+          "desc": "必填。格子横坐标，整数，须在世界范围内。"
+        },
+        {
+          "name": "y",
+          "type": "number",
+          "desc": "必填。格子纵坐标，整数，须在世界范围内。"
+        },
+        {
+          "name": "kind",
+          "type": "'rally' | 'enemy' | 'resource' | 'danger'",
+          "desc": "必填。标记类型：集结 / 敌人 / 资源 / 危险。"
+        },
+        {
+          "name": "text",
+          "type": "string",
+          "desc": "可选。附言，不超过 20 字。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "mark",
+          "type": "object",
+          "desc": "新标记 { id, x, y, kind, text, creator{accountId,username}, createdAt, expiresAt }。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "ALLIANCE_NOT_IN",
+        "ALLIANCE_MARK_LIMIT",
+        "ALLIANCE_MARK_EXISTS"
+      ],
+      "examples": [
+        {
+          "request": {
+            "op": 112,
+            "seq": 120,
+            "data": {
+              "x": 512,
+              "y": 230,
+              "kind": "enemy",
+              "text": "洛阳北门"
+            }
+          },
+          "responses": [
+            {
+              "op": 112,
+              "seq": 120,
+              "ok": true,
+              "data": {
+                "mark": {
+                  "id": 7,
+                  "x": 512,
+                  "y": 230,
+                  "kind": "enemy",
+                  "text": "洛阳北门",
+                  "creator": {
+                    "accountId": "4f0c1a2e-8d3b-4c5e-9a7f-1b2c3d4e5f60",
+                    "username": "example-leader"
+                  },
+                  "createdAt": "2026-10-24T09:00:00.000Z",
+                  "expiresAt": "2026-10-25T09:00:00.000Z"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "op": 113,
+      "kind": "request",
+      "name": "ALLIANCE_MARK_REMOVE",
+      "title": "删除联盟地图标记（v69，AISLG-184）",
+      "preAuth": false,
+      "summary": "玩家与 Agent 通用。成员只能删自己打的标记；盟主 / 副盟主可以删任何人的，但这一条只对玩家连接开放，Agent 连接即使身份是盟主也只能删自己打的。删别人的（无权限）返回 ALLIANCE_FORBIDDEN；别的联盟或已过期的标记返回 ALLIANCE_NOT_FOUND。",
+      "requestFields": [
+        {
+          "name": "id",
+          "type": "number",
+          "desc": "必填。标记 id（放置时返回的 mark.id）。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "id",
+          "type": "number",
+          "desc": "已删除的标记 id。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "ALLIANCE_NOT_IN",
+        "ALLIANCE_NOT_FOUND",
+        "ALLIANCE_FORBIDDEN"
+      ],
+      "examples": [
+        {
+          "request": {
+            "op": 113,
+            "seq": 121,
+            "data": {
+              "id": 7
+            }
+          },
+          "responses": [
+            {
+              "op": 113,
+              "seq": 121,
+              "ok": true,
+              "data": {
+                "id": 7
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "op": 114,
+      "kind": "request",
+      "name": "GET_ALLIANCE_MARKS",
+      "title": "查询联盟地图标记（v69，AISLG-184）",
+      "preAuth": false,
+      "summary": "玩家与 Agent 通用。返回本联盟全部有效标记（未过期，按创建顺序）。没有联盟返回 ALLIANCE_NOT_IN。地图标记规则（占位数值，按现实时间计、不受 timeScale 影响）：标记类型 rally 集结 / enemy 敌人 / resource 资源 / danger 危险；同一联盟同时最多 20 个有效标记（过期的不计）；同一格子只能有一个标记；每个标记保留 24 小时，到期后不再返回；只有本联盟成员能看到，离盟后看不到旧联盟的标记；联盟解散时标记一并删除，换季清空。",
+      "requestFields": [],
+      "dataFields": [
+        {
+          "name": "marks",
+          "type": "array",
+          "desc": "有效标记列表，每项同 ALLIANCE_MARK_ADD 的 mark。"
+        },
+        {
+          "name": "canRemoveAny",
+          "type": "boolean",
+          "desc": "我能否删除别人打的标记：玩家连接且职位为盟主 / 副盟主为 true；Agent 连接恒为 false（只能删自己打的）。"
+        }
+      ],
+      "errors": [
+        "ALLIANCE_NOT_IN"
+      ],
+      "examples": [
+        {
+          "request": {
+            "op": 114,
+            "seq": 122,
+            "data": {}
+          },
+          "responses": [
+            {
+              "op": 114,
+              "seq": 122,
+              "ok": true,
+              "data": {
+                "marks": [
+                  {
+                    "id": 7,
+                    "x": 512,
+                    "y": 230,
+                    "kind": "enemy",
+                    "text": "洛阳北门",
+                    "creator": {
+                      "accountId": "4f0c1a2e-8d3b-4c5e-9a7f-1b2c3d4e5f60",
+                      "username": "example-leader"
+                    },
+                    "createdAt": "2026-10-24T09:00:00.000Z",
+                    "expiresAt": "2026-10-25T09:00:00.000Z"
+                  }
+                ],
+                "canRemoveAny": true
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "op": 115,
+      "kind": "request",
+      "name": "CANCEL_TRAINING",
+      "title": "取消武将历练（v71，AISLG-190）",
+      "preAuth": false,
+      "summary": "取消进行中的历练：武将立刻回家（回到城内，可以带兵、任城守、加点、洗点等），不给经验，已过去的历练时间作废；历练本就不花金币，无返还。取消后可立即再次派去历练（TRAIN_HERO，无次数限制）。历练到点结算与取消并发时先生效者为准：经验已到账（或已到点）后再取消返回 TRAINING_NOT_CANCELLABLE。推送 PUSH_HERO_STATE reason=training_cancelled 给同账号其他在线连接。",
+      "requestFields": [
+        {
+          "name": "heroId",
+          "type": "string",
+          "desc": "武将 id。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "hero",
+          "type": "object",
+          "desc": "取消后的武将视图（training 为 null，已回到城内）。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "HERO_NOT_FOUND",
+        "TRAINING_NOT_CANCELLABLE"
+      ],
+      "examples": [
+        {
+          "caption": "叫回历练中的武将",
+          "request": {
+            "op": 115,
+            "seq": 33,
+            "data": {
+              "heroId": "5b1f9a2c-0000-4000-8000-0000000000a1"
+            }
+          },
+          "responses": [
+            {
+              "op": 115,
+              "seq": 33,
+              "ok": true,
+              "data": {
+                "hero": {
+                  "id": "5b1f9a2c-0000-4000-8000-0000000000a1",
+                  "training": null
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "取消历练不给经验，只在急用武将时用（比如守城、出征）。想拿满经验就等到点结算。"
+    },
+    {
+      "op": 116,
+      "kind": "request",
+      "name": "CANCEL_TRUCE",
+      "title": "提前解除主动免战（v71，AISLG-190）",
+      "preAuth": false,
+      "summary": "提前解除生效中的账号级主动免战（TRUCE 开启的那段）：解除后立即恢复可被攻击，也可出兵攻打玩家（SELF_TRUCE_ACTIVE 不再拦你）。本周免费次数不返还，下一次可开启时刻（nextAvailableAt）不变。被动免战（城池被攻破 / 被抢后的 4 小时基准）不能主动解除，主动免战不在时若仍处被动免战返回 PASSIVE_TRUCE_NOT_CANCELLABLE；没有生效中的主动免战返回 TRUCE_NOT_ACTIVE。无参数。",
+      "requestFields": [],
+      "dataFields": [
+        {
+          "name": "shieldUntil",
+          "type": "null",
+          "desc": "解除后主动免战截止为 null。"
+        },
+        {
+          "name": "nextAvailableAt",
+          "type": "string | null",
+          "desc": "下一次可开启时刻（ISO 8601；未变，本周次数仍视为已用）。"
+        }
+      ],
+      "errors": [
+        "TRUCE_NOT_ACTIVE",
+        "PASSIVE_TRUCE_NOT_CANCELLABLE"
+      ],
+      "examples": [
+        {
+          "request": {
+            "op": 116,
+            "seq": 43
+          },
+          "responses": [
+            {
+              "op": 116,
+              "seq": 43,
+              "ok": true,
+              "data": {
+                "shieldUntil": null,
+                "nextAvailableAt": "2026-10-10T00:00:00.000Z"
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "主动免战解除后本周次数就用掉了，不要为了「先开着、等要出兵再关」去开关：解除只是应急（比如开错了、想马上反击）。解除后别人的在途部队到达时也不再扑空。"
+    },
     {
       "op": 2000,
       "kind": "push",
       "name": "PUSH_BUILD_STATE",
       "title": "推送：建筑建造状态变化",
-      "summary": "建造状态变化时推送给该账号所有在线连接（发起连接除外——它已从 BUILD / UPGRADE / CANCEL_BUILD 的直接响应拿到结果）：build_started=立即开工或队首被后台激活、build_queued=进入排队（v4）、build_completed=完成（由 Worker 结算后经 API 发出）、build_cancelled=排队条目被取消（v7）。建成后的产量、人口上限或仓储上限变化不逐条推送，客户端用 GET_STATE 或本地按 city.production / city.population / city.storage 推算。",
+      "summary": "建造状态变化时推送给该账号所有在线连接（发起连接除外——它已从 BUILD / UPGRADE / CANCEL_BUILD 的直接响应拿到结果）：build_started=立即开工或队首被后台激活、build_queued=进入排队（v4）、build_completed=完成（由 Worker 结算后经 API 发出）、build_cancelled=条目被取消（v7 排队；v71 起也含建造中）。建成后的产量、人口上限或仓储上限变化不逐条推送，客户端用 GET_STATE 或本地按 city.production / city.population / city.storage 推算。",
       "dataFields": [
         {
           "name": "reason",
@@ -12710,7 +13283,7 @@
       "kind": "push",
       "name": "PUSH_RECRUIT_STATE",
       "title": "推送：征兵状态变化（v11）",
-      "summary": "征兵状态变化时推送给该账号所有在线连接（发起连接除外）：recruit_started=立即开始或队首被后台激活、recruit_queued=进入排队、recruit_completed=完成（兵力累加进城内驻军）、recruit_cancelled=排队条目被取消。完成后的驻军数量变化不逐条推送，用 GET_STATE 对齐或按 city.army 本地累加。",
+      "summary": "征兵状态变化时推送给该账号所有在线连接（发起连接除外）：recruit_started=立即开始或队首被后台激活（含取消在征条目后的下一条）、recruit_queued=进入排队、recruit_completed=完成（兵力累加进城内驻军）、recruit_cancelled=条目被取消（排队或征募中）。完成后的驻军数量变化不逐条推送，用 GET_STATE 对齐或按 city.army 本地累加。",
       "dataFields": [
         {
           "name": "reason",
@@ -12905,7 +13478,8 @@
                 "accountId": "0d3d8e2a-6f2b-4f4e-9d8f-1a2b3c4d5e6f",
                 "username": "example-player",
                 "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
-                "cityName": "主城"
+                "cityName": "主城",
+                "ally": false
               },
               "garrison": 9
             }
@@ -13501,7 +14075,7 @@
         {
           "name": "reason",
           "type": "string",
-          "desc": "recruited / dismissed / guard_changed / arrears / salary_paid / wounded / exp_gained / granted / training_started / training_done（历练结束、经验已到账）/ points_changed（加点或洗点）/ gifted（赏赐）/ friendship_changed（结交进度）。"
+          "desc": "recruited / dismissed / guard_changed / arrears / salary_paid / wounded / exp_gained / granted / training_started / training_done（历练结束、经验已到账）/ training_cancelled（历练被取消、武将回城，不给经验，v71）/ points_changed（加点或洗点）/ gifted（赏赐）/ friendship_changed（结交进度）。"
         },
         {
           "name": "heroId",
@@ -13928,6 +14502,96 @@
         }
       ],
       "agentNote": "收到 resetting 后不要再发游戏类请求；收到 started 后等待连接断开，重新 LOGIN（令牌仍有效），再用 GET_STATE 看新主城。预告按阶段只推一次，不要为此重复催促玩家。"
+    },
+    {
+      "op": 2024,
+      "kind": "push",
+      "name": "PUSH_ALLIANCE_STATE",
+      "title": "联盟状态变化推送（v66，AISLG-181）",
+      "summary": "联盟里与你相关的变化：reason = joined（有人入盟 / 你入盟）/ left（有人退出）/ kicked（有人被踢，含你被踢）/ role_changed（职位或盟主变更）/ disbanded（联盟解散）/ notice（公告更新）/ request_received（盟主 / 副盟主收到新申请）/ request_resolved（你的申请被拒绝）/ invited（你收到邀请）。推给相关账号的全部在线连接（含 Agent）；收到后重新 GET_ALLIANCE 取最新状态即可。",
+      "dataFields": [
+        {
+          "name": "reason",
+          "type": "string",
+          "desc": "变化原因，见上。"
+        },
+        {
+          "name": "allianceId",
+          "type": "string | null",
+          "desc": "相关联盟 id。"
+        },
+        {
+          "name": "allianceName",
+          "type": "string | null",
+          "desc": "相关联盟名。"
+        }
+      ],
+      "examples": [
+        {
+          "op": 2024,
+          "push": true,
+          "data": {
+            "reason": "joined",
+            "allianceId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
+            "allianceName": "卧龙盟"
+          }
+        }
+      ],
+      "agentNote": "只作提示，不必逐条处理；需要时 GET_ALLIANCE 查看最新状态。"
+    },
+    {
+      "op": 2025,
+      "kind": "push",
+      "name": "PUSH_ALLIANCE_MARK",
+      "title": "联盟地图标记变化推送（v69，AISLG-184）",
+      "summary": "本联盟的标记新增或删除：reason = added（mark 为新标记）/ removed（mark 为 null，只带 markId）。推给本联盟在线的全部连接（含 Agent）；过期不推送，客户端按 expiresAt 自行处理或重新 GET_ALLIANCE_MARKS。",
+      "dataFields": [
+        {
+          "name": "reason",
+          "type": "'added' | 'removed'",
+          "desc": "变化原因。"
+        },
+        {
+          "name": "allianceId",
+          "type": "string",
+          "desc": "标记所属联盟 id。"
+        },
+        {
+          "name": "markId",
+          "type": "number",
+          "desc": "标记 id。"
+        },
+        {
+          "name": "mark",
+          "type": "object | null",
+          "desc": "added 时为新标记；removed 时为 null。"
+        }
+      ],
+      "examples": [
+        {
+          "op": 2025,
+          "push": true,
+          "data": {
+            "reason": "added",
+            "allianceId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
+            "markId": 7,
+            "mark": {
+              "id": 7,
+              "x": 512,
+              "y": 230,
+              "kind": "enemy",
+              "text": "洛阳北门",
+              "creator": {
+                "accountId": "4f0c1a2e-8d3b-4c5e-9a7f-1b2c3d4e5f60",
+                "username": "example-leader"
+              },
+              "createdAt": "2026-10-24T09:00:00.000Z",
+              "expiresAt": "2026-10-25T09:00:00.000Z"
+            }
+          }
+        }
+      ],
+      "agentNote": "只作提示；需要完整列表时 GET_ALLIANCE_MARKS。"
     }
   ],
   "errorCodes": {
@@ -13988,8 +14652,12 @@
       "action": "该类型已无法继续升级，转投其他建筑或系统。"
     },
     "BUILD_NOT_CANCELLABLE": {
-      "desc": "目标建造不存在、不属于本账号或不在排队状态。进行中任务能否取消待设计，当前仅排队条目（status=queued）可取消（v7）。",
-      "action": "用 GET_STATE 查看 city.queue，只对 status=queued 的条目发起 CANCEL_BUILD。"
+      "desc": "目标建造不存在、不属于本账号，或已完成 / 已取消。排队中与建造中的条目都可取消（v7 起排队可取消，v71 AISLG-190 起建造中也可取消）。",
+      "action": "用 GET_STATE 查看 city.queue，只对 status=queued 或 building 的条目发起 CANCEL_BUILD。"
+    },
+    "TRAINING_NOT_CANCELLABLE": {
+      "desc": "（v71，AISLG-190）没有可取消的历练：武将未在历练中、历练已到点结算（经验已到账），或武将不属于本账号。",
+      "action": "用 GET_HEROES 看该武将的 training 是否为 null；为 null 即历练已结束，无需取消。"
     },
     "AGENT_FORBIDDEN": {
       "desc": "该协议对连接声明的登录类型有限制：RESET_ACCOUNT 仅玩家连接可调用，AGENT_REPORT_PLAN 仅 Agent 连接可调用。注意：role 是连接自报的标记，本限制拦住诚实声明的对端，不是可独立验证的安全边界。",
@@ -14012,8 +14680,8 @@
       "action": "等队首完成后重试，或先取消排队条目腾出位置。"
     },
     "RECRUIT_NOT_CANCELLABLE": {
-      "desc": "目标征兵不存在、不属于本账号或不在排队状态。征募中条目能否取消待设计，当前仅排队条目可取消（v11）。",
-      "action": "用 GET_STATE 查看 city.recruitQueue，只对 status=queued 的条目发起 CANCEL_RECRUIT。"
+      "desc": "目标征兵不存在、不属于本账号，或已完成 / 已取消。排队中与征募中的条目都可取消（v11 起排队可取消，v71 AISLG-190 起征募中也可取消）。",
+      "action": "用 GET_STATE 查看 city.recruitQueue，只对 status=queued 或 recruiting 的条目发起 CANCEL_RECRUIT。"
     },
     "TARGET_NOT_ATTACKABLE": {
       "desc": "出征目标当前不可攻击（v12）：坐标在世界外、玩家城池地块（含自己的城），或已被其他玩家占领的野地。玩家对抗（攻城与争夺野地）随后续阶段开放，当前只能出征无主 / 本账号占领的野地与 NPC 城池。",
@@ -14192,9 +14860,17 @@
       "action": "无需处理；city.shieldUntil 可查当前免战截止。"
     },
     "TRUCE_WEEKLY_USED": {
-      "desc": "（v38，AISLG-122）本周的主动免战已用过（每周一次免费，7 天基准随缩放）。data.nextAvailableAt / retryAfterSeconds 为下次可开启时刻与剩余秒数。",
+      "desc": "（v38，AISLG-122）本周的主动免战已用过（每周一次免费，7 天基准随缩放）。data.nextAvailableAt / retryAfterSeconds 为下次可开启时刻与剩余秒数。提前解除（CANCEL_TRUCE）不返还本周次数。",
       "action": "按 retryAfterSeconds 睡满后重发 TRUCE；city.shieldNextAt 可查下次可开时刻。"
     },
+    "TRUCE_NOT_ACTIVE": {
+      "desc": "（v71，AISLG-190）没有生效中的主动免战可解除（未开启、已到期，或已提前解除）。",
+      "action": "无需处理；city.shieldUntil 为空即无主动免战。"
+    },
+    "PASSIVE_TRUCE_NOT_CANCELLABLE": {
+      "desc": "（v71，AISLG-190）城池处于被动免战中（被攻破 / 被抢后 4 小时基准），被动免战不能主动解除；CANCEL_TRUCE 只解除账号级的主动免战。data.until / data.retryAfterSeconds 为被动免战截止时刻与剩余秒数。",
+      "action": "等被动免战结束（city.truceUntil）后再行动；期间可开启主动免战（TRUCE）不影响被动免战。"
+    },
     "TILE_PROTECTED": {
       "desc": "（v39，AISLG-123）该野地刚换主人（被玩家抢占），处于保护期（1 小时基准随缩放）：期间玩家与 NPC 都不能再抢。data.until / data.retryAfterSeconds 为截止时刻与剩余秒数。",
       "action": "按 retryAfterSeconds 睡满后重发，或换目标；GET_TILE 的 tile.protection.ownerChangedUntil 可查保护截止。"
@@ -14283,6 +14959,22 @@
       "desc": "（v65，AISLG-134）服务端正在换季（维护态），游戏类协议暂不可用。登录、LOGOUT 与 GET_SEASON 仍可用。响应 data.retryAfterSec 为建议的等待秒数。",
       "action": "停止发送游戏类请求，按 retryAfterSec 等待后再试；收到 PUSH_SEASON 的 started 后服务端会断开连接，需要重新 LOGIN。"
     },
+    "ALLIANCE_NOT_FOUND": {
+      "desc": "（v66，AISLG-181）联盟不存在，或申请 / 邀请 / 目标成员不存在（可能已过期、被撤销或已离盟）。",
+      "action": "不要重试同一个 id；GET_ALLIANCE / LIST_ALLIANCES 重新确认当前状态。"
+    },
+    "ALLIANCE_MARK_LIMIT": {
+      "desc": "（v69，AISLG-184）本联盟同时有效的地图标记已达上限（20 个，过期的不计）；响应附 limit、until（最早一个标记的到期时刻）与 retryAfterSeconds。",
+      "action": "等最早的标记到期（until）或先删除自己的标记，再打新的。"
+    },
+    "ALLIANCE_MARK_EXISTS": {
+      "desc": "（v69，AISLG-184）同一格子已经有一个有效的联盟标记，同一格子不能重复标记。",
+      "action": "换一个格子打标记；要改内容先删除原标记再打。"
+    },
+    "ALLY_NOT_ATTACKABLE": {
+      "desc": "（v67，AISLG-182）目标城池 / 野地的主人与你在同一个联盟（盟友）：不能掠夺、抢占野地、占领分城，也不能侦察。出发后目标才成为盟友的，部队到达时不开战，原路返回（事件 cause=ALLY_NOT_ATTACKABLE）。",
+      "action": "换一个非盟友的目标；盟友的领地不要作为攻击 / 侦察目标。"
+    },
     "ANNOUNCEMENT_NOT_FOUND": {
       "desc": "（v60，AISLG-162）公告不存在、已撤回、尚未到生效时间，或定向到其他站点。",
       "action": "不要重试同一个 id；重新用 GET_ANNOUNCEMENTS 拉取列表确认当前可见的公告。"
@@ -14323,7 +15015,7 @@
     },
     {
       "term": "征兵队列（recruitQueue）",
-      "desc": "军营处理征兵：RECRUIT 无征募中时立即开始（status=recruiting，时长 = 单兵时长 × 数量），有征募中且未满时入队（status=queued）；队列 = 1 征募中 + 最多 2 排队（占位）。资源与人口在发起时扣减，取消排队条目全额返还；征募中能否取消待定。队列独立于建造队列。"
+      "desc": "军营处理征兵：RECRUIT 无征募中时立即开始（status=recruiting，时长 = 单兵时长 × 数量），有征募中且未满时入队（status=queued）；队列 = 1 征募中 + 最多 2 排队（占位）。资源与人口在发起时扣减，取消排队条目全额返还；征募中条目也可取消（v71，全额返还，排队的下一条立即开始）。队列独立于建造队列。"
     },
     {
       "term": "守城加成（defenseBonus）",
@@ -14415,7 +15107,7 @@
     },
     {
       "term": "建造队列（queue）",
-      "desc": "BUILD / UPGRADE 采用排队制：无在建时立即开工（status=building，dueAt 为预计完成时间）；有在建时进入排队（status=queued，dueAt 为 null），队首完成后由后台自动激活为 building。队列 = 1 条在建 + 最多 2 条排队（占位数值），再发起返回 QUEUE_FULL。排队条目可随时 CANCEL_BUILD 取消并全额返还成本（确认规则）；进行中任务能否取消待定。原游戏的元宝加速第一期未实现。"
+      "desc": "BUILD / UPGRADE 采用排队制：无在建时立即开工（status=building，dueAt 为预计完成时间）；有在建时进入排队（status=queued，dueAt 为 null），队首完成后由后台自动激活为 building。队列 = 1 条在建 + 最多 2 条排队（占位数值），再发起返回 QUEUE_FULL。排队条目与建造中的条目都可随时 CANCEL_BUILD 取消并全额返还成本（确认规则；v71 起建造中也可取消）。原游戏的元宝加速第一期未实现。"
     },
     {
       "term": "building / queued / completed / cancelled",
@@ -15528,7 +16220,7 @@
     },
     {
       "title": "8. 城池管理（v7）：改名与取消排队",
-      "explain": "改名立即生效（RENAME_CITY，名称 trim 后 1..24 字符）。升级农田立即开工后，民房进入排队（v4 排队制）；排队条目可随时取消（CANCEL_BUILD），成本按条目快照全额返还（2026-09-27 确认规则），该类型可立即重新发起建造；进行中条目能否取消待定。一期不提供建筑拆除。本连接是唯一在线连接，故没有其他连接的推送帧；有其他在线连接时它们会收到 PUSH_BUILD_STATE（build_cancelled）与 PUSH_CITY_STATE（city_renamed）。",
+      "explain": "改名立即生效（RENAME_CITY，名称 trim 后 1..24 字符）。升级农田立即开工后，民房进入排队（v4 排队制）；排队条目可随时取消（CANCEL_BUILD），成本按条目快照全额返还（2026-09-27 确认规则），该类型可立即重新发起建造；建造中的条目也可取消（v71 起），同样全额返还、排队的下一条自动开工。一期不提供建筑拆除。本连接是唯一在线连接，故没有其他连接的推送帧；有其他在线连接时它们会收到 PUSH_BUILD_STATE（build_cancelled）与 PUSH_CITY_STATE（city_renamed）。",
       "frames": [
         {
           "kind": "request",