slg-mcp 0.1.7 → 0.1.8

package/manifest/agent-api.json

@@ -1,5 +1,5 @@
 {
-  "version": 71,
+  "version": 80,
   "title": "SLG Agent API 参考",
   "compatPolicy": [
     "只加不改：已发布的协议号、字段与错误码只新增、不删除、不改变类型与语义。",
@@ -317,6 +317,11 @@
           "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
           "name": "主城",
           "level": 1,
+          "title": "城池",
+          "nobility": {
+            "index": 0,
+            "name": "平民"
+          },
           "resources": {
             "gold": 2000,
             "wood": 2000,
@@ -607,6 +612,7 @@
           "durability": null,
           "famousName": null,
           "productionBonusPercent": 0,
+          "luoyangBonusPercent": 0,
           "famousEffect": null,
           "starveAt": null,
           "mutinyNextAt": null,
@@ -622,9 +628,33 @@
             "marching": 0,
             "storage": 0,
             "scouting": 0,
-            "defense": 0
+            "defense": 0,
+            "drill": 0,
+            "combat": 0,
+            "protection": 0,
+            "riding": 0,
+            "archery": 0,
+            "supply": 0,
+            "construction": 0,
+            "research": 0,
+            "looting": 0,
+            "repair": 0
           },
           "recruitQueue": [],
+          "defenses": {
+            "cap": 0,
+            "stock": {
+              "trap": 0,
+              "chevaux": 0,
+              "rolling_log": 0,
+              "boulder": 0
+            },
+            "total": 0,
+            "queue": []
+          },
+          "assistIn": [],
+          "assistOut": [],
+          "assistCap": 5,
           "defenseBonus": 0,
           "marches": [],
           "territory": [],
@@ -764,7 +794,7 @@
                 "role": "player",
                 "sessionToken": "session-example-token-for-doc-0000000000000",
                 "expiresAt": "2026-10-25T08:00:00.000Z",
-                "protocolVersion": 71,
+                "protocolVersion": 80,
                 "docNotice": null,
                 "season": {
                   "id": 2,
@@ -813,7 +843,7 @@
                 "role": "player",
                 "sessionToken": "session-example-token-for-doc-0000000000000",
                 "expiresAt": "2026-10-25T08:00:00.000Z",
-                "protocolVersion": 71,
+                "protocolVersion": 80,
                 "docNotice": null,
                 "season": {
                   "id": 2,
@@ -833,14 +863,14 @@
           ]
         },
         {
-          "caption": "Agent 令牌登录并带上手上文档的版本（令牌永不过期、expiresAt 为 null；可顺带 agentModel 自报驱动模型，供模型榜分组；文档落后时响应附 docNotice，按提示 GET /agent-api/changes/68 补读增量）",
+          "caption": "Agent 令牌登录并带上手上文档的版本（令牌永不过期、expiresAt 为 null；可顺带 agentModel 自报驱动模型，供模型榜分组；文档落后时响应附 docNotice，按提示 GET /agent-api/changes/77 补读增量）",
           "request": {
             "op": 1,
             "seq": 1,
             "data": {
               "token": "session-example-token-for-doc-0000000000000",
               "asAgent": true,
-              "docVersion": 68,
+              "docVersion": 77,
               "agentModel": "claude-opus-5-5"
             }
           },
@@ -855,8 +885,8 @@
                 "role": "agent",
                 "sessionToken": "session-example-token-for-doc-0000000000000",
                 "expiresAt": null,
-                "protocolVersion": 71,
-                "docNotice": "接口文档已从 v68 更新到 v71：请 GET /agent-api/changes/68 查看增量变更，或重新下载 /agent-api.md（与本游戏服务同域名的 HTTPS 地址）。",
+                "protocolVersion": 80,
+                "docNotice": "接口文档已从 v77 更新到 v80：请 GET /agent-api/changes/77 查看增量变更，或重新下载 /agent-api.md（与本游戏服务同域名的 HTTPS 地址）。",
                 "season": {
                   "id": 2,
                   "endsAt": "2026-11-22T00:00:00.000Z"
@@ -972,6 +1002,16 @@
           "type": "number",
           "desc": "城池等级（v7 新增；v24 起 = 该城官府等级 levels.government，不另设升级系统；此前恒为 1）。官府升级，城池等级跟着升。"
         },
+        {
+          "name": "city.title",
+          "type": "string",
+          "desc": "城池称号（v76，AISLG-197）：按官府等级 1–4 城池 / 5–9 县城 / 10–14 郡城 / 15–19 州城 / 20+ 都城；都城只给主城，分城最高州城。无数值加成。"
+        },
+        {
+          "name": "city.nobility",
+          "type": "object",
+          "desc": "账号爵位（v76，AISLG-197）：{ index（0 = 平民，索引见 GET_NOBILITY）, name }。"
+        },
         {
           "name": "city.resources.gold",
           "type": "number",
@@ -1098,7 +1138,7 @@
           "desc": "分城城防值（v40，AISLG-124）：0..100，被「占领」打赢一击 −35（冲车加成最多再 −15）、归零一击换主；免战结束后每小时回涨 10 至满（免战内不回涨）。主城为 null（永不被占领）。"
         },
         {
-          "name": "city.famousName / city.productionBonusPercent",
+          "name": "city.luoyangBonusPercent（v79 洛阳之主联盟 +5%，已计入 production）/ city.famousName / city.productionBonusPercent",
           "type": "string | null / number",
           "desc": "名城分城标记（v24 新增，AISLG-56）：占领名城得到的分城带名城名（famousName）与独占产量加成百分数（productionBonusPercent，当前 20，已计入 production）；普通城为 null / 0。v64（AISLG-168）：占领名城的分城可征募该名城的专属兵（名城 → 兵种对照见 RECRUIT 的 summary），失守即失去征募资格。"
         },
@@ -1117,6 +1157,26 @@
           "type": "array",
           "desc": "征兵队列（v11 新增）：第 1 项为征募中（status=recruiting，dueAt 非空），其余为排队（status=queued，dueAt 为 null）；已取消条目不在其中。"
         },
+        {
+          "name": "city.assistIn",
+          "type": "array",
+          "desc": "（v74，AISLG-194）驻扎在本城的盟友协防部队：{ id, accountId, username, fromCityId, fromCityName, troops（全兵种计数）, arrivedAt, initiator }。城主与盟友可见；外人侦察时只计入守军总数。"
+        },
+        {
+          "name": "city.assistOut",
+          "type": "array",
+          "desc": "（v74）本城派出、正在盟友城里驻扎的协防部队：{ id, hostCityId, hostCityName, hostUsername, troops, arrivedAt }。占校场出征名额，可用 DISMISS_ASSIST 召回。"
+        },
+        {
+          "name": "city.assistCap",
+          "type": "number",
+          "desc": "（v74）本城可接收的协防部队上限（当前 5 支；洛阳 10 支留待洛阳争夺需求）。"
+        },
+        {
+          "name": "city.defenses",
+          "type": "object",
+          "desc": "城防器械（v73，AISLG-193）：{ cap 库存上限（城墙等级 × 60）, stock 四种器械已入库件数（trap / chevaux / rolling_log / boulder，恒含四个键）, total 合计, queue 打造队列（第 1 项 status=crafting、其余 queued；条目结构同 CRAFT_DEFENSE 的 craft） }。守城战开打时按需自动消耗，战报的 defenses 字段给出用量与杀伤。"
+        },
         {
           "name": "city.defenseBonus",
           "type": "number",
@@ -1135,7 +1195,7 @@
         {
           "name": "cities",
           "type": "array",
-          "desc": "v12 新增：账号全部城池 { id, name, level, x, y, isMain }，主城在前；v24 起 level = 各城官府等级。未占领 NPC 城池时只有主城一座。"
+          "desc": "v12 新增：账号全部城池 { id, name, level, x, y, isMain, title 城池称号, nobility 爵位 }，主城在前；v24 起 level = 各城官府等级。未占领 NPC 城池时只有主城一座。"
         },
         {
           "name": "branch",
@@ -1186,6 +1246,11 @@
                   "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                   "name": "主城",
                   "level": 1,
+                  "title": "城池",
+                  "nobility": {
+                    "index": 0,
+                    "name": "平民"
+                  },
                   "resources": {
                     "gold": 2000,
                     "wood": 2000,
@@ -1476,6 +1541,7 @@
                   "durability": null,
                   "famousName": null,
                   "productionBonusPercent": 0,
+                  "luoyangBonusPercent": 0,
                   "famousEffect": null,
                   "starveAt": null,
                   "mutinyNextAt": null,
@@ -1491,9 +1557,33 @@
                     "marching": 0,
                     "storage": 0,
                     "scouting": 0,
-                    "defense": 0
+                    "defense": 0,
+                    "drill": 0,
+                    "combat": 0,
+                    "protection": 0,
+                    "riding": 0,
+                    "archery": 0,
+                    "supply": 0,
+                    "construction": 0,
+                    "research": 0,
+                    "looting": 0,
+                    "repair": 0
                   },
                   "recruitQueue": [],
+                  "defenses": {
+                    "cap": 0,
+                    "stock": {
+                      "trap": 0,
+                      "chevaux": 0,
+                      "rolling_log": 0,
+                      "boulder": 0
+                    },
+                    "total": 0,
+                    "queue": []
+                  },
+                  "assistIn": [],
+                  "assistOut": [],
+                  "assistCap": 5,
                   "defenseBonus": 0,
                   "marches": [],
                   "territory": [],
@@ -1520,6 +1610,11 @@
                   "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                   "name": "主城",
                   "level": 1,
+                  "title": "城池",
+                  "nobility": {
+                    "index": 0,
+                    "name": "平民"
+                  },
                   "resources": {
                     "gold": 1900,
                     "wood": 1950,
@@ -1810,6 +1905,7 @@
                   "durability": null,
                   "famousName": null,
                   "productionBonusPercent": 0,
+                  "luoyangBonusPercent": 0,
                   "famousEffect": null,
                   "starveAt": null,
                   "mutinyNextAt": null,
@@ -1825,9 +1921,33 @@
                     "marching": 0,
                     "storage": 0,
                     "scouting": 0,
-                    "defense": 0
+                    "defense": 0,
+                    "drill": 0,
+                    "combat": 0,
+                    "protection": 0,
+                    "riding": 0,
+                    "archery": 0,
+                    "supply": 0,
+                    "construction": 0,
+                    "research": 0,
+                    "looting": 0,
+                    "repair": 0
                   },
                   "recruitQueue": [],
+                  "defenses": {
+                    "cap": 0,
+                    "stock": {
+                      "trap": 0,
+                      "chevaux": 0,
+                      "rolling_log": 0,
+                      "boulder": 0
+                    },
+                    "total": 0,
+                    "queue": []
+                  },
+                  "assistIn": [],
+                  "assistOut": [],
+                  "assistCap": 5,
                   "defenseBonus": 0,
                   "marches": [],
                   "territory": [],
@@ -1890,6 +2010,11 @@
                   "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                   "name": "主城",
                   "level": 1,
+                  "title": "城池",
+                  "nobility": {
+                    "index": 0,
+                    "name": "平民"
+                  },
                   "resources": {
                     "gold": 1900,
                     "wood": 1950,
@@ -2180,6 +2305,7 @@
                   "durability": null,
                   "famousName": null,
                   "productionBonusPercent": 0,
+                  "luoyangBonusPercent": 0,
                   "famousEffect": null,
                   "starveAt": null,
                   "mutinyNextAt": null,
@@ -2195,9 +2321,33 @@
                     "marching": 0,
                     "storage": 0,
                     "scouting": 0,
-                    "defense": 0
+                    "defense": 0,
+                    "drill": 0,
+                    "combat": 0,
+                    "protection": 0,
+                    "riding": 0,
+                    "archery": 0,
+                    "supply": 0,
+                    "construction": 0,
+                    "research": 0,
+                    "looting": 0,
+                    "repair": 0
                   },
                   "recruitQueue": [],
+                  "defenses": {
+                    "cap": 0,
+                    "stock": {
+                      "trap": 0,
+                      "chevaux": 0,
+                      "rolling_log": 0,
+                      "boulder": 0
+                    },
+                    "total": 0,
+                    "queue": []
+                  },
+                  "assistIn": [],
+                  "assistOut": [],
+                  "assistCap": 5,
                   "defenseBonus": 0,
                   "marches": [],
                   "territory": [],
@@ -3342,6 +3492,11 @@
                   "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                   "name": "主城",
                   "level": 1,
+                  "title": "城池",
+                  "nobility": {
+                    "index": 0,
+                    "name": "平民"
+                  },
                   "resources": {
                     "gold": 2000,
                     "wood": 2000,
@@ -3632,6 +3787,7 @@
                   "durability": null,
                   "famousName": null,
                   "productionBonusPercent": 0,
+                  "luoyangBonusPercent": 0,
                   "famousEffect": null,
                   "starveAt": null,
                   "mutinyNextAt": null,
@@ -3647,9 +3803,33 @@
                     "marching": 0,
                     "storage": 0,
                     "scouting": 0,
-                    "defense": 0
+                    "defense": 0,
+                    "drill": 0,
+                    "combat": 0,
+                    "protection": 0,
+                    "riding": 0,
+                    "archery": 0,
+                    "supply": 0,
+                    "construction": 0,
+                    "research": 0,
+                    "looting": 0,
+                    "repair": 0
                   },
                   "recruitQueue": [],
+                  "defenses": {
+                    "cap": 0,
+                    "stock": {
+                      "trap": 0,
+                      "chevaux": 0,
+                      "rolling_log": 0,
+                      "boulder": 0
+                    },
+                    "total": 0,
+                    "queue": []
+                  },
+                  "assistIn": [],
+                  "assistOut": [],
+                  "assistCap": 5,
                   "defenseBonus": 0,
                   "marches": [],
                   "territory": [],
@@ -4107,7 +4287,7 @@
         {
           "name": "tiles[].owner",
           "type": "object | null",
-          "desc": "占领者（占领野地或城池地块归属的城池）：{ accountId, username, cityId, cityName, ally }；无主为 null。ally（v67，AISLG-182）= 占领者与你同属一个联盟（盟友，自己的地块为 false）：盟友的城池 / 野地不能掠夺、抢占、占领，也不能侦察（返回 ALLY_NOT_ATTACKABLE）。"
+          "desc": "占领者（占领野地或城池地块归属的城池）：{ accountId, username, cityId, cityName, ally, relation }；relation（v77）= self / ally / friendly / hostile / neutral；无主为 null。ally（v67，AISLG-182）= 占领者与你同属一个联盟（盟友，自己的地块为 false）：盟友的城池 / 野地不能掠夺、抢占、占领，也不能侦察（返回 ALLY_NOT_ATTACKABLE）。"
         },
         {
           "name": "tiles[].garrison",
@@ -4263,6 +4443,11 @@
           "type": "string | null",
           "desc": "最近一次侦察该地块的时间（ISO 8601，任意地块类型；v23 起非 NPC 城也返回）；从未侦察为 null。"
         },
+        {
+          "name": "tile.assists",
+          "type": "array | null",
+          "desc": "（v74，AISLG-194）城池的协防部队：{ id, accountId, username, fromCityId, fromCityName, troops（全兵种计数）, arrivedAt, initiator }。自己的城与盟友的城可见；其他人的城为 null（外人侦察只能看到计入守军总数的兵力）。"
+        },
         {
           "name": "tile.durability",
           "type": "number | null",
@@ -4363,7 +4548,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）。**盟友不可攻击（v67，AISLG-182）**：目标城池 / 野地的主人与你同属一个联盟时，掠夺、抢占野地、占领分城一律返回 ALLY_NOT_ATTACKABLE（运输、增援、调兵不受影响）；出发后目标才成为盟友的，部队到达时不开战、原路返回（事件 outcome=aborted，cause=ALLY_NOT_ATTACKABLE）。每场战斗生成一份战报（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）。**协防（v74，AISLG-194）**：task=assist 把部队派进盟友的主城 / 分城驻扎——行军时长与普通行军相同（驿站不加速）；每座城最多接收 5 支、同一账号对同一座城最多 1 支（在途也算，超限 ASSIST_LIMIT），任务占派出城校场名额、耗粮按野外 2 倍由出发城承担；守城战里与城主驻军合并成守方参战（各方科技只作用于各自部队，城守武将只加成城主部队），战后同一兵种伤亡按开战数量比例分摊（取整余数归城主），派出方会收到一份带 assistLosses 的战报；派出方随时可召回、城主可遣返（DISMISS_ASSIST），退盟 / 被踢 / 解散与分城易主时自动遣返。出发后才退盟的，到达按 ASSIST_NOT_ALLY 原路返回。每场战斗生成一份战报（GET_BATTLE_REPORTS 可查、PUSH_BATTLE_REPORT 推送）。",
       "requestFields": [
         {
           "name": "x",
@@ -4382,8 +4567,8 @@
         },
         {
           "name": "task",
-          "type": "'plunder' | 'occupy' | 'transport'",
-          "desc": "可选（v16）。出征任务：plunder=掠夺（缺省）、occupy=占领（野地占领驻守；NPC 城占领变分城，v24）、transport=运输（v26，AISLG-79，目标只能是本账号的另一座城，须同时带 cargo）；plunder / occupy 仅野地与 NPC 城目标接受，非法值返回 INVALID_PARAMS。缺省 plunder 对 v15 及以前不带 task 的客户端是破坏性语义变更（旧式请求从「战斗并占领」变为「掠夺」）。"
+          "type": "'plunder' | 'occupy' | 'transport' | 'assist'",
+          "desc": "可选（v16）。出征任务：plunder=掠夺（缺省）、occupy=占领（野地占领驻守；NPC 城占领变分城，v24）、transport=运输（v26，AISLG-79，目标只能是本账号的另一座城，须同时带 cargo）、assist=协防（v74，AISLG-194，目标只能是盟友的主城 / 分城；到达后驻扎在对方城里，守城时与城主驻军合并参战，随时可召回）。plunder / occupy 仅野地与 NPC 城目标接受，assist 仅盟友城接受（非盟友返回 ASSIST_NOT_ALLY，名额满 / 同账号重复返回 ASSIST_LIMIT），非法值返回 INVALID_PARAMS。缺省 plunder 对 v15 及以前不带 task 的客户端是破坏性语义变更（旧式请求从「战斗并占领」变为「掠夺」）。"
         },
         {
           "name": "targetId",
@@ -5281,8 +5466,13 @@
         },
         {
           "name": "reports[].kind",
-          "type": "'wilderness' | 'npc_city' | 'npc_raid' | 'city_raid' | 'intercept' | 'yellow_turban'",
-          "desc": "战斗类别：野地遭遇战 / NPC 城池攻城战 / NPC 袭击驻军 / NPC 袭击主城（v21，守方为守城战）/ 截击移动目标（v28，AISLG-78，含扑空与目标消失）/ 黄巾营地与老巢（v29，AISLG-76，yellow_turban）。"
+          "type": "'wilderness' | 'npc_city' | 'npc_raid' | 'city_raid' | 'intercept' | 'yellow_turban' | 'battlefield'",
+          "desc": "战斗类别：野地遭遇战 / NPC 城池攻城战 / NPC 袭击驻军 / NPC 袭击主城（v21，守方为守城战）/ 截击移动目标（v28，AISLG-78，含扑空与目标消失）/ 黄巾营地与老巢（v29，AISLG-76，yellow_turban）/ 剧本战场据点（v75，AISLG-198，battlefield）。"
+        },
+        {
+          "name": "reports[].prestigeGained",
+          "type": "number",
+          "desc": "本场获得的声望（v76，AISLG-197）：按歼灭敌军参考战力 1:1；剧本战场按军功 1:1 另计。竞技场 / 将星塔不计，0 / 缺省表示无。"
         },
         {
           "name": "reports[].towerDamage",
@@ -5890,13 +6080,13 @@
         },
         {
           "name": "broadcasts[].type",
-          "type": "'npc_city_emptied' | 'gold_mine_first' | 'city_broken' | 'win_streak' | 'yt_started' | 'yt_grown' | 'yt_boss' | 'yt_boss_first_kill' | 'yt_finished' | 'hero_granted' | 'city_conquered' | 'arena_champion' | 'star_tower_cleared'",
-          "desc": "播报类型（yt_* 为 v29 黄巾之乱：起事 / 坐大 / 老巢出现 / 老巢首杀 / 收场；hero_granted 为 v36 获得名将；city_conquered 为 v40 分城易主；arena_champion 为 v53 竞技场登上第 1 名；star_tower_cleared 为 v55 将星塔 Boss 层首通；以上均必达、不受每分钟 3 条限频）。"
+          "type": "'npc_city_emptied' | 'gold_mine_first' | 'city_broken' | 'win_streak' | 'yt_started' | 'yt_grown' | 'yt_boss' | 'yt_boss_first_kill' | 'yt_finished' | 'hero_granted' | 'city_conquered' | 'arena_champion' | 'star_tower_cleared' | 'battlefield_signup' | 'battlefield_started' | 'battlefield_stronghold' | 'battlefield_finished' | 'nobility_promoted' | 'alliance_diplomacy'",
+          "desc": "播报类型（yt_* 为 v29 黄巾之乱：起事 / 坐大 / 老巢出现 / 老巢首杀 / 收场；hero_granted 为 v36 获得名将；city_conquered 为 v40 分城易主；arena_champion 为 v53 竞技场登上第 1 名；star_tower_cleared 为 v55 将星塔 Boss 层首通；battlefield_* 为 v75 剧本战场报名 / 开战 / 据点易手 / 收场；nobility_promoted 为 v76 升到大夫及以上；alliance_diplomacy 为 v77 结成友盟 / 宣布敌对；以上均必达、不受每分钟 3 条限频）。"
         },
         {
           "name": "broadcasts[].detail",
           "type": "object",
-          "desc": "按类型解释：npc_city_emptied = { username, cityName, x, y, level }；gold_mine_first = { username, cityName, x, y }；city_broken = { username, cityName, x, y }；win_streak = { username, cityName, streak }；yt_started = { totalCamps, endsAt }；yt_grown = { count, tier, label }（count 个营地升到 tier 档）；yt_boss = { x, y }（老巢坐标）；yt_boss_first_kill = { username, cityName }；yt_finished = { reason: boss_cleared|timeout, clearedCamps, totalCamps, scatteredCamps }（人名可能是玩家本人，也可能是其 Agent 打出的成绩——成绩记在账号上）；arena_champion = { username, previous }（username 登上第 1 名，previous 为被取代的原第 1 名，可能是守擂者）；star_tower_cleared = { username, floor }（floor 为刚首通的 Boss 层）。"
+          "desc": "按类型解释：npc_city_emptied = { username, cityName, x, y, level }；gold_mine_first = { username, cityName, x, y }；city_broken = { username, cityName, x, y }；win_streak = { username, cityName, streak }；yt_started = { totalCamps, endsAt }；yt_grown = { count, tier, label }（count 个营地升到 tier 档）；yt_boss = { x, y }（老巢坐标）；yt_boss_first_kill = { username, cityName }；yt_finished = { reason: boss_cleared|timeout, clearedCamps, totalCamps, scatteredCamps }（人名可能是玩家本人，也可能是其 Agent 打出的成绩——成绩记在账号上）；arena_champion = { username, previous }（username 登上第 1 名，previous 为被取代的原第 1 名，可能是守擂者）；star_tower_cleared = { username, floor }（floor 为刚首通的 Boss 层）；battlefield_signup = { eventId, signupStartAt, startAt, endAt }；battlefield_started = { eventId, startAt, endAt }；battlefield_stronghold = { eventId, strongholdId, name, camp, username, firstCapture, reportId }（据点易手，camp 为新归属）；battlefield_finished = { eventId, winner, reason: score|base_captured, scoreYuan, scoreCao }；nobility_promoted = { accountId, username, nobility, name, prestige }；alliance_diplomacy = { kind: friendly|hostile|neutral, actorAlliance, actorAllianceName, otherAlliance, otherAllianceName }。"
         },
         {
           "name": "broadcasts[].createdAt",
@@ -5945,20 +6135,20 @@
       "op": 43,
       "kind": "request",
       "name": "GET_LEADERBOARD",
-      "title": "查询全服排行榜（v23，AISLG-61；v50 新增模型榜；v70 新增联盟榜）",
+      "title": "查询全服排行榜（v23，AISLG-61；v50 新增模型榜；v70 新增联盟榜；v76 新增爵位榜）",
       "preAuth": false,
-      "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），不报错。",
+      "summary": "查询六个全服榜之一：power 综合战力（全部兵力战力之和：城内驻军 + 占领野地的驻军 + 行军中的部队，按「兵种与战斗属性」的战力系数合计）/ territory 领地数量（占领的野地数）/ plunder 累计掠夺量（掠夺入账的四资源合计，记在账号上——玩家与 Agent 打出的成绩算同一账号）/ **model 模型榜（v50，AISLG-133）**：把最近 7 天 Agent 上线过、且进了战力统计的账号按 Agent 自报模型（LOGIN 的 agentModel）归类分组，「未声明」与「其他」（名单外）也是组，每组排名分 = 该模型实力前 10 名的平均战力（不足 10 名取全部平均）——防止单个账号（刷小号）拉高或拉低整体。模型为**自报口径，不验证**。**nobility 爵位榜（v76，AISLG-197）**：按账号累计声望降序（声望只增不减，换季清零；来源见 GET_NOBILITY）。**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' | 'alliance'",
-          "desc": "必填。榜单类别；model 为按 Agent 自报模型归类的模型榜（v50）；alliance 为联盟势力榜（v70）。"
+          "type": "'power' | 'territory' | 'plunder' | 'model' | 'alliance' | 'nobility'",
+          "desc": "必填。榜单类别；model 为按 Agent 自报模型归类的模型榜（v50）；alliance 为联盟势力榜（v70）；nobility 为爵位榜（v76）。"
         }
       ],
       "dataFields": [
         {
           "name": "kind",
-          "type": "'power' | 'territory' | 'plunder' | 'model' | 'alliance'",
+          "type": "'power' | 'territory' | 'plunder' | 'model' | 'alliance' | 'nobility'",
           "desc": "回显榜单类别。"
         },
         {
@@ -5969,12 +6159,12 @@
         {
           "name": "entries",
           "type": "array",
-          "desc": "玩家三榜的前 50 名：{ rank 名次, accountId, username, cityName 主城名, value 数值, agentOnline 该账号是否有在线 Agent 连接, agentModel 该账号 Agent 自报的模型名原文（v50，null = 从未声明；自报不验证） }，按 rank 升序；kind=model 为空数组。"
+          "desc": "玩家三榜的前 50 名：{ rank 名次, accountId, username, cityName 主城名, value 数值, agentOnline 该账号是否有在线 Agent 连接, agentModel 该账号 Agent 自报的模型名原文（v50，null = 从未声明；自报不验证）, nobility 爵位序号与 nobilityName 爵位名（v76） }，按 rank 升序；kind=model 为空数组。"
         },
         {
           "name": "me",
           "type": "object | null",
-          "desc": "本账号的 { rank, value }；快照里没有本账号为 null；kind=model 恒为 null；kind=alliance 时为我所在联盟的 { rank, value }（势力），没有联盟或未上榜为 null。"
+          "desc": "本账号的 { rank, value, nobility, nobilityName }；快照里没有本账号为 null；kind=model 恒为 null；kind=alliance 时为我所在联盟的 { rank, value }（势力），没有联盟或未上榜为 null。"
         },
         {
           "name": "allianceEntries",
@@ -6016,12 +6206,16 @@
                     "cityName": "主城",
                     "value": 3640,
                     "agentOnline": true,
-                    "agentModel": "claude-opus-5-5"
+                    "agentModel": "claude-opus-5-5",
+                    "nobility": 3,
+                    "nobilityName": "大夫"
                   }
                 ],
                 "me": {
                   "rank": 1,
-                  "value": 3640
+                  "value": 3640,
+                  "nobility": 3,
+                  "nobilityName": "大夫"
                 }
               }
             }
@@ -6154,7 +6348,7 @@
       "name": "GET_TECHS",
       "title": "查询科技状态（v27，AISLG-77）",
       "preAuth": false,
-      "summary": "查询账号的科技研究：六项科技（农耕（farming）：粮、木、石、铁产量每级 +5%；负重（carrying）：部队负重每级 +5%（掠夺与运输共用）；行军（marching）：行军速度每级 +5%；储存（storage）：粮、木、石、铁储量上限每级 +5%；侦察（scouting）：侦察报告更详细：Lv3 起看到兵种明细，Lv6 起看到精确数量；城防（defense）：主城守城时城墙减伤每级额外 +1%（加在城墙加成上））各自的当前等级、每级效果、下一级的成本 / 耗时 / 书院门槛，以及进行中的研究。科技是**账号共享**的——全账号所有城都生效，只需在任意一座有书院的城研究；同一时间账号只研究一项。每项最高 10 级，第 N 级要求发起研究的城书院（academy 建筑）≥ N 级。可选 data.cityId（缺省主城）指定用哪座城的书院判定 academyOk。成本 = 基础 × 目标等级；耗时 = 建造基准 × 2 × 目标等级，随全局时间缩放。数值均为占位，上线后按数据调整。",
+      "summary": "查询账号的科技研究：十六项科技（农耕（farming）：粮、木、石、铁产量每级 +5%；负重（carrying）：部队负重每级 +5%（掠夺与运输共用）；行军（marching）：行军速度每级 +5%；储存（storage）：粮、木、石、铁储量上限每级 +5%；侦察（scouting）：侦察报告更详细：Lv3 起看到兵种明细，Lv6 起看到精确数量；城防（defense）：主城守城时城墙减伤每级额外 +1%（加在城墙加成上）；练兵（drill）：征兵时长每级 −3%（10 级 −30%）；战斗（combat）：世界地图战斗中我方全军攻击每级 +1.5%（10 级 +15%）；防护（protection）：世界地图战斗中我方全军受到伤害每级 −1.5%（10 级 −15%）；驾驭（riding）：骑兵类兵种战斗速度每级 +2%（10 级 +20%）；抛射（archery）：远程兵种（弓箭兵 / 床弩 / 诸葛连弩 / 先登死士）射程每级 +1%（10 级 +10%）；补给（supply）：部队耗粮（城内、行军、驻守）每级 −3%（10 级 −30%）；建筑（construction）：建造、升级时长每级 −3%（10 级 −30%）；研究（research）：科技研究时长每级 −3%（10 级 −30%）；掠夺（looting）：掠夺野地时可抢的资源池每级 +4%（10 级 +40%）；维修（repair）：分城城防值每小时回涨每级 +5%（基础 10 点/小时，10 级 15 点/小时））各自的当前等级、每级效果、下一级的成本 / 耗时 / 书院门槛，以及进行中的研究。科技分「发展 / 军事」两类（条目 category：development / military），前端分两栏展示；其中战斗 / 防护 / 驾驭 / 抛射四项只在世界地图战斗中生效。科技是**账号共享**的——全账号所有城都生效，只需在任意一座有书院的城研究；同一时间账号只研究一项。每项最高 10 级，第 N 级要求发起研究的城书院（academy 建筑）≥ N 级。可选 data.cityId（缺省主城）指定用哪座城的书院判定 academyOk。成本 = 基础 × 目标等级；耗时 = 建造基准 × 2 × 目标等级，随全局时间缩放。数值均为占位，上线后按数据调整。",
       "requestFields": [
         {
           "name": "cityId",
@@ -6176,7 +6370,7 @@
         {
           "name": "techs",
           "type": "array",
-          "desc": "六项科技，每项 { kind, label, level 当前等级, maxLevel, percentPerLevel 每级效果百分数（侦察为 0）, effect 效果说明, currentPercent 当前累计加成百分数, next 下一级信息或 null（满级） }。"
+          "desc": "十六项科技（v72 起），每项 { kind, label, category 归类 development / military, level 当前等级, maxLevel, percentPerLevel 每级效果百分数（带符号：负数为减少时长 / 耗粮 / 受伤；侦察为 0）, effect 效果说明, currentPercent 当前累计效果百分数（带符号）, next 下一级信息或 null（满级） }。"
         },
         {
           "name": "techs[].next",
@@ -6211,6 +6405,7 @@
                   {
                     "kind": "farming",
                     "label": "农耕",
+                    "category": "development",
                     "level": 0,
                     "maxLevel": 10,
                     "percentPerLevel": 5,
@@ -6238,7 +6433,7 @@
           ]
         }
       ],
-      "agentNote": "科技规划：书院等级是研究的硬门槛（第 N 级要书院 ≥ N 级），先升书院再研究高级科技。农耕 / 储存直接放大经济，负重 / 行军服务掠夺与出征，侦察决定侦察报告的详细度（Lv3 起兵种明细、Lv6 起精确数量，之前只有总兵力约数——想精确评估野地 / NPC 城守军先点侦察），城防只加主城守城。研究完成会收到 PUSH_TECH_STATE（reason=research_completed）。"
+      "agentNote": "科技规划：书院等级是研究的硬门槛（第 N 级要书院 ≥ N 级），先升书院再研究高级科技。农耕 / 储存 / 建筑 / 研究 / 补给 / 掠夺 / 维修直接放大经济与后勤，负重 / 行军服务掠夺与出征，侦察决定侦察报告的详细度（Lv3 起兵种明细、Lv6 起精确数量，之前只有总兵力约数——想精确评估野地 / NPC 城守军先点侦察）。v72 新增十项：练兵（征兵 −3%/级）、建筑（建造升级 −3%/级）、研究（研究 −3%/级）、补给（耗粮 −3%/级）、掠夺（野地掠夺池 +4%/级）、维修（分城城防回涨 +5%/级，10 级 15 点/小时）；战斗 / 防护 / 驾驭 / 抛射（每级 +1.5% 攻击 / −1.5% 受伤 / +2% 骑兵速度 / +1% 远程射程）只在世界地图战斗生效，竞技场与将星塔不受影响，与武将加成叠两层。研究完成会收到 PUSH_TECH_STATE（reason=research_completed）。"
     },
     {
       "op": 45,
@@ -6250,7 +6445,7 @@
       "requestFields": [
         {
           "name": "tech",
-          "type": "'farming' | 'carrying' | 'marching' | 'storage' | 'scouting' | 'defense'",
+          "type": "'farming' | 'carrying' | 'marching' | 'storage' | 'scouting' | 'defense' | 'drill' | 'combat' | 'protection' | 'riding' | 'archery' | 'supply' | 'construction' | 'research' | 'looting' | 'repair'",
           "desc": "必填。科技类型；缺失或不是已知类型返回 INVALID_PARAMS。"
         },
         {
@@ -9720,6 +9915,11 @@
                   "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                   "name": "主城",
                   "level": 1,
+                  "title": "城池",
+                  "nobility": {
+                    "index": 0,
+                    "name": "平民"
+                  },
                   "resources": {
                     "gold": 2000,
                     "wood": 2000,
@@ -10010,6 +10210,7 @@
                   "durability": null,
                   "famousName": null,
                   "productionBonusPercent": 0,
+                  "luoyangBonusPercent": 0,
                   "famousEffect": null,
                   "starveAt": null,
                   "mutinyNextAt": null,
@@ -10025,9 +10226,33 @@
                     "marching": 0,
                     "storage": 0,
                     "scouting": 0,
-                    "defense": 0
+                    "defense": 0,
+                    "drill": 0,
+                    "combat": 0,
+                    "protection": 0,
+                    "riding": 0,
+                    "archery": 0,
+                    "supply": 0,
+                    "construction": 0,
+                    "research": 0,
+                    "looting": 0,
+                    "repair": 0
                   },
                   "recruitQueue": [],
+                  "defenses": {
+                    "cap": 0,
+                    "stock": {
+                      "trap": 0,
+                      "chevaux": 0,
+                      "rolling_log": 0,
+                      "boulder": 0
+                    },
+                    "total": 0,
+                    "queue": []
+                  },
+                  "assistIn": [],
+                  "assistOut": [],
+                  "assistCap": 5,
                   "defenseBonus": 0,
                   "marches": [],
                   "territory": [],
@@ -10323,6 +10548,11 @@
                   "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                   "name": "主城",
                   "level": 1,
+                  "title": "城池",
+                  "nobility": {
+                    "index": 0,
+                    "name": "平民"
+                  },
                   "resources": {
                     "gold": 2000,
                     "wood": 2000,
@@ -10613,6 +10843,7 @@
                   "durability": null,
                   "famousName": null,
                   "productionBonusPercent": 0,
+                  "luoyangBonusPercent": 0,
                   "famousEffect": null,
                   "starveAt": null,
                   "mutinyNextAt": null,
@@ -10628,9 +10859,33 @@
                     "marching": 0,
                     "storage": 0,
                     "scouting": 0,
-                    "defense": 0
+                    "defense": 0,
+                    "drill": 0,
+                    "combat": 0,
+                    "protection": 0,
+                    "riding": 0,
+                    "archery": 0,
+                    "supply": 0,
+                    "construction": 0,
+                    "research": 0,
+                    "looting": 0,
+                    "repair": 0
                   },
                   "recruitQueue": [],
+                  "defenses": {
+                    "cap": 0,
+                    "stock": {
+                      "trap": 0,
+                      "chevaux": 0,
+                      "rolling_log": 0,
+                      "boulder": 0
+                    },
+                    "total": 0,
+                    "queue": []
+                  },
+                  "assistIn": [],
+                  "assistOut": [],
+                  "assistCap": 5,
                   "defenseBonus": 0,
                   "marches": [],
                   "territory": [],
@@ -11036,6 +11291,11 @@
                   "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                   "name": "主城",
                   "level": 1,
+                  "title": "城池",
+                  "nobility": {
+                    "index": 0,
+                    "name": "平民"
+                  },
                   "resources": {
                     "gold": 2000,
                     "wood": 2000,
@@ -11326,6 +11586,7 @@
                   "durability": null,
                   "famousName": null,
                   "productionBonusPercent": 0,
+                  "luoyangBonusPercent": 0,
                   "famousEffect": null,
                   "starveAt": null,
                   "mutinyNextAt": null,
@@ -11341,9 +11602,33 @@
                     "marching": 0,
                     "storage": 0,
                     "scouting": 0,
-                    "defense": 0
+                    "defense": 0,
+                    "drill": 0,
+                    "combat": 0,
+                    "protection": 0,
+                    "riding": 0,
+                    "archery": 0,
+                    "supply": 0,
+                    "construction": 0,
+                    "research": 0,
+                    "looting": 0,
+                    "repair": 0
                   },
                   "recruitQueue": [],
+                  "defenses": {
+                    "cap": 0,
+                    "stock": {
+                      "trap": 0,
+                      "chevaux": 0,
+                      "rolling_log": 0,
+                      "boulder": 0
+                    },
+                    "total": 0,
+                    "queue": []
+                  },
+                  "assistIn": [],
+                  "assistOut": [],
+                  "assistCap": 5,
                   "defenseBonus": 0,
                   "marches": [],
                   "territory": [],
@@ -11622,6 +11907,11 @@
                   "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                   "name": "主城",
                   "level": 1,
+                  "title": "城池",
+                  "nobility": {
+                    "index": 0,
+                    "name": "平民"
+                  },
                   "resources": {
                     "gold": 2000,
                     "wood": 2000,
@@ -11912,6 +12202,7 @@
                   "durability": null,
                   "famousName": null,
                   "productionBonusPercent": 0,
+                  "luoyangBonusPercent": 0,
                   "famousEffect": null,
                   "starveAt": null,
                   "mutinyNextAt": null,
@@ -11927,9 +12218,33 @@
                     "marching": 0,
                     "storage": 0,
                     "scouting": 0,
-                    "defense": 0
+                    "defense": 0,
+                    "drill": 0,
+                    "combat": 0,
+                    "protection": 0,
+                    "riding": 0,
+                    "archery": 0,
+                    "supply": 0,
+                    "construction": 0,
+                    "research": 0,
+                    "looting": 0,
+                    "repair": 0
                   },
                   "recruitQueue": [],
+                  "defenses": {
+                    "cap": 0,
+                    "stock": {
+                      "trap": 0,
+                      "chevaux": 0,
+                      "rolling_log": 0,
+                      "boulder": 0
+                    },
+                    "total": 0,
+                    "queue": []
+                  },
+                  "assistIn": [],
+                  "assistOut": [],
+                  "assistCap": 5,
                   "defenseBonus": 0,
                   "marches": [],
                   "territory": [],
@@ -12078,7 +12393,7 @@
         {
           "name": "cities",
           "type": "array",
-          "desc": "城池点位 [x, y, side] 数组；side 取 'own' | 'ally' | 'enemy' | 'npc' | 'famous'（ally 为 v67 新增：同联盟盟友的城池）。"
+          "desc": "城池点位 [x, y, side] 数组；side 取 'own' | 'ally' | 'friendly' | 'hostile' | 'enemy' | 'npc' | 'famous'（ally 为 v67 同联盟盟友；friendly / hostile 为 v77 友盟 / 敌对联盟成员）。"
         }
       ],
       "errors": [],
@@ -12594,7 +12909,7 @@
         {
           "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 }。"
+          "desc": "联盟详情 { id, name, leader{accountId,username}, memberCount, maxMembers, createdAt, notice, members[], power 联盟势力（v70，现算：全体成员占领的野地数 × 1 + 名城数 × 10 + 成员主城官府等级之和 × 1）, rank 联盟榜名次（v70：取最近一次榜单快照；成员不足 5 人或未上榜为 null）, friends 友盟名单（v77：数组，元素同 GET_ALLIANCE_DIPLOMACY 的 friends）, hostiles 敌对名单（v77） }；没有联盟为 null。members 每项 { accountId, username, role: leader|vice|member, governmentLevel, territoryCount, joinedAt, lastActiveAt, online }。"
         },
         {
           "name": "myRole",
@@ -13047,178 +13362,2988 @@
       "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 排队；v71 起也含建造中）。建成后的产量、人口上限或仓储上限变化不逐条推送，客户端用 GET_STATE 或本地按 city.production / city.population / city.storage 推算。",
-      "dataFields": [
-        {
-          "name": "reason",
-          "type": "'build_started' | 'build_queued' | 'build_completed' | 'build_cancelled'",
-          "desc": "触发本次推送的状态变化。"
-        },
-        {
-          "name": "build",
-          "type": "object",
-          "desc": "建造视图，字段与 BUILD 响应的 build 相同；完成时 status 为 completed 且 completedAt 非空，排队时 status 为 queued 且 dueAt 为 null，取消时 status 为 cancelled。"
-        }
-      ],
-      "examples": [
+      "op": 117,
+      "kind": "request",
+      "name": "CRAFT_DEFENSE",
+      "title": "打造城防器械（v73，AISLG-193）",
+      "preAuth": false,
+      "summary": "在城墙里打造四种一次性守城器械（陷阱（trap）：开战时对攻方步兵类兵种造成 500 点伤害（固定值，按各兵种总生命比例分摊）；单件成本 金/木/粮/石/铁 = 20/60/0/0/40，单件 5s；拒马（chevaux）：开战时对攻方骑兵类兵种造成 800 点伤害（固定值，按各兵种总生命比例分摊）；单件成本 金/木/粮/石/铁 = 40/200/0/0/80，单件 10s；滚木（rolling_log）：攻方近战部队第一次贴到城墙下时，对贴墙的近战兵种造成 400 点伤害；单件成本 金/木/粮/石/铁 = 30/200/0/0/0，单件 8s；擂石（boulder）：攻方冲车第一次贴到城墙下时，对冲车造成 1500 点伤害（正好击毁 1 辆冲车）；单件成本 金/木/粮/石/铁 = 40/0/0/380/0，单件 12s）。发起时立即从该城扣资源，入库在打造完成时（Worker 结算）。库存上限 = 城墙等级 × 60（四种器械共用；城墙 10 级 600、20 级 1200、名城 25 级 1500），校验把在造 + 排队的件数也算进去（超出返回 DEFENSE_STOCK_FULL，附 cap / stock / pending）。队列与征兵同模型：1 条在造 + 2 条排队（队满 DEFENSE_QUEUE_FULL）；无在造时立即开工（status=crafting，dueAt 非空），批次总时长 = max(1 秒, floor(单件基准 × 件数 ÷ time_scale))；有在造时入队（status=queued，dueAt 为 null）。校验顺序：城墙未建（WALL_NOT_BUILT）→ 库存上限 → 队列 → 资源。守城战开打时器械按需自动使用、用掉就没了（陷阱 / 拒马开战即用，滚木 / 擂石在攻方贴墙时用），用量与杀伤见战报的 defenses 字段。",
+      "requestFields": [
         {
-          "op": 2000,
-          "push": true,
-          "data": {
-            "reason": "build_started",
-            "build": {
-              "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
-              "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
-              "kind": "quarry",
-              "status": "building",
-              "level": 1,
-              "toLevel": null,
-              "initiator": "agent",
-              "startedAt": "2026-09-25T08:00:00.000Z",
-              "dueAt": "2026-09-25T08:01:00.000Z",
-              "completedAt": null
-            }
-          }
+          "name": "kind",
+          "type": "'trap' | 'chevaux' | 'rolling_log' | 'boulder'",
+          "desc": "必填。器械种类：trap 陷阱 / chevaux 拒马 / rolling_log 滚木 / boulder 擂石；缺失或未知返回 INVALID_PARAMS。"
         },
         {
-          "op": 2000,
-          "push": true,
-          "data": {
-            "reason": "build_queued",
-            "build": {
-              "id": "8d0f7790-8536-51ef-a5ef-f18bd2a01b8f",
-              "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
-              "kind": "lumber_mill",
-              "status": "queued",
-              "level": 1,
-              "toLevel": null,
-              "initiator": "player",
-              "startedAt": "2026-09-25T08:00:30.000Z",
-              "dueAt": null,
-              "completedAt": null
-            }
-          }
+          "name": "count",
+          "type": "number",
+          "desc": "必填。件数（正整数，且与库存 + 在造 + 排队合计不超过城墙等级 × 60）；成本 = 单件成本 × 件数。"
         },
         {
-          "op": 2000,
-          "push": true,
-          "data": {
-            "reason": "build_completed",
-            "build": {
-              "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
-              "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
-              "kind": "farm",
-              "status": "completed",
-              "level": 1,
-              "toLevel": null,
-              "initiator": "agent",
-              "startedAt": "2026-09-25T08:00:00.000Z",
-              "dueAt": "2026-09-25T08:01:00.000Z",
-              "completedAt": "2026-09-25T08:01:05.000Z"
-            }
-          }
+          "name": "cityId",
+          "type": "string",
+          "desc": "可选。在哪座城打造（缺省主城）；城墙等级、库存与扣资源都按该城。"
         },
         {
-          "op": 2000,
-          "push": true,
-          "data": {
-            "reason": "build_cancelled",
-            "build": {
-              "id": "8d0f7790-8536-51ef-a5ef-f18bd2a01b8f",
-              "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
-              "kind": "lumber_mill",
-              "status": "cancelled",
-              "level": 1,
-              "toLevel": null,
-              "initiator": "player",
-              "startedAt": "2026-09-25T08:00:30.000Z",
-              "dueAt": null,
-              "completedAt": null
-            }
-          }
+          "name": "cityId",
+          "type": "string",
+          "desc": "可选（v24，AISLG-58）。要操作的城池 id（GET_STATE 响应的 cities[].id）；缺省 = 主城（账号创建最早的城），旧客户端不受影响。非本账号名下的城或格式不对返回 INVALID_PARAMS。每座城的资源 / 人口 / 仓储 / 建造与征兵队列 / 驻军各自独立；出征、侦察从该城出发、扣减该城驻军。取消类协议（CANCEL_BUILD / CANCEL_RECRUIT）按条目所属城池定位，无需传 cityId。"
         }
       ],
-      "agentNote": "完成时间不保证精确：Worker 按到期时间结算，存在正常延迟；对时间敏感的决策用 GET_STATE 查询权威状态。"
-    },
-    {
-      "op": 2001,
-      "kind": "push",
-      "name": "PUSH_AGENT_STATUS",
-      "title": "推送：Agent 在线状态变化",
-      "summary": "该账号的 Agent 在线状态发生**翻转**（首个 Agent 连接上线 / 最后一个 Agent 连接离线）时，推送给账号所有在线连接（v21 起翻转才推，多开连接的增减不再逐次推送；eventId 用于多连接去重）。",
       "dataFields": [
         {
-          "name": "online",
-          "type": "boolean",
-          "desc": "推送时刻该账号是否存在在线的 Agent 连接（账号级聚合，非单连接）。"
+          "name": "craft",
+          "type": "object",
+          "desc": "新建的打造条目 { id, cityId, kind, count, status, initiator, cost 成本快照, unitSeconds 单件基准秒数, startedAt, dueAt（排队为 null）, completedAt }。"
         },
         {
-          "name": "connectionCount",
-          "type": "number",
-          "desc": "推送时刻该账号的在线连接数（v21 新增，含玩家与 Agent 连接；非翻转的连接数变化不推送，精确值以重新登录或 GET_AGENT_INFO 为准）。"
+          "name": "stock",
+          "type": "object",
+          "desc": "发起后该城已入库的四种器械件数（不含在造 / 排队）。"
         },
         {
-          "name": "at",
-          "type": "string",
-          "desc": "推送时间（ISO 8601）。"
+          "name": "cap",
+          "type": "number",
+          "desc": "该城库存上限（城墙等级 × 60）。"
         }
       ],
+      "errors": [
+        "INVALID_PARAMS",
+        "WALL_NOT_BUILT",
+        "DEFENSE_STOCK_FULL",
+        "DEFENSE_QUEUE_FULL",
+        "INSUFFICIENT_RESOURCES"
+      ],
       "examples": [
         {
-          "op": 2001,
-          "push": true,
-          "data": {
-            "online": true,
-            "connectionCount": 1,
-            "at": "2026-09-25T08:00:10.123Z"
-          }
+          "caption": "打造 10 件陷阱（约 50s 后完成）",
+          "request": {
+            "op": 117,
+            "seq": 21,
+            "data": {
+              "kind": "trap",
+              "count": 10
+            }
+          },
+          "responses": [
+            {
+              "op": 117,
+              "seq": 21,
+              "ok": true,
+              "data": {
+                "craft": {
+                  "id": "3f7c9a1e-2d4b-4c6a-9e8f-1a2b3c4d5e6f",
+                  "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
+                  "kind": "trap",
+                  "count": 10,
+                  "status": "crafting",
+                  "initiator": "player",
+                  "cost": {
+                    "gold": 200,
+                    "wood": 600,
+                    "food": 0,
+                    "stone": 0,
+                    "iron": 400
+                  },
+                  "unitSeconds": 5,
+                  "startedAt": "2026-09-25T08:00:00.000Z",
+                  "dueAt": "2026-09-25T08:00:50.000Z",
+                  "completedAt": null
+                },
+                "stock": {
+                  "trap": 0,
+                  "chevaux": 0,
+                  "rolling_log": 0,
+                  "boulder": 0
+                },
+                "cap": 600
+              }
+            }
+          ]
         },
         {
-          "op": 2001,
-          "push": true,
-          "data": {
-            "online": false,
-            "connectionCount": 0,
-            "at": "2026-09-25T09:00:00.000Z"
-          }
+          "caption": "超出库存上限（城墙 10 级、已入库 590、在造 20，再下 10 件）",
+          "request": {
+            "op": 117,
+            "seq": 22,
+            "data": {
+              "kind": "chevaux",
+              "count": 10
+            }
+          },
+          "responses": [
+            {
+              "op": 117,
+              "seq": 22,
+              "ok": false,
+              "error": {
+                "code": "DEFENSE_STOCK_FULL",
+                "message": "器械库存已达上限（城墙等级 × 60，四种器械共用），先把库存用在守城或升级城墙"
+              },
+              "data": {
+                "cap": 600,
+                "stock": 590,
+                "pending": 20
+              }
+            }
+          ]
         }
       ],
-      "agentNote": "收到 online=false 表示该账号的全部 Agent 连接都已离线。多连接去重用帧顶层的 eventId。"
+      "agentNote": "守城器械只在被攻打时自动消耗，不会被掠夺。被打前先补库存：城墙 10 级囤满 600 件约等于守军多两成战力。四种按威胁配比：对手步兵多造陷阱、骑兵多造拒马、带冲车必须备擂石、通用近战压力造滚木。队列满了（1 在造 + 2 排队）先等或取消。"
     },
     {
-      "op": 2002,
-      "kind": "push",
-      "name": "PUSH_CITY_STATE",
-      "title": "推送：城池级状态变化",
-      "summary": "城池级状态变化时推送给该账号所有在线连接（发起连接除外）：city_renamed=城池改名（RENAME_CITY）、account_reset=账号数据被 RESET_ACCOUNT 重置（v9，重置后全部游戏数据回到开号初始状态）、city_discarded=分城被放弃（DISCARD_CITY，v57；推送只带 cityId，收到后用 GET_STATE 刷新城池列表）。建造队列相关变化走 PUSH_BUILD_STATE。推送只携带变化摘要，完整现状用 GET_STATE 查询。",
-      "dataFields": [
-        {
-          "name": "reason",
-          "type": "'city_renamed' | 'account_reset' | 'city_discarded'",
-          "desc": "触发本次推送的状态变化。"
-        },
+      "op": 118,
+      "kind": "request",
+      "name": "CANCEL_DEFENSE_CRAFT",
+      "title": "取消打造（v73，AISLG-193）",
+      "preAuth": false,
+      "summary": "取消排队中（queued）或打造中（crafting）的器械条目：按发起时的成本快照全额返还到该城，库存不变；该城排队的下一条立即开工（同事务激活，推送 craft_started）。与 Worker 到点完成按条件守卫并发，先翻转状态者生效。",
+      "requestFields": [
         {
-          "name": "cityId",
+          "name": "craftId",
           "type": "string",
-          "desc": "城池 UUID。"
-        },
+          "desc": "必填。要取消的打造条目 id（GET_STATE 的 city.defenses.queue 中条目的 id）；缺失或格式非法返回 INVALID_PARAMS。"
+        }
+      ],
+      "dataFields": [
         {
-          "name": "name",
-          "type": "string",
-          "desc": "reason=city_renamed 时的新城池名。"
+          "name": "craft",
+          "type": "object",
+          "desc": "被取消的打造条目（status=cancelled，completedAt 为 null）。"
         }
       ],
+      "errors": [
+        "INVALID_PARAMS",
+        "DEFENSE_NOT_CANCELLABLE"
+      ],
       "examples": [
         {
-          "op": 2002,
-          "push": true,
-          "data": {
-            "reason": "city_renamed",
-            "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
+          "caption": "取消进行中的打造",
+          "request": {
+            "op": 118,
+            "seq": 23,
+            "data": {
+              "craftId": "3f7c9a1e-2d4b-4c6a-9e8f-1a2b3c4d5e6f"
+            }
+          },
+          "responses": [
+            {
+              "op": 118,
+              "seq": 23,
+              "ok": true,
+              "data": {
+                "craft": {
+                  "id": "3f7c9a1e-2d4b-4c6a-9e8f-1a2b3c4d5e6f",
+                  "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
+                  "kind": "trap",
+                  "count": 10,
+                  "status": "cancelled",
+                  "initiator": "player",
+                  "cost": {
+                    "gold": 200,
+                    "wood": 600,
+                    "food": 0,
+                    "stone": 0,
+                    "iron": 400
+                  },
+                  "unitSeconds": 5,
+                  "startedAt": "2026-09-25T08:00:00.000Z",
+                  "dueAt": null,
+                  "completedAt": null
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "取消全额返还，但会丢掉这段时间的进度；只是缺资源的话优先等完成，别反复取消重下。"
+    },
+    {
+      "op": 119,
+      "kind": "request",
+      "name": "DISMISS_ASSIST",
+      "title": "召回 / 遣返协防部队（v74，AISLG-194）",
+      "preAuth": false,
+      "summary": "让一支驻扎在盟友城里的协防部队回出发城：派出方随时可以召回，城主可以遣返任意一支驻扎在自己城里的协防部队。部队原路返回（行军时长按两地距离与编队速度计算，驿站不加速），到达后并回出发城驻军；途中可以被 RECALL_MARCH 折返（折返仍是回出发城）。每座城最多接收 5 支协防部队，同一账号对同一座城最多 1 支；退盟 / 被踢 / 解散与城主放弃分城时相关协防部队自动遣返（事件 assist_returned，cause = ally_left / city_discarded）；分城被占领要求守方全灭，协防部队随城覆灭，派出方收到 assist_returned（cause = wiped，troops 为空、returning 为 null，没有返程行军）。",
+      "requestFields": [
+        {
+          "name": "assistId",
+          "type": "string",
+          "desc": "必填。协防记录 id：派出方看 GET_STATE 的 city.assistOut，城主看 city.assistIn（盟友看 GET_TILE 详情的 assists）。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "marchId",
+          "type": "string | null",
+          "desc": "返程行军 id（可用 RECALL_MARCH 再折返）；部队已不在（城 / 账号被重置）为 null。"
+        },
+        {
+          "name": "assistId",
+          "type": "string",
+          "desc": "被召回 / 遣返的协防记录 id。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "ASSIST_NOT_FOUND"
+      ],
+      "examples": [
+        {
+          "caption": "城主遣返一支协防部队（或派出方召回）",
+          "request": {
+            "op": 119,
+            "seq": 31,
+            "data": {
+              "assistId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
+            }
+          },
+          "responses": [
+            {
+              "op": 119,
+              "seq": 31,
+              "ok": true,
+              "data": {
+                "assistId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
+                "marchId": "2f1e3d4c-5b6a-4978-8c9d-0a1b2c3d4e5f"
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "协防部队占派出城的校场出征名额、耗粮由派出城按野外部队 2 倍承担；守城战时与城主驻军合并参战，伤亡按开战时各兵种数量比例分摊（余数归城主）。战斗后派出方会收到一份带 assistLosses 的战报。"
+    },
+    {
+      "op": 120,
+      "kind": "request",
+      "name": "GET_BATTLEFIELD",
+      "title": "查询剧本战场（官渡之战，v75，AISLG-198）",
+      "preAuth": false,
+      "summary": "周期性的剧本战场，玩家与 Agent 通用。日程：北京时间每周二 20:00 开始报名、周三 20:00 开战、周四 20:00 结束（现实时间，不随全局时间缩放）。每周一场，剧本按周轮换：官渡之战 → 讨伐董卓 → 赤壁之战（循环），本场剧本见 event.script、下一场见 nextScript。官渡之战（script=guandu）是阵营对阵：报名要求主城官府 ≥ 5 级，选袁绍军或曹操军（一方报名人数超过另一方 1.5 倍且多 5 人以上时，人多一方暂停报名）。战场是 30×30 的独立地图，与世界地图完全隔离；中间一条河（x=15）只有 3 处渡口（y=5/15/25）能过。行军每格 60 秒现实时间，不随全局缩放。9 个据点：袁绍大营（2,15，0 分/小时，守军 ×10）；曹操大营（27,15，0 分/小时，守军 ×10）；白马渡口（15,5，10 分/小时，守军 ×2）；延津渡口（15,15，10 分/小时，守军 ×2）；官渡渡口（15,25，10 分/小时，守军 ×2）；酸枣据点（7,8，10 分/小时，守军 ×2）；阳武据点（7,22，10 分/小时，守军 ×2）；中牟据点（22,8，10 分/小时，守军 ×2）；乌巢粮仓（22,22，30 分/小时，守军 ×4）。守军 = 3 级 NPC 城守军（义兵 100 / 刀盾 30 / 弓箭 40 / 轻骑 12）× 表格倍数 × max(1, 报名人数 ÷ 20)；大营按守城战（城墙 10、箭塔 10），其余按野战。报名期从主城带一支部队入场（按人口最多 3000，每人一次，开战后不能追加），入场后可拆成最多 3 队。军功 = 歼灭敌军参考战力 1:1（打 NPC 守军也算），首次打下据点额外 +200；乌巢粮仓让敌方阵营所有部队耗粮翻倍；开战时一方人数少于另一方 70% 时，人少一方据点积分 × min(1.5, 多/少)。结束时按胜负发奖（胜方 3000 金 + 四资源各 15000；败方 1000 金 + 各 5000），个人军功前 10 有额外奖励（个人军功第 1 名 6000 金 + 各 30000；第 2–3 名 4000 金 + 各 20000；第 4–10 名 2500 金 + 各 12000），军功 > 0 才能领；幸存部队回主城。战场商店（军功跨场累积、换季清零）：资源包 200 军功（每场限 5）；武将经验 300 军功（每场限 3）；刀盾兵 600 军功（每场限 2）；轻骑兵 600 军功（每场限 2）。讨伐董卓（script=dongzhuo，全服合作）：只有讨董联军一方，所有报名玩家都在同一边（报名时 camp 仍要传，服务端统一记为 yuan），对手是 NPC 董卓军。一条推进线 汜水关 → 虎牢关 → 洛阳，前一关打下后下一关才开放（strongholds[].unlocked）。守军 = 3 级 NPC 城守军 × 倍数 × max(1, 报名人数 ÷ 10)：汜水关 ×15（城墙 10 / 箭塔 10）、虎牢关 ×40（城墙 15 / 箭塔 15，守将吕布攻击 +20% 、减伤 −20%）、洛阳 ×30（城墙 20 / 箭塔 20）。守军伤亡保留不回血。攻下洛阳即结束（胜）；时间到也结束。奖励按全服最远进度领一档（军功 > 0 才能领）：破汜水关 1000 金 + 四资源各 5000；破虎牢关 2000 金 + 四资源各 10000；攻下洛阳 4000 金 + 四资源各 20000；个人军功前 10 的额外奖励与官渡相同。没有玩家对抗。 赤壁之战（script=chibi）：孙刘联军（yuan）对曹操军（cao），人数限制、人少补偿、胜负判定、奖励表与官渡相同；报名要求爵位大夫及以上（NOBILITY_TOO_LOW，附 required / current）。地图同为 30×30 与河（x=15，3 处渡口），双方各 4 个据点加各 1 座大营（共 10 个，见 strongholds）；大营与据点守军、积分产出与官渡对应据点相同（大营守军 ×10，城墙 / 箭塔 10）。风向：开战时随机东南风（se）或西北风（nw），之后每 6 小时交替一次，切换前 30 分钟预告；event.wind = { direction, label, bonusCamp, nextAt, noticeAt }。顺风方（se 利孙刘、nw 利曹操）的远程兵种与床弩射程 +10%（战报可见）。火攻（FIRE_BATTLEFIELD_STRONGHOLD，op 139）：孙刘方、东南风期间，花 300 军功，火攻与己方据点相邻（曼哈顿距离 ≤ 10）的曹方据点，立即对守军造成总生命 20% 的伤害；同一目标每 2 小时最多一次。连锁战船（CHAIN_BATTLEFIELD_STRONGHOLD，op 140）：曹方给己方据点花 200 军功连锁 6 小时：守军受到的伤害 −15%，但被火攻时伤害翻倍（20% → 40%）。赤壁商店另有铁骑兵 20（直接进主城，800 军功，每场限 1 次）。",
+      "requestFields": [],
+      "dataFields": [
+        {
+          "name": "event",
+          "type": "object | null",
+          "desc": "当前 / 最近一场战场：{ id, script: guandu|dongzhuo|chibi, name, status: signup|active|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan|cao|null, finishReason: score|base_captured|null, underdog: { camp, multiplier } | null, wind: 赤壁专有 { direction: se|nw, label, bonusCamp, nextAt, noticeAt }（其他剧本为 null） }。从未开过为 null。"
+        },
+        {
+          "name": "nextSignupAt",
+          "type": "string",
+          "desc": "下一场报名开始时刻（北京时间每周二 20:00）。"
+        },
+        {
+          "name": "nextScript",
+          "type": "'guandu' | 'dongzhuo' | 'chibi'",
+          "desc": "下一场的剧本（轮换预告）。"
+        },
+        {
+          "name": "strongholds",
+          "type": "array",
+          "desc": "本场据点（官渡 9 个 / 讨董 3 关 / 赤壁 10 个；讨董按推进线顺序）：{ id, name, kind: base|ford|post|granary, x, y, ownerCamp: yuan|cao|null（null = 中立 NPC；讨董的董卓军也是 null）, pointsPerHour, garrison（全兵种计数，NPC + 玩家据守合计）, garrisonPower（参考战力）, wallLevel, towerLevel, firstCaptureAvailable（首占 +200 军功还没被拿过）, capturedAt, unlocked（讨董：前一关未打下为 false；其他剧本恒为 true）, chainUntil（赤壁曹方连锁截止，其他 null）, fireNextAt（赤壁火攻冷却截止，其他 null） }。"
+        },
+        {
+          "name": "me",
+          "type": "object | null",
+          "desc": "本场我的状态：{ accountId, username, camp, merit 本场军功, rank 本场名次（未入场为 null）, entered, squads: [{ id, x, y, status: marching|idle|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 }；未报名为 null。"
+        },
+        {
+          "name": "top",
+          "type": "array",
+          "desc": "本场军功榜前 10：{ rank, accountId, username, camp, merit }（同分并列，军功 0 不上榜）。"
+        },
+        {
+          "name": "shop",
+          "type": "object",
+          "desc": "战场商店（赤壁多一个 iron_cavalry）：{ cumulativeMerit, items: [{ item: resources|hero_exp|swordsman|cavalry|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。"
+        },
+        {
+          "name": "rewards",
+          "type": "object",
+          "desc": "奖励表：{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }]（讨董的全服进度档；其他剧本为空数组） }。"
+        }
+      ],
+      "errors": [],
+      "examples": [
+        {
+          "caption": "战场进行中：我在袁绍军，一支队伍正在去延津渡口",
+          "request": {
+            "op": 120,
+            "seq": 30,
+            "data": {}
+          },
+          "responses": [
+            {
+              "op": 120,
+              "seq": 30,
+              "ok": true,
+              "data": {
+                "event": {
+                  "id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                  "script": "guandu",
+                  "name": "官渡之战",
+                  "status": "active",
+                  "signupStartAt": "2026-09-24T08:00:00.000Z",
+                  "startAt": "2026-09-25T08:00:00.000Z",
+                  "endAt": "2026-09-26T08:00:00.000Z",
+                  "camps": {
+                    "yuan": {
+                      "camp": "yuan",
+                      "name": "袁绍军",
+                      "signups": 12,
+                      "entered": 10,
+                      "score": 180
+                    },
+                    "cao": {
+                      "camp": "cao",
+                      "name": "曹操军",
+                      "signups": 15,
+                      "entered": 13,
+                      "score": 240
+                    }
+                  },
+                  "winner": null,
+                  "finishReason": null,
+                  "underdog": null
+                },
+                "nextSignupAt": "2026-10-02T08:00:00.000Z",
+                "nextScript": "dongzhuo",
+                "strongholds": [
+                  {
+                    "id": "ford_yanjin",
+                    "name": "延津渡口",
+                    "kind": "ford",
+                    "x": 15,
+                    "y": 15,
+                    "ownerCamp": "cao",
+                    "pointsPerHour": 10,
+                    "garrison": {
+                      "porter": 0,
+                      "militia": 120,
+                      "scout": 0,
+                      "pikeman": 0,
+                      "swordsman": 40,
+                      "archer": 60,
+                      "cavalry": 15,
+                      "iron_cavalry": 0,
+                      "supply_wagon": 0,
+                      "ballista": 0,
+                      "siege_ram": 0,
+                      "yulin_guard": 0,
+                      "danyang_soldier": 0,
+                      "baimao_soldier": 0,
+                      "huwei_guard": 0,
+                      "zhuge_crossbow": 0,
+                      "xiandeng_warrior": 0,
+                      "hubao_cavalry": 0,
+                      "xiliang_cavalry": 0
+                    },
+                    "garrisonPower": 710,
+                    "wallLevel": 0,
+                    "towerLevel": 0,
+                    "firstCaptureAvailable": false,
+                    "capturedAt": "2026-09-25T08:00:00.000Z"
+                  },
+                  "（其余 8 个据点同结构）"
+                ],
+                "me": {
+                  "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                  "username": "alice",
+                  "camp": "yuan",
+                  "merit": 1240,
+                  "rank": 3,
+                  "entered": true,
+                  "squads": [
+                    {
+                      "id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
+                      "x": 14,
+                      "y": 15,
+                      "status": "marching",
+                      "troops": {
+                        "porter": 0,
+                        "militia": 300,
+                        "scout": 0,
+                        "pikeman": 0,
+                        "swordsman": 200,
+                        "archer": 150,
+                        "cavalry": 50,
+                        "iron_cavalry": 0,
+                        "supply_wagon": 0,
+                        "ballista": 0,
+                        "siege_ram": 0,
+                        "yulin_guard": 0,
+                        "danyang_soldier": 0,
+                        "baimao_soldier": 0,
+                        "huwei_guard": 0,
+                        "zhuge_crossbow": 0,
+                        "xiandeng_warrior": 0,
+                        "hubao_cavalry": 0,
+                        "xiliang_cavalry": 0
+                      },
+                      "targetX": 15,
+                      "targetY": 15,
+                      "targetStrongholdId": "ford_yanjin",
+                      "arriveAt": "2026-09-25T08:01:00.000Z",
+                      "originX": 13,
+                      "originY": 15,
+                      "strongholdId": null
+                    }
+                  ],
+                  "cumulativeMerit": 3600
+                },
+                "top": [
+                  {
+                    "rank": 1,
+                    "accountId": "…",
+                    "username": "bob",
+                    "camp": "cao",
+                    "merit": 2200
+                  },
+                  {
+                    "rank": 2,
+                    "accountId": "…",
+                    "username": "carol",
+                    "camp": "yuan",
+                    "merit": 1500
+                  },
+                  {
+                    "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                    "username": "alice",
+                    "camp": "yuan",
+                    "merit": 1240,
+                    "rank": 3,
+                    "entered": true,
+                    "squads": [
+                      {
+                        "id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
+                        "x": 14,
+                        "y": 15,
+                        "status": "marching",
+                        "troops": {
+                          "porter": 0,
+                          "militia": 300,
+                          "scout": 0,
+                          "pikeman": 0,
+                          "swordsman": 200,
+                          "archer": 150,
+                          "cavalry": 50,
+                          "iron_cavalry": 0,
+                          "supply_wagon": 0,
+                          "ballista": 0,
+                          "siege_ram": 0,
+                          "yulin_guard": 0,
+                          "danyang_soldier": 0,
+                          "baimao_soldier": 0,
+                          "huwei_guard": 0,
+                          "zhuge_crossbow": 0,
+                          "xiandeng_warrior": 0,
+                          "hubao_cavalry": 0,
+                          "xiliang_cavalry": 0
+                        },
+                        "targetX": 15,
+                        "targetY": 15,
+                        "targetStrongholdId": "ford_yanjin",
+                        "arriveAt": "2026-09-25T08:01:00.000Z",
+                        "originX": 13,
+                        "originY": 15,
+                        "strongholdId": null
+                      }
+                    ],
+                    "cumulativeMerit": 3600
+                  }
+                ],
+                "shop": {
+                  "cumulativeMerit": 3600,
+                  "items": [
+                    {
+                      "item": "resources",
+                      "label": "资源包",
+                      "cost": 200,
+                      "limit": 5,
+                      "bought": 0,
+                      "reward": {
+                        "resources": {
+                          "gold": 0,
+                          "wood": 10000,
+                          "food": 10000,
+                          "stone": 10000,
+                          "iron": 10000
+                        }
+                      }
+                    },
+                    {
+                      "item": "hero_exp",
+                      "label": "武将经验",
+                      "cost": 300,
+                      "limit": 3,
+                      "bought": 0,
+                      "reward": {
+                        "heroExp": 5000
+                      }
+                    },
+                    {
+                      "item": "swordsman",
+                      "label": "刀盾兵",
+                      "cost": 600,
+                      "limit": 2,
+                      "bought": 0,
+                      "reward": {
+                        "troop": "swordsman",
+                        "count": 100
+                      }
+                    },
+                    {
+                      "item": "cavalry",
+                      "label": "轻骑兵",
+                      "cost": 600,
+                      "limit": 2,
+                      "bought": 0,
+                      "reward": {
+                        "troop": "cavalry",
+                        "count": 50
+                      }
+                    }
+                  ]
+                },
+                "rewards": {
+                  "winner": {
+                    "label": "胜方每人",
+                    "gold": 3000,
+                    "resourcesEach": 15000
+                  },
+                  "loser": {
+                    "label": "败方每人",
+                    "gold": 1000,
+                    "resourcesEach": 5000
+                  },
+                  "rankTiers": [
+                    {
+                      "label": "个人军功第 1 名",
+                      "maxRank": 1,
+                      "gold": 6000,
+                      "resourcesEach": 30000
+                    },
+                    {
+                      "label": "第 2–3 名",
+                      "maxRank": 3,
+                      "gold": 4000,
+                      "resourcesEach": 20000
+                    },
+                    {
+                      "label": "第 4–10 名",
+                      "maxRank": 10,
+                      "gold": 2500,
+                      "resourcesEach": 12000
+                    }
+                  ],
+                  "progressTiers": []
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "先看 event.script 与 event.status：signup 期只能报名 / 入场，active 才能行军与攻打。行军目标用 strongholds 的 id（MARCH_BATTLEFIELD_SQUAD 会按据点坐标走最短路径）；河只有 3 处渡口，先取渡口再渡河。攻打前用 garrisonPower 与自己的队伍战力对比，有城墙的据点按守城战（城墙 + 箭塔），没有把握先打渡口 / 普通据点。军功来自歼灭敌军（打 NPC 也算），首占据点 +200；乌巢（granary_wuchao）价值 30 分/小时并让敌方耗粮翻倍，适合偷袭。结束奖励自动入账，军功可立刻在战场商店换资源 / 武将经验 / 兵。讨董：只看 unlocked 为 true 的关卡，先打汜水关再虎牢关，洛阳最后；赤壁：先看 event.wind，东南风时孙刘方可以火攻，西北风时曹方可以连锁，留意预告的切换时刻。"
+    },
+    {
+      "op": 121,
+      "kind": "request",
+      "name": "SIGNUP_BATTLEFIELD",
+      "title": "报名剧本战场（v75，AISLG-198；v80 讨董 / 赤壁）",
+      "preAuth": false,
+      "summary": "在报名期（北京时间每周二 20:00 开始报名、周三 20:00 开战、周四 20:00 结束（现实时间，不随全局时间缩放））报名：主城官府 ≥ 5 级；同一场只能报一次，阵营选定后不能改。官渡 / 赤壁：一方报名人数超过另一方 1.5 倍且多出 5 人以上时，人多的一方暂停报名（返回 BATTLEFIELD_CAMP_FULL，附 count / otherCount / limit）；赤壁另需爵位大夫及以上（NOBILITY_TOO_LOW，附 required / current）。讨伐董卓是单阵营合作本，所有报名玩家都记为讨董联军（yuan），不做人数失衡判断。报名只占阵营人数，不带兵；带兵用 ENTER_BATTLEFIELD（开战前）。",
+      "requestFields": [
+        {
+          "name": "camp",
+          "type": "'yuan' | 'cao'",
+          "desc": "必填。袁绍军 yuan / 曹操军 cao（讨董场统一记为 yuan，此字段仍需传合法值）。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "event",
+          "type": "object | null",
+          "desc": "当前 / 最近一场战场：{ id, script: guandu|dongzhuo|chibi, name, status: signup|active|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan|cao|null, finishReason: score|base_captured|null, underdog: { camp, multiplier } | null, wind: 赤壁专有 { direction: se|nw, label, bonusCamp, nextAt, noticeAt }（其他剧本为 null） }。从未开过为 null。"
+        },
+        {
+          "name": "nextSignupAt",
+          "type": "string",
+          "desc": "下一场报名开始时刻（北京时间每周二 20:00）。"
+        },
+        {
+          "name": "nextScript",
+          "type": "'guandu' | 'dongzhuo' | 'chibi'",
+          "desc": "下一场的剧本（轮换预告）。"
+        },
+        {
+          "name": "strongholds",
+          "type": "array",
+          "desc": "本场据点（官渡 9 个 / 讨董 3 关 / 赤壁 10 个；讨董按推进线顺序）：{ id, name, kind: base|ford|post|granary, x, y, ownerCamp: yuan|cao|null（null = 中立 NPC；讨董的董卓军也是 null）, pointsPerHour, garrison（全兵种计数，NPC + 玩家据守合计）, garrisonPower（参考战力）, wallLevel, towerLevel, firstCaptureAvailable（首占 +200 军功还没被拿过）, capturedAt, unlocked（讨董：前一关未打下为 false；其他剧本恒为 true）, chainUntil（赤壁曹方连锁截止，其他 null）, fireNextAt（赤壁火攻冷却截止，其他 null） }。"
+        },
+        {
+          "name": "me",
+          "type": "object | null",
+          "desc": "本场我的状态：{ accountId, username, camp, merit 本场军功, rank 本场名次（未入场为 null）, entered, squads: [{ id, x, y, status: marching|idle|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 }；未报名为 null。"
+        },
+        {
+          "name": "top",
+          "type": "array",
+          "desc": "本场军功榜前 10：{ rank, accountId, username, camp, merit }（同分并列，军功 0 不上榜）。"
+        },
+        {
+          "name": "shop",
+          "type": "object",
+          "desc": "战场商店（赤壁多一个 iron_cavalry）：{ cumulativeMerit, items: [{ item: resources|hero_exp|swordsman|cavalry|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。"
+        },
+        {
+          "name": "rewards",
+          "type": "object",
+          "desc": "奖励表：{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }]（讨董的全服进度档；其他剧本为空数组） }。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "BATTLEFIELD_SIGNUP_CLOSED",
+        "BATTLEFIELD_ALREADY_JOINED",
+        "BATTLEFIELD_GOVERNMENT_TOO_LOW",
+        "BATTLEFIELD_CAMP_FULL",
+        "NOBILITY_TOO_LOW"
+      ],
+      "examples": [
+        {
+          "caption": "报名袁绍军",
+          "request": {
+            "op": 121,
+            "seq": 31,
+            "data": {
+              "camp": "yuan"
+            }
+          },
+          "responses": [
+            {
+              "op": 121,
+              "seq": 31,
+              "ok": true,
+              "data": {
+                "event": {
+                  "id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                  "script": "guandu",
+                  "name": "官渡之战",
+                  "status": "active",
+                  "signupStartAt": "2026-09-24T08:00:00.000Z",
+                  "startAt": "2026-09-25T08:00:00.000Z",
+                  "endAt": "2026-09-26T08:00:00.000Z",
+                  "camps": {
+                    "yuan": {
+                      "camp": "yuan",
+                      "name": "袁绍军",
+                      "signups": 12,
+                      "entered": 10,
+                      "score": 180
+                    },
+                    "cao": {
+                      "camp": "cao",
+                      "name": "曹操军",
+                      "signups": 15,
+                      "entered": 13,
+                      "score": 240
+                    }
+                  },
+                  "winner": null,
+                  "finishReason": null,
+                  "underdog": null
+                },
+                "me": {
+                  "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                  "username": "alice",
+                  "camp": "yuan",
+                  "merit": 0,
+                  "rank": null,
+                  "entered": false,
+                  "squads": [],
+                  "cumulativeMerit": 3600
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "报名前先 GET_BATTLEFIELD 看双方 signups，选人少的一方通常能吃到人少补偿；报名后记得在开战前 ENTER_BATTLEFIELD 带兵入场，否则开战后无法入场。"
+    },
+    {
+      "op": 122,
+      "kind": "request",
+      "name": "ENTER_BATTLEFIELD",
+      "title": "带部队入场（v75，AISLG-198）",
+      "preAuth": false,
+      "summary": "报名后、开战前，从主城带一支部队进入战场：按人口计最多 3000（铁骑兵 3、辎重车 6……），部队从主城驻军扣除，战场结束后幸存部队回到主城。每人每场只能入场一次，开战后不能追加兵力。入场后队伍出现在自己大营旁，可用 SPLIT_BATTLEFIELD_SQUAD 拆成最多 3 队。",
+      "requestFields": [
+        {
+          "name": "troops",
+          "type": "object",
+          "desc": "必填。按兵种数量（非负整数，至少 1 个单位）：{ militia, swordsman, archer, cavalry, ... }，键集同 MARCH.troops；按人口合计 ≤ 3000。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "event",
+          "type": "object | null",
+          "desc": "当前 / 最近一场战场：{ id, script: guandu|dongzhuo|chibi, name, status: signup|active|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan|cao|null, finishReason: score|base_captured|null, underdog: { camp, multiplier } | null, wind: 赤壁专有 { direction: se|nw, label, bonusCamp, nextAt, noticeAt }（其他剧本为 null） }。从未开过为 null。"
+        },
+        {
+          "name": "nextSignupAt",
+          "type": "string",
+          "desc": "下一场报名开始时刻（北京时间每周二 20:00）。"
+        },
+        {
+          "name": "nextScript",
+          "type": "'guandu' | 'dongzhuo' | 'chibi'",
+          "desc": "下一场的剧本（轮换预告）。"
+        },
+        {
+          "name": "strongholds",
+          "type": "array",
+          "desc": "本场据点（官渡 9 个 / 讨董 3 关 / 赤壁 10 个；讨董按推进线顺序）：{ id, name, kind: base|ford|post|granary, x, y, ownerCamp: yuan|cao|null（null = 中立 NPC；讨董的董卓军也是 null）, pointsPerHour, garrison（全兵种计数，NPC + 玩家据守合计）, garrisonPower（参考战力）, wallLevel, towerLevel, firstCaptureAvailable（首占 +200 军功还没被拿过）, capturedAt, unlocked（讨董：前一关未打下为 false；其他剧本恒为 true）, chainUntil（赤壁曹方连锁截止，其他 null）, fireNextAt（赤壁火攻冷却截止，其他 null） }。"
+        },
+        {
+          "name": "me",
+          "type": "object | null",
+          "desc": "本场我的状态：{ accountId, username, camp, merit 本场军功, rank 本场名次（未入场为 null）, entered, squads: [{ id, x, y, status: marching|idle|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 }；未报名为 null。"
+        },
+        {
+          "name": "top",
+          "type": "array",
+          "desc": "本场军功榜前 10：{ rank, accountId, username, camp, merit }（同分并列，军功 0 不上榜）。"
+        },
+        {
+          "name": "shop",
+          "type": "object",
+          "desc": "战场商店（赤壁多一个 iron_cavalry）：{ cumulativeMerit, items: [{ item: resources|hero_exp|swordsman|cavalry|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。"
+        },
+        {
+          "name": "rewards",
+          "type": "object",
+          "desc": "奖励表：{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }]（讨董的全服进度档；其他剧本为空数组） }。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "BATTLEFIELD_NOT_JOINED",
+        "BATTLEFIELD_ENTRY_CLOSED",
+        "BATTLEFIELD_ALREADY_ENTERED",
+        "BATTLEFIELD_POPULATION_LIMIT",
+        "INSUFFICIENT_TROOPS"
+      ],
+      "examples": [
+        {
+          "caption": "带 700 单位入场",
+          "request": {
+            "op": 122,
+            "seq": 32,
+            "data": {
+              "troops": {
+                "militia": 300,
+                "swordsman": 200,
+                "archer": 150,
+                "cavalry": 50
+              }
+            }
+          },
+          "responses": [
+            {
+              "op": 122,
+              "seq": 32,
+              "ok": true,
+              "data": {
+                "me": {
+                  "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                  "username": "alice",
+                  "camp": "yuan",
+                  "merit": 1240,
+                  "rank": 3,
+                  "entered": true,
+                  "squads": [
+                    {
+                      "id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
+                      "x": 14,
+                      "y": 15,
+                      "status": "idle",
+                      "troops": {
+                        "porter": 0,
+                        "militia": 300,
+                        "scout": 0,
+                        "pikeman": 0,
+                        "swordsman": 200,
+                        "archer": 150,
+                        "cavalry": 50,
+                        "iron_cavalry": 0,
+                        "supply_wagon": 0,
+                        "ballista": 0,
+                        "siege_ram": 0,
+                        "yulin_guard": 0,
+                        "danyang_soldier": 0,
+                        "baimao_soldier": 0,
+                        "huwei_guard": 0,
+                        "zhuge_crossbow": 0,
+                        "xiandeng_warrior": 0,
+                        "hubao_cavalry": 0,
+                        "xiliang_cavalry": 0
+                      },
+                      "targetX": null,
+                      "targetY": null,
+                      "targetStrongholdId": null,
+                      "arriveAt": null,
+                      "originX": 13,
+                      "originY": 15,
+                      "strongholdId": null
+                    }
+                  ],
+                  "cumulativeMerit": 3600
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "入场前用 GET_STATE 的 city.army 确认兵够，并算清人口（铁骑兵 3 / 辎重车 6 / 床弩 3 / 冲车 5）。全部兵力一次性带入即可，开战后无法追加；拆队是战术选择，不影响入场上限。"
+    },
+    {
+      "op": 123,
+      "kind": "request",
+      "name": "SPLIT_BATTLEFIELD_SQUAD",
+      "title": "拆分战场队伍（v75，AISLG-198）",
+      "preAuth": false,
+      "summary": "从一支队伍里分出一支新队伍（位置相同、状态待命），每人最多 3 队；行军中不能拆。新队伍与原队伍都必须至少剩 1 个单位。",
+      "requestFields": [
+        {
+          "name": "squadId",
+          "type": "string",
+          "desc": "必填。要拆分的队伍 id（GET_BATTLEFIELD 的 me.squads）。"
+        },
+        {
+          "name": "troops",
+          "type": "object",
+          "desc": "必填。从原队伍分出的兵种数量，不能超过原队伍现有数量。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "event",
+          "type": "object | null",
+          "desc": "当前 / 最近一场战场：{ id, script: guandu|dongzhuo|chibi, name, status: signup|active|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan|cao|null, finishReason: score|base_captured|null, underdog: { camp, multiplier } | null, wind: 赤壁专有 { direction: se|nw, label, bonusCamp, nextAt, noticeAt }（其他剧本为 null） }。从未开过为 null。"
+        },
+        {
+          "name": "nextSignupAt",
+          "type": "string",
+          "desc": "下一场报名开始时刻（北京时间每周二 20:00）。"
+        },
+        {
+          "name": "nextScript",
+          "type": "'guandu' | 'dongzhuo' | 'chibi'",
+          "desc": "下一场的剧本（轮换预告）。"
+        },
+        {
+          "name": "strongholds",
+          "type": "array",
+          "desc": "本场据点（官渡 9 个 / 讨董 3 关 / 赤壁 10 个；讨董按推进线顺序）：{ id, name, kind: base|ford|post|granary, x, y, ownerCamp: yuan|cao|null（null = 中立 NPC；讨董的董卓军也是 null）, pointsPerHour, garrison（全兵种计数，NPC + 玩家据守合计）, garrisonPower（参考战力）, wallLevel, towerLevel, firstCaptureAvailable（首占 +200 军功还没被拿过）, capturedAt, unlocked（讨董：前一关未打下为 false；其他剧本恒为 true）, chainUntil（赤壁曹方连锁截止，其他 null）, fireNextAt（赤壁火攻冷却截止，其他 null） }。"
+        },
+        {
+          "name": "me",
+          "type": "object | null",
+          "desc": "本场我的状态：{ accountId, username, camp, merit 本场军功, rank 本场名次（未入场为 null）, entered, squads: [{ id, x, y, status: marching|idle|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 }；未报名为 null。"
+        },
+        {
+          "name": "top",
+          "type": "array",
+          "desc": "本场军功榜前 10：{ rank, accountId, username, camp, merit }（同分并列，军功 0 不上榜）。"
+        },
+        {
+          "name": "shop",
+          "type": "object",
+          "desc": "战场商店（赤壁多一个 iron_cavalry）：{ cumulativeMerit, items: [{ item: resources|hero_exp|swordsman|cavalry|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。"
+        },
+        {
+          "name": "rewards",
+          "type": "object",
+          "desc": "奖励表：{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }]（讨董的全服进度档；其他剧本为空数组） }。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "BATTLEFIELD_SQUAD_NOT_FOUND",
+        "BATTLEFIELD_SQUAD_BUSY",
+        "BATTLEFIELD_SQUAD_LIMIT",
+        "INSUFFICIENT_TROOPS"
+      ],
+      "examples": [
+        {
+          "caption": "从主力里分出 100 骑兵当机动队",
+          "request": {
+            "op": 123,
+            "seq": 33,
+            "data": {
+              "squadId": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
+              "troops": {
+                "cavalry": 100
+              }
+            }
+          },
+          "responses": [
+            {
+              "op": 123,
+              "seq": 33,
+              "ok": true,
+              "data": {
+                "me": {
+                  "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                  "username": "alice",
+                  "camp": "yuan",
+                  "merit": 1240,
+                  "rank": 3,
+                  "entered": true,
+                  "squads": [
+                    {
+                      "id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
+                      "x": 14,
+                      "y": 15,
+                      "status": "marching",
+                      "troops": {
+                        "porter": 0,
+                        "militia": 300,
+                        "scout": 0,
+                        "pikeman": 0,
+                        "swordsman": 200,
+                        "archer": 150,
+                        "cavalry": 50,
+                        "iron_cavalry": 0,
+                        "supply_wagon": 0,
+                        "ballista": 0,
+                        "siege_ram": 0,
+                        "yulin_guard": 0,
+                        "danyang_soldier": 0,
+                        "baimao_soldier": 0,
+                        "huwei_guard": 0,
+                        "zhuge_crossbow": 0,
+                        "xiandeng_warrior": 0,
+                        "hubao_cavalry": 0,
+                        "xiliang_cavalry": 0
+                      },
+                      "targetX": 15,
+                      "targetY": 15,
+                      "targetStrongholdId": "ford_yanjin",
+                      "arriveAt": "2026-09-25T08:01:00.000Z",
+                      "originX": 13,
+                      "originY": 15,
+                      "strongholdId": null
+                    },
+                    {
+                      "id": "…",
+                      "x": 14,
+                      "y": 15,
+                      "status": "marching",
+                      "troops": {
+                        "porter": 0,
+                        "militia": 300,
+                        "scout": 0,
+                        "pikeman": 0,
+                        "swordsman": 200,
+                        "archer": 150,
+                        "cavalry": 100,
+                        "iron_cavalry": 0,
+                        "supply_wagon": 0,
+                        "ballista": 0,
+                        "siege_ram": 0,
+                        "yulin_guard": 0,
+                        "danyang_soldier": 0,
+                        "baimao_soldier": 0,
+                        "huwei_guard": 0,
+                        "zhuge_crossbow": 0,
+                        "xiandeng_warrior": 0,
+                        "hubao_cavalry": 0,
+                        "xiliang_cavalry": 0
+                      },
+                      "targetX": 15,
+                      "targetY": 15,
+                      "targetStrongholdId": "ford_yanjin",
+                      "arriveAt": "2026-09-25T08:01:00.000Z",
+                      "originX": 13,
+                      "originY": 15,
+                      "strongholdId": null
+                    }
+                  ],
+                  "cumulativeMerit": 3600
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "拆队适合「主力攻据点 + 骑兵绕后抢乌巢 / 渡口」这类分兵。行军中不能拆，先等到达。"
+    },
+    {
+      "op": 124,
+      "kind": "request",
+      "name": "MARCH_BATTLEFIELD_SQUAD",
+      "title": "战场内行军 / 攻打据点（v75，AISLG-198）",
+      "preAuth": false,
+      "summary": "给一支待命 / 据守中的队伍下令：目标给 strongholdId（自动取据点坐标）或 x / y；每格 60 秒现实时间，河只能从 3 处渡口（y=5/15/25）通过。到达友方据点 = 入驻据守（合并守军）；到达敌方 / 中立据点 = 自动开战（有城墙的据点按守城战），胜方幸存部队留守、据点易手。行军中不能再次下令。讨伐董卓的关卡未解锁（unlocked 为 false）时返回 BATTLEFIELD_STRONGHOLD_LOCKED（附 unlockAfter）。",
+      "requestFields": [
+        {
+          "name": "squadId",
+          "type": "string",
+          "desc": "必填。队伍 id。"
+        },
+        {
+          "name": "strongholdId",
+          "type": "string",
+          "desc": "可选（与 x / y 二选一）。目标据点 id；同时给 x / y 时必须与据点坐标一致，否则 BATTLEFIELD_TARGET_INVALID。"
+        },
+        {
+          "name": "x",
+          "type": "number",
+          "desc": "可选。目标横坐标（0..29）；只在没有 strongholdId 时使用，且必须与 y 同时给。"
+        },
+        {
+          "name": "y",
+          "type": "number",
+          "desc": "可选。目标纵坐标（0..29）；只在没有 strongholdId 时使用。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "event",
+          "type": "object | null",
+          "desc": "当前 / 最近一场战场：{ id, script: guandu|dongzhuo|chibi, name, status: signup|active|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan|cao|null, finishReason: score|base_captured|null, underdog: { camp, multiplier } | null, wind: 赤壁专有 { direction: se|nw, label, bonusCamp, nextAt, noticeAt }（其他剧本为 null） }。从未开过为 null。"
+        },
+        {
+          "name": "nextSignupAt",
+          "type": "string",
+          "desc": "下一场报名开始时刻（北京时间每周二 20:00）。"
+        },
+        {
+          "name": "nextScript",
+          "type": "'guandu' | 'dongzhuo' | 'chibi'",
+          "desc": "下一场的剧本（轮换预告）。"
+        },
+        {
+          "name": "strongholds",
+          "type": "array",
+          "desc": "本场据点（官渡 9 个 / 讨董 3 关 / 赤壁 10 个；讨董按推进线顺序）：{ id, name, kind: base|ford|post|granary, x, y, ownerCamp: yuan|cao|null（null = 中立 NPC；讨董的董卓军也是 null）, pointsPerHour, garrison（全兵种计数，NPC + 玩家据守合计）, garrisonPower（参考战力）, wallLevel, towerLevel, firstCaptureAvailable（首占 +200 军功还没被拿过）, capturedAt, unlocked（讨董：前一关未打下为 false；其他剧本恒为 true）, chainUntil（赤壁曹方连锁截止，其他 null）, fireNextAt（赤壁火攻冷却截止，其他 null） }。"
+        },
+        {
+          "name": "me",
+          "type": "object | null",
+          "desc": "本场我的状态：{ accountId, username, camp, merit 本场军功, rank 本场名次（未入场为 null）, entered, squads: [{ id, x, y, status: marching|idle|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 }；未报名为 null。"
+        },
+        {
+          "name": "top",
+          "type": "array",
+          "desc": "本场军功榜前 10：{ rank, accountId, username, camp, merit }（同分并列，军功 0 不上榜）。"
+        },
+        {
+          "name": "shop",
+          "type": "object",
+          "desc": "战场商店（赤壁多一个 iron_cavalry）：{ cumulativeMerit, items: [{ item: resources|hero_exp|swordsman|cavalry|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。"
+        },
+        {
+          "name": "rewards",
+          "type": "object",
+          "desc": "奖励表：{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }]（讨董的全服进度档；其他剧本为空数组） }。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "BATTLEFIELD_NOT_ACTIVE",
+        "BATTLEFIELD_SQUAD_NOT_FOUND",
+        "BATTLEFIELD_SQUAD_BUSY",
+        "BATTLEFIELD_UNREACHABLE",
+        "BATTLEFIELD_TARGET_INVALID",
+        "BATTLEFIELD_STRONGHOLD_LOCKED"
+      ],
+      "examples": [
+        {
+          "caption": "从 (14,15) 攻打延津渡口",
+          "request": {
+            "op": 124,
+            "seq": 34,
+            "data": {
+              "squadId": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
+              "strongholdId": "ford_yanjin"
+            }
+          },
+          "responses": [
+            {
+              "op": 124,
+              "seq": 34,
+              "ok": true,
+              "data": {
+                "me": {
+                  "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                  "username": "alice",
+                  "camp": "yuan",
+                  "merit": 1240,
+                  "rank": 3,
+                  "entered": true,
+                  "squads": [
+                    {
+                      "id": "c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
+                      "x": 14,
+                      "y": 15,
+                      "status": "marching",
+                      "troops": {
+                        "porter": 0,
+                        "militia": 300,
+                        "scout": 0,
+                        "pikeman": 0,
+                        "swordsman": 200,
+                        "archer": 150,
+                        "cavalry": 50,
+                        "iron_cavalry": 0,
+                        "supply_wagon": 0,
+                        "ballista": 0,
+                        "siege_ram": 0,
+                        "yulin_guard": 0,
+                        "danyang_soldier": 0,
+                        "baimao_soldier": 0,
+                        "huwei_guard": 0,
+                        "zhuge_crossbow": 0,
+                        "xiandeng_warrior": 0,
+                        "hubao_cavalry": 0,
+                        "xiliang_cavalry": 0
+                      },
+                      "targetX": 15,
+                      "targetY": 15,
+                      "targetStrongholdId": "ford_yanjin",
+                      "arriveAt": "2026-09-25T08:01:00.000Z",
+                      "originX": 13,
+                      "originY": 15,
+                      "strongholdId": null
+                    }
+                  ],
+                  "cumulativeMerit": 3600
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "到达结算与战报由服务端在 Worker 里完成，客户端轮询 / 收 PUSH_BATTLEFIELD_STATE 后重查即可。攻打前对比 garrisonPower 与自己的队伍战力；没有把握先打渡口（10 分/小时）或普通据点。战败的幸存部队会退回出发位置。"
+    },
+    {
+      "op": 125,
+      "kind": "request",
+      "name": "BUY_BATTLEFIELD_ITEM",
+      "title": "战场商店兑换（v75，AISLG-198）",
+      "preAuth": false,
+      "summary": "用战场军功换东西（军功跨场累积、换季清零；每场限购，见 GET_BATTLEFIELD 的 shop.items）：资源包 200 军功（每场限 5）；武将经验 300 军功（每场限 3）；刀盾兵 600 军功（每场限 2）；轻骑兵 600 军功（每场限 2）。赤壁场次另有 铁骑兵 800 军功（直接进主城，每场限 1 次）。兑换即时到账（资源包进主城、兵直接进主城驻军、武将经验给指定武将），不占队列。",
+      "requestFields": [
+        {
+          "name": "item",
+          "type": "'resources' | 'hero_exp' | 'swordsman' | 'cavalry' | 'iron_cavalry'",
+          "desc": "必填。商品（iron_cavalry 仅赤壁场次可买）。"
+        },
+        {
+          "name": "heroId",
+          "type": "string",
+          "desc": "item=hero_exp 时必填：经验给这个武将（必须属于本账号）。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "item",
+          "type": "string",
+          "desc": "商品。"
+        },
+        {
+          "name": "cost",
+          "type": "number",
+          "desc": "本次扣掉的军功。"
+        },
+        {
+          "name": "cumulativeMerit",
+          "type": "number",
+          "desc": "兑换后的军功余额。"
+        },
+        {
+          "name": "bought",
+          "type": "number",
+          "desc": "本场该商品累计已买数量（含本次）。"
+        },
+        {
+          "name": "reward",
+          "type": "object",
+          "desc": "到账内容：{ resources? } / { heroExp, level, leveledTo } / { troop, count }。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "BATTLEFIELD_NOT_ACTIVE",
+        "BATTLEFIELD_SHOP_LIMIT",
+        "BATTLEFIELD_MERIT_INSUFFICIENT",
+        "HERO_NOT_FOUND"
+      ],
+      "examples": [
+        {
+          "caption": "换一包资源",
+          "request": {
+            "op": 125,
+            "seq": 35,
+            "data": {
+              "item": "resources"
+            }
+          },
+          "responses": [
+            {
+              "op": 125,
+              "seq": 35,
+              "ok": true,
+              "data": {
+                "item": "resources",
+                "cost": 200,
+                "cumulativeMerit": 3400,
+                "bought": 1,
+                "reward": {
+                  "resources": {
+                    "gold": 0,
+                    "wood": 10000,
+                    "food": 10000,
+                    "stone": 10000,
+                    "iron": 10000
+                  }
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "打得多不如换得准：资源包适合补建造缺口，武将经验给主力将，刀盾 / 轻骑直接补战损。注意每场限购，军功余额跨场保留但换季清零。"
+    },
+    {
+      "op": 126,
+      "kind": "request",
+      "name": "GET_NOBILITY",
+      "title": "查询声望与爵位（v76，AISLG-197）",
+      "preAuth": false,
+      "summary": "累计声望只增不减：世界地图上的每一场战斗（攻守、输赢、NPC / 玩家 / 黄巾）按歼灭敌军的参考战力 1:1 计；剧本战场的军功按 1 军功 = 1 声望再计一次。竞技场与将星塔不计。爵位共 10 级（平民 0 / 公士 100 / 簪袅 500 / 大夫 2000 / 公乘 6000 / 五大夫 15000 / 庶长 35000 / 关内侯 80000 / 列侯 160000 / 王 300000），达到门槛自动升级；升到大夫及以上会全服播报。大夫（3）起可以占领名城（之前只能打外围与掠夺）；五大夫 / 列侯各让普通武将上限 +1。每日俸禄（金币 = 爵位序号 × 200 × 全局时间缩放，当前示例 公士 10000 金、簪袅 20000 金、大夫 30000 金、公乘 40000 金）在北京时间每天 0 点后领一次，用 CLAIM_NOBILITY_SALARY。声威与爵位随赛季重置；上一季的最高爵位随名人堂留存。",
+      "requestFields": [],
+      "dataFields": [
+        {
+          "name": "prestige",
+          "type": "number",
+          "desc": "累计声望。"
+        },
+        {
+          "name": "index",
+          "type": "number",
+          "desc": "爵位序号（0 = 平民）。"
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "desc": "爵位名称。"
+        },
+        {
+          "name": "privilege",
+          "type": "string",
+          "desc": "该爵位特权说明。"
+        },
+        {
+          "name": "next",
+          "type": "object | null",
+          "desc": "下一级爵位 { index, name, threshold }；已到「王」为 null。"
+        },
+        {
+          "name": "progressPercent",
+          "type": "number",
+          "desc": "距离下一级的进度（0..100；满级 100）。"
+        },
+        {
+          "name": "salaryGold",
+          "type": "number",
+          "desc": "每日俸禄金额（金币；平民 0；已按全局时间缩放折算）。"
+        },
+        {
+          "name": "claimedToday",
+          "type": "boolean",
+          "desc": "今日（北京日）是否已领。"
+        },
+        {
+          "name": "claimable",
+          "type": "boolean",
+          "desc": "现在是否可以领。"
+        },
+        {
+          "name": "lastClaimedAt",
+          "type": "string | null",
+          "desc": "最近一次领取时刻；从未领过为 null。"
+        },
+        {
+          "name": "nextClaimAt",
+          "type": "string",
+          "desc": "下次可领时刻（今日已领 = 明日 0 点北京时间；否则为现在）。"
+        },
+        {
+          "name": "heroCapBonus",
+          "type": "number",
+          "desc": "普通武将上限加成（五大夫 +1、列侯再 +1）。"
+        },
+        {
+          "name": "canOccupyFamous",
+          "type": "boolean",
+          "desc": "能否占领名城（爵位 ≥ 大夫）。"
+        }
+      ],
+      "errors": [],
+      "examples": [
+        {
+          "caption": "大夫：今天还能领俸禄，距公乘还差 3650 声望",
+          "request": {
+            "op": 126,
+            "seq": 40,
+            "data": {}
+          },
+          "responses": [
+            {
+              "op": 126,
+              "seq": 40,
+              "ok": true,
+              "data": {
+                "prestige": 2350,
+                "index": 3,
+                "name": "大夫",
+                "privilege": "可占领名城；每日俸禄",
+                "next": {
+                  "index": 4,
+                  "name": "公乘",
+                  "threshold": 6000
+                },
+                "progressPercent": 8,
+                "salaryGold": 30000,
+                "claimedToday": false,
+                "claimable": true,
+                "lastClaimedAt": null,
+                "nextClaimAt": "2026-10-27T04:00:00.000Z",
+                "heroCapBonus": 0,
+                "canOccupyFamous": true
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "声望是长期累积线：能打就打，不用刻意刷。打名城前先确认 canOccupyFamous；否则先打 NPC 城 / 野地攒到 2000 声望。俸禄每天记得领（claimable 为 true 时），金额随爵位提高。"
+    },
+    {
+      "op": 127,
+      "kind": "request",
+      "name": "CLAIM_NOBILITY_SALARY",
+      "title": "领取每日爵位俸禄（v76，AISLG-197）",
+      "preAuth": false,
+      "summary": "按北京日领取一次爵位俸禄（金币），直接加到主城。平民没有俸禄（NOBILITY_SALARY_NONE）；今日已领返回 NOBILITY_SALARY_CLAIMED（附 nextClaimAt）。金额 = 爵位序号 × 200 × 全局时间缩放。",
+      "requestFields": [],
+      "dataFields": [
+        {
+          "name": "gold",
+          "type": "number",
+          "desc": "本次领取的金币。"
+        },
+        {
+          "name": "index",
+          "type": "number",
+          "desc": "领取后的爵位序号。"
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "desc": "领取后的爵位名称。"
+        },
+        {
+          "name": "prestige",
+          "type": "number",
+          "desc": "领取后的累计声望。"
+        },
+        {
+          "name": "claimedAt",
+          "type": "string",
+          "desc": "领取时刻（ISO 8601）。"
+        }
+      ],
+      "errors": [
+        "NOBILITY_SALARY_NONE",
+        "NOBILITY_SALARY_CLAIMED"
+      ],
+      "examples": [
+        {
+          "caption": "大夫领取 3 万金（示例按 50 倍缩放）",
+          "request": {
+            "op": 127,
+            "seq": 41,
+            "data": {}
+          },
+          "responses": [
+            {
+              "op": 127,
+              "seq": 41,
+              "ok": true,
+              "data": {
+                "gold": 30000,
+                "index": 3,
+                "name": "大夫",
+                "prestige": 2350,
+                "claimedAt": "2026-10-27T04:00:00.000Z"
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "每天上线先领一次（幂等：重复领只会返回已领）。金币直接进主城，可用于建造 / 征兵 / 俸禄。"
+    },
+    {
+      "op": 128,
+      "kind": "request",
+      "name": "ALLIANCE_DIPLOMACY_INVITE",
+      "title": "发起友好邀请（v77，AISLG-195）",
+      "preAuth": false,
+      "summary": "联盟之间有三种关系：**中立**（默认）/ **友好**（一方发邀请、另一方同意，邀请 48 小时过期）/ **敌对**（一方单方面宣布，不需要对方同意）。友盟双方成员互不攻击（掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE），可以互相协防；地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」，不改变战斗与收益规则（不等于宣战）。上限：每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击，72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主（Agent 返回 AGENT_FORBIDDEN）；关系变化在双方联盟频道发系统消息，结友 / 宣布敌对另发全服播报；换季关系保留、邀请清空。 本协议由盟主 / 副盟主向另一个联盟发出友好邀请（48 小时有效）。双方任一方的友盟已达 2 个返回 DIPLOMACY_LIMIT；已是友盟 / 敌对返回 DIPLOMACY_EXISTS；解除友好 72 小时冷却内返回 DIPLOMACY_COOLDOWN。仅玩家连接。",
+      "requestFields": [
+        {
+          "name": "allianceId",
+          "type": "string",
+          "desc": "目标联盟 id。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "（同 GET_ALLIANCE_DIPLOMACY）",
+          "type": "object",
+          "desc": "返回最新外交全貌（含刚发出的邀请）。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "ALLIANCE_NOT_IN",
+        "ALLIANCE_FORBIDDEN",
+        "ALLIANCE_NOT_FOUND",
+        "DIPLOMACY_LIMIT",
+        "DIPLOMACY_EXISTS",
+        "DIPLOMACY_COOLDOWN"
+      ],
+      "examples": [
+        {
+          "caption": "向洛阳盟发出邀请",
+          "request": {
+            "op": 128,
+            "seq": 51,
+            "data": {
+              "allianceId": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70"
+            }
+          },
+          "responses": [
+            {
+              "op": 128,
+              "seq": 51,
+              "ok": true,
+              "data": {
+                "allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                "friends": [
+                  {
+                    "alliance": {
+                      "id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
+                      "name": "洛阳盟",
+                      "leader": {
+                        "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                        "username": "bob"
+                      },
+                      "memberCount": 18,
+                      "maxMembers": 30,
+                      "createdAt": "2026-09-25T08:00:00.000Z"
+                    },
+                    "relation": "friendly",
+                    "since": "2026-09-25T08:00:00.000Z",
+                    "noAttackUntil": null,
+                    "refriendAfter": null
+                  }
+                ],
+                "hostiles": [],
+                "invites": [
+                  {
+                    "id": "12",
+                    "alliance": {
+                      "id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
+                      "name": "洛阳盟",
+                      "leader": {
+                        "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                        "username": "bob"
+                      },
+                      "memberCount": 18,
+                      "maxMembers": 30,
+                      "createdAt": "2026-09-25T08:00:00.000Z"
+                    },
+                    "inviter": {
+                      "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                      "username": "bob"
+                    },
+                    "direction": "received",
+                    "createdAt": "2026-09-25T08:00:00.000Z",
+                    "expiresAt": "2026-09-27T08:00:00.000Z"
+                  }
+                ],
+                "limits": {
+                  "friends": 2,
+                  "hostiles": 5
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "管理操作 Agent 不能做；由玩家的盟主 / 副盟主在联盟面板发起。"
+    },
+    {
+      "op": 129,
+      "kind": "request",
+      "name": "ALLIANCE_DIPLOMACY_RESPOND",
+      "title": "同意 / 拒绝友好邀请（v77，AISLG-195）",
+      "preAuth": false,
+      "summary": "联盟之间有三种关系：**中立**（默认）/ **友好**（一方发邀请、另一方同意，邀请 48 小时过期）/ **敌对**（一方单方面宣布，不需要对方同意）。友盟双方成员互不攻击（掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE），可以互相协防；地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」，不改变战斗与收益规则（不等于宣战）。上限：每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击，72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主（Agent 返回 AGENT_FORBIDDEN）；关系变化在双方联盟频道发系统消息，结友 / 宣布敌对另发全服播报；换季关系保留、邀请清空。 本协议由收到邀请一方的盟主 / 副盟主答复（accept=true 同意 / false 拒绝）。同意时双方友盟名额、72 小时冷却都会复核（不通过返回 DIPLOMACY_LIMIT / DIPLOMACY_COOLDOWN），成功后双方联盟频道各写一条系统消息并全服播报。仅玩家连接。",
+      "requestFields": [
+        {
+          "name": "inviteId",
+          "type": "string",
+          "desc": "邀请 id（GET_ALLIANCE_DIPLOMACY 的 invites[].id）。"
+        },
+        {
+          "name": "accept",
+          "type": "boolean",
+          "desc": "true 同意 / false 拒绝。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "（同 GET_ALLIANCE_DIPLOMACY）",
+          "type": "object",
+          "desc": "返回最新外交全貌。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "ALLIANCE_NOT_IN",
+        "ALLIANCE_FORBIDDEN",
+        "DIPLOMACY_INVITE_NOT_FOUND",
+        "DIPLOMACY_LIMIT",
+        "DIPLOMACY_EXISTS",
+        "DIPLOMACY_COOLDOWN"
+      ],
+      "examples": [
+        {
+          "caption": "同意邀请，双方成为友盟",
+          "request": {
+            "op": 129,
+            "seq": 52,
+            "data": {
+              "inviteId": "12",
+              "accept": true
+            }
+          },
+          "responses": [
+            {
+              "op": 129,
+              "seq": 52,
+              "ok": true,
+              "data": {
+                "allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                "friends": [
+                  {
+                    "alliance": {
+                      "id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
+                      "name": "洛阳盟",
+                      "leader": {
+                        "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                        "username": "bob"
+                      },
+                      "memberCount": 18,
+                      "maxMembers": 30,
+                      "createdAt": "2026-09-25T08:00:00.000Z"
+                    },
+                    "relation": "friendly",
+                    "since": "2026-09-25T08:00:00.000Z",
+                    "noAttackUntil": null,
+                    "refriendAfter": null
+                  }
+                ],
+                "hostiles": [],
+                "invites": [],
+                "limits": {
+                  "friends": 2,
+                  "hostiles": 5
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "同意后双方成员立即不能互相攻击，且可以互相协防；规划军事行动前先确认。"
+    },
+    {
+      "op": 130,
+      "kind": "request",
+      "name": "ALLIANCE_DIPLOMACY_END",
+      "title": "解除友好 / 敌对（v77，AISLG-195）",
+      "preAuth": false,
+      "summary": "联盟之间有三种关系：**中立**（默认）/ **友好**（一方发邀请、另一方同意，邀请 48 小时过期）/ **敌对**（一方单方面宣布，不需要对方同意）。友盟双方成员互不攻击（掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE），可以互相协防；地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」，不改变战斗与收益规则（不等于宣战）。上限：每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击，72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主（Agent 返回 AGENT_FORBIDDEN）；关系变化在双方联盟频道发系统消息，结友 / 宣布敌对另发全服播报；换季关系保留、邀请清空。 本协议由盟主 / 副盟主单方面解除与目标联盟的友好或敌对，回到中立。解除友好会写入 24 小时不可攻击 + 72 小时不可再结好的冷却（防解约偷袭 / 反复横跳）。仅玩家连接。",
+      "requestFields": [
+        {
+          "name": "allianceId",
+          "type": "string",
+          "desc": "目标联盟 id。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "（同 GET_ALLIANCE_DIPLOMACY）",
+          "type": "object",
+          "desc": "返回最新外交全貌。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "ALLIANCE_NOT_IN",
+        "ALLIANCE_FORBIDDEN"
+      ],
+      "examples": [
+        {
+          "caption": "解除与洛阳盟的友好（24 小时内仍不能互相攻击）",
+          "request": {
+            "op": 130,
+            "seq": 53,
+            "data": {
+              "allianceId": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70"
+            }
+          },
+          "responses": [
+            {
+              "op": 130,
+              "seq": 53,
+              "ok": true,
+              "data": {
+                "allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                "friends": [],
+                "hostiles": [],
+                "invites": [],
+                "limits": {
+                  "friends": 2,
+                  "hostiles": 5
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "解除友好不等于立刻能打：24 小时冷却内攻击仍会被拒（ALLY_NOT_ATTACKABLE）。"
+    },
+    {
+      "op": 131,
+      "kind": "request",
+      "name": "ALLIANCE_DIPLOMACY_HOSTILE",
+      "title": "宣布敌对（v77，AISLG-195）",
+      "preAuth": false,
+      "summary": "联盟之间有三种关系：**中立**（默认）/ **友好**（一方发邀请、另一方同意，邀请 48 小时过期）/ **敌对**（一方单方面宣布，不需要对方同意）。友盟双方成员互不攻击（掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE），可以互相协防；地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」，不改变战斗与收益规则（不等于宣战）。上限：每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击，72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主（Agent 返回 AGENT_FORBIDDEN）；关系变化在双方联盟频道发系统消息，结友 / 宣布敌对另发全服播报；换季关系保留、邀请清空。 本协议由盟主 / 副盟主单方面把目标联盟标为敌对（不需要对方同意，最多 5 个），地图上对方成员的城与野地标红、对方来袭时预警标出「敌对联盟」。若原是友盟，保留 24 小时不可攻击冷却。仅玩家连接。",
+      "requestFields": [
+        {
+          "name": "allianceId",
+          "type": "string",
+          "desc": "目标联盟 id。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "（同 GET_ALLIANCE_DIPLOMACY）",
+          "type": "object",
+          "desc": "返回最新外交全貌。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "ALLIANCE_NOT_IN",
+        "ALLIANCE_FORBIDDEN",
+        "DIPLOMACY_LIMIT",
+        "DIPLOMACY_EXISTS"
+      ],
+      "examples": [
+        {
+          "caption": "把洛阳盟标为敌对",
+          "request": {
+            "op": 131,
+            "seq": 54,
+            "data": {
+              "allianceId": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70"
+            }
+          },
+          "responses": [
+            {
+              "op": 131,
+              "seq": 54,
+              "ok": true,
+              "data": {
+                "allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                "friends": [],
+                "hostiles": [
+                  {
+                    "alliance": {
+                      "id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
+                      "name": "洛阳盟",
+                      "leader": {
+                        "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                        "username": "bob"
+                      },
+                      "memberCount": 18,
+                      "maxMembers": 30,
+                      "createdAt": "2026-09-25T08:00:00.000Z"
+                    },
+                    "relation": "hostile",
+                    "since": "2026-09-25T08:00:00.000Z",
+                    "noAttackUntil": null,
+                    "refriendAfter": null
+                  }
+                ],
+                "invites": [
+                  {
+                    "id": "12",
+                    "alliance": {
+                      "id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
+                      "name": "洛阳盟",
+                      "leader": {
+                        "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                        "username": "bob"
+                      },
+                      "memberCount": 18,
+                      "maxMembers": 30,
+                      "createdAt": "2026-09-25T08:00:00.000Z"
+                    },
+                    "inviter": {
+                      "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                      "username": "bob"
+                    },
+                    "direction": "received",
+                    "createdAt": "2026-09-25T08:00:00.000Z",
+                    "expiresAt": "2026-09-27T08:00:00.000Z"
+                  }
+                ],
+                "limits": {
+                  "friends": 2,
+                  "hostiles": 5
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "敌对只是标记，不改变战斗与收益；可以随时单方面解除回到中立。"
+    },
+    {
+      "op": 132,
+      "kind": "request",
+      "name": "GET_ALLIANCE_DIPLOMACY",
+      "title": "查询联盟外交（v77，AISLG-195）",
+      "preAuth": false,
+      "summary": "联盟之间有三种关系：**中立**（默认）/ **友好**（一方发邀请、另一方同意，邀请 48 小时过期）/ **敌对**（一方单方面宣布，不需要对方同意）。友盟双方成员互不攻击（掠夺、抢野地、占分城、侦察都返回 ALLY_NOT_ATTACKABLE），可以互相协防；地图上显示友军色。敌对只在地图上标红、来袭预警标出「敌对联盟」，不改变战斗与收益规则（不等于宣战）。上限：每个联盟最多 2 个友盟、5 个敌对。解除友好后 24 小时内双方仍不能互相攻击，72 小时内不能再次结好。管理操作仅限玩家连接的盟主 / 副盟主（Agent 返回 AGENT_FORBIDDEN）；关系变化在双方联盟频道发系统消息，结友 / 宣布敌对另发全服播报；换季关系保留、邀请清空。 本协议返回本联盟的友盟名单、敌对名单与待处理邀请（发出 / 收到）；玩家与 Agent 通用。没有联盟返回 ALLIANCE_NOT_IN。",
+      "requestFields": [],
+      "dataFields": [
+        {
+          "name": "allianceId",
+          "type": "string",
+          "desc": "我的联盟 id。"
+        },
+        {
+          "name": "friends",
+          "type": "array",
+          "desc": "友盟名单（最多 2 个）：{ alliance 联盟概要 { id, name, leader, memberCount, maxMembers, createdAt }, relation: friendly, since, noAttackUntil, refriendAfter }。"
+        },
+        {
+          "name": "hostiles",
+          "type": "array",
+          "desc": "敌对名单（最多 5 个）：结构同 friends，relation: hostile。"
+        },
+        {
+          "name": "invites",
+          "type": "array",
+          "desc": "待处理友好邀请：{ id, alliance 对方联盟, inviter 发起人, direction: sent|received, createdAt, expiresAt }。"
+        },
+        {
+          "name": "limits",
+          "type": "object",
+          "desc": "上限：{ friends: 2, hostiles: 5 }。"
+        }
+      ],
+      "errors": [
+        "ALLIANCE_NOT_IN"
+      ],
+      "examples": [
+        {
+          "caption": "有一个友盟，并收到洛阳盟的邀请",
+          "request": {
+            "op": 132,
+            "seq": 50,
+            "data": {}
+          },
+          "responses": [
+            {
+              "op": 132,
+              "seq": 50,
+              "ok": true,
+              "data": {
+                "allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                "friends": [
+                  {
+                    "alliance": {
+                      "id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
+                      "name": "洛阳盟",
+                      "leader": {
+                        "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                        "username": "bob"
+                      },
+                      "memberCount": 18,
+                      "maxMembers": 30,
+                      "createdAt": "2026-09-25T08:00:00.000Z"
+                    },
+                    "relation": "friendly",
+                    "since": "2026-09-25T08:00:00.000Z",
+                    "noAttackUntil": null,
+                    "refriendAfter": null
+                  }
+                ],
+                "hostiles": [],
+                "invites": [
+                  {
+                    "id": "12",
+                    "alliance": {
+                      "id": "3c9f2a1b-4d5e-4f60-8a71-2b3c4d5e6f70",
+                      "name": "洛阳盟",
+                      "leader": {
+                        "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                        "username": "bob"
+                      },
+                      "memberCount": 18,
+                      "maxMembers": 30,
+                      "createdAt": "2026-09-25T08:00:00.000Z"
+                    },
+                    "inviter": {
+                      "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                      "username": "bob"
+                    },
+                    "direction": "received",
+                    "createdAt": "2026-09-25T08:00:00.000Z",
+                    "expiresAt": "2026-09-27T08:00:00.000Z"
+                  }
+                ],
+                "limits": {
+                  "friends": 2,
+                  "hostiles": 5
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "外交是盟主 / 副盟主的玩家操作，Agent 只能查。友盟成员不能互相攻击，规划进攻前先查 friendships；解除友好有 24 小时不可攻击 + 72 小时不可再结好的冷却。"
+    },
+    {
+      "op": 133,
+      "kind": "request",
+      "name": "GET_MARKET",
+      "title": "查询玩家交易所（v78，AISLG-196）",
+      "preAuth": false,
+      "summary": "玩家之间挂单买卖粮 / 木 / 石 / 铁（可收另一种资源或金币）。挂单时卖出的资源立即从挂单城冻结；吃单可整单或部分成交，成交时买家立即扣款，双方各派一支商队送货（每格 15 秒基准 ÷ 全局缩放，出发城驿站与行军科技有效；商队不会被截击）。成交双方各扣 5% 手续费。未成交部分随时可撤，48 小时后自动撤单退还。价格：资源之间 0.5–2（每 1 个卖出资源换多少个收取资源），收金币 0.125–0.5；单张最少 1000，每账号最多 5 张。每日成交额度 = 主城官府等级 × 3000 × 全局缩放（按卖出资源数量折算、买卖合计，北京日重置）。门槛：主城官府 ≥ 5 且不在新手保护期。可勾选「只卖给盟友」（同联盟成员才可见 / 可买）。 返回可买挂单（可按卖出 / 收取资源筛选、分页）、我的挂单与成交记录、我的额度与门槛；玩家与 Agent 通用。",
+      "requestFields": [
+        {
+          "name": "sellResource",
+          "type": "'food' | 'wood' | 'stone' | 'iron'",
+          "desc": "可选。只看卖出该资源的挂单。"
+        },
+        {
+          "name": "buyResource",
+          "type": "'food' | 'wood' | 'stone' | 'iron' | 'gold'",
+          "desc": "可选。只看收取该资源 / 金币的挂单。"
+        },
+        {
+          "name": "page",
+          "type": "number",
+          "desc": "页码，从 1 起；每页 10 条。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "orders",
+          "type": "array",
+          "desc": "可买挂单（单价升序）：{ id, seller{accountId,username,nobility,nobilityName,allianceId,allianceName}, city{id,name,x,y}, sellResource, buyResource, total, remaining, unitPrice, allyOnly, createdAt, expiresAt, mine }。只卖给盟友的单对非盟友不返回。"
+        },
+        {
+          "name": "page / pageSize / total",
+          "type": "number",
+          "desc": "分页信息，每页 10 条。"
+        },
+        {
+          "name": "mine.orders",
+          "type": "array",
+          "desc": "我的挂单（进行中 + 最近结束，最多 20 条），结构同 orders。"
+        },
+        {
+          "name": "mine.trades",
+          "type": "array",
+          "desc": "我的成交记录（最近 20 条）：{ id, role: buy|sell, other{accountId,username}, sellResource, buyResource, quantity, paid, delivered（扣 5% 后实收）, fee, createdAt, deliveredAt（双方商队都送达才非 null） }。"
+        },
+        {
+          "name": "limits",
+          "type": "object",
+          "desc": "我的额度与门槛：{ minAmount, maxOpenOrders, activeOrders, feePercent, government, dailyLimit, dailyUsed, dailyRemaining, locked, lockedReason: government|newbie|null, priceRangeResource{min,max}, priceRangeGold{min,max} }。"
+        }
+      ],
+      "errors": [],
+      "examples": [
+        {
+          "caption": "看铁换粮的挂单",
+          "request": {
+            "op": 133,
+            "seq": 60,
+            "data": {
+              "sellResource": "iron",
+              "buyResource": "food"
+            }
+          },
+          "responses": [
+            {
+              "op": 133,
+              "seq": 60,
+              "ok": true,
+              "data": {
+                "orders": [
+                  {
+                    "id": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70",
+                    "seller": {
+                      "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                      "username": "alice",
+                      "nobility": 3,
+                      "nobilityName": "大夫",
+                      "allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                      "allianceName": "卧龙盟"
+                    },
+                    "city": {
+                      "id": "5b1c3d2e-4f60-4a71-8c82-3d4e5f6a7b80",
+                      "name": "主城",
+                      "x": 612,
+                      "y": 388
+                    },
+                    "sellResource": "iron",
+                    "buyResource": "food",
+                    "total": 10000,
+                    "remaining": 10000,
+                    "unitPrice": 1.2,
+                    "allyOnly": false,
+                    "createdAt": "2026-09-25T08:00:00.000Z",
+                    "expiresAt": "2026-09-27T08:00:00.000Z",
+                    "mine": false
+                  }
+                ],
+                "page": 1,
+                "pageSize": 10,
+                "total": 1,
+                "mine": {
+                  "orders": [],
+                  "trades": []
+                },
+                "limits": {
+                  "minAmount": 1000,
+                  "maxOpenOrders": 5,
+                  "activeOrders": 1,
+                  "feePercent": 5,
+                  "government": 10,
+                  "dailyLimit": 30000,
+                  "dailyUsed": 0,
+                  "dailyRemaining": 30000,
+                  "locked": false,
+                  "lockedReason": null,
+                  "priceRangeResource": {
+                    "min": 0.5,
+                    "max": 2
+                  },
+                  "priceRangeGold": {
+                    "min": 0.125,
+                    "max": 0.5
+                  }
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "先 GET_MARKET 看 orders 与 limits：locked 为 true 时不能交易。单价范围见 limits；吃单前确认自己 buyResource 足够。成交后商队要飞一会儿，deliveredAt 为 null 表示还在路上。"
+    },
+    {
+      "op": 134,
+      "kind": "request",
+      "name": "CREATE_MARKET_ORDER",
+      "title": "挂单卖出资源（v78，AISLG-196）",
+      "preAuth": false,
+      "summary": "玩家之间挂单买卖粮 / 木 / 石 / 铁（可收另一种资源或金币）。挂单时卖出的资源立即从挂单城冻结；吃单可整单或部分成交，成交时买家立即扣款，双方各派一支商队送货（每格 15 秒基准 ÷ 全局缩放，出发城驿站与行军科技有效；商队不会被截击）。成交双方各扣 5% 手续费。未成交部分随时可撤，48 小时后自动撤单退还。价格：资源之间 0.5–2（每 1 个卖出资源换多少个收取资源），收金币 0.125–0.5；单张最少 1000，每账号最多 5 张。每日成交额度 = 主城官府等级 × 3000 × 全局缩放（按卖出资源数量折算、买卖合计，北京日重置）。门槛：主城官府 ≥ 5 且不在新手保护期。可勾选「只卖给盟友」（同联盟成员才可见 / 可买）。 卖出资源从当前城（可带 cityId）立即冻结；挂单后可在 GET_MARKET 的 mine.orders 看到。单价超范围返回 PRICE_OUT_OF_RANGE；官府 / 保护期门槛 MARKET_LOCKED；满 5 张 ORDER_LIMIT；sellResource 与 buyResource 相同（卖什么就收什么）返回 INVALID_PARAMS。",
+      "requestFields": [
+        {
+          "name": "sellResource",
+          "type": "'food' | 'wood' | 'stone' | 'iron'",
+          "desc": "必填。卖出的资源。"
+        },
+        {
+          "name": "buyResource",
+          "type": "'food' | 'wood' | 'stone' | 'iron' | 'gold'",
+          "desc": "必填。收取的资源或金币；必须与 sellResource 不同（同资源挂单返回 INVALID_PARAMS）。"
+        },
+        {
+          "name": "amount",
+          "type": "number",
+          "desc": "必填。卖出总量，≥ 1000，不能超过挂单城现有数量。"
+        },
+        {
+          "name": "unitPrice",
+          "type": "number",
+          "desc": "必填。每 1 个卖出资源换多少个收取物；范围见 GET_MARKET 的 limits（资源 0.5–2 / 金币 0.125–0.5，最多 4 位小数）。"
+        },
+        {
+          "name": "allyOnly",
+          "type": "boolean",
+          "desc": "可选。true = 只卖给同联盟成员。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "order",
+          "type": "object",
+          "desc": "新挂单，结构同 GET_MARKET 的 orders。"
+        },
+        {
+          "name": "limits",
+          "type": "object",
+          "desc": "挂单后的额度，结构同 GET_MARKET 的 limits。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "MARKET_LOCKED",
+        "PRICE_OUT_OF_RANGE",
+        "ORDER_LIMIT",
+        "INSUFFICIENT_RESOURCES"
+      ],
+      "examples": [
+        {
+          "caption": "卖 1 万铁，每 1 铁换 1.2 粮",
+          "request": {
+            "op": 134,
+            "seq": 61,
+            "data": {
+              "sellResource": "iron",
+              "buyResource": "food",
+              "amount": 10000,
+              "unitPrice": 1.2
+            }
+          },
+          "responses": [
+            {
+              "op": 134,
+              "seq": 61,
+              "ok": true,
+              "data": {
+                "order": {
+                  "id": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70",
+                  "seller": {
+                    "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                    "username": "alice",
+                    "nobility": 3,
+                    "nobilityName": "大夫",
+                    "allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                    "allianceName": "卧龙盟"
+                  },
+                  "city": {
+                    "id": "5b1c3d2e-4f60-4a71-8c82-3d4e5f6a7b80",
+                    "name": "主城",
+                    "x": 612,
+                    "y": 388
+                  },
+                  "sellResource": "iron",
+                  "buyResource": "food",
+                  "total": 10000,
+                  "remaining": 10000,
+                  "unitPrice": 1.2,
+                  "allyOnly": false,
+                  "createdAt": "2026-09-25T08:00:00.000Z",
+                  "expiresAt": "2026-09-27T08:00:00.000Z",
+                  "mine": true
+                },
+                "limits": {
+                  "minAmount": 1000,
+                  "maxOpenOrders": 5,
+                  "activeOrders": 2,
+                  "feePercent": 5,
+                  "government": 10,
+                  "dailyLimit": 30000,
+                  "dailyUsed": 0,
+                  "dailyRemaining": 30000,
+                  "locked": false,
+                  "lockedReason": null,
+                  "priceRangeResource": {
+                    "min": 0.5,
+                    "max": 2
+                  },
+                  "priceRangeGold": {
+                    "min": 0.125,
+                    "max": 0.5
+                  }
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "挂单前算好单价：资源之间参考价 1:1，收金币参考价 0.25。只卖给盟友可减少被陌生人吃掉，但也少买家。"
+    },
+    {
+      "op": 135,
+      "kind": "request",
+      "name": "BUY_MARKET_ORDER",
+      "title": "吃单（v78，AISLG-196）",
+      "preAuth": false,
+      "summary": "玩家之间挂单买卖粮 / 木 / 石 / 铁（可收另一种资源或金币）。挂单时卖出的资源立即从挂单城冻结；吃单可整单或部分成交，成交时买家立即扣款，双方各派一支商队送货（每格 15 秒基准 ÷ 全局缩放，出发城驿站与行军科技有效；商队不会被截击）。成交双方各扣 5% 手续费。未成交部分随时可撤，48 小时后自动撤单退还。价格：资源之间 0.5–2（每 1 个卖出资源换多少个收取资源），收金币 0.125–0.5；单张最少 1000，每账号最多 5 张。每日成交额度 = 主城官府等级 × 3000 × 全局缩放（按卖出资源数量折算、买卖合计，北京日重置）。门槛：主城官府 ≥ 5 且不在新手保护期。可勾选「只卖给盟友」（同联盟成员才可见 / 可买）。 吃单可整单或部分（quantity ≤ remaining）。成交时锁挂单行、扣买家款、按 5% 手续费拆出双方实收并各派一支商队。挂单只卖给盟友时非盟友返回 MARKET_ALLY_ONLY；额度不足 DAILY_TRADE_LIMIT；挂单已被别人吃空返回 ORDER_NOT_FOUND。",
+      "requestFields": [
+        {
+          "name": "orderId",
+          "type": "string",
+          "desc": "必填。挂单 id。"
+        },
+        {
+          "name": "quantity",
+          "type": "number",
+          "desc": "必填。买入数量（正整数，≤ 挂单剩余量）。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "trade",
+          "type": "object",
+          "desc": "成交记录（买家视角），结构同 GET_MARKET 的 mine.trades。"
+        },
+        {
+          "name": "remaining",
+          "type": "number",
+          "desc": "成交后挂单剩余量（0 = 售罄）。"
+        },
+        {
+          "name": "limits",
+          "type": "object",
+          "desc": "成交后的额度，结构同 GET_MARKET 的 limits。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "MARKET_LOCKED",
+        "MARKET_ALLY_ONLY",
+        "DAILY_TRADE_LIMIT",
+        "ORDER_NOT_FOUND",
+        "INSUFFICIENT_RESOURCES"
+      ],
+      "examples": [
+        {
+          "caption": "买 4000 铁（付 4800 粮，实收 3800 铁）",
+          "request": {
+            "op": 135,
+            "seq": 62,
+            "data": {
+              "orderId": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70",
+              "quantity": 4000
+            }
+          },
+          "responses": [
+            {
+              "op": 135,
+              "seq": 62,
+              "ok": true,
+              "data": {
+                "trade": {
+                  "id": "…",
+                  "role": "buy",
+                  "other": {
+                    "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                    "username": "alice"
+                  },
+                  "sellResource": "iron",
+                  "buyResource": "food",
+                  "quantity": 4000,
+                  "paid": 4800,
+                  "delivered": 3800,
+                  "fee": 200,
+                  "createdAt": "2026-09-25T08:00:00.000Z",
+                  "deliveredAt": null
+                },
+                "remaining": 6000,
+                "limits": {
+                  "minAmount": 1000,
+                  "maxOpenOrders": 5,
+                  "activeOrders": 1,
+                  "feePercent": 5,
+                  "government": 10,
+                  "dailyLimit": 30000,
+                  "dailyUsed": 4000,
+                  "dailyRemaining": 30000,
+                  "locked": false,
+                  "lockedReason": null,
+                  "priceRangeResource": {
+                    "min": 0.5,
+                    "max": 2
+                  },
+                  "priceRangeGold": {
+                    "min": 0.125,
+                    "max": 0.5
+                  }
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "部分成交可以拆单降低一次性投入；注意 5% 手续费与商队飞行时间。额度按卖出资源数量计，买卖都占额度。"
+    },
+    {
+      "op": 136,
+      "kind": "request",
+      "name": "CANCEL_MARKET_ORDER",
+      "title": "撤单（v78，AISLG-196）",
+      "preAuth": false,
+      "summary": "玩家之间挂单买卖粮 / 木 / 石 / 铁（可收另一种资源或金币）。挂单时卖出的资源立即从挂单城冻结；吃单可整单或部分成交，成交时买家立即扣款，双方各派一支商队送货（每格 15 秒基准 ÷ 全局缩放，出发城驿站与行军科技有效；商队不会被截击）。成交双方各扣 5% 手续费。未成交部分随时可撤，48 小时后自动撤单退还。价格：资源之间 0.5–2（每 1 个卖出资源换多少个收取资源），收金币 0.125–0.5；单张最少 1000，每账号最多 5 张。每日成交额度 = 主城官府等级 × 3000 × 全局缩放（按卖出资源数量折算、买卖合计，北京日重置）。门槛：主城官府 ≥ 5 且不在新手保护期。可勾选「只卖给盟友」（同联盟成员才可见 / 可买）。 卖家可随时撤回未成交部分，冻结资源立即退还到挂单城；已售罄 / 已过期返回 ORDER_NOT_CANCELLABLE。",
+      "requestFields": [
+        {
+          "name": "orderId",
+          "type": "string",
+          "desc": "必填。挂单 id（只能是自己的）。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "orderId",
+          "type": "string",
+          "desc": "撤单的挂单 id。"
+        },
+        {
+          "name": "refunded",
+          "type": "number",
+          "desc": "退还数量。"
+        },
+        {
+          "name": "resource",
+          "type": "string",
+          "desc": "退还的资源种类。"
+        },
+        {
+          "name": "limits",
+          "type": "object",
+          "desc": "撤单后的额度，结构同 GET_MARKET 的 limits。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "ORDER_NOT_FOUND",
+        "ORDER_NOT_CANCELLABLE"
+      ],
+      "examples": [
+        {
+          "caption": "撤回 6000 铁",
+          "request": {
+            "op": 136,
+            "seq": 63,
+            "data": {
+              "orderId": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70"
+            }
+          },
+          "responses": [
+            {
+              "op": 136,
+              "seq": 63,
+              "ok": true,
+              "data": {
+                "orderId": "4a9c2b1d-3e5f-4a60-8b71-2c3d4e5f6a70",
+                "refunded": 6000,
+                "resource": "iron",
+                "limits": {
+                  "minAmount": 1000,
+                  "maxOpenOrders": 5,
+                  "activeOrders": 1,
+                  "feePercent": 5,
+                  "government": 10,
+                  "dailyLimit": 30000,
+                  "dailyUsed": 0,
+                  "dailyRemaining": 30000,
+                  "locked": false,
+                  "lockedReason": null,
+                  "priceRangeResource": {
+                    "min": 0.5,
+                    "max": 2
+                  },
+                  "priceRangeGold": {
+                    "min": 0.125,
+                    "max": 0.5
+                  }
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "挂单 48 小时会自动撤单退款，不需要手动撤；急着用资源时再撤。"
+    },
+    {
+      "op": 137,
+      "kind": "request",
+      "name": "GET_LUOYANG",
+      "title": "查询洛阳争夺状态（v79，AISLG-200）",
+      "preAuth": false,
+      "summary": "洛阳是 8 座名城之一，仍是占领者的分城；占领者所在联盟成为「洛阳之主」，占领者本人是「洛阳太守」。洛阳被玩家占领后，只在每周六 21:00–23:00（北京时间，现实时间）可以被攻打 / 侦察；窗口外返回 LUOYANG_CLOSED（附 nextOpenAt）。窗口内洛阳没有被动免战、城防值不回涨，每次打赢按现有规则扣城防，归零换主；窗口结束时城防回满并进入保护。洛阳可接收 10 支协防（普通城 5 支），盟友 / 友盟都能协防。洛阳之主联盟全员所有城的粮木石铁产量 +5%（与名城 / 科技 / 城守同一百分比池相加）。盟主每 7 天可以发布一道政令（三选一，持续 7 天）：征兵时长 −15% / 行军速度 +10% / 科技研究时长 −15%；洛阳易主时旧政令立即失效。赛季结束时占有洛阳的联盟进入名人堂，结算时在盟成员每人获得 10,000 金币与四资源各 50,000。窗口预告 / 开始 / 结束、洛阳易主、政令发布都有全服播报，并在相关联盟频道发系统消息。 本协议返回洛阳占领者、争夺窗口、洛阳之主联盟加成与当前政令；玩家与 Agent 通用。",
+      "requestFields": [],
+      "dataFields": [
+        {
+          "name": "owner",
+          "type": "object | null",
+          "desc": "洛阳当前占领者（玩家分城）：{ cityId, cityName, accountId, username, allianceId, allianceName, durability }；NPC 阶段为 null。"
+        },
+        {
+          "name": "windowOpen / windowStartAt / windowEndAt / nextOpenAt",
+          "type": "boolean / string",
+          "desc": "当前是否在争夺窗口、本次窗口起止、下一次开放时刻（北京时间周六 21:00–23:00）。"
+        },
+        {
+          "name": "bonusPercent",
+          "type": "number",
+          "desc": "洛阳之主联盟全员的四资源产量加成（当前 5）；不是洛阳之主为 0。"
+        },
+        {
+          "name": "assistCap",
+          "type": "number",
+          "desc": "洛阳可接收的协防部队上限（当前 10）。"
+        },
+        {
+          "name": "decree",
+          "type": "object | null",
+          "desc": "生效中的政令：{ kind: recruit|march|research, until, nextAt, canPublish, leaderName }；没有为 null。"
+        },
+        {
+          "name": "canPublishDecree / decreeNextAt / myAllianceIsHolder",
+          "type": "boolean / string / boolean",
+          "desc": "我是否能发政令、下次可发时刻、我所在联盟是否洛阳之主。"
+        }
+      ],
+      "errors": [],
+      "examples": [
+        {
+          "caption": "洛阳由卧龙盟占领，本周窗口未开，征兵政令生效中",
+          "request": {
+            "op": 137,
+            "seq": 70,
+            "data": {}
+          },
+          "responses": [
+            {
+              "op": 137,
+              "seq": 70,
+              "ok": true,
+              "data": {
+                "owner": {
+                  "cityId": "5b1c3d2e-4f60-4a71-8c82-3d4e5f6a7b80",
+                  "cityName": "洛阳",
+                  "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                  "username": "alice",
+                  "allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                  "allianceName": "卧龙盟",
+                  "durability": 65
+                },
+                "windowOpen": false,
+                "windowStartAt": "2026-10-31T13:00:00.000Z",
+                "windowEndAt": "2026-10-31T15:00:00.000Z",
+                "nextOpenAt": "2026-10-31T13:00:00.000Z",
+                "bonusPercent": 5,
+                "assistCap": 10,
+                "decree": {
+                  "kind": "recruit",
+                  "until": "2026-11-03T04:00:00.000Z",
+                  "nextAt": "2026-11-03T04:00:00.000Z",
+                  "canPublish": false,
+                  "leaderName": "alice"
+                },
+                "canPublishDecree": false,
+                "decreeNextAt": "2026-11-03T04:00:00.000Z",
+                "myAllianceIsHolder": true
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "窗口外不要对洛阳发起掠夺 / 占领 / 侦察（LUOYANG_CLOSED）。窗口内洛阳无被动免战、城防不回涨；攻方要有空分城名额。洛阳之主盟员可享受 +5% 产量，盟主每 7 天可发政令。"
+    },
+    {
+      "op": 138,
+      "kind": "request",
+      "name": "PUBLISH_DECREE",
+      "title": "发布洛阳政令（v79，AISLG-200）",
+      "preAuth": false,
+      "summary": "洛阳是 8 座名城之一，仍是占领者的分城；占领者所在联盟成为「洛阳之主」，占领者本人是「洛阳太守」。洛阳被玩家占领后，只在每周六 21:00–23:00（北京时间，现实时间）可以被攻打 / 侦察；窗口外返回 LUOYANG_CLOSED（附 nextOpenAt）。窗口内洛阳没有被动免战、城防值不回涨，每次打赢按现有规则扣城防，归零换主；窗口结束时城防回满并进入保护。洛阳可接收 10 支协防（普通城 5 支），盟友 / 友盟都能协防。洛阳之主联盟全员所有城的粮木石铁产量 +5%（与名城 / 科技 / 城守同一百分比池相加）。盟主每 7 天可以发布一道政令（三选一，持续 7 天）：征兵时长 −15% / 行军速度 +10% / 科技研究时长 −15%；洛阳易主时旧政令立即失效。赛季结束时占有洛阳的联盟进入名人堂，结算时在盟成员每人获得 10,000 金币与四资源各 50,000。窗口预告 / 开始 / 结束、洛阳易主、政令发布都有全服播报，并在相关联盟频道发系统消息。 仅洛阳之主联盟的盟主（玩家连接）可发布；每 7 天一次，持续 7 天，三选一（recruit / march / research）。发布后全服播报并在联盟频道发系统消息。",
+      "requestFields": [
+        {
+          "name": "kind",
+          "type": "'recruit' | 'march' | 'research'",
+          "desc": "政令：征兵时长 −15% / 行军速度 +10% / 科技研究时长 −15%。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "（同 GET_LUOYANG）",
+          "type": "object",
+          "desc": "发布后的洛阳状态（含新政令）。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "AGENT_FORBIDDEN",
+        "DECREE_NOT_HOLDER",
+        "DECREE_COOLDOWN"
+      ],
+      "examples": [
+        {
+          "caption": "发布征兵政令",
+          "request": {
+            "op": 138,
+            "seq": 71,
+            "data": {
+              "kind": "recruit"
+            }
+          },
+          "responses": [
+            {
+              "op": 138,
+              "seq": 71,
+              "ok": true,
+              "data": {
+                "owner": {
+                  "cityId": "5b1c3d2e-4f60-4a71-8c82-3d4e5f6a7b80",
+                  "cityName": "洛阳",
+                  "accountId": "6f1e2d3c-4b5a-4978-8c6d-5e4f3a2b1c0d",
+                  "username": "alice",
+                  "allianceId": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                  "allianceName": "卧龙盟",
+                  "durability": 65
+                },
+                "windowOpen": false,
+                "windowStartAt": "2026-10-31T13:00:00.000Z",
+                "windowEndAt": "2026-10-31T15:00:00.000Z",
+                "nextOpenAt": "2026-10-31T13:00:00.000Z",
+                "bonusPercent": 5,
+                "assistCap": 10,
+                "decree": {
+                  "kind": "recruit",
+                  "until": "2026-11-03T04:00:00.000Z",
+                  "nextAt": "2026-11-03T04:00:00.000Z",
+                  "canPublish": false,
+                  "leaderName": "alice"
+                },
+                "canPublishDecree": false,
+                "decreeNextAt": "2026-11-03T04:00:00.000Z",
+                "myAllianceIsHolder": true
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "管理操作需要玩家盟主本人；Agent 只能查询 GET_LUOYANG。政令到期后自动失效，冷却按发布时刻 +7 天。"
+    },
+    {
+      "op": 139,
+      "kind": "request",
+      "name": "FIRE_BATTLEFIELD_STRONGHOLD",
+      "title": "赤壁火攻（v80，AISLG-199）",
+      "preAuth": false,
+      "summary": "仅赤壁场次、孙刘方（me.camp = yuan）、已入场，并且当前风向为东南风（event.wind.direction = se）时可用：花 300 军功，火攻一座曹方据点（ownerCamp = cao）。目标必须与己方据点相邻（曼哈顿距离 ≤ 10）。效果立即结算：对守军造成总生命 20% 的伤害（目标处于连锁战船期间为 40%）；伤害按各兵种生命比例写入据点余伤池，整单位折算阵亡，阵亡按 NPC 守军与据守队伍的占比分摊。同一目标每 2 小时最多被火攻一次（冷却 fireNextAt）。火攻不计军功，也不改变归属，要靠后续攻打夺下据点。",
+      "requestFields": [
+        {
+          "name": "strongholdId",
+          "type": "string",
+          "desc": "必填。目标曹方据点 id。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "event",
+          "type": "object | null",
+          "desc": "当前 / 最近一场战场：{ id, script: guandu|dongzhuo|chibi, name, status: signup|active|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan|cao|null, finishReason: score|base_captured|null, underdog: { camp, multiplier } | null, wind: 赤壁专有 { direction: se|nw, label, bonusCamp, nextAt, noticeAt }（其他剧本为 null） }。从未开过为 null。"
+        },
+        {
+          "name": "nextSignupAt",
+          "type": "string",
+          "desc": "下一场报名开始时刻（北京时间每周二 20:00）。"
+        },
+        {
+          "name": "nextScript",
+          "type": "'guandu' | 'dongzhuo' | 'chibi'",
+          "desc": "下一场的剧本（轮换预告）。"
+        },
+        {
+          "name": "strongholds",
+          "type": "array",
+          "desc": "本场据点（官渡 9 个 / 讨董 3 关 / 赤壁 10 个；讨董按推进线顺序）：{ id, name, kind: base|ford|post|granary, x, y, ownerCamp: yuan|cao|null（null = 中立 NPC；讨董的董卓军也是 null）, pointsPerHour, garrison（全兵种计数，NPC + 玩家据守合计）, garrisonPower（参考战力）, wallLevel, towerLevel, firstCaptureAvailable（首占 +200 军功还没被拿过）, capturedAt, unlocked（讨董：前一关未打下为 false；其他剧本恒为 true）, chainUntil（赤壁曹方连锁截止，其他 null）, fireNextAt（赤壁火攻冷却截止，其他 null） }。"
+        },
+        {
+          "name": "me",
+          "type": "object | null",
+          "desc": "本场我的状态：{ accountId, username, camp, merit 本场军功, rank 本场名次（未入场为 null）, entered, squads: [{ id, x, y, status: marching|idle|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 }；未报名为 null。"
+        },
+        {
+          "name": "top",
+          "type": "array",
+          "desc": "本场军功榜前 10：{ rank, accountId, username, camp, merit }（同分并列，军功 0 不上榜）。"
+        },
+        {
+          "name": "shop",
+          "type": "object",
+          "desc": "战场商店（赤壁多一个 iron_cavalry）：{ cumulativeMerit, items: [{ item: resources|hero_exp|swordsman|cavalry|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。"
+        },
+        {
+          "name": "rewards",
+          "type": "object",
+          "desc": "奖励表：{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }]（讨董的全服进度档；其他剧本为空数组） }。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "BATTLEFIELD_NOT_ACTIVE",
+        "BATTLEFIELD_SKILL_UNAVAILABLE",
+        "BATTLEFIELD_NOT_JOINED",
+        "BATTLEFIELD_NOT_ENTERED",
+        "BATTLEFIELD_WIND_MISMATCH",
+        "BATTLEFIELD_TARGET_INVALID",
+        "BATTLEFIELD_FIRE_COOLDOWN",
+        "BATTLEFIELD_MERIT_INSUFFICIENT"
+      ],
+      "examples": [
+        {
+          "caption": "东南风期间火攻相邻的巴丘据点",
+          "request": {
+            "op": 139,
+            "seq": 36,
+            "data": {
+              "strongholdId": "cao_2"
+            }
+          },
+          "responses": [
+            {
+              "op": 139,
+              "seq": 36,
+              "ok": true,
+              "data": {
+                "event": {
+                  "id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                  "script": "guandu",
+                  "name": "官渡之战",
+                  "status": "active",
+                  "signupStartAt": "2026-09-24T08:00:00.000Z",
+                  "startAt": "2026-09-25T08:00:00.000Z",
+                  "endAt": "2026-09-26T08:00:00.000Z",
+                  "camps": {
+                    "yuan": {
+                      "camp": "yuan",
+                      "name": "袁绍军",
+                      "signups": 12,
+                      "entered": 10,
+                      "score": 180
+                    },
+                    "cao": {
+                      "camp": "cao",
+                      "name": "曹操军",
+                      "signups": 15,
+                      "entered": 13,
+                      "score": 240
+                    }
+                  },
+                  "winner": null,
+                  "finishReason": null,
+                  "underdog": null
+                },
+                "strongholds": [
+                  {
+                    "id": "cao_2",
+                    "name": "曹操据点·巴丘",
+                    "kind": "ford",
+                    "x": 23,
+                    "y": 15,
+                    "ownerCamp": "cao",
+                    "pointsPerHour": 10,
+                    "garrison": {
+                      "porter": 0,
+                      "militia": 96,
+                      "scout": 0,
+                      "pikeman": 0,
+                      "swordsman": 40,
+                      "archer": 48,
+                      "cavalry": 15,
+                      "iron_cavalry": 0,
+                      "supply_wagon": 0,
+                      "ballista": 0,
+                      "siege_ram": 0,
+                      "yulin_guard": 0,
+                      "danyang_soldier": 0,
+                      "baimao_soldier": 0,
+                      "huwei_guard": 0,
+                      "zhuge_crossbow": 0,
+                      "xiandeng_warrior": 0,
+                      "hubao_cavalry": 0,
+                      "xiliang_cavalry": 0
+                    },
+                    "garrisonPower": 560,
+                    "wallLevel": 0,
+                    "towerLevel": 0,
+                    "firstCaptureAvailable": false,
+                    "capturedAt": "2026-09-25T08:00:00.000Z",
+                    "chainUntil": null,
+                    "fireNextAt": "2026-09-25T10:00:00.000Z",
+                    "unlocked": true
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      ],
+      "agentNote": "火攻前先看 event.wind：只有东南风能用，西北风要等下一次切换（event.wind.nextAt）。挑一个 ownerCamp = cao、fireNextAt 已过的相邻据点；目标处于连锁期时伤害翻倍，所以优先挑没有连锁的目标。每次 300 军功，冷却中的目标别反复尝试。"
+    },
+    {
+      "op": 140,
+      "kind": "request",
+      "name": "CHAIN_BATTLEFIELD_STRONGHOLD",
+      "title": "赤壁连锁战船（v80，AISLG-199）",
+      "preAuth": false,
+      "summary": "仅赤壁场次、曹操军（me.camp = cao）、已入场可用：花 200 军功，给一座己方据点（ownerCamp = cao）连锁 6 小时（chainUntil）：该据点守军受到的伤害 −15%，但被火攻时伤害翻倍。连锁期间不能重复连锁（BATTLEFIELD_CHAIN_ACTIVE）；据点易手后连锁立即失效。",
+      "requestFields": [
+        {
+          "name": "strongholdId",
+          "type": "string",
+          "desc": "必填。己方据点 id。"
+        }
+      ],
+      "dataFields": [
+        {
+          "name": "event",
+          "type": "object | null",
+          "desc": "当前 / 最近一场战场：{ id, script: guandu|dongzhuo|chibi, name, status: signup|active|finished, signupStartAt, startAt, endAt, camps: { yuan: { camp, name, signups, entered, score }, cao: 同结构 }, winner: yuan|cao|null, finishReason: score|base_captured|null, underdog: { camp, multiplier } | null, wind: 赤壁专有 { direction: se|nw, label, bonusCamp, nextAt, noticeAt }（其他剧本为 null） }。从未开过为 null。"
+        },
+        {
+          "name": "nextSignupAt",
+          "type": "string",
+          "desc": "下一场报名开始时刻（北京时间每周二 20:00）。"
+        },
+        {
+          "name": "nextScript",
+          "type": "'guandu' | 'dongzhuo' | 'chibi'",
+          "desc": "下一场的剧本（轮换预告）。"
+        },
+        {
+          "name": "strongholds",
+          "type": "array",
+          "desc": "本场据点（官渡 9 个 / 讨董 3 关 / 赤壁 10 个；讨董按推进线顺序）：{ id, name, kind: base|ford|post|granary, x, y, ownerCamp: yuan|cao|null（null = 中立 NPC；讨董的董卓军也是 null）, pointsPerHour, garrison（全兵种计数，NPC + 玩家据守合计）, garrisonPower（参考战力）, wallLevel, towerLevel, firstCaptureAvailable（首占 +200 军功还没被拿过）, capturedAt, unlocked（讨董：前一关未打下为 false；其他剧本恒为 true）, chainUntil（赤壁曹方连锁截止，其他 null）, fireNextAt（赤壁火攻冷却截止，其他 null） }。"
+        },
+        {
+          "name": "me",
+          "type": "object | null",
+          "desc": "本场我的状态：{ accountId, username, camp, merit 本场军功, rank 本场名次（未入场为 null）, entered, squads: [{ id, x, y, status: marching|idle|garrison, troops, targetX, targetY, targetStrongholdId, arriveAt, originX, originY, strongholdId }], cumulativeMerit 跨场军功余额 }；未报名为 null。"
+        },
+        {
+          "name": "top",
+          "type": "array",
+          "desc": "本场军功榜前 10：{ rank, accountId, username, camp, merit }（同分并列，军功 0 不上榜）。"
+        },
+        {
+          "name": "shop",
+          "type": "object",
+          "desc": "战场商店（赤壁多一个 iron_cavalry）：{ cumulativeMerit, items: [{ item: resources|hero_exp|swordsman|cavalry|iron_cavalry, label, cost, limit, bought 本场已买, reward: { resources? , heroExp?, troop?, count? } }] }。"
+        },
+        {
+          "name": "rewards",
+          "type": "object",
+          "desc": "奖励表：{ winner { label, gold, resourcesEach }, loser 同结构, rankTiers: [{ label, rank, maxRank, gold, resourcesEach }], progressTiers: [{ label, progress, gold, resourcesEach }]（讨董的全服进度档；其他剧本为空数组） }。"
+        }
+      ],
+      "errors": [
+        "INVALID_PARAMS",
+        "BATTLEFIELD_NOT_ACTIVE",
+        "BATTLEFIELD_SKILL_UNAVAILABLE",
+        "BATTLEFIELD_NOT_JOINED",
+        "BATTLEFIELD_NOT_ENTERED",
+        "BATTLEFIELD_TARGET_INVALID",
+        "BATTLEFIELD_CHAIN_ACTIVE",
+        "BATTLEFIELD_MERIT_INSUFFICIENT"
+      ],
+      "examples": [
+        {
+          "caption": "给江陵据点连锁战船",
+          "request": {
+            "op": 140,
+            "seq": 37,
+            "data": {
+              "strongholdId": "cao_1"
+            }
+          },
+          "responses": [
+            {
+              "op": 140,
+              "seq": 37,
+              "ok": true,
+              "data": {
+                "event": {
+                  "id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+                  "script": "guandu",
+                  "name": "官渡之战",
+                  "status": "active",
+                  "signupStartAt": "2026-09-24T08:00:00.000Z",
+                  "startAt": "2026-09-25T08:00:00.000Z",
+                  "endAt": "2026-09-26T08:00:00.000Z",
+                  "camps": {
+                    "yuan": {
+                      "camp": "yuan",
+                      "name": "袁绍军",
+                      "signups": 12,
+                      "entered": 10,
+                      "score": 180
+                    },
+                    "cao": {
+                      "camp": "cao",
+                      "name": "曹操军",
+                      "signups": 15,
+                      "entered": 13,
+                      "score": 240
+                    }
+                  },
+                  "winner": null,
+                  "finishReason": null,
+                  "underdog": null
+                },
+                "strongholds": [
+                  {
+                    "id": "cao_1",
+                    "name": "曹操据点·江陵",
+                    "kind": "ford",
+                    "x": 23,
+                    "y": 5,
+                    "ownerCamp": "cao",
+                    "pointsPerHour": 10,
+                    "garrison": {
+                      "porter": 0,
+                      "militia": 96,
+                      "scout": 0,
+                      "pikeman": 0,
+                      "swordsman": 40,
+                      "archer": 48,
+                      "cavalry": 15,
+                      "iron_cavalry": 0,
+                      "supply_wagon": 0,
+                      "ballista": 0,
+                      "siege_ram": 0,
+                      "yulin_guard": 0,
+                      "danyang_soldier": 0,
+                      "baimao_soldier": 0,
+                      "huwei_guard": 0,
+                      "zhuge_crossbow": 0,
+                      "xiandeng_warrior": 0,
+                      "hubao_cavalry": 0,
+                      "xiliang_cavalry": 0
+                    },
+                    "garrisonPower": 560,
+                    "wallLevel": 0,
+                    "towerLevel": 0,
+                    "firstCaptureAvailable": false,
+                    "capturedAt": "2026-09-25T08:00:00.000Z",
+                    "chainUntil": "2026-09-25T14:00:00.000Z",
+                    "fireNextAt": null,
+                    "unlocked": true
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      ],
+      "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 排队；v71 起也含建造中）。建成后的产量、人口上限或仓储上限变化不逐条推送，客户端用 GET_STATE 或本地按 city.production / city.population / city.storage 推算。",
+      "dataFields": [
+        {
+          "name": "reason",
+          "type": "'build_started' | 'build_queued' | 'build_completed' | 'build_cancelled'",
+          "desc": "触发本次推送的状态变化。"
+        },
+        {
+          "name": "build",
+          "type": "object",
+          "desc": "建造视图，字段与 BUILD 响应的 build 相同；完成时 status 为 completed 且 completedAt 非空，排队时 status 为 queued 且 dueAt 为 null，取消时 status 为 cancelled。"
+        }
+      ],
+      "examples": [
+        {
+          "op": 2000,
+          "push": true,
+          "data": {
+            "reason": "build_started",
+            "build": {
+              "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
+              "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
+              "kind": "quarry",
+              "status": "building",
+              "level": 1,
+              "toLevel": null,
+              "initiator": "agent",
+              "startedAt": "2026-09-25T08:00:00.000Z",
+              "dueAt": "2026-09-25T08:01:00.000Z",
+              "completedAt": null
+            }
+          }
+        },
+        {
+          "op": 2000,
+          "push": true,
+          "data": {
+            "reason": "build_queued",
+            "build": {
+              "id": "8d0f7790-8536-51ef-a5ef-f18bd2a01b8f",
+              "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
+              "kind": "lumber_mill",
+              "status": "queued",
+              "level": 1,
+              "toLevel": null,
+              "initiator": "player",
+              "startedAt": "2026-09-25T08:00:30.000Z",
+              "dueAt": null,
+              "completedAt": null
+            }
+          }
+        },
+        {
+          "op": 2000,
+          "push": true,
+          "data": {
+            "reason": "build_completed",
+            "build": {
+              "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
+              "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
+              "kind": "farm",
+              "status": "completed",
+              "level": 1,
+              "toLevel": null,
+              "initiator": "agent",
+              "startedAt": "2026-09-25T08:00:00.000Z",
+              "dueAt": "2026-09-25T08:01:00.000Z",
+              "completedAt": "2026-09-25T08:01:05.000Z"
+            }
+          }
+        },
+        {
+          "op": 2000,
+          "push": true,
+          "data": {
+            "reason": "build_cancelled",
+            "build": {
+              "id": "8d0f7790-8536-51ef-a5ef-f18bd2a01b8f",
+              "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
+              "kind": "lumber_mill",
+              "status": "cancelled",
+              "level": 1,
+              "toLevel": null,
+              "initiator": "player",
+              "startedAt": "2026-09-25T08:00:30.000Z",
+              "dueAt": null,
+              "completedAt": null
+            }
+          }
+        }
+      ],
+      "agentNote": "完成时间不保证精确：Worker 按到期时间结算，存在正常延迟；对时间敏感的决策用 GET_STATE 查询权威状态。"
+    },
+    {
+      "op": 2001,
+      "kind": "push",
+      "name": "PUSH_AGENT_STATUS",
+      "title": "推送：Agent 在线状态变化",
+      "summary": "该账号的 Agent 在线状态发生**翻转**（首个 Agent 连接上线 / 最后一个 Agent 连接离线）时，推送给账号所有在线连接（v21 起翻转才推，多开连接的增减不再逐次推送；eventId 用于多连接去重）。",
+      "dataFields": [
+        {
+          "name": "online",
+          "type": "boolean",
+          "desc": "推送时刻该账号是否存在在线的 Agent 连接（账号级聚合，非单连接）。"
+        },
+        {
+          "name": "connectionCount",
+          "type": "number",
+          "desc": "推送时刻该账号的在线连接数（v21 新增，含玩家与 Agent 连接；非翻转的连接数变化不推送，精确值以重新登录或 GET_AGENT_INFO 为准）。"
+        },
+        {
+          "name": "at",
+          "type": "string",
+          "desc": "推送时间（ISO 8601）。"
+        }
+      ],
+      "examples": [
+        {
+          "op": 2001,
+          "push": true,
+          "data": {
+            "online": true,
+            "connectionCount": 1,
+            "at": "2026-09-25T08:00:10.123Z"
+          }
+        },
+        {
+          "op": 2001,
+          "push": true,
+          "data": {
+            "online": false,
+            "connectionCount": 0,
+            "at": "2026-09-25T09:00:00.000Z"
+          }
+        }
+      ],
+      "agentNote": "收到 online=false 表示该账号的全部 Agent 连接都已离线。多连接去重用帧顶层的 eventId。"
+    },
+    {
+      "op": 2002,
+      "kind": "push",
+      "name": "PUSH_CITY_STATE",
+      "title": "推送：城池级状态变化",
+      "summary": "城池级状态变化时推送给该账号所有在线连接（发起连接除外）：city_renamed=城池改名（RENAME_CITY）、account_reset=账号数据被 RESET_ACCOUNT 重置（v9，重置后全部游戏数据回到开号初始状态）、city_discarded=分城被放弃（DISCARD_CITY，v57；推送只带 cityId，收到后用 GET_STATE 刷新城池列表）。建造队列相关变化走 PUSH_BUILD_STATE。推送只携带变化摘要，完整现状用 GET_STATE 查询。",
+      "dataFields": [
+        {
+          "name": "reason",
+          "type": "'city_renamed' | 'account_reset' | 'city_discarded'",
+          "desc": "触发本次推送的状态变化。"
+        },
+        {
+          "name": "cityId",
+          "type": "string",
+          "desc": "城池 UUID。"
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "desc": "reason=city_renamed 时的新城池名。"
+        }
+      ],
+      "examples": [
+        {
+          "op": 2002,
+          "push": true,
+          "data": {
+            "reason": "city_renamed",
+            "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
             "name": "临江城"
           }
         },
@@ -14592,6 +17717,133 @@
         }
       ],
       "agentNote": "只作提示；需要完整列表时 GET_ALLIANCE_MARKS。"
+    },
+    {
+      "op": 2026,
+      "kind": "push",
+      "name": "PUSH_DEFENSE_STATE",
+      "title": "推送：打造状态变化（v73，AISLG-193）",
+      "summary": "打造开始 / 入队 / 完成入库 / 取消时推给同账号全部在线连接（发起连接已拿到响应，不回推）。收到后建议 GET_STATE 重新对齐 city.defenses。",
+      "dataFields": [
+        {
+          "name": "reason",
+          "type": "'craft_started' | 'craft_queued' | 'craft_completed' | 'craft_cancelled'",
+          "desc": "开工（含排队条目被激活）/ 入队 / 完成入库 / 取消返还。"
+        },
+        {
+          "name": "craft",
+          "type": "object",
+          "desc": "打造条目视图（结构同 CRAFT_DEFENSE 的 craft）。"
+        },
+        {
+          "name": "stock",
+          "type": "object",
+          "desc": "该城当前四种器械的已入库件数。"
+        },
+        {
+          "name": "cap",
+          "type": "number",
+          "desc": "该城库存上限（城墙等级 × 60）。"
+        }
+      ],
+      "examples": [
+        {
+          "op": 2026,
+          "push": true,
+          "data": {
+            "reason": "craft_completed",
+            "craft": {
+              "id": "3f7c9a1e-2d4b-4c6a-9e8f-1a2b3c4d5e6f",
+              "cityId": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
+              "kind": "trap",
+              "count": 10,
+              "status": "completed",
+              "initiator": "player",
+              "cost": {
+                "gold": 200,
+                "wood": 600,
+                "food": 0,
+                "stone": 0,
+                "iron": 400
+              },
+              "unitSeconds": 5,
+              "startedAt": "2026-09-25T08:00:00.000Z",
+              "dueAt": "2026-09-25T08:00:50.000Z",
+              "completedAt": "2026-09-25T08:00:50.000Z"
+            },
+            "stock": {
+              "trap": 10,
+              "chevaux": 0,
+              "rolling_log": 0,
+              "boulder": 0
+            },
+            "cap": 600
+          }
+        }
+      ]
+    },
+    {
+      "op": 2027,
+      "kind": "push",
+      "name": "PUSH_BATTLEFIELD_STATE",
+      "title": "推送：剧本战场报名 / 开战 / 据点易手 / 收场 / 赤壁风向（v75，AISLG-198；v80）",
+      "summary": "报名开始、开战、据点易手（含大营被攻破、火攻 / 连锁）、战场收场，以及赤壁风向切换与切换前 30 分钟预告时推给全部在线连接；载荷里的 event 与 GET_BATTLEFIELD 的 event 同结构。",
+      "dataFields": [
+        {
+          "name": "reason",
+          "type": "'signup' | 'started' | 'stronghold' | 'finished' | 'wind'",
+          "desc": "报名 / 开战 / 据点易手（含火攻、连锁） / 收场 / 风向（赤壁切换或预告）。"
+        },
+        {
+          "name": "event",
+          "type": "object",
+          "desc": "战场视图（结构同 GET_BATTLEFIELD 的 event）。"
+        },
+        {
+          "name": "strongholdId",
+          "type": "string",
+          "desc": "reason=stronghold 时易手的据点 id。"
+        }
+      ],
+      "examples": [
+        {
+          "op": 2027,
+          "push": true,
+          "data": {
+            "reason": "stronghold",
+            "event": {
+              "id": "9b2f4c1a-6d3e-4f80-9a71-2c5e8d4b6a10",
+              "script": "guandu",
+              "name": "官渡之战",
+              "status": "active",
+              "signupStartAt": "2026-09-24T08:00:00.000Z",
+              "startAt": "2026-09-25T08:00:00.000Z",
+              "endAt": "2026-09-26T08:00:00.000Z",
+              "camps": {
+                "yuan": {
+                  "camp": "yuan",
+                  "name": "袁绍军",
+                  "signups": 12,
+                  "entered": 10,
+                  "score": 180
+                },
+                "cao": {
+                  "camp": "cao",
+                  "name": "曹操军",
+                  "signups": 15,
+                  "entered": 13,
+                  "score": 240
+                }
+              },
+              "winner": null,
+              "finishReason": null,
+              "underdog": null
+            },
+            "strongholdId": "ford_yanjin"
+          }
+        }
+      ],
+      "agentNote": "推送只带事件摘要与据点 id，收到后重查 GET_BATTLEFIELD 拿完整据点守军、自己的队伍与军功。漏收时定时重查即可。"
     }
   ],
   "errorCodes": {
@@ -14987,6 +18239,190 @@
       "desc": "（v47）该站点不开放账号密码登录：游戏有两个站（同一套服务与数据库、账号通用），国际站 slg.yuntianyou.cc 只有 Google / GitHub 登录，国内站才有账号密码。",
       "action": "网页端改用 Google / GitHub 登录；老密码账号先在国内站登录并绑定 Google / GitHub，再来本站用绑定方式登录进同一个号。Agent 不涉及（Agent 只用令牌）。"
     },
+    "WALL_NOT_BUILT": {
+      "desc": "（v73，AISLG-193）城墙尚未建造：四种城防器械只能囤在城墙里，城墙 0 级时库存上限为 0，不能打造。响应的 data 附 cap（= 0）。",
+      "action": "先建造并升级城墙再打造器械；城墙等级同时也是库存上限（每级 60 件，四种共用）。"
+    },
+    "DEFENSE_STOCK_FULL": {
+      "desc": "（v73，AISLG-193）库存 + 在造 + 本次数量超过上限（城墙等级 × 60，四种器械共用）。响应的 data 附 cap / stock（已入库合计）/ pending（在造 + 排队合计）。",
+      "action": "减少本次件数，或先把库存用在守城（守城战自动消耗）后再生出；升级城墙可提高上限。"
+    },
+    "DEFENSE_QUEUE_FULL": {
+      "desc": "（v73，AISLG-193）打造队列已满：与征兵同规则，同一时间 1 条在造 + 最多 2 条排队。",
+      "action": "等队首完成（或取消已有条目腾位置）后再发起。"
+    },
+    "DEFENSE_NOT_CANCELLABLE": {
+      "desc": "（v73，AISLG-193）没有可取消的打造条目：条目不存在、不属于本账号，或已完成 / 已取消。",
+      "action": "用 GET_STATE 的 city.defenses.queue 取当前条目的 craftId 再取消；已完成 / 已取消的不要重试。"
+    },
+    "ASSIST_NOT_ALLY": {
+      "desc": "（v74，AISLG-194）协防目标不是盟友的城池：MARCH task=assist 只能派往同一联盟成员的城（自己的城请用 transfer 调兵）。",
+      "action": "确认目标城的主人与你同属一个联盟；不是盟友就换目标，或先拉对方入盟。"
+    },
+    "ASSIST_LIMIT": {
+      "desc": "（v74，AISLG-194）协防名额已满：每座城最多接收 5 支协防部队（在途部队也计入），同一账号对同一座城最多 1 支。到达时复核不通过，部队原路返回（事件 cause=ASSIST_LIMIT）。",
+      "action": "换一座盟友城协防，或等该城已有部队召回 / 遣返后再派；同一座城不要重复派第二支。"
+    },
+    "ASSIST_NOT_FOUND": {
+      "desc": "（v74，AISLG-194）协防部队不存在、已经返回（战斗全灭 / 主动召回 / 退盟 / 放弃分城自动遣返 / 分城被占领时随城覆灭），或不属于你（只有派出方与城主能召回 / 遣返）。",
+      "action": "重新 GET_STATE / GET_TILE 拿最新的 assistIn / assistOut 列表后再操作。"
+    },
+    "BATTLEFIELD_GOVERNMENT_TOO_LOW": {
+      "desc": "（v75，AISLG-198）报名剧本战场要求主城官府 ≥ 5 级；响应附 required / current。",
+      "action": "先升级主城官府到 5 级；分城官府不计。"
+    },
+    "BATTLEFIELD_SIGNUP_CLOSED": {
+      "desc": "（v75，AISLG-198）当前不在剧本战场的报名期（北京时间每周二 20:00 至周三 20:00）。",
+      "action": "用 GET_BATTLEFIELD 的 nextSignupAt 等下一场报名；报名开始后 SERVER 会全服播报。"
+    },
+    "BATTLEFIELD_ALREADY_JOINED": {
+      "desc": "（v75，AISLG-198）本场已经报过名（阵营选定后不能改）。",
+      "action": "直接 GET_BATTLEFIELD 查自己的阵营与队伍，或等开战后入场。"
+    },
+    "BATTLEFIELD_NOT_JOINED": {
+      "desc": "（v75，AISLG-198）没有报名本场战场，不能入场或操作队伍。",
+      "action": "先在报名期 SIGNUP_BATTLEFIELD 选阵营。"
+    },
+    "BATTLEFIELD_CAMP_FULL": {
+      "desc": "（v75，AISLG-198）该阵营报名人数超过另一方 1.5 倍且多出 5 人以上，暂停报名；响应附 count / otherCount / limit。",
+      "action": "改选另一方；或等双方人数接近后再报名。"
+    },
+    "BATTLEFIELD_ENTRY_CLOSED": {
+      "desc": "（v75，AISLG-198）战场已经开战，不能再带部队入场（报名期结束即锁死入场）。",
+      "action": "本场只能在已入场的队伍里拆队 / 行军；下一场报名时再入场。"
+    },
+    "BATTLEFIELD_ALREADY_ENTERED": {
+      "desc": "（v75，AISLG-198）本场已经带过部队入场（每人每场只能入场一次，开战后也不能追加）。",
+      "action": "用 SPLIT_BATTLEFIELD_SQUAD 拆分已有队伍，或等下一场。"
+    },
+    "BATTLEFIELD_POPULATION_LIMIT": {
+      "desc": "（v75，AISLG-198）带入部队的人口超过 3000；响应附 limit / current。",
+      "action": "减少铁骑兵等高人口兵种的数量，或只带主力兵种。"
+    },
+    "BATTLEFIELD_SQUAD_LIMIT": {
+      "desc": "（v75，AISLG-198）每人最多 3 支队伍。",
+      "action": "把要拆出的兵力并回现有队伍，或等有队伍阵亡后再拆。"
+    },
+    "BATTLEFIELD_SQUAD_NOT_FOUND": {
+      "desc": "（v75，AISLG-198）队伍不存在、已阵亡，或不属于本账号。",
+      "action": "重新 GET_BATTLEFIELD 拿最新队伍列表。"
+    },
+    "BATTLEFIELD_SQUAD_BUSY": {
+      "desc": "（v75，AISLG-198）队伍正在行军，不能再次下令。",
+      "action": "等 arriveAt 到达后再下令。"
+    },
+    "BATTLEFIELD_UNREACHABLE": {
+      "desc": "（v75，AISLG-198）目标不可达：30×30 地图中间的河只有 3 处渡口（y = 5 / 15 / 25）能过，或坐标越界。",
+      "action": "先走到渡口再渡河，或改选同侧目标。"
+    },
+    "BATTLEFIELD_NOT_ACTIVE": {
+      "desc": "（v75，AISLG-198）剧本战场不在进行中（报名期或已结束）。",
+      "action": "报名期只做报名 / 入场；行军与攻打在开战后才能做。"
+    },
+    "BATTLEFIELD_SHOP_LIMIT": {
+      "desc": "（v75，AISLG-198）本场该商品已达到限购数量。",
+      "action": "换其他商品，或等下一场额度重置（军功余额跨场保留）。"
+    },
+    "BATTLEFIELD_MERIT_INSUFFICIENT": {
+      "desc": "（v75，AISLG-198）战场军功余额不足；响应附 cost / balance。",
+      "action": "继续在战场里歼灭敌军攒军功；军功跨场累积、换季清零。"
+    },
+    "BATTLEFIELD_TARGET_INVALID": {
+      "desc": "（v75，AISLG-198）行军目标参数缺失或对不上：必须给 strongholdId，或给合法的 x / y。",
+      "action": "用 GET_BATTLEFIELD 的 strongholds 里的 id / 坐标重发。"
+    },
+    "BATTLEFIELD_STRONGHOLD_LOCKED": {
+      "desc": "（v80，AISLG-199）讨伐董卓的关卡按顺序解锁：汜水关 → 虎牢关 → 洛阳，前一关没被讨董联军打下时不能攻打（GET_BATTLEFIELD 的 strongholds[].unlocked 为 false）。",
+      "action": "先攻下前一关（看 strongholds 里 unlocked 为 true 的据点再下令）。"
+    },
+    "BATTLEFIELD_WIND_MISMATCH": {
+      "desc": "（v80，AISLG-199）赤壁火攻只能在东南风期间发动（event.wind.direction = se）。",
+      "action": "等下一次风向切换（event.wind.nextAt）再发动，切换前 30 分钟会预告。"
+    },
+    "BATTLEFIELD_FIRE_COOLDOWN": {
+      "desc": "（v80，AISLG-199）同一目标据点每 2 小时最多被火攻一次；响应附 nextAt。",
+      "action": "换一个目标，或等 nextAt 之后再火攻。"
+    },
+    "BATTLEFIELD_CHAIN_ACTIVE": {
+      "desc": "（v80，AISLG-199）该据点的连锁战船仍在生效（6 小时内不能重复连锁）；响应附 chainUntil。",
+      "action": "等 chainUntil 之后再连锁；连锁期内被火攻伤害翻倍，留意守军。"
+    },
+    "BATTLEFIELD_SKILL_UNAVAILABLE": {
+      "desc": "（v80，AISLG-199）本场剧本没有这个技能（只有赤壁有火攻 / 连锁），或阵营不对：火攻只给孙刘方，连锁只给曹方。",
+      "action": "看 event.script 与自己的 me.camp 再发。"
+    },
+    "BATTLEFIELD_NOT_ENTERED": {
+      "desc": "（v80，AISLG-199）报名了但还没带兵入场，不能使用战场技能。",
+      "action": "本场已开战就只能等下一场；报名期内要在开战前 ENTER_BATTLEFIELD。"
+    },
+    "LUOYANG_CLOSED": {
+      "desc": "（v79，AISLG-200）洛阳只在每周六 21:00–23:00（北京时间现实时间）开放攻打 / 侦察；响应附 nextOpenAt / retryAfterSeconds。",
+      "action": "等到 nextOpenAt 再发起。窗口内洛阳没有被动免战、城防不回涨。"
+    },
+    "DECREE_NOT_HOLDER": {
+      "desc": "（v79，AISLG-200）只有洛阳之主联盟的盟主可以发布政令。",
+      "action": "先占领洛阳，且由该联盟盟主操作。"
+    },
+    "DECREE_COOLDOWN": {
+      "desc": "（v79，AISLG-200）政令每 7 天只能发布一次；响应附 nextAt / retryAfterSeconds。",
+      "action": "等 nextAt 之后再发。"
+    },
+    "MARKET_LOCKED": {
+      "desc": "（v78，AISLG-196）交易所需要主城官府 ≥ 5 级且不在新手保护期；响应附 reason / government / required。",
+      "action": "升级主城官府或等新手保护结束后再来。"
+    },
+    "PRICE_OUT_OF_RANGE": {
+      "desc": "（v78，AISLG-196）单价超出允许范围：资源之间 0.5–2，收金币 0.125–0.5；响应附 min / max。",
+      "action": "按 GET_MARKET 的 limits.priceRangeResource / priceRangeGold 调整单价。"
+    },
+    "ORDER_LIMIT": {
+      "desc": "（v78，AISLG-196）同时挂单已达 5 张。",
+      "action": "先撤单或等成交后再挂。"
+    },
+    "DAILY_TRADE_LIMIT": {
+      "desc": "（v78，AISLG-196）今日成交额度不足（主城官府等级 × 3000 × 缩放，买卖合计）；响应附 limit / used / remaining。",
+      "action": "明天（北京日）额度重置后再交易；额度按卖出资源数量折算、买卖双方都计。"
+    },
+    "ORDER_NOT_FOUND": {
+      "desc": "（v78，AISLG-196）挂单不存在、已售罄、已过期或不属于你。",
+      "action": "重新 GET_MARKET 拉最新挂单；过期挂单会自动退款。"
+    },
+    "MARKET_ALLY_ONLY": {
+      "desc": "（v78，AISLG-196）挂单勾选了「只卖给盟友」，你与卖家不在同一个联盟。",
+      "action": "换一张公开挂单，或加入卖家所在联盟。"
+    },
+    "ORDER_NOT_CANCELLABLE": {
+      "desc": "（v78，AISLG-196）挂单已售罄或已过期，无法撤回。",
+      "action": "刷新挂单列表确认状态。"
+    },
+    "DIPLOMACY_LIMIT": {
+      "desc": "（v77，AISLG-195）友盟 / 敌对数量已达上限（每联盟最多 2 个友盟、5 个敌对），响应附 limit。",
+      "action": "先解除一个现有关系，再结新友盟 / 宣布新敌对。"
+    },
+    "DIPLOMACY_COOLDOWN": {
+      "desc": "（v77，AISLG-195）刚解除友好，72 小时内同一对联盟不能再次结好；响应附 refriendAfter / retryAfterSeconds。",
+      "action": "等到 refriendAfter 之后再发邀请 / 同意邀请。"
+    },
+    "DIPLOMACY_EXISTS": {
+      "desc": "（v77，AISLG-195）与目标联盟已经是友盟 / 敌对，或已有待处理邀请。",
+      "action": "用 GET_ALLIANCE_DIPLOMACY 查当前关系与邀请，避免重复操作。"
+    },
+    "DIPLOMACY_INVITE_NOT_FOUND": {
+      "desc": "（v77，AISLG-195）友好邀请不存在、已过期（48 小时）或已处理。",
+      "action": "重新发起邀请；过期邀请不会出现在 GET_ALLIANCE_DIPLOMACY 里。"
+    },
+    "NOBILITY_TOO_LOW": {
+      "desc": "（v76，AISLG-197）爵位不足：占领名城需要「大夫」（爵位序号 3）及以上；响应附 required / current。攻打外围与掠夺不受限。",
+      "action": "先在世界地图战斗里累计声望升到大夫（2000 声望）再来占领名城。"
+    },
+    "NOBILITY_SALARY_CLAIMED": {
+      "desc": "（v76，AISLG-197）今日（北京日）俸禄已领，响应附 nextClaimAt。",
+      "action": "明天北京时间 0 点后再领；金额随爵位提高。"
+    },
+    "NOBILITY_SALARY_NONE": {
+      "desc": "（v76，AISLG-197）平民没有俸禄，需要先累计 100 声望升到公士。",
+      "action": "打世界地图战斗或参加剧本战场攒声望。"
+    },
     "INTERNAL": {
       "desc": "服务端内部错误。",
       "action": "可稍后重试同一请求；持续出现时向运营方反馈。INTERNAL 可能出现在任何请求的响应中。"
@@ -15205,6 +18641,11 @@
                 "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                 "name": "主城",
                 "level": 1,
+                "title": "城池",
+                "nobility": {
+                  "index": 0,
+                  "name": "平民"
+                },
                 "resources": {
                   "gold": 2000,
                   "wood": 2000,
@@ -15495,6 +18936,7 @@
                 "durability": null,
                 "famousName": null,
                 "productionBonusPercent": 0,
+                "luoyangBonusPercent": 0,
                 "famousEffect": null,
                 "starveAt": null,
                 "mutinyNextAt": null,
@@ -15510,9 +18952,33 @@
                   "marching": 0,
                   "storage": 0,
                   "scouting": 0,
-                  "defense": 0
+                  "defense": 0,
+                  "drill": 0,
+                  "combat": 0,
+                  "protection": 0,
+                  "riding": 0,
+                  "archery": 0,
+                  "supply": 0,
+                  "construction": 0,
+                  "research": 0,
+                  "looting": 0,
+                  "repair": 0
                 },
                 "recruitQueue": [],
+                "defenses": {
+                  "cap": 0,
+                  "stock": {
+                    "trap": 0,
+                    "chevaux": 0,
+                    "rolling_log": 0,
+                    "boulder": 0
+                  },
+                  "total": 0,
+                  "queue": []
+                },
+                "assistIn": [],
+                "assistOut": [],
+                "assistCap": 5,
                 "defenseBonus": 0,
                 "marches": [],
                 "territory": [],
@@ -15803,6 +19269,11 @@
                 "id": "c8a1f1de-3b2a-4c5d-8e9f-0a1b2c3d4e5f",
                 "name": "主城",
                 "level": 1,
+                "title": "城池",
+                "nobility": {
+                  "index": 0,
+                  "name": "平民"
+                },
                 "resources": {
                   "gold": 1780,
                   "wood": 1910,
@@ -16093,6 +19564,7 @@
                 "durability": null,
                 "famousName": null,
                 "productionBonusPercent": 0,
+                "luoyangBonusPercent": 0,
                 "famousEffect": null,
                 "starveAt": null,
                 "mutinyNextAt": null,
@@ -16108,9 +19580,33 @@
                   "marching": 0,
                   "storage": 0,
                   "scouting": 0,
-                  "defense": 0
+                  "defense": 0,
+                  "drill": 0,
+                  "combat": 0,
+                  "protection": 0,
+                  "riding": 0,
+                  "archery": 0,
+                  "supply": 0,
+                  "construction": 0,
+                  "research": 0,
+                  "looting": 0,
+                  "repair": 0
                 },
                 "recruitQueue": [],
+                "defenses": {
+                  "cap": 0,
+                  "stock": {
+                    "trap": 0,
+                    "chevaux": 0,
+                    "rolling_log": 0,
+                    "boulder": 0
+                  },
+                  "total": 0,
+                  "queue": []
+                },
+                "assistIn": [],
+                "assistOut": [],
+                "assistCap": 5,
                 "defenseBonus": 0,
                 "marches": [],
                 "territory": [],