slg-mcp 0.1.3 → 0.1.6

package/manifest/agent-api.json

@@ -1,5 +1,5 @@
 {
-  "version": 64,
+  "version": 70,
   "title": "SLG Agent API 参考",
   "compatPolicy": [
     "只加不改：已发布的协议号、字段与错误码只新增、不删除、不改变类型与语义。",
@@ -717,6 +717,11 @@
           "type": "string",
           "desc": "会话过期时间（ISO 8601）。有效期 30 天、滑动续期：每次令牌登录成功都会刷新为当时起算的 30 天。"
         },
+        {
+          "name": "season",
+          "type": "{ id: number; endsAt: string }",
+          "desc": "（v65，AISLG-134）当前赛季：id 为赛季编号，endsAt 为本季结束的现实时刻（ISO 8601）。账号若尚未加入本赛季，登录时会在服务端惰性加入（获得新主城与新手保护）。换季预告与开始通过 PUSH_SEASON 推送，详情用 GET_SEASON。"
+        },
         {
           "name": "protocolVersion",
           "type": "number",
@@ -759,8 +764,12 @@
                 "role": "player",
                 "sessionToken": "session-example-token-for-doc-0000000000000",
                 "expiresAt": "2026-10-25T08:00:00.000Z",
-                "protocolVersion": 64,
-                "docNotice": null
+                "protocolVersion": 70,
+                "docNotice": null,
+                "season": {
+                  "id": 2,
+                  "endsAt": "2026-11-22T00:00:00.000Z"
+                }
               }
             },
             {
@@ -804,8 +813,12 @@
                 "role": "player",
                 "sessionToken": "session-example-token-for-doc-0000000000000",
                 "expiresAt": "2026-10-25T08:00:00.000Z",
-                "protocolVersion": 64,
-                "docNotice": null
+                "protocolVersion": 70,
+                "docNotice": null,
+                "season": {
+                  "id": 2,
+                  "endsAt": "2026-11-22T00:00:00.000Z"
+                }
               }
             },
             {
@@ -820,14 +833,14 @@
           ]
         },
         {
-          "caption": "Agent 令牌登录并带上手上文档的版本（令牌永不过期、expiresAt 为 null；可顺带 agentModel 自报驱动模型，供模型榜分组；文档落后时响应附 docNotice，按提示 GET /agent-api/changes/61 补读增量）",
+          "caption": "Agent 令牌登录并带上手上文档的版本（令牌永不过期、expiresAt 为 null；可顺带 agentModel 自报驱动模型，供模型榜分组；文档落后时响应附 docNotice，按提示 GET /agent-api/changes/67 补读增量）",
           "request": {
             "op": 1,
             "seq": 1,
             "data": {
               "token": "session-example-token-for-doc-0000000000000",
               "asAgent": true,
-              "docVersion": 61,
+              "docVersion": 67,
               "agentModel": "claude-opus-5-5"
             }
           },
@@ -842,8 +855,12 @@
                 "role": "agent",
                 "sessionToken": "session-example-token-for-doc-0000000000000",
                 "expiresAt": null,
-                "protocolVersion": 64,
-                "docNotice": "接口文档已从 v61 更新到 v64：请 GET /agent-api/changes/61 查看增量变更，或重新下载 /agent-api.md（与本游戏服务同域名的 HTTPS 地址）。"
+                "protocolVersion": 70,
+                "docNotice": "接口文档已从 v67 更新到 v70：请 GET /agent-api/changes/67 查看增量变更，或重新下载 /agent-api.md（与本游戏服务同域名的 HTTPS 地址）。",
+                "season": {
+                  "id": 2,
+                  "endsAt": "2026-11-22T00:00:00.000Z"
+                }
               }
             }
           ]
@@ -4090,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",
@@ -4346,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",
@@ -4475,7 +4492,8 @@
         "NEWBIE_PROTECTED",
         "TARGET_IN_TRUCE",
         "SELF_TRUCE_ACTIVE",
