公平模式 - War3AI

本项目的观察能力来自「客户端持有全部玩家的状态」：快照里有整张地图的所有单位，包括迷雾里的敌人。这对调试很方便，但对比赛不公平。

公平模式让 SDK 按你的视野过滤：

python tools/play.py --bot my_bot.py --fair
python -m openwar3 run my_bot.py --inst 5 --fair

from openwar3 import Game, run
g = Game(inst=5, fair=True)            # 直接用 Game
run(MyBot, inst=5, fair=True)          # 或者交给运行器

过滤了什么

内容	公平模式下
单位	我方全部 + 此刻我方看得见的敌方和中立单位
地上物品	只留我方单位视野内的（白天 / 夜里视野按数据表分别算）
生产表	只留看得见的建筑（看不见对手在练什么）
事件	自己的；看得见的（或 1 秒内看得见过的）；我方打出的伤害

视野从哪来

快照里每个单位带一个可见性掩码：第 p 位 = 玩家 p 此刻看得见它（只算场上有单位的 0 ~ 11 号；自己的单位对自己恒可见）。u.visible_to(g.me()) 直接读它，零等待。
任意一点：g.visible(x, y) 问引擎（看得见 / 迷雾 / 黑区），走快车道，每次约一帧。一拍里要判断很多单位时，用快照里的 u.visible_to()，别逐个调 g.visible()。

敌人的记忆：`last_seen`

人类玩家会记得「刚才在那边看到过一队狼骑」。SDK 也帮你记：每次刷新快照，记下我方此刻看得见的敌方和野怪单位（最后的位置、血量、时间）；看见它死了就删，换局清空。

for u, t, age in g.last_seen(max_age=60):         # 60 游戏秒内看到过的敌人
    print(u.type, u.x, u.y, f"{age:.0f}s 前")

heroes = [r for r in g.last_seen() if r[0].is_hero]   # 对面英雄上次在哪
camps  = g.last_seen(owner="creep")                   # 见过的野怪

公平模式下，这是你唯一的「对手信息来源」—— 和人类玩家一样。普通模式也按视野记，所以可以用同一套代码。

以几号玩家的身份指挥

python tools/play.py --bot my_bot.py --player 1 --attach

--player N（或 Game(player=N)）让 Bot 以 N 号玩家的身份指挥，只能指挥 N 号玩家的单位。两个 AI 对打，就是同一局里开两条这样的通道。

本机模式下，公平是约定，不是安全边界

在你自己的机器上，没有任何办法阻止一个程序读全图。--fair 是你对自己的约束；真正的比赛由对战平台的裁判进程保证：Bot 永远碰不到共享内存，只能拿到裁判按视野过滤过的观察，只能提交动作，每条动作先校验单位归属。

为什么现在就该开

将来上擂台时规则就是这样，现在按公平模式写，到时候一行不用改；
离开全图信息，才知道你的 Bot 真实水平如何（参考大脑目前大量依赖全图信息，比如电脑队长的目标点 —— 这正好是一次检验）；
公平模式下写出来的侦察、记忆、判断，才是真正有价值的 AI 能力。