# AI 坦克接入指南与两套参赛考题 大厅的「接入其他大模型坦克 AI → 参赛考题与本地文件槽位」支持分别阅读、复制下方的 A、B 两份完整考题。由参赛模型的实际作者编写脚本,并在注册名称中使用模型全称。 | 参赛模型 | 注册 ID | 脚本 | | --- | --- | --- | | OpenAI GPT-6.2 Astra · 竞技与突围 | `gpt_6_2_astra_arena` | `tanks/gpt_6_2_astra_arena.js` | | OpenAI GPT-6.2 Astra · 移动迷宫 | `gpt_6_2_astra_maze` | `tanks/gpt_6_2_astra_maze.js` | | Gemini 4 Carbon | `gemini_4` | `tanks/gemini_4.js` | | Gemini 4 Carbon · 行者 | `gemini_4_runner` | `tanks/gemini_4_runner.js` | | Claude Fable 5.2 Max · 竞技与突围 | `claude_fable_5_2_max_arena` | `tanks/claude_fable_5_2_max_arena.js` | | Claude Fable 5.2 Max · 移动迷宫 | `claude_fable_5_2_max_maze` | `tanks/claude_fable_5_2_max_maze.js` | ## 接入与复盘 拿到其他大模型生成的 JS 代码后,任选以下一种方式即可接入参战(无需安装任何依赖、无需打包构建,直接双击 `index.html` 即可零报错运行): 本地参赛 JS 会在游戏页面里执行,已保存的动态脚本也会随该页面的后续打开自动加载。使用真实模型 API Key 的页面只应加载受信脚本;测试陌生代码时可用单独的浏览器配置文件和模拟接口。参赛考题中关于 DOM、网络和存储的限制依赖作者遵守。连接与计分规则见[模型 API 驾驶说明](模型API驾驶.md)。 ### 方式一:粘贴到预留槽位文件(推荐 · 永久生效) 1. 项目 `tanks/` 目录下已预留好 4 个干净的空槽位文件: - `tanks/slot_model_1.js` - `tanks/slot_model_2.js` - `tanks/slot_model_3.js` - `tanks/slot_model_4.js` 2. 用记事本或任意代码编辑器打开其中一个空槽位文件,将对应大模型生成的 JS 代码**全选粘贴覆盖**进去,按 `Ctrl + S` 保存。 3. 刷新浏览器中的 `index.html` 页面,该模型就会自动出现在对战大厅的模型列表中! ### 方式二:网页大厅直接粘贴或上传 `.js`(免改本地文件) 1. 打开 `index.html`,在对战大厅界面点击 **「+ 接入新模型坦克」** 按钮。 2. 直接将大模型生成的 JS 代码粘贴进输入框(即使连带 ` ```javascript ` 代码块标记一起粘贴也能自动剥离识别),或点击上传 `.js` 文件。 3. 导入成功后会自动保存在浏览器本地(`localStorage`),下次打开网页依然自动保留,也可随时在大厅一键移除(注:动态导入使用与内置车重名的 ID 时会另行命名)。 ### 方式三:新建独立 `.js` 脚本(支持无限扩展) 如需更多模型文件,按以下步骤添加。 1. 在 `tanks/` 目录下新建任意 `.js` 文件(例如 `tanks/model_5.js`),粘贴代码并保存。 2. 用编辑器打开 `index.html`,在 `tanks/slot_model_4.js` 所在 ` ``` 3. 保存并刷新网页即可生效。 ### 🧬 进阶玩法:使用「📊 战报与模型进化」一键复盘迭代你的坦克 1. 进行数局对战后(可使用战斗界面 `8x / 16x` 倍速快速完成多局百格远征评测),点击大厅顶部导航栏的 **「📊 战报与模型进化」** 按钮(或冠军结算弹窗底部的 **「🧬 复盘本场并生成模型进化 Prompt」**)。 2. 在面板中可查看每个参赛模型的**生涯胜率/突围率、破译密码数、探索效率、重复绕路率、猎杀鬼火兽数**以及 **15 类精确死因拆解诊断**。 3. 切换到 **「🧬 模型针对性进化 Prompt 生成器」**,选择参赛模型和对应考题,即可**一键复制专属进化升级 Prompt**(自动汇总其 Top 3 致命短板根因、败局复盘切片、v4.0 完整 API 契约以及网页动态导入模型的当前源码),直接发回给原大模型即可定向重构出战斗力暴涨的 vNext 进化版! --- ## 怎样出一道移动迷宫考题 把大厅中完整的 **考题 B** 发给要参赛的模型,让它交付一份同时能读电影和原著档案的控制器。复盘时在「战报与模型进化」选择同一辆车和「考题 B · 移动迷宫」,复制的进化题会附上相同的专项规则。 | 大厅线索模式 | 一趟出营要带回什么 | 译码后怎样找门 | | --- | --- | --- | | 电影(默认) | 三处外区的开放拍号记录;阵营首枚生化核心可装上编号追踪器。 | 从轮换顺序读出拍号对应的扇区,再按营心距离带找支路。靠近终室的开放通道时,追踪器有强弱两级信号。 | | 原著 | 三处记录点各存着两日的描图。同日取交集,再把第一日的营门与第二日的左右支路组合。 | 用译出的扇区和距离带找唯一入口。鬼火兽核心供受损、缺弹或正在装填的队员使用。 | **沙盘选址。** 「随机禁区」随新局选址,地图尺度和时限会影响远征距离。「沙盘指定出口」可以点击或拖动到营外通路;林间和四道营门直接相连的通行格须留给出生、返营和通行。无效点保留上一处有效设置。手选坐标按地图宽、高保存在本机,同尺寸可重开、跨局或刷新复用。距离过远会提示时限风险。切回随机可以恢复沙盘本图的随机终室,新局重新选址。每支阵营仍要自己获取档案并目击出口。 **改编依据。** 电影里的装置标着 7,跑者另有八区开放的记录。原著中,各区跑者按日叠图读出字母,再拼成词。竞技场把长期调查压缩为三个记录点,把出口改为可随机或手动配置的单入口终室;解码与维修按游戏规则结算。报告含首部电影和小说的结局及来源。[阅读《移动迷宫首部电影与原著机制考据》](移动迷宫首部电影与原著机制考据.md) ## 考题 A · 乱斗与基础逃离 给《AI 坦克大乱斗》写一辆能打乱斗、能从未知地图突围的参赛车。同一份脚本分别处理 state.mode === "brawl" 和 state.mode === "escape" 且 state.mazeObjectives?.trial 为空的局。下面是两场的规则、共用世界知识、接口与带注释的注册样例。 ### 第一场 · 乱斗 自由混战中争取最后存活;组队时保住最后一个存活阵营取一分,队友即使先阵亡也可随队获胜。全灭或交战阵营超时未分胜负为平局。单阵营练习局可持续到车辆阵亡。state.visionRadius 为 Infinity,tanks、enemies、allies、items、bullets 和地图给出全场情报。知道敌车的位置后,仍要检查墙体、射界、队友与弹道回折风险。此模式 exit 和 exitPing 为 null,frontierCells 为空。state.mazeCycle 平时为 null;在 maze_runner 图形上打乱斗时它非空,含 enabled、phase(day、dusk、night)、phaseTimeLeft、phaseDuration、dayDuration、duskDuration、nightDuration、cycleCount、doorsOpen、openRatio、bloodMoonActive、inGlade、gladeBounds(c0、r0、c1、r1、cols、rows、centerX、centerY)、gladeDoors(每项 id、col、row、x、y、open、openRatio)和 visibleShiftingWarnings(每项 col、row、x、y、timeLeft),nightWatch 与 campDuty 在本卷的对局里为 null;夜里四座营门关闭,通路以 cellWalls 为准。 在直廊尝试直射,在遮挡处判断反弹是否可行,目标丢失射界时换位。用来弹的速度和可能的反弹段规划躲避。地面补给和怪物掉落从出现起保留 40 个模拟秒,items[].lifeLeft 是剩余模拟秒数。按可走距离、转向时间、现有装备和受损程度比较补给价值。此模式的怪物可掉常规箱、维修包或兽王整备箱,生化核心只在逃离出现。 ### 第二场 · 基础逃离 从分配的出生点出发,在迷雾中寻找可通行的撤离门。state.exit 最初可为 null,探索支路时记住岔路、死路、阻塞和可回头的位置。出现 state.exitPing 时可读 {active,pulseSeq,bearingRad,roughDistBand,age}。普通脉冲约持续 3 秒,方位误差第一次在 ±0.24 弧度内、此后每次乘 0.65、最小 ±0.05 弧度,并且是按脉冲产生那一刻的车位算好的,持续期间不随车移动更新,可用 pulseSeq 区分新旧脉冲;首个脉冲在开局 min(45, 时限的一半) 秒后发出,之后每 12 秒一次,剩余时间不足 18 秒时每 5 秒一次;near/medium/far 表示直线距离小于 260×k、不超过 560×k、更远(k = cellSize/64,单位像素);无提示、关掉提示或已经发现出口时通常为 null。用脉冲指向筛选可达前沿,绕墙走实际通道。 先确认 mazeObjectives?.vaultLocked。开放的门可直接驶入;仅在开启锁门等设置时才需要密码。基础逃离中的可选石碑以 visibleSteles 给出 {id,sector,col,row,x,y,radius,activated}。车心驶到距未激活石碑的碑心 stele.radius + self.radius 以内,立刻为本阵营加 1,不需要停留(石碑在长边不少于 28 格的地图和 maze_runner 图形上生成;开启密码锁门时,任何尺寸的地图都至少有 3 块);逃离中鬼火兽、兽王,或受机关击杀的怪物可掉 type 为 griever_core 的核心,普通核心加 2,兽王核心加 3。启用的地图室 mapRoom.ready 为 true 时也可驶到距终端 max(18, min(cellSize × 0.3, 38)) + self.radius 以内取得 1 点,并向本阵营揭示最近一座未激活的石碑;ready 要求上次使用后新探索的格数不少于 min(45, max(14, floor(有效格数 × 0.06))),用过后有 45 秒冷却,剩余时间见 mapRoom.cooldownLeft。以快照实际出现的对象为准。 基础密码 ciphersProgress 与 ciphersRequired 在 mazeObjectives 中。mazeObjectives 在逃离局恒存在,共含 vaultLocked、ciphersRequired、ciphersProgress、trial(本卷的对局里为 null)、targetExitSector、visibleSteles、theBox、mapRoom、bloodMoonActive;mapRoom 为 {ready,x,y,col,row,cooldownLeft} 或 null,theBox 为 {active,hasCrate,col,row,x,y} 或 null,两者只在 maze_runner 图形上出现。进度首次增加可收到一次误差约 ±0.045 弧度的窄角 exitPing(这一次的 roughDistBand 固定报 medium,不代表距离),达到 2 点可读 mazeObjectives.targetExitSector,达到 3 点给存活队员精确出口(直接出现在 state.exit)与至少 5 秒 turbo,并解除密码门锁。基础逃离的扇区号(targetExitSector 和石碑的 sector)以地图中心为原点、正西起顺时针每 45° 一区:floor((atan2(row − (rows−1)/2, col − (cols−1)/2) + π) ÷ (π/4)) 对 8 取余再加 1,即 1 区在西到西北,3 区在北到东北,5 区在东到东南,7 区在南到西南。在可选孤狼坍缩局,多阵营中由参赛车击毁最后一辆敌方车且无人先撤,可触发 collapseActive(敌方死于自毁、友伤、怪物或机关不触发),幸存者获出口位置和解锁资格,须在剩余时限内驶入;坍缩最多给 30 秒。坍缩期间 state.collapseActive 为 true,剩余时间读 state.timeRemaining。击毁数本身不能替代撤离。 验收时用同一脚本在多种形状、宽度、单车和团队局对战,检查直射/反弹、躲弹、自伤友伤、按需拾取或放弃过期箱;再从未知出生点探索普通逃离,验证绕墙、穿缝、门锁与个人撤离。多人和高倍速下应保持响应。 ### 交卷、动作与计时 只交一份完整原生 JavaScript 源码,含全部辅助函数,能直接粘贴到大厅或保存为 .js,通过 file:// 运行。用文末样例的 IIFE 调用 global.registerTankAI({ id, name, author, color, description, createController })。id 用唯一英文标识,name 写真实完整模型名及项目,author 写实际作者,color 用 HEX 色值,description 说明你的策略。用代码注释解释目标优先级、射界与碰撞判断、捡取与使用道具的取舍,以及切换阶段或重算路线的条件。只使用传入的比赛信息与每车自己的记忆;禁止使用模块导入、外部库、DOM、存储、网络、计时器、引擎私有对象或其他参赛车代码。 | 调用 | 你收到什么、应返回什么 | | --- | --- | | createController(tankInfo) | 每局开局时为每辆车新建一份实例,闭包里的记忆不会带到下一局,跨局只能读 onRoundStart 的 experience。tankInfo 含 id、slotId、aiId、name、modelName、color、team。返回带 decide 方法的对象,路线、访问次数、上一目标、脱困记录都放本车闭包。 | | onRoundStart(roundInfo)(可选) | 清理本局记忆。round、mode、selfId、team、map、visionRadius、rules 描述开局(map 与 state.map 同一视角,逃离时只含开局已看到的部分),experience 为可空的本模型历史统计。rules 另含 mazeCycleEnabled、monstersEnabled、trapsEnabled(启用的机关 ID 数组)。 | | decide(state, api) | 同步返回 { throttle, targetAngle, fire } 或 { throttle, turn, fire }。throttle ∈ [−1,1],负值倒车,零油门停驱动。targetAngle 是世界绝对弧度,turn ∈ [−1,1] 是转向输入(负左、正右),选一种;两者都给时非零 turn 优先,targetAngle 只在 turn 为 0 时生效。希望保持朝向时省略 targetAngle 并给 turn: 0。fire 为布尔值,触发当前武器。炮管随车身转;转向需要时间,可倒车瞄准。 | | onRoundEnd(result)(可选) | 可读本车 won、extracted、extractionOrder、deathCause、survivalSec、kills、teamKills、itemsPicked、exploredRatio、backtrackRatio、shotsFired、shotsHit 等复盘字段,另有 round、mode、outcome、durationSec、modelId、isPlayer、aliveAtEnd、deaths、suicides、killerModelId、hitAccuracy、shieldBreaksTaken、monstersKilled、grieverKills、alphaGrieverKills、swarmerKills、sentinelKills、ciphersDecoded、exitFirstSeenSec、minStepsToExit、nightOutsideSec 和 driver(启用模型 API 驾驶时的用量统计,否则为空)。未撤离时 extractionOrder 为 null。 | state.mode 只有 brawl 和 escape 两个取值。state 里的 tanks、allies、enemies、bullets、lasers、items、monsters、monsterPings、traps、frontierCells、knownWalls 恒为数组,没有内容时是空数组;state.collapseActive 是布尔值。物理以 60 Hz 推进。state.tick 是物理步序号,time 是本局模拟秒,dt 是本车距上次决策经过的模拟秒,timeRemaining 是剩余的模拟秒(不限时为 Infinity)。高倍速或多车时可能跳过若干次决策:被跳过的物理步沿用上一次的 throttle 与转向,fire 只有 gatling 会续射,其他武器等下一次决策再发;近处出现敌弹或怪物时引擎会提前安排决策。用模拟秒计时。state.rules 的 mode、roundTimeLimit(模拟秒,逃离局填的是逃离时限,0 表示不限时)、friendlyFire、selfDamage、maxBounces、visionRadius、corridorScale、cellSize、wallThickness、sprintEnabled、exitPingEnabled、vaultRequiresCipher 反映本局配置。 ### 地图、四邻通路与物理 state.map 给出 cols、rows、width、height、cellSize、wallThickness、corridorScale、shape、isMegaMap、gridMask、cellWalls、walls。乱斗的 shape 是真实形状;逃离的迷雾快照里 shape 恒为 "unknown",轮廓要从已探明的 gridMask 判断。Canvas 原点在左上,x 向右、y 向下,角 0 朝右、π/2 朝下;位置、半径、距离用世界像素,速度用像素/模拟秒,角速度用弧度/模拟秒。格子地址是 (col,row),网格访问是 [row][col],格心为 ((col+0.5)×cellSize,(row+0.5)×cellSize)。 常规尺寸从 9×7、14×10、22×16、36×26、64×48 延伸到百格级(如 111×111、161×161、221×221)和 1000×1000,自定义每边 6~1000。五档走廊的格宽/墙厚分别为 classic 64/6、wide 128/16、cinema 224/36、colossus 288/48、plaza 680/60,沙盘还可自定宽厚。实际几何取本图字段,沿墙行驶时车心到墙段中心线至少留 self.radius + wallThickness/2 的距离。标准车半径 14.5;视野、弹速、弹寿、部分怪物与机关半径随尺度变化,优先用实体的 radius 与速度。令 k = cellSize/64:弹速乘 1 + 0.22×(k − 1),弹寿乘 √k,EMP 半径为 round(190 × k^0.45),撤离门半径为 round(20 × clamp(1 + 0.4×(k − 1), 1, 2.4))(64 格宽为 20,224 为 40);车半径、普通弹半径、拾取距离、地雷的 28 和 56 像素、怪物速度不随尺度变化。逃离的实际视距 = round(配置视距 × (cellSize/64)^0.85),cinema 尺度配置 420 时为 1218 像素。 gridMask[r][c] 为 false 的已知格不可走。自当前格进入四邻格,检查边界、两格掩码、当前格 top/right/bottom/left(true 封闭)和邻格反方向的边;拐角按车体半径留量。形状决定地板范围,内部迷宫通路仍须逐边判断。 | 地图地形 | 对行车、视线或弹道的影响 | | --- | --- | | rectangle 矩形 | 外接矩形内均为地板,内墙仍会把相邻两格隔开。 | | circle 圆形 | 按横纵尺寸归一的圆/椭圆轮廓,四角裁去。贴外圈时沿阶梯状边界走。 | | ring 环形回廊 | 外环包住中央禁区。目标在对侧时比较顺、逆时针两条路线,小图按掩码确认内孔。 | | cross 十字要塞 | 切掉四角形成四翼。跨翼通常要回中部,翼端受堵时及时掉头。 | | hourglass 沙漏峡谷 | 南北两头较宽,左右边往中线收拢成腰口。南北换区要经过腰口,留意封路炮火。 | | diamond 菱形 | 四角沿斜向裁成阶梯,中央横向最宽。沿斜边用四邻绕行,切角时检查车体净空。 | | fortress 双核堡垒 | 地图内有对称的不可走柱块,尺寸够大时分为四组,小尺寸可简化为左右两组。可沿中路或外缘迂回。 | | custom 画笔掩码 | 地板来自沙盘绘制的轮廓,可能有孔洞、窄桥和凹边。根据观测到的 gridMask 和邻边规划。 | | maze_runner 移动迷宫 | 中央林间、四门、八区和可变侧路,较大图外轮廓削去四角。通路随门况与墙位变化,已见过的路也要复核。专项使用此图形。 | | 薄墙、厚石墙、巨石壁 | 经典窄巷为薄墙,宽道用厚石墙,电影峡谷、史诗巨廊与大道的墙更厚。它们都能遮蔽视线、阻挡车身并反弹普通弹;厚度影响过角和炮口净空。 | | 普通内墙、边界墙 | 墙段给 x1、y1、x2、y2、isBoundary。穿墙增益与穿墙弹可忽略普通内墙,地图外缘、地板孔洞或标为边界的隔墙仍会阻挡。 | | 风化墙、开放裂缝 | 启用时,部分内墙可击穿。风化墙 3 点耐久,普通弹每次碰撞削 1,霰弹弹丸、巨炮、破片弹本体、激光或地雷爆炸可削 3。打通后只开中央约 42~44 像素净口,两肩仍实体,子弹也会碰肩。以已知墙段几何为准;有标记的墙段可带 isWeathered / isCrackStub,以及标识所属裂缝的 crackKey。小虫可钻缝,普通鬼火兽和兽王体型过大。 | ### 车况、弹道与地面物资 乱斗经典底盘前进 138、倒车 96 像素/秒,转向 3.9 弧度/秒;宽廊下乱斗车速乘 1 + 0.10×(cellSize/64 − 1)。逃离底盘前进 172、倒车 122、转向 4.3,基础行驶速度独立于格宽。车没有惯性:每个物理步的速度就是油门 × 极速 × self.speedMultiplier,沿车头方向;turn 乘以最大转向率,targetAngle 以最大转向率逼近、差不足一步时直接对正。rules.sprintEnabled 开启时,逃离在油门 ≥0.55、平稳前进且无近战威胁约 1.35 秒后渐升至 275 像素/秒,与 turbo 叠加前进上限 320。开火、激烈转向、撞墙、黑沼或受击可打断巡航。平稳指实际转向率不超过 2.35 弧度/秒(乱斗 1.85);近战威胁指 240×max(1, cellSize/64)^0.7 像素内有处于 chase 状态的怪物(不看视线)或有直视的敌车。被打断后要等 1.6 秒才能重新累计,受伤后 1.8 秒,迎头撞墙 0.65 秒。乱斗默认不开疾跑,沙盘开启后需平稳直行约 2 秒才起步。用实际速度估算返程,可倒车迎击追兵。 state.self 以及 tanks、allies、enemies 的车体快照含 id、name、modelName、team、color、skinId、x、y、col、row、vx、vy、angle、radius、hp、maxHp、hpRatio、ammo、maxAmmo、reloadCooldown、fireCooldown、weapon、weaponAmmo、hasShield、turboTimer、phaseTimer、empStunTimer、invulnTimer、speedMultiplier、sprinting、sprintFactor、mireExposure、ciphersProgress。各 Timer/Cooldown 用秒。reloadCooldown 是距下一发普通弹装好的秒数(弹鼓已满为 0),fireCooldown 是距可以再次开火的秒数;敌车和队友的这些字段也是真实值。weapon 为 null 时用普通炮。普通炮每发消耗 1 点 ammo,ammo 为 0 时 fire 无效。用 allies / enemies 分辨阵营,空队号车各自作战。tanks、allies、enemies 只含存活车。多车同阵营共享胜负,开火风险由 friendlyFire 和 selfDamage 分别控制。 装甲档为 1、100、160 点,按 self.maxHp 判断。一击制中一次有效伤害即可击毁;装甲制中普通弹、导弹、加特林弹丸与破片各伤 25,激光/穿墙弹/巨炮 65,地雷与榴弹本体 55,霰弹同一轮对同车至多 60;怪物近战为 swarmer 20、sentinel 30、griever 38、alpha_griever 52,地刺、锯片和红外绊线 30,移动墙夹击 60。常规受伤后约 0.55 秒无敌(机关 0.65、黑沼 0.2、破盾 0.5),读取 invulnTimer 安排下一发。普通弹鼓 5 发,约每 1.55 秒回 1 发,最短射击间隔 0.18 秒。经典尺度的普通弹半径 3.8、速度 235、寿命 11.5 秒,反弹上限读 rules.maxBounces(默认 9)。 state.bullets 每项含 id、ownerId、type、x/y、vx/vy、speed、angle、radius、bouncesLeft、lifeLeft、piercingWalls、armed;type 取 normal、shotgun、gatling、railgun、missile、frag_bomb、giant_ball、shrapnel(榴弹炸出的破片)或 mine,弹丸命中车体即消失,piercingWalls 只有 railgun 为 true;mine 也在这里,armed 表示已布防。lasers 含 ownerId、segments(每段 x1/y1/x2/y2)、lifeLeft,记录已发出的瞬发光束。射击前从炮口方向检查墙、己方车及各反射段;躲弹时要看弹速、半径和预计相遇时间。fire 在同一物理步的转向和位移之后结算,弹丸沿结算时的车头方向、从车心前 max(20, 16 + 弹半径) 像素处出膛(普通弹、霰弹、加特林和激光 20,railgun 21,missile 21.5,frag_bomb 22.5,giant_ball 29;地雷放在车心后 24.5);炮口顶着墙时贴着墙面出膛并立刻反弹。selfDamage 开启时,自己的弹丸出膛约 0.1 秒后或第一次反弹后就能伤到自己(导弹、榴弹与巨炮约 0.7 秒),破片没有保护期;激光首段不伤发射者,反射段会。经典尺度下特殊弹丸的速度为 shotgun 265、gatling 290、railgun 480、missile 165、frag_bomb 185、giant_ball 195(半径 13),其余以快照的 speed、radius 为准。 state.items 每项有 id、type、x、y、col、row,常规箱有 category:武器箱为 weapon(type 就是武器 ID),shield、turbo、phase 为 buff;特殊掉落按 type 判断。车心驶到距物资约 self.radius + 20 像素内且接触路径与物资间无遮挡即自动拾取,无单独按键;石碑、地图室终端、补给井、物资和撤离门都不是实体,车可以直接开上去;lifeLeft 只在乱斗快照提供。每辆车只有一个特殊武器槽;持有特殊武器期间 fire 只发射它,普通炮用不了,也不能主动丢弃;捡到武器即替换旧武器并给予表中弹数,fire 每次成功发射消耗一发,用尽自动回普通炮;特殊武器每发后有约 0.28~0.42 秒间隔,刚捡到时等待压到 0.08 秒内,按 fireCooldown 判断。增益和维修包接触即结算。常规补给默认约每 5.5 秒尝试刷新、基础上限 6 个;沙盘可调种类、间隔和上限,大图还可按有效格数提高上限、加快刷新。 | 武器 ID | 每箱弹数 | 发射效果及取舍 | | --- | ---: | --- | | laser | 1 | 瞬发光束,最多反射 6 次,沿线可命中多辆车。光束总长 3500×max(1, cellSize/64) 像素。适合已算准的折射线,回折段可击中自己。 | | railgun | 2 | 高速电磁弹穿非边界内墙,零反弹。适合隔掩体拦截已知目标,射线后方的队友也可能中弹。 | | shotgun | 2 | 每发扇射 7 枚、各可反弹 3 次。近距横向覆盖宽,窄角内先为后坐与散射留空间。 | | giant_ball | 2 | 大半径铁球可反弹 8 次,能碾碎普通弹幕;适合直廊压制,贴厚墙时容易折回。 | | missile | 1 | 导弹向敌车制导、可沿通路转向,最多反弹 2 次,也能被其他弹击毁。适合追击转角后的移动目标。 | | frag_bomb | 1 | 榴弹到期、弹跳满 3 次或接敌可炸出 14 枚全向破片。适合封堵路口,爆点近身会使己车与友军同时暴露。 | | gatling | 18 | 持续 fire 快速逐发射击(间隔 0.075 秒),弹丸略有散布、可反弹 4 次。可压制走廊,连续开火也会引怪、打断巡航。 | | mine | 3 | 每发在车尾放一枚,约 1.2 秒布防;感应、弹击或连锁可引爆。布防后任何存活车(含布雷者和队友)驶入约 28 像素即触发,爆炸半径约 56 像素,无人触发约 55 秒后失效,对己方的伤害仍按 selfDamage、friendlyFire 结算。封退路时留出爆区,布设本身不发远距枪声。 | | emp | 1 | 以自身为中心(经典尺度半径约 190 像素)清除范围内其他车发出的弹体(含友弹和地雷),使敌车和怪物减速 2.5 秒:移动与转向降到约 35%,前 1 秒无法开火。适合弹幕中脱身或近距控怪,半径随尺度变化。 | | 物资 ID | 触发与收益 | 何时值得靠近 | | --- | --- | --- | | shield | 立即获得一层护盾,挡下一次有效受击,破盾后短暂免伤。重复拾取仍为一层。 | 无盾过危险路口或对射前。 | | turbo | 立即刷新到 8 秒,移动和转向乘 1.45,受速度上限约束。 | 长廊赶路或离开威胁;狭口提前收油。 | | phase | 立即刷新到 5 秒,车体可越非边界内墙,并免地刺、锯片和红外绊线。黑沼仍减速、腐蚀。 | 借内墙截弯或躲机关,结束前找可站立的有效地面。 | | medkit | 仅受损车可拾取,最多修复 45 点,不超 maxHp。装甲局可随常规刷新或怪物掉落出现。 | 按缺血量、敌火和可达路线估算收益;满血时留给队友。 | | supply_crate | 金色整备箱一次修满装甲、加一层盾、补满普通弹,随机装备满弹 laser、railgun、shotgun 或 giant_ball。 | 受损缺弹时价值高,已有主武器会被替换;兽王也可掉落。 | ### 怪物与地面机关(可由沙盘启闭) state.monsters 每项为 id、type、x/y、vx/vy、angle、radius、hp/maxHp、state、frenzied。state 取 patrol、alert、chase、retreat 或 stunned,frenzied 为布尔值。griever(3 HP)凭目击、枪声追猎,夜间狂暴;alpha_griever(8 HP)可能守在出口防区,留意其追击和回防;swarmer(1 HP)体小可钻开放裂缝;sentinel(1 HP)沿直廊折返,近身切割。激光、穿墙炮、巨炮、导弹、榴弹本体和地雷可对怪物造成 3 点,普通弹通常 1 点。怪物速度不随尺度变化,按巡逻、追击、夜间或狂暴依次为(像素/秒):swarmer 118、152、160,griever 96、134、152,alpha_griever 88、126、142,sentinel 122、136、146;追击都快过倒车,只靠倒车甩不掉。怪物与车的中心距不超过两者半径之和减 1.5 像素即咬中。可引怪踏入机关,计算它与车的距离再决定取掉落。逃离的 monsterPings 提供 bearingRad(带误差的世界绝对弧度)、intensity(强度)、isBoss,仅代表本车听到的动静。 | state.traps 的 type | 读数与通过办法 | | --- | --- | | spike | 地刺按 dormant → warning → active 循环,active 圆区伤车。三段固定为 4.2、1.4、0.85 秒,开局相位随机。预警时用剩余时间判断能否穿过。 | | mire | 黑沼让速度与转向乘 0.62,连续停留约 1.25 秒起每 0.25 秒腐蚀一次,装甲车每次 4 点。self.mireExposure 为 0~1,离开重置,phase 仍会受影响。 | | saw | 锯片沿 (x1,y1) 至 (x2,y2) 往返。滑轨有的横穿走廊,有的顺着走廊跨两格。往返一趟约 5.56 秒:每个单程先在端点停约 0.5 秒,再用约 2.28 秒按余弦缓动滑到另一端(两头慢、中间快)。按 bladeX、bladeY、radius 及连续观测判断扫过时间,贴着刚扫过的空档通行。顺着走廊的滑轨等不出空档,要按 radius 判断能否贴墙从旁边过,过不去就改道。 | | laser_trip | 红外线段两端为 x1/y1、x2/y2;off 熄灭,warn 将亮,on 通电。三段固定为 3.5、0.65、1.85 秒,开局相位随机。比较开窗长度和车体清空线段所需时间。 | 每个机关共同字段为 id、type、col/row、x/y、radius、visible、state、stateTimer。stateTimer 是当前状态还剩多少秒。地刺、黑沼和锯片按圆与车体圆相交判定(中心距 ≤ 两者半径之和),绊线按车心到线段的距离 ≤ 车半径判定。逃离时旧机关只保留底座位置,visible 为 false、state 为 unknown、stateTimer 为 null,锯片和绊线的动态几何只在可见时给出。不要用上一帧倒计时穿越阴影中的机关。 ### 迷雾观测与几何 API 逃离时 state.visionRadius 是实际视距,墙会遮住光学视线。state.visibleGrid[r][c] 表示现在看见,state.exploredGrid[r][c] 表示曾探索;state.knownWalls 是已知墙段,state.frontierCells 中的 {col,row,x,y,unknownNeighbors,frontierAngle} 表示一个已知格、开放方向上的未知邻格数和建议探索角。尚未探明的格子在 gridMask 里为 true,cellWalls 四边按开放给出(紧贴已探明无效格的除外),findPath 也会乐观地穿过它们;用 exploredGrid 区分已探和未探,进入视野后以新墙、掩码和实际运动修正路线。敌车、地面物资和飞弹按本车与存活队友的观测提供,激光只给可见片段。同队存活车由 allies 直接给出,己方地雷即使出了视距也可在 bullets 中出现。tanks 汇总 self、allies 与已知 enemies。看不见的敌人可能仍在活动。 逃离中 exit 未知时为 null,已知对象为 {col,row,x,y,radius,visible,firstSeenTime},visible 表示此刻能否看见。门心或其上下左右约 0.6 个门半径处的任一点进入本车或存活队友的视距且中间无墙,才算发现;所在格进了 exploredGrid 不等于门已被看见。解锁后使车心距门心 ≤ exit.radius 才算撤离。首辆撤离车锁定胜方与积分,其余车辆继续至各自撤离、阵亡或超时,同帧按距门心远近定先后。用 result.extracted、extractionOrder 区分个人撤离与阵营获胜。 | 调用(? 为可选参数) | 返回及使用范围 | | --- | --- | | api.normalizeAngle(rad);api.angleDiff(fromRad,toRad) | 归一化弧度;从前角转向后角的最短有符号角差。 | | api.distance(x1,y1,x2,y2) | 两个世界点间的直线距离,计算弯路行程应累加各段。 | | api.worldToCell(x,y);api.cellToWorld(col,row) | 前者返回夹在外接矩形内的 {col,row},仍要查掩码;后者返回格心 {x,y}。 | | api.hasLineOfSight(x1,y1,x2,y2,ignoreInternalWalls?) | 是否有无遮挡的几何直线,布尔值。可选 true 忽略内墙;自行核对光学可见性与车身净空。 | | api.raycast(x,y,angle,maxDist,ignoreInternalWalls?,radius?) | 沿给定弧度测墙距,radius 是射线的膨胀半径。读取 hit、dist、x、y;命中时另有 normalX、normalY、wall,未命中时 dist 为最大测距。 | | api.traceBouncePath(x,y,angle,maxBounces?,maxDist?,bulletRadius?) | 返回可遍历的线段数组,每段含 x1/y1/x2/y2、length、angle、bounceIndex,数组另有 totalDist。maxBounces 缺省取 rules.maxBounces,maxDist 缺省取 2400×max(1, cellSize/64) 像素(比激光短,验算激光要显式传 6 和 3500×同一系数),bulletRadius 缺省为普通弹半径。计算沿途车体相交需自己完成。 | | api.findPath(fromCol,fromRow,toCol,toRow,ignoreInternalWalls?) | 返回含起点的 {col,row,x,y} 路点数组;无路或非法格返回 [],超大图搜索预算用尽可只给部分路线,核对末节点。 | | api.alignForKnownCrack(state, travel, memory)(仅逃离) | travel 是本车拟执行的行驶动作,memory 为每车每局持有并复用的对象。需要时返回穿过已知通缝的对齐动作,其余返回 null;由控制器决定是否采用。 | 通用几何 API 在乱斗使用实图,在逃离只按已知地图答复。不要把穿过未知格的射线或试算路线当作侦察结果。cols×rows > 65536 时 map.isMegaMap 为 true,地形与迷雾按需读取,逃离的 knownWalls 只覆盖局部战术窗口;按 [row][col] 查询邻域。可缓存稀疏访问、用前沿和分段路点规划,地图更新、掉头或久未前进时重算。按平均每次 decide 约 2 ms 以内设计,避开逐帧全图遍历、复制网格、全图尺寸内存分配;线性索引使用 Number 或 Int32Array,避免 Int16 超过 32767。 可直接导入的 JS 示例 把下面代码块内的内容粘贴到大厅「接入新模型坦克」即可试跑。交卷时替换 id、模型全名和作者,在对应的模式分支实现自己的决策。 ```javascript (function (global) { 'use strict'; global.registerTankAI({ id: 'example_model_arena', // 交卷时换成自己唯一的英文 id,两份不同脚本分别命名。 name: '示例模型全名 · 竞技与突围', // 大厅和战报显示的名字,填写实际模型全名和项目。 author: '示例作者', // 填写实际作者;由模型独立编写时署该模型全名。 color: '#2563eb', description: '瞄准有射界的敌车,空档取补给;突围时记住走过的路口。', createController: function (tankInfo) { // 每辆车各调用一次工厂。即使同一模型同时出战两辆,tankInfo.id、路点和足迹也各自独立。 const visits = new Map(); let waypoint = null, lastCell = -1, crackMemory = {}; function reset() { visits.clear(); waypoint = null; lastCell = -1; crackMemory = {}; } function drive(self, point, throttle, mayFire) { // 画布左上为原点,x 向右、y 向下。由两点之差取 atan2(dy, dx),右方是 0,下方是 π/2。 const angle = Math.atan2(point.y - self.y, point.x - self.x); // 包回 [-π, π],例如从 179° 向 -179° 只差 2°。车体就是炮口,先转正再推进、射击。 const delta = angle - self.angle; const error = Math.abs(Math.atan2(Math.sin(delta), Math.cos(delta))); return { targetAngle: angle, throttle: error < 0.8 ? throttle : 0, fire: mayFire && error < 0.08 }; } function crosses(point, x1, y1, x2, y2) { // 队友到弹道线段上最近点的距离,小于车体半径加弹丸余量就可能命中。 const dx = x2 - x1, dy = y2 - y1; const t = Math.max(0, Math.min(1, ((point.x-x1)*dx + (point.y-y1)*dy) / (dx*dx + dy*dy || 1))); return Math.hypot(point.x - (x1 + t*dx), point.y - (y1 + t*dy)) <= (point.radius ?? 14.5) + 4; } return { onRoundStart: function (roundInfo) { // roundInfo.mode、map、rules 属于新局,experience 可为空。上一张图的墙和目标在这里作废。 reset(); }, onRoundEnd: function (result) { // 每车收到自己的 won、extracted、deathCause、backtrackRatio 等,胜方队友也可能尚未撤离。 reset(); }, decide: function (state, api) { // 没有要追的朝向时传 turn: 0 保持车头。targetAngle: 0 会让车头转向画面右方。 const idle = { throttle: 0, turn: 0, fire: false }; if (!state?.self || !state.map || !api) return idle; const { self, map } = state; const visible = p => api.hasLineOfSight(self.x, self.y, p.x, p.y); const distance = p => Math.hypot(self.x - p.x, self.y - p.y); // 中心线能看到墙角另一侧,圆形车身却可能挤不过去。用车身半径试探整段净宽。 const canDriveTo = p => visible(p) && !api.raycast?.(self.x, self.y, Math.atan2(p.y - self.y, p.x - self.x), distance(p), false, self.radius)?.hit; let goal = null, bearing = null; if (state.mode === 'brawl') { // 乱斗公开敌我位置,墙仍能挡住直射。只用可直射的敌人开火,墙后敌人可以当作换位目标。 const enemies = state.enemies || []; const enemy = enemies.find(visible); if (enemy) { waypoint = null; const allies = state.allies || []; const near = distance(enemy) < (self.radius ?? 14.5) * 6; const rear = { x: self.x - Math.cos(self.angle) * (self.radius ?? 14.5) * 2, y: self.y - Math.sin(self.angle) * (self.radius ?? 14.5) * 2 }; // 倒车是负油门,炮口仍对着敌人。车后有空间才退;远处静止瞄准,有利于观察弹道。 const act = drive(self, enemy, near && canDriveTo(rear) ? -0.65 : 0, true); // fire 请求使用当前装备。无特殊武器才扣普通弹,地雷从车尾放置,EMP 作用于周围; // 本例只在近敌时用 EMP,未实现布雷战术,遇到地雷装备会保留。 if (self.weapon === 'mine' || (self.weapon === 'emp' && !near) || (!self.weapon && self.ammo === 0) || self.fireCooldown > 0) act.fire = false; if (act.fire && state.rules?.friendlyFire !== false && allies.some(a => crosses(a, self.x, self.y, enemy.x, enemy.y))) act.fire = false; // 普通炮额外检查一次近距反弹。第一段从自己出发,只在折返段检查自身。 // 这是静态近似;扇射、爆炸范围、多次反射和车辆下一拍的位置都要另行预判。 if (act.fire && !self.weapon && api.traceBouncePath) { const trace = api.traceBouncePath(self.x, self.y, self.angle, 1, distance(enemy) + map.cellSize); act.fire = !trace.slice(1).some(s => (state.rules?.selfDamage !== false && crosses(self, s.x1, s.y1, s.x2, s.y2)) || (state.rules?.friendlyFire !== false && allies.some(a => crosses(a, s.x1, s.y1, s.x2, s.y2)))); } return act; } // 补给靠车体接触且中间无遮挡才会拾取。武器会换装,护盾/加速等接触即生效,无需开火。 // 只取眼前有收益且来得及的物品,粗估直行时间外再留 1 秒转向;乱斗补给会过期。 let best = Infinity; for (const it of state.items || []) { const useful = it.type === 'medkit' ? self.hp < self.maxHp : it.category === 'weapon' ? !self.weapon : it.type === 'shield' ? !self.hasShield : it.type === 'turbo' || it.type === 'phase'; const d = distance(it); if (useful && d < best && d / 138 + 1 < (it.lifeLeft ?? Infinity) && visible(it)) { goal = it; best = d; } } goal = goal || enemies[0]; } else if (state.mode === 'escape' && !state.mazeObjectives?.trial) { // 普通逃离的 exit 首次发现前为 null,exitPing 只给粗略方向;锁门时先找可激活的碑。 const obj = state.mazeObjectives; goal = obj?.vaultLocked ? obj.visibleSteles?.find(s => !s.activated) : state.exit; bearing = state.exitPing?.bearingRad; } else return idle; // 已有直线通路就开到物品或出口中心。进入 exit.radius 才由引擎记录本车撤离。 const move = p => { const act = drive(self, p, 1, false); // 助手需要知道打算前行,即使车头还在原地转向;由它决定对齐时实际该给多少油门。 const aligned = state.mode === 'escape' && api.alignForKnownCrack?.(state, { ...act, throttle: 1 }, crackMemory); return aligned || act; }; const index = self.row * map.cols + self.col; if (lastCell !== index) { visits.set(index, (visits.get(index) || 0) + 1); lastCell = index; } if (goal && canDriveTo(goal)) { waypoint = null; return move(goal); } if (goal) bearing = Math.atan2(goal.y - self.y, goal.x - self.x); if (waypoint && distance(waypoint) > 5 && visible(waypoint)) return move(waypoint); waypoint = null; // 迷雾图只读眼前四邻。gridMask 为假是图形边界,cellWalls 记各边;黑雾里的开口只是推测。 // 优先少走的格子,同分时用目标方位择路,死路允许原路退回。疏散时保持停火可累积疾跑。 const walls = map.cellWalls?.[self.row]?.[self.col]; if (!walls) return idle; // 小图可绕墙接近已知目标。路径第 0 格是自己,第 1 格才是要走的路口。 const step = goal && map.cols * map.rows <= 4096 ? api.findPath?.(self.col, self.row, Math.floor(goal.x / map.cellSize), Math.floor(goal.y / map.cellSize))?.[1] : null; let best = -Infinity; for (const [edge, dx, dy] of [['top',0,-1], ['right',1,0], ['bottom',0,1], ['left',-1,0]]) { const c = self.col + dx, r = self.row + dy; if (walls[edge] || c < 0 || r < 0 || c >= map.cols || r >= map.rows) continue; if (map.gridMask && !map.gridMask[r]?.[c]) continue; const align = Number.isFinite(bearing) ? dx*Math.cos(bearing) + dy*Math.sin(bearing) : 0; const score = step && c === step.col && r === step.row ? Infinity : align - 3 * (visits.get(r * map.cols + c) || 0); if (score > best) { best = score; waypoint = { x: (c + 0.5) * map.cellSize, y: (r + 0.5) * map.cellSize }; } } return waypoint ? move(waypoint) : idle; } }; } }); })(typeof window !== 'undefined' ? window : globalThis); ``` ## 考题 B · 移动迷宫 给《AI 坦克大乱斗》的移动迷宫试炼写一辆专用参赛车,在电影线和原著线各跑一局。认出 state.mode === "escape" 且 state.mazeObjectives.trial 存在后,读取 trial.clueMode(film 或 book)。大厅设置名为 mazeClueMode,默认 film。下文的 trial 和 clues 分别指 state.mazeObjectives.trial 和 trial.clues。 ### 出营测绘、返航解码与最终撤离 从林间空地经过四座营门前往八个编号区,白昼、黄昏、夜间共用一张地图。营外主路相互连通,侧路可能随夜间换墙,终室有受保护的隔壁和唯一实际入口;自动选址时每座营门外有一条主路,先笔直向外,中途可能横移一小段再继续向外,末端向一侧拐几格(不超过门到地图边缘格数的四分之一,81×81 最多 8 格,121×121 最多 12 格),其中一座门的主路末端 1~3 格就是终室;三处记录点由近到远分属三个扇区,尽量挂在三座不同营门外的支路上;四座门外的通路各自成树,树与树只各接一次,换扇区通常要回林间改走另一座门;手选终室可以落在任何营外通路上,扇区和距离带仍按实际门位给出,这些规律只能用来排搜索顺序;封闭营墙或终室隔壁按边界碰撞处理。北门左/右分别接 8/1 区,东门 2/3,南门 4/5,西门 6/7。扇区按地图几何中心划分,正北起顺时针每 45° 一区:令 dx = 2×col + 1 − cols、dy = 2×row + 1 − rows;dx ≥ 0 且 dy < 0 时,−dy ≥ dx 为 1 区,否则 2 区;dx ≥ 0 且 dy ≥ 0 时,dx ≥ dy 为 3 区,否则 4 区;dx < 0 且 dy ≥ 0 时,dy ≥ −dx 为 5 区,否则 6 区;dx < 0 且 dy < 0 时,−dx ≥ −dy 为 7 区,否则 8 区。林间之内的格子不属于任何扇区。这里只是营心朝外看时的方位,长走廊会拐弯、跨区和进入死路。大厅专项预设包括紧凑 81×81(360 秒)、标准 121×121(900 秒)、大型 181×181(900 秒)和深渊 241×241(无限时),也可自定义尺度、时限和昼夜时长。 外出调查 · trial.stage === "survey"。从中央林间出发,在三个不同扇区寻找记录点。mazeObjectives.visibleSteles 保存本车或队友已见的石碑,每座含 id、sector、col、row、x、y、radius、activated。驶入同格、距碑心 ≤ stele.radius + self.radius、实际速度 ≤12 像素/秒,连续 2 个模拟秒完成采样。读 trial.scanSeconds、scanRequired 和 sampledSectors,换碑或开走会中断本次采样,重复的扇区只计一次。采样完成后该碑的 activated 变为 true,全阵营共享。trial 上的 hintSector、hintBearing、hintDistanceBand 指向离本车直线最近的那处未采样记录点:hintBearing 是从本车指向它的世界绝对弧度,取整到 45° 的倍数,直线 ≤3 格为 near、≤9 格为 medium、更远为 far。队友采样也会更新阵营记录。 电影线 · 八个外区按本局的顺序轮换。clues.activeSector 显示当期扇区,参与轮换的可动侧路也按此顺序改变。每条 clues.records 记录含 stationSector、kind === "rotation"、beats 和 sectors。两个数组分别是这一组开放拍号和对应的扇区集合,数组下标没有配对含义。beats、sectors 以及 candidates、sampledSectors、rotationOrder 都是 1~8 的整数数组;记录上的 label 只是给观战看的说明文字。比较多组记录的交集,利用 clues.candidates 缩小搜索面。地图室完成分析后公开完整的八拍 rotationOrder。 原著线 · 每条记录的 kind === "overlay",layers 含两份 {day, marks}。day 为 1 和 2,marks 是字符串数组;LL 与 L 同为左支,RR 与 R 同为右支。把三个记录点同一天的笔迹取交集,再组合两个日期的结果。第一日 N/E/S/W 表示从营心面向北/东/南/西门,第二日 L、LL 表示左支,R、RR 表示右支。例如北门左支指向第 8 区,右支指向第 1 区。本局把跨日测绘压缩成石碑上的历史描图,一次勘察即可带回两天的图层。 推理举例。电影档案若依次给扇区集合 [1,3,4,6]、[2,3,5,6]、[1,2,6,8],交集为 6;要还原某一拍,在每份记录里比较「beats 是否含该拍」与「sectors 是否含该区」,三次都相符的就是该拍扇区。原著档案若第 1 日只剩 E,第 2 日只剩 LL,按东门左支得 2 区。示例数字只说明算法,每局重新读档。 生化核心 · 在 state.items 中寻找可见的 type === "griever_core",按本车的 pickupUseful、grantsTracker、healAmount 和 refillsAmmo 决定是否靠近。电影线本阵营取得第一枚核心会装备编号追踪器,同时会按需维修、补弹和清除装填等待,满血满弹也有收益。trial.tracker.equipped 表示阵营已装备;number 是本局终端开放的拍号,译码后可用 clues.rotationOrder[number - 1] 核对目标扇区。signal 只反映本车至禁区内格沿开放通路的近距信号:0–1 步 strong、2–3 步 weak,近路被墙封住且无三步内绕行时为 none。原著线的核心及电影线后续核心会给拾取者至多修复 30 点装甲、补满普通弹仓并清除装填等待。三项都无收益时留在地上。两线均可通过测绘与返营完成试炼。 返回地图室 · trial.stage === "return" 时,clues.pendingAnalysis 为 true。第三份记录已经写入本阵营档案,公开 candidates 保留上一次分析的结果。三份齐全后,由处在林间外的任一队员实际返回中央 mazeObjectives.mapRoom,驶入终端所在的那一格并贴近到距终端 min(38, cellSize×0.3) + self.radius 以内,地图室才会核准三份记录、解锁本阵营。mapRoom.ready 表示本车具备返航资格,留守队员需要先出营再回来。mapRoom 为 {ready,x,y,col,row,cooldownLeft},x、y 就是终端位置,本试炼的 cooldownLeft 恒为 0。核准的那一刻 stage 变为 escape,vaultLocked 变为 false。核准和撤离都在进入范围的当帧完成,不需要停留或减速。 寻找真实入口 · trial.stage === "escape" 后,clues.decodedSector 和 mazeObjectives.targetExitSector 给出目标扇区。clues.rangeBand 给出相对营心的静态距离带 minCells 至 maxCells,距离按横纵格差的较大值计算。营心取 gladeBounds 的中点格,即列 floor((c0+c1)/2)、行 floor((r0+r1)/2)。带宽为 clamp(round(min(cols, rows) ÷ 10), 6, 16) 格,minCells 是带宽的整数倍。结合扇区与距离带,在已知通道的边界分段搜索;绕墙的步数可能更长。跨区时 hintBearing 只指示从营心看该扇区的方向,进入目标扇区后 hintBearing 变为 null,依靠自身观测找路;此阶段 hintDistanceBand 始终为 null。首次目击后 state.exit 才含精确坐标,visible 表示现在是否看得见。每辆车须穿过禁区唯一入口并驶入 exit.radius 才算撤离;提前看到门仍须取得本阵营的译码资格。 选址与验收 · 自动选址在时限和地图尺度允许的营外支路生成终室,各局可能落在不同扇区。另有沙盘手选合法外区格的对局;设图者的坐标不会发给参赛车。请在两条线路下分别检验调查、破译、远区搜门和个人撤离,也要覆盖没有追踪器、信号被墙隔断及手选不同终室的情况。请勿把电影剧情的第 7 区或上一局的门位写成常量。 在本试炼两条线中,vaultLocked 持续到阵营真正返航完成译码,ciphersProgress 只反映本阵营已采样数。ciphersRequired 恒为 3,state.collapseActive 恒为 false。三份齐全仍要返回地图室,解锁后仍要目击门。exitPing 在本试炼为 null,血月、击倒最后对手、捡核心都不会公开隐藏门坐标;未安装追踪器时 tracker.number 为 null、signal 为 none。hintBearing 或 hintDistanceBand 无提示时也可为 null,解码前 rangeBand、decodedSector 为 null,rotationOrder 仅电影线译码后可用。 ### 守夜、营务与补给井 state.mazeCycle.phase 为 day、dusk 或 night;phaseTimeLeft、phaseDuration 是本时段剩余和总模拟秒,dayDuration、duskDuration、nightDuration 是本局三个独立时长,cycleCount 是日夜轮次。标准节奏下 cinema 尺度 81×81 的三个时长为 118、65、39 秒,121×121 为 176、97、59 秒。enabled 在本试炼恒为 true。白昼和黄昏在林间内、没被怪物盯上也没刚挨打时,每 0.25 秒回 2 点装甲。inGlade 标记是否在营内,gladeBounds 给 c0/r0/c1/r1(含端点的格子范围)以及 cols、rows 和林间中心的世界坐标 centerX、centerY,gladeDoors 含 id、col/row、x/y、open、openRatio。id 为 north、east、south、west,col/row 是门内侧的林间格,x/y 是门洞在墙线上的中点。营门关闭时,门所在的格边在 cellWalls 和 knownWalls 里是封闭的,要亲眼看到才会更新。doorsOpen 是当前物理门况;visibleShiftingWarnings 给已目击的 {col,row,x,y,timeLeft},黄昏、黑夜的侧路换墙可夹伤车。按实际回程路线与关门剩余时间选择赶门或留在营外,墙变化后重算已缓存的路线。 日间和黄昏,在营内未被怪物盯住、未刚受伤且血月未至时,受损车每 0.25 秒修 2 点。开启的中央补给井 mazeObjectives.theBox 给 {active,hasCrate,col,row,x,y} 或 null;首次约在开局 16 秒送货,随后每次破晓补货,每车每批最多领一箱。全局上场至少五辆时井有两个箱位。驶近可见的 supply_crate 拾取,满血/满弹/盾和重武效果见下方物资表。取箱会占用返程时间,也会换掉现有武器。 普通夜四门关闭;开放时尾随入营的鬼火兽仍能攻击,白昼和黄昏怪物也会凭直视追进林间。夜巡启用时入夜和夜半有巡逻,墙外可听到带方向误差的动静,黎明开门。巡逻在未隐蔽的营外车、四座营门外和三处记录点周围 4~10 格处生成,不会出现在车的三格内或视线里,黎明撤走。第四夜开始时血月使四门永久敞开,bloodMoonActive 为 true 时营地失去庇护、营务与营内回血停止,须在当前阶段下决定找掩体、继续采样、返航译码或冲门。 墙外脱追 · 普通夜在营外把实际速度压到 12 像素/秒以内(疾跑状态不算)、停火且避开鬼火兽直视,连续约 3 个模拟秒可避开远距嗅探。只读本车的 state.mazeCycle.nightWatch(concealed、quietSeconds、quietRequired);被看见、开火、疾跑或受伤都会暴露,近身仍会受伤。验收会观察黄昏赶门、营内守夜、来不及回营时的取舍,以及解锁后冒险撤离的时机。 普通夜营务 · state.mazeCycle.campDuty 提供 stations.workshop/scout 的 x、y、radius、seconds,以及本车 workshopDone、spare、work、seconds、patchSeconds 和本队 scoutDone、rally。这里的安静指未被怪物盯上、未刚受击、未开火且实际速度不超过 12 像素/秒。维修棚内安静停车 4 秒,受损或缺弹车修最多 30 装甲并补满普通弹;满血满弹可带一组备件,每车每夜值一次。营外装甲≤72% 或缺普通弹≥2 发时,安静停车 1 秒会消耗备件,修最多 30 并补弹。侦察桌停车停火 5 秒,从本队已知路径标一次次日探索前沿;rally 可为 null,有标记时含 col、row、x、y、gate、steps,队友在白昼抵达该格即消耗。每队每夜可制图一次。受袭、驶离、开火或黎明会中断营内值班。可回报 mazeIntent 为 camp_workshop、camp_scout、camp_patch 或 camp_rally。 观战意图 · decide 返回动作时可附带 mazeIntent,填写当次真实决策。可选值为 survey 勘察、decode 返航译码、escape 前往撤离、return_to_camp 赶门返营、guard_camp 营内守夜、hide_outside 墙外避险、risk_escape 冒险突围、collect_supply 拾取补给。该字段只供观战展示;移动和开火仍由动作字段决定。 行车考核:洞悉死路和掉头空间,沿走廊记录返程路线;用 state.mazeCycle 的 phase、phaseTimeLeft、doorsOpen 和已目击的移动墙预警决定是否折返。夜间路线改变要重新观察,迷雾内旧墙是上次目击的记录。处理血月、怪物与机关,宽廊不要用固定像素距离规划。考察不同扇区图样、成功返航译码、个人撤离与超时。 ### 交卷、动作与计时 只交一份完整原生 JavaScript 源码,含全部辅助函数,能直接粘贴到大厅或保存为 .js,通过 file:// 运行。用文末样例的 IIFE 调用 global.registerTankAI({ id, name, author, color, description, createController })。id 用唯一英文标识,name 写真实完整模型名及项目,author 写实际作者,color 用 HEX 色值,description 说明你的策略。用代码注释解释目标优先级、射界与碰撞判断、捡取与使用道具的取舍,以及切换阶段或重算路线的条件。只使用传入的比赛信息与每车自己的记忆;禁止使用模块导入、外部库、DOM、存储、网络、计时器、引擎私有对象或其他参赛车代码。 | 调用 | 你收到什么、应返回什么 | | --- | --- | | createController(tankInfo) | 每局开局时为每辆车新建一份实例,闭包里的记忆不会带到下一局,跨局只能读 onRoundStart 的 experience。tankInfo 含 id、slotId、aiId、name、modelName、color、team。返回带 decide 方法的对象,路线、访问次数、上一目标、脱困记录都放本车闭包。 | | onRoundStart(roundInfo)(可选) | 清理本局记忆。round、mode、selfId、team、map、visionRadius、rules 描述开局(map 与 state.map 同一视角,逃离时只含开局已看到的部分),experience 为可空的本模型历史统计。rules 另含 mazeCycleEnabled、monstersEnabled、trapsEnabled(启用的机关 ID 数组)。 | | decide(state, api) | 同步返回 { throttle, targetAngle, fire } 或 { throttle, turn, fire }。throttle ∈ [−1,1],负值倒车,零油门停驱动。targetAngle 是世界绝对弧度,turn ∈ [−1,1] 是转向输入(负左、正右),选一种;两者都给时非零 turn 优先,targetAngle 只在 turn 为 0 时生效。希望保持朝向时省略 targetAngle 并给 turn: 0。fire 为布尔值,触发当前武器。炮管随车身转;转向需要时间,可倒车瞄准。 | | onRoundEnd(result)(可选) | 可读本车 won、extracted、extractionOrder、deathCause、survivalSec、kills、teamKills、itemsPicked、exploredRatio、backtrackRatio、shotsFired、shotsHit 等复盘字段,另有 round、mode、outcome、durationSec、modelId、isPlayer、aliveAtEnd、deaths、suicides、killerModelId、hitAccuracy、shieldBreaksTaken、monstersKilled、grieverKills、alphaGrieverKills、swarmerKills、sentinelKills、ciphersDecoded、exitFirstSeenSec、minStepsToExit、nightOutsideSec 和 driver(启用模型 API 驾驶时的用量统计,否则为空)。未撤离时 extractionOrder 为 null。 | state.mode 只有 brawl 和 escape 两个取值。state 里的 tanks、allies、enemies、bullets、lasers、items、monsters、monsterPings、traps、frontierCells、knownWalls 恒为数组,没有内容时是空数组;state.collapseActive 是布尔值。物理以 60 Hz 推进。state.tick 是物理步序号,time 是本局模拟秒,dt 是本车距上次决策经过的模拟秒,timeRemaining 是剩余的模拟秒(不限时为 Infinity)。高倍速或多车时可能跳过若干次决策:被跳过的物理步沿用上一次的 throttle 与转向,fire 只有 gatling 会续射,其他武器等下一次决策再发;近处出现敌弹或怪物时引擎会提前安排决策。用模拟秒计时。state.rules 的 mode、roundTimeLimit(模拟秒,逃离局填的是逃离时限,0 表示不限时)、friendlyFire、selfDamage、maxBounces、visionRadius、corridorScale、cellSize、wallThickness、sprintEnabled、exitPingEnabled、vaultRequiresCipher 反映本局配置。 ### 地图、四邻通路与物理 state.map 给出 cols、rows、width、height、cellSize、wallThickness、corridorScale、shape、isMegaMap、gridMask、cellWalls、walls。乱斗的 shape 是真实形状;逃离的迷雾快照里 shape 恒为 "unknown",轮廓要从已探明的 gridMask 判断。Canvas 原点在左上,x 向右、y 向下,角 0 朝右、π/2 朝下;位置、半径、距离用世界像素,速度用像素/模拟秒,角速度用弧度/模拟秒。格子地址是 (col,row),网格访问是 [row][col],格心为 ((col+0.5)×cellSize,(row+0.5)×cellSize)。 常规尺寸从 9×7、14×10、22×16、36×26、64×48 延伸到百格级(如 111×111、161×161、221×221)和 1000×1000,自定义每边 6~1000。五档走廊的格宽/墙厚分别为 classic 64/6、wide 128/16、cinema 224/36、colossus 288/48、plaza 680/60,沙盘还可自定宽厚。实际几何取本图字段,沿墙行驶时车心到墙段中心线至少留 self.radius + wallThickness/2 的距离。标准车半径 14.5;视野、弹速、弹寿、部分怪物与机关半径随尺度变化,优先用实体的 radius 与速度。令 k = cellSize/64:弹速乘 1 + 0.22×(k − 1),弹寿乘 √k,EMP 半径为 round(190 × k^0.45),撤离门半径为 round(20 × clamp(1 + 0.4×(k − 1), 1, 2.4))(64 格宽为 20,224 为 40);车半径、普通弹半径、拾取距离、地雷的 28 和 56 像素、怪物速度不随尺度变化。逃离的实际视距 = round(配置视距 × (cellSize/64)^0.85),cinema 尺度配置 420 时为 1218 像素。 gridMask[r][c] 为 false 的已知格不可走。自当前格进入四邻格,检查边界、两格掩码、当前格 top/right/bottom/left(true 封闭)和邻格反方向的边;拐角按车体半径留量。形状决定地板范围,内部迷宫通路仍须逐边判断。 | 地图地形 | 对行车、视线或弹道的影响 | | --- | --- | | rectangle 矩形 | 外接矩形内均为地板,内墙仍会把相邻两格隔开。 | | circle 圆形 | 按横纵尺寸归一的圆/椭圆轮廓,四角裁去。贴外圈时沿阶梯状边界走。 | | ring 环形回廊 | 外环包住中央禁区。目标在对侧时比较顺、逆时针两条路线,小图按掩码确认内孔。 | | cross 十字要塞 | 切掉四角形成四翼。跨翼通常要回中部,翼端受堵时及时掉头。 | | hourglass 沙漏峡谷 | 南北两头较宽,左右边往中线收拢成腰口。南北换区要经过腰口,留意封路炮火。 | | diamond 菱形 | 四角沿斜向裁成阶梯,中央横向最宽。沿斜边用四邻绕行,切角时检查车体净空。 | | fortress 双核堡垒 | 地图内有对称的不可走柱块,尺寸够大时分为四组,小尺寸可简化为左右两组。可沿中路或外缘迂回。 | | custom 画笔掩码 | 地板来自沙盘绘制的轮廓,可能有孔洞、窄桥和凹边。根据观测到的 gridMask 和邻边规划。 | | maze_runner 移动迷宫 | 中央林间、四门、八区和可变侧路,较大图外轮廓削去四角。通路随门况与墙位变化,已见过的路也要复核。专项使用此图形。 | | 薄墙、厚石墙、巨石壁 | 经典窄巷为薄墙,宽道用厚石墙,电影峡谷、史诗巨廊与大道的墙更厚。它们都能遮蔽视线、阻挡车身并反弹普通弹;厚度影响过角和炮口净空。 | | 普通内墙、边界墙 | 墙段给 x1、y1、x2、y2、isBoundary。穿墙增益与穿墙弹可忽略普通内墙,地图外缘、地板孔洞或标为边界的隔墙仍会阻挡。 | | 风化墙、开放裂缝 | 启用时,部分内墙可击穿。风化墙 3 点耐久,普通弹每次碰撞削 1,霰弹弹丸、巨炮、破片弹本体、激光或地雷爆炸可削 3。打通后只开中央约 42~44 像素净口,两肩仍实体,子弹也会碰肩。以已知墙段几何为准;有标记的墙段可带 isWeathered / isCrackStub,以及标识所属裂缝的 crackKey。小虫可钻缝,普通鬼火兽和兽王体型过大。 | ### 车况、弹道与地面物资 乱斗经典底盘前进 138、倒车 96 像素/秒,转向 3.9 弧度/秒;宽廊下乱斗车速乘 1 + 0.10×(cellSize/64 − 1)。逃离底盘前进 172、倒车 122、转向 4.3,基础行驶速度独立于格宽。车没有惯性:每个物理步的速度就是油门 × 极速 × self.speedMultiplier,沿车头方向;turn 乘以最大转向率,targetAngle 以最大转向率逼近、差不足一步时直接对正。rules.sprintEnabled 开启时,逃离在油门 ≥0.55、平稳前进且无近战威胁约 1.35 秒后渐升至 275 像素/秒,与 turbo 叠加前进上限 320。开火、激烈转向、撞墙、黑沼或受击可打断巡航。平稳指实际转向率不超过 2.35 弧度/秒(乱斗 1.85);近战威胁指 240×max(1, cellSize/64)^0.7 像素内有处于 chase 状态的怪物(不看视线)或有直视的敌车。被打断后要等 1.6 秒才能重新累计,受伤后 1.8 秒,迎头撞墙 0.65 秒。乱斗默认不开疾跑,沙盘开启后需平稳直行约 2 秒才起步。用实际速度估算返程,可倒车迎击追兵。 state.self 以及 tanks、allies、enemies 的车体快照含 id、name、modelName、team、color、skinId、x、y、col、row、vx、vy、angle、radius、hp、maxHp、hpRatio、ammo、maxAmmo、reloadCooldown、fireCooldown、weapon、weaponAmmo、hasShield、turboTimer、phaseTimer、empStunTimer、invulnTimer、speedMultiplier、sprinting、sprintFactor、mireExposure、ciphersProgress。各 Timer/Cooldown 用秒。reloadCooldown 是距下一发普通弹装好的秒数(弹鼓已满为 0),fireCooldown 是距可以再次开火的秒数;敌车和队友的这些字段也是真实值。weapon 为 null 时用普通炮。普通炮每发消耗 1 点 ammo,ammo 为 0 时 fire 无效。用 allies / enemies 分辨阵营,空队号车各自作战。tanks、allies、enemies 只含存活车。多车同阵营共享胜负,开火风险由 friendlyFire 和 selfDamage 分别控制。 装甲档为 1、100、160 点,按 self.maxHp 判断。一击制中一次有效伤害即可击毁;装甲制中普通弹、导弹、加特林弹丸与破片各伤 25,激光/穿墙弹/巨炮 65,地雷与榴弹本体 55,霰弹同一轮对同车至多 60;怪物近战为 swarmer 20、sentinel 30、griever 38、alpha_griever 52,地刺、锯片和红外绊线 30,移动墙夹击 60。常规受伤后约 0.55 秒无敌(机关 0.65、黑沼 0.2、破盾 0.5),读取 invulnTimer 安排下一发。普通弹鼓 5 发,约每 1.55 秒回 1 发,最短射击间隔 0.18 秒。经典尺度的普通弹半径 3.8、速度 235、寿命 11.5 秒,反弹上限读 rules.maxBounces(默认 9)。 state.bullets 每项含 id、ownerId、type、x/y、vx/vy、speed、angle、radius、bouncesLeft、lifeLeft、piercingWalls、armed;type 取 normal、shotgun、gatling、railgun、missile、frag_bomb、giant_ball、shrapnel(榴弹炸出的破片)或 mine,弹丸命中车体即消失,piercingWalls 只有 railgun 为 true;mine 也在这里,armed 表示已布防。lasers 含 ownerId、segments(每段 x1/y1/x2/y2)、lifeLeft,记录已发出的瞬发光束。射击前从炮口方向检查墙、己方车及各反射段;躲弹时要看弹速、半径和预计相遇时间。fire 在同一物理步的转向和位移之后结算,弹丸沿结算时的车头方向、从车心前 max(20, 16 + 弹半径) 像素处出膛(普通弹、霰弹、加特林和激光 20,railgun 21,missile 21.5,frag_bomb 22.5,giant_ball 29;地雷放在车心后 24.5);炮口顶着墙时贴着墙面出膛并立刻反弹。selfDamage 开启时,自己的弹丸出膛约 0.1 秒后或第一次反弹后就能伤到自己(导弹、榴弹与巨炮约 0.7 秒),破片没有保护期;激光首段不伤发射者,反射段会。经典尺度下特殊弹丸的速度为 shotgun 265、gatling 290、railgun 480、missile 165、frag_bomb 185、giant_ball 195(半径 13),其余以快照的 speed、radius 为准。 state.items 每项有 id、type、x、y、col、row,常规箱有 category:武器箱为 weapon(type 就是武器 ID),shield、turbo、phase 为 buff;特殊掉落按 type 判断。车心驶到距物资约 self.radius + 20 像素内且接触路径与物资间无遮挡即自动拾取,无单独按键;石碑、地图室终端、补给井、物资和撤离门都不是实体,车可以直接开上去;lifeLeft 只在乱斗快照提供。每辆车只有一个特殊武器槽;持有特殊武器期间 fire 只发射它,普通炮用不了,也不能主动丢弃;捡到武器即替换旧武器并给予表中弹数,fire 每次成功发射消耗一发,用尽自动回普通炮;特殊武器每发后有约 0.28~0.42 秒间隔,刚捡到时等待压到 0.08 秒内,按 fireCooldown 判断。增益和维修包接触即结算。常规补给默认约每 5.5 秒尝试刷新、基础上限 6 个;沙盘可调种类、间隔和上限,大图还可按有效格数提高上限、加快刷新。 | 武器 ID | 每箱弹数 | 发射效果及取舍 | | --- | ---: | --- | | laser | 1 | 瞬发光束,最多反射 6 次,沿线可命中多辆车。光束总长 3500×max(1, cellSize/64) 像素。适合已算准的折射线,回折段可击中自己。 | | railgun | 2 | 高速电磁弹穿非边界内墙,零反弹。适合隔掩体拦截已知目标,射线后方的队友也可能中弹。 | | shotgun | 2 | 每发扇射 7 枚、各可反弹 3 次。近距横向覆盖宽,窄角内先为后坐与散射留空间。 | | giant_ball | 2 | 大半径铁球可反弹 8 次,能碾碎普通弹幕;适合直廊压制,贴厚墙时容易折回。 | | missile | 1 | 导弹向敌车制导、可沿通路转向,最多反弹 2 次,也能被其他弹击毁。适合追击转角后的移动目标。 | | frag_bomb | 1 | 榴弹到期、弹跳满 3 次或接敌可炸出 14 枚全向破片。适合封堵路口,爆点近身会使己车与友军同时暴露。 | | gatling | 18 | 持续 fire 快速逐发射击(间隔 0.075 秒),弹丸略有散布、可反弹 4 次。可压制走廊,连续开火也会引怪、打断巡航。 | | mine | 3 | 每发在车尾放一枚,约 1.2 秒布防;感应、弹击或连锁可引爆。布防后任何存活车(含布雷者和队友)驶入约 28 像素即触发,爆炸半径约 56 像素,无人触发约 55 秒后失效,对己方的伤害仍按 selfDamage、friendlyFire 结算。封退路时留出爆区,布设本身不发远距枪声。 | | emp | 1 | 以自身为中心(经典尺度半径约 190 像素)清除范围内其他车发出的弹体(含友弹和地雷),使敌车和怪物减速 2.5 秒:移动与转向降到约 35%,前 1 秒无法开火。适合弹幕中脱身或近距控怪,半径随尺度变化。 | | 物资 ID | 触发与收益 | 何时值得靠近 | | --- | --- | --- | | shield | 立即获得一层护盾,挡下一次有效受击,破盾后短暂免伤。重复拾取仍为一层。 | 无盾过危险路口或对射前。 | | turbo | 立即刷新到 8 秒,移动和转向乘 1.45,受速度上限约束。 | 长廊赶路或离开威胁;狭口提前收油。 | | phase | 立即刷新到 5 秒,车体可越非边界内墙,并免地刺、锯片和红外绊线。黑沼仍减速、腐蚀。 | 借内墙截弯或躲机关,结束前找可站立的有效地面。 | | medkit | 仅受损车可拾取,最多修复 45 点,不超 maxHp。装甲局可随常规刷新或怪物掉落出现。 | 按缺血量、敌火和可达路线估算收益;满血时留给队友。 | | supply_crate | 金色整备箱一次修满装甲、加一层盾、补满普通弹,随机装备满弹 laser、railgun、shotgun 或 giant_ball。 | 受损缺弹时价值高,已有主武器会被替换;兽王也可掉落。 | ### 怪物与地面机关(可由沙盘启闭) state.monsters 每项为 id、type、x/y、vx/vy、angle、radius、hp/maxHp、state、frenzied。state 取 patrol、alert、chase、retreat 或 stunned,frenzied 为布尔值。griever(3 HP)凭目击、枪声追猎,夜间狂暴;alpha_griever(8 HP)可能守在出口防区,留意其追击和回防;swarmer(1 HP)体小可钻开放裂缝;sentinel(1 HP)沿直廊折返,近身切割。激光、穿墙炮、巨炮、导弹、榴弹本体和地雷可对怪物造成 3 点,普通弹通常 1 点。怪物速度不随尺度变化,按巡逻、追击、夜间或狂暴依次为(像素/秒):swarmer 118、152、160,griever 96、134、152,alpha_griever 88、126、142,sentinel 122、136、146;追击都快过倒车,只靠倒车甩不掉。怪物与车的中心距不超过两者半径之和减 1.5 像素即咬中。可引怪踏入机关,计算它与车的距离再决定取掉落。逃离的 monsterPings 提供 bearingRad(带误差的世界绝对弧度)、intensity(强度)、isBoss,仅代表本车听到的动静。 | state.traps 的 type | 读数与通过办法 | | --- | --- | | spike | 地刺按 dormant → warning → active 循环,active 圆区伤车。三段固定为 4.2、1.4、0.85 秒,开局相位随机。预警时用剩余时间判断能否穿过。 | | mire | 黑沼让速度与转向乘 0.62,连续停留约 1.25 秒起每 0.25 秒腐蚀一次,装甲车每次 4 点。self.mireExposure 为 0~1,离开重置,phase 仍会受影响。 | | saw | 锯片沿 (x1,y1) 至 (x2,y2) 往返。滑轨有的横穿走廊,有的顺着走廊跨两格。往返一趟约 5.56 秒:每个单程先在端点停约 0.5 秒,再用约 2.28 秒按余弦缓动滑到另一端(两头慢、中间快)。按 bladeX、bladeY、radius 及连续观测判断扫过时间,贴着刚扫过的空档通行。顺着走廊的滑轨等不出空档,要按 radius 判断能否贴墙从旁边过,过不去就改道。 | | laser_trip | 红外线段两端为 x1/y1、x2/y2;off 熄灭,warn 将亮,on 通电。三段固定为 3.5、0.65、1.85 秒,开局相位随机。比较开窗长度和车体清空线段所需时间。 | 每个机关共同字段为 id、type、col/row、x/y、radius、visible、state、stateTimer。stateTimer 是当前状态还剩多少秒。地刺、黑沼和锯片按圆与车体圆相交判定(中心距 ≤ 两者半径之和),绊线按车心到线段的距离 ≤ 车半径判定。逃离时旧机关只保留底座位置,visible 为 false、state 为 unknown、stateTimer 为 null,锯片和绊线的动态几何只在可见时给出。不要用上一帧倒计时穿越阴影中的机关。 ### 迷雾观测与几何 API 逃离时 state.visionRadius 是实际视距,墙会遮住光学视线。state.visibleGrid[r][c] 表示现在看见,state.exploredGrid[r][c] 表示曾探索;state.knownWalls 是已知墙段,state.frontierCells 中的 {col,row,x,y,unknownNeighbors,frontierAngle} 表示一个已知格、开放方向上的未知邻格数和建议探索角。尚未探明的格子在 gridMask 里为 true,cellWalls 四边按开放给出(紧贴已探明无效格的除外),findPath 也会乐观地穿过它们;用 exploredGrid 区分已探和未探,进入视野后以新墙、掩码和实际运动修正路线。敌车、地面物资和飞弹按本车与存活队友的观测提供,激光只给可见片段。同队存活车由 allies 直接给出,己方地雷即使出了视距也可在 bullets 中出现。tanks 汇总 self、allies 与已知 enemies。看不见的敌人可能仍在活动。 逃离中 exit 未知时为 null,已知对象为 {col,row,x,y,radius,visible,firstSeenTime},visible 表示此刻能否看见。门心或其上下左右约 0.6 个门半径处的任一点进入本车或存活队友的视距且中间无墙,才算发现;所在格进了 exploredGrid 不等于门已被看见。解锁后使车心距门心 ≤ exit.radius 才算撤离。首辆撤离车锁定胜方与积分,其余车辆继续至各自撤离、阵亡或超时,同帧按距门心远近定先后。用 result.extracted、extractionOrder 区分个人撤离与阵营获胜。 | 调用(? 为可选参数) | 返回及使用范围 | | --- | --- | | api.normalizeAngle(rad);api.angleDiff(fromRad,toRad) | 归一化弧度;从前角转向后角的最短有符号角差。 | | api.distance(x1,y1,x2,y2) | 两个世界点间的直线距离,计算弯路行程应累加各段。 | | api.worldToCell(x,y);api.cellToWorld(col,row) | 前者返回夹在外接矩形内的 {col,row},仍要查掩码;后者返回格心 {x,y}。 | | api.hasLineOfSight(x1,y1,x2,y2,ignoreInternalWalls?) | 是否有无遮挡的几何直线,布尔值。可选 true 忽略内墙;自行核对光学可见性与车身净空。 | | api.raycast(x,y,angle,maxDist,ignoreInternalWalls?,radius?) | 沿给定弧度测墙距,radius 是射线的膨胀半径。读取 hit、dist、x、y;命中时另有 normalX、normalY、wall,未命中时 dist 为最大测距。 | | api.traceBouncePath(x,y,angle,maxBounces?,maxDist?,bulletRadius?) | 返回可遍历的线段数组,每段含 x1/y1/x2/y2、length、angle、bounceIndex,数组另有 totalDist。maxBounces 缺省取 rules.maxBounces,maxDist 缺省取 2400×max(1, cellSize/64) 像素(比激光短,验算激光要显式传 6 和 3500×同一系数),bulletRadius 缺省为普通弹半径。计算沿途车体相交需自己完成。 | | api.findPath(fromCol,fromRow,toCol,toRow,ignoreInternalWalls?) | 返回含起点的 {col,row,x,y} 路点数组;无路或非法格返回 [],超大图搜索预算用尽可只给部分路线,核对末节点。 | | api.alignForKnownCrack(state, travel, memory)(仅逃离) | travel 是本车拟执行的行驶动作,memory 为每车每局持有并复用的对象。需要时返回穿过已知通缝的对齐动作,其余返回 null;由控制器决定是否采用。 | 通用几何 API 在乱斗使用实图,在逃离只按已知地图答复。不要把穿过未知格的射线或试算路线当作侦察结果。cols×rows > 65536 时 map.isMegaMap 为 true,地形与迷雾按需读取,逃离的 knownWalls 只覆盖局部战术窗口;按 [row][col] 查询邻域。可缓存稀疏访问、用前沿和分段路点规划,地图更新、掉头或久未前进时重算。按平均每次 decide 约 2 ms 以内设计,避开逐帧全图遍历、复制网格、全图尺寸内存分配;线性索引使用 Number 或 Int32Array,避免 Int16 超过 32767。 可直接导入的移动迷宫 JS 入门样板 将代码块内的内容粘贴到大厅「接入新模型坦克」即可试跑。样板演示如何识别两条线、判断核心收益、逐格勘察、返营、守夜与撤离。交卷时换成唯一 id、实际模型全名和作者,并实现自己的档案推理、长程寻路和夜间风险决策。 ```javascript (function (global) { 'use strict'; global.registerTankAI({ id: 'example_model_maze_trial', // 用自己的唯一英文 id,与 A 卷区分。 name: '示例模型全名 · 移动迷宫', // 排行和战报显示真实模型全名,author 署实际作者。 author: '示例作者', color: '#0d9488', description: '循线索调查三个不同扇区,返营译码后逐格找门;普通夜优先静默。', createController: function (tankInfo) { // 同一模型的队友共享的是引擎公布的阵营档案。tankInfo.id 对应的车单独保留路线和足迹。 const visits = new Map(); let next = null, lastCell = -1, crackMemory = {}; function reset() { visits.clear(); next = null; lastCell = -1; crackMemory = {}; } function stop(intent) { // turn 是相对转向量,零表示保持当前朝向。targetAngle: 0 则会转向右方。 return { throttle: 0, turn: 0, fire: false, mazeIntent: intent }; } return { onRoundStart: function (roundInfo) { // roundInfo 有 mode、map、rules 和可为空的 experience。新局的扇区、门位和机关都可能变化。 reset(); }, onRoundEnd: function (result) { // result.extracted 是本车是否出门,extractionOrder 是顺位,won 是胜负结果。 reset(); }, decide: function (state, api) { const objectives = state?.mazeObjectives; const trial = objectives?.trial; // 普通逃离也叫 escape。trial 缺失或为 null 就停车,让样板只参加自己的项目。 if (state?.mode !== 'escape' || !trial || !state.self || !state.map || !api) return stop(); const { self, map } = state; const cycle = state.mazeCycle; const dist = p => Math.hypot(p.x - self.x, p.y - self.y); const sees = p => api.hasLineOfSight(self.x, self.y, p.x, p.y); const room = objectives.mapRoom; const openExit = trial.stage === 'escape' && state.exit; const nearExit = openExit && dist(openExit) < map.cellSize && sees(openExit); const night = cycle?.phase === 'night'; // 普通夜营内关门也可能有先前进来的怪;营外停车停火且避开直视约 3 秒才可能隐蔽。 // 只在已解锁且眼前就能冲门时冒险。血月门已失守,继续执行本队试炼进度。 if (night && !cycle.bloodMoonActive && !nearExit) { next = null; return stop(cycle.inGlade ? 'guard_camp' : 'hide_outside'); } let target = null, intent; if (cycle?.phase === 'dusk' && trial.stage !== 'escape' && room && (cycle.inGlade || dist(room) / (172 * 0.8) + 2 <= cycle.phaseTimeLeft)) { // 逃离基础前速 172,本例给八成油门,另留 2 秒转向。墙后地图室可改用实际绕行距离估时。 intent = 'return_to_camp'; target = room; } else if (trial.stage === 'survey') { intent = 'survey'; target = (objectives.visibleSteles || []).find(s => !s.activated && !trial.sampledSectors.includes(s.sector)); // 电影的三份轮换记录约束八拍顺序,第一枚核心可给本队编号追踪器;原著的两层描图 // 分别按日期求交,得出营门和左右支路。原著核心只作维修补弹,两线都要回地图室。 if (!target) { const core = (state.items || []).find(it => it.type === 'griever_core' && it.pickupUseful && dist(it) <= map.cellSize * (trial.clueMode === 'film' && it.grantsTracker ? 1.5 : 1) && sees(it)); // 核心靠接触拾取。fire 会发射当前武器或触发 EMP/地雷,并暴露夜间位置。 if (core) { target = core; intent = 'collect_supply'; } } } else if (trial.stage === 'return') { // 第三份记录入档后仍待核准。留守车的 ready 为假,此时继续出营探索,取得资格再返航。 intent = 'decode'; if (room?.ready) target = room; } else if (trial.stage === 'escape') { // 译码公开扇区和距离带。门坐标要亲眼或由队友发现,exit 尚为 null 就继续搜。 // 跨区的 hintBearing 指营心看该扇区的方向;进入该区后约束消失,不能当作门的坐标。 intent = night && nearExit ? 'risk_escape' : 'escape'; target = state.exit; } else return stop(); const here = self.row * map.cols + self.col; if (here !== lastCell) { visits.set(here, (visits.get(here) || 0) + 1); lastCell = here; } let aim; if (target && self.col === target.col && self.row === target.row) { next = null; // 采样需同格靠碑且低速持续 2 个模拟秒,停车等 trial.scanSeconds 累积; // 返营靠近地图室终端,离场必须驶入 exit.radius。mazeIntent 只是申报动作意图。 if (dist(target) <= (target === state.exit ? target.radius : self.radius)) return stop(intent); aim = target; } else { const goal = target ? target.row * map.cols + target.col : -1; if (next && (next.intent !== intent || next.goal !== goal || dist(next) <= 5 || !sees(next))) next = null; if (!next) { const walls = map.cellWalls?.[self.row]?.[self.col]; if (!walls) return stop(intent); const bearing = target ? Math.atan2(target.y - self.y, target.x - self.x) : trial.hintBearing; // 小图已知目标隔墙时,findPath 用本车的迷雾地图规划,路径含起点,[1] 才是下一格。 // 未探通路是假设,墙移后要重新观察。大图只看四邻,避免扫描整幅百万格地图。 const step = target && map.cols * map.rows <= 4096 ? api.findPath?.(self.col, self.row, target.col, target.row)?.[1] : null; let best = -Infinity; for (const [edge, dx, dy] of [['right',1,0], ['bottom',0,1], ['left',-1,0], ['top',0,-1]]) { const col = self.col + dx, row = self.row + dy; if (walls[edge] || col < 0 || row < 0 || col >= map.cols || row >= map.rows) continue; if (map.gridMask && !map.gridMask[row]?.[col]) continue; const along = Number.isFinite(bearing) ? dx*Math.cos(bearing) + dy*Math.sin(bearing) : 0; const followsPath = step && col === step.col && row === step.row; const score = followsPath ? Infinity : along - 3 * (visits.get(row * map.cols + col) || 0); if (score > best) { best = score; next = { intent, goal, x: (col + 0.5) * map.cellSize, y: (row + 0.5) * map.cellSize }; } } if (!next) return stop(intent); } aim = next; } // x 向右、y 向下;atan2(dy, dx) 给出车体兼炮口的世界朝向。余弦接近 1 才前进, // 防止车头横着时擦墙。需要对着追兵撤退可以保留瞄准角并给负油门。本例保持静默。 const angle = Math.atan2(aim.y - self.y, aim.x - self.x); const act = { throttle: Math.cos(angle - self.angle) > 0.8 ? 0.8 : 0, targetAngle: angle, fire: false, mazeIntent: intent }; // 只对已知开放裂缝修正进场角。样板展示调查循环;长期地图归档、选掩体和营务可由参赛者扩展。 return api.alignForKnownCrack?.(state, { ...act, throttle: 0.8 }, crackMemory) || act; } }; } }); })(typeof window !== 'undefined' ? window : globalThis); ```