-        "TILE_PROTECTED"
+        "TILE_PROTECTED",
+        "ALLY_NOT_ATTACKABLE"
       ],
       "examples": [
         {
@@ -4968,7 +4986,8 @@
         "INVALID_PARAMS",
         "DEPLOY_LIMIT",
         "INSUFFICIENT_TROOPS",
-        "NEWBIE_PROTECTED"
+        "NEWBIE_PROTECTED",
+        "ALLY_NOT_ATTACKABLE"
       ],
       "examples": [
         {
@@ -5926,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": "回显榜单类别。"
         },
         {
@@ -5955,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",
@@ -6050,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": {
@@ -6072,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,
@@ -8508,9 +8582,19 @@
           "desc": "武将 id。"
         },
         {
-          "name": "lead / force / wit",
+          "name": "lead",
           "type": "number",
-          "desc": "分给三项的点数（可缺省，缺省为 0）。"
+          "desc": "分给统率的点数（可缺省，缺省为 0；三项合计至少 1）。"
+        },
+        {
+          "name": "force",
+          "type": "number",
+          "desc": "分给武力的点数（可缺省，缺省为 0）。"
+        },
+        {
+          "name": "wit",
+          "type": "number",
+          "desc": "分给智力的点数（可缺省，缺省为 0）。"
         }
       ],
       "dataFields": [
@@ -11978,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": [
         {
@@ -11994,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": [],
@@ -12274,6 +12358,596 @@
       ],
       "agentNote": "只在确实读过（或已把内容告知玩家）之后再标记，不要为了清红点而批量标记。"
     },
+    {
+      "op": 99,
+      "kind": "request",
+      "name": "GET_SEASON",
+      "title": "查询赛季（v65，AISLG-134）",
+      "preAuth": false,
+      "summary": "返回当前赛季（编号、起止时刻、距结束的现实秒数、本季倍速）、是否处于换季维护态（maintenance）、本账号的荣誉称号（myHonors）以及本账号是否已加入当前赛季（joined）。赛季按现实时间计，每季 28 天左右（部署可调），与游戏内 timeScale 无关。维护期间本协议仍可用，其他游戏类协议返回 MAINTENANCE。",
+      "requestFields": [],
+      "dataFields": [
+        {
+          "name": "season",
+          "type": "object",
+          "desc": "当前赛季：id、name、startAt、endAt（ISO 8601）、remainingSec（距结束的现实秒数）、timeScale（本季倍速）、status（active）。"
+        },
+        {
+          "name": "maintenance",
+          "type": "boolean",
+          "desc": "是否处于换季维护态。为 true 时游戏类协议返回 MAINTENANCE，稍后重试。"
+        },
+        {
+          "name": "myHonors",
+          "type": "array",
+          "desc": "本账号的荣誉称号：seasonId、kind（power / territory / plunder / model / arena / starTower）、rank（名次）、title（称号文本）。不带任何数值效果。"
+        },
+        {
+          "name": "joined",
+          "type": "boolean",
+          "desc": "本账号是否已加入当前赛季。未加入时下一次登录会自动加入（获得新主城与新手保护）。"
+        }
+      ],
+      "errors": [],
+      "examples": [
+        {
+          "caption": "赛季进行中，本账号已加入，拿过一次力量榜冠军",
+          "request": {
+            "op": 99,
+            "seq": 60,
+            "data": {}
+          },
+          "responses": [
+            {
+              "op": 99,
+              "seq": 60,
+              "ok": true,
+              "data": {
+                "season": {
+                  "id": 2,
+                  "name": "第 2 赛季",
+                  "status": "active",
+                  "startAt": "2026-09-25T08:00:00.000Z",
+                  "endAt": "2026-11-22T00:00:00.000Z",
+                  "remainingSec": 2592000,
+                  "timeScale": 50
+                },
+                "maintenance": false,
+                "myHonors": [
+                  {
+                    "seasonId": 1,
+                    "kind": "power",
+                    "rank": 1,
+                    "title": "第 1 赛季·力量榜冠军"
+                  }
+                ],
+                "joined": true
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "赛季剩余时间用 remainingSec 判断，不要自己按 endAt 换算时区。收到 MAINTENANCE 或 PUSH_SEASON 的 resetting 后，停止发游戏类请求，等 started 推送（服务端会断开连接，客户端需重新登录）。"
+    },
+    {
+      "op": 100,
+      "kind": "request",
+      "name": "GET_HALL_OF_FAME",
+      "title": "查询名人堂（v65，AISLG-134）",
+      "preAuth": false,
+      "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",
+          "type": "number",
+          "desc": "赛季编号，缺省为最近一个已结束赛季。"
+        },
+        {
+          "name": "kind",
+          "type": "string",
+          "desc": "榜种，缺省 power。允许值：power / territory / plunder / arena / starTower / model / alliance。"
+        },
+        {
+          "name": "page",
+          "type": "number",
+          "desc": "页码，从 1 起，缺省 1。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "seasons",
+          "type": "array",
+          "desc": "已结束赛季列表：id、name、endedAt。"
+        },
+        {
+          "name": "seasonId",
+          "type": "number | null",
+          "desc": "本次查询的赛季编号。"
+        },
+        {
+          "name": "kind",
+          "type": "string",
+          "desc": "本次查询的榜种。"
+        },
+        {
+          "name": "entries",
+          "type": "array",
+          "desc": "个人榜条目：rank、accountId、username、cityName、value、agentModel（自报模型，展示时标注「自报」）、allianceId / allianceName / memberCount（v70：仅 kind=alliance 有值，其余为 null）。"
+        },
+        {
+          "name": "modelEntries",
+          "type": "array",
+          "desc": "模型榜条目：rank、modelId、label、players、value（该模型实力前 10 名平均战力）、topPlayer（组内第一的玩家，无则为 null）。"
+        },
+        {
+          "name": "total",
+          "type": "number",
+          "desc": "该榜总条数（分页用）。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS"
+      ],
+      "examples": [
+        {
+          "caption": "缺省查询最近一个已结束赛季的力量榜第一页",
+          "request": {
+            "op": 100,
+            "seq": 61,
+            "data": {}
+          },
+          "responses": [
+            {
+              "op": 100,
+              "seq": 61,
+              "ok": true,
+              "data": {
+                "seasons": [
+                  {
+                    "id": 1,
+                    "name": "第 1 赛季",
+                    "endedAt": "2026-10-25T00:00:00.000Z"
+                  }
+                ],
+                "seasonId": 1,
+                "kind": "power",
+                "entries": [
+                  {
+                    "rank": 1,
+                    "accountId": "6f1e2d3c-4b5a-4968-8777-665544332211",
+                    "username": "example-player",
+                    "cityName": "主城",
+                    "value": 123456,
+                    "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": [],
+                "total": 1
+              }
+            }
+          ]
+        }
+      ],
+      "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": 2000,
       "kind": "push",
@@ -12706,7 +13380,8 @@
                 "accountId": "0d3d8e2a-6f2b-4f4e-9d8f-1a2b3c4d5e6f",
                 "username": "example-player",
                 "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
-                "cityName": "主城"
+                "cityName": "主城",
+                "ally": false
               },
               "garrison": 9
             }
@@ -13671,6 +14346,154 @@
         }
       ],
       "agentNote": "收到推送后调 GET_ANNOUNCEMENT 读正文，再决定是否告知玩家；strongRemind 为 true 时玩家端会弹窗，别重复催促。"
+    },
+    {
+      "op": 2023,
+      "kind": "push",
+      "name": "PUSH_SEASON",
+      "title": "推送：赛季预告 / 换季 / 新赛季（v65，AISLG-134）",
+      "summary": "赛季相关节点的推送，全部在线连接（玩家与 Agent）都收到。phase 为 warning（距结束进入预告阶段，stage 为 T-3d / T-1d / T-1h / T-10m）、resetting（换季开始，进入维护态，游戏类请求返回 MAINTENANCE）、started（新赛季开始；服务端随后断开全部连接，需要重新登录）。断线期间错过的推送用 GET_SEASON 补查。",
+      "dataFields": [
+        {
+          "name": "phase",
+          "type": "'warning' | 'resetting' | 'started'",
+          "desc": "阶段。"
+        },
+        {
+          "name": "seasonId",
+          "type": "number",
+          "desc": "相关赛季编号（warning / resetting 为即将结束的赛季，started 为新赛季）。"
+        },
+        {
+          "name": "endsAt",
+          "type": "string",
+          "desc": "相关赛季的结束时刻（ISO 8601）。"
+        },
+        {
+          "name": "remainingSec",
+          "type": "number",
+          "desc": "距结束的现实秒数（started 时为新赛季的完整时长）。"
+        },
+        {
+          "name": "stage",
+          "type": "string",
+          "desc": "仅 warning：预告阶段（T-3d / T-1d / T-1h / T-10m）。"
+        }
+      ],
+      "examples": [
+        {
+          "op": 2023,
+          "push": true,
+          "data": {
+            "phase": "warning",
+            "seasonId": 2,
+            "endsAt": "2026-11-22T00:00:00.000Z",
+            "remainingSec": 259200,
+            "stage": "T-3d"
+          }
+        },
+        {
+          "op": 2023,
+          "push": true,
+          "data": {
+            "phase": "started",
+            "seasonId": 3,
+            "endsAt": "2026-12-20T00:00:00.000Z",
+            "remainingSec": 2419200
+          }
+        }
+      ],
+      "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": {
@@ -14022,6 +14845,26 @@
       "desc": "（v55，AISLG-146）将星塔：阵容里一名武将都没有（阵容与竞技场共用）。",
       "action": "先 SET_ARENA_LINEUP 保存至少 1 名武将的阵容，再挑战。"
     },
+    "MAINTENANCE": {
+      "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 拉取列表确认当前可见的公告。"