feat: 新增物理 tick 录制，把「走不动」的三种原因切开（1.9.0）
抓包已经证明「手动按键时客户端坐标一字未变、服务端入站位置包为 0」， 问题在 prismarine-physics 这一层；但抓包只能看到「发出去的包」， 看不到物理引擎内部读到了什么输入、算出了什么、有没有真的移动。 本提交补上这最后一块拼图。 新增 src/core/physicsRecorder.js + 控制台接口 （POST /api/bots/:id/physics/start|stop、GET /api/bots/:id/physics）： 逐 tick 记录位置增量、速度、onGround、isCollidedHorizontally、控制键快照、 脚下/脚部/头部方块名、physicsEnabled；汇总给出四个判定计数： - inputTicks 有移动输入的 tick 数 - inputMovedTicks 其中真的产生了水平位移的 - blockedTicks 有输入、没位移、物理报告碰撞 → 被方块挡住（地形） - frozenTicks 有输入、没位移、物理没报告碰撞 → 输入根本没进物理 即：抓包看「发了什么」，本录制器看「物理读到了什么、动没动」，两者配合即可定位。 细节： - 录制开始时先取一次当前位置作基线，避免第一个 tick 因「没有上一 tick 可比」 被误判成「有输入但没动」； - 滚动缓冲只保留最近 240 个 tick（约 12 秒），只放内存、不写盘； - 录制全程 try 包裹，诊断自身出异常绝不影响物理循环； - FakeBot 补上与 mineflayer 一致的 controlState（带 getter 的实时控制键代理）。 测试：451 → 468 个用例（含三种故障判定的回归用例与控制台接口用例），全绿。
这个提交包含在：
lyizai
@@ -50,6 +50,16 @@ class FakeBot extends EventEmitter {
|
||||
};
|
||||
/** @type {Record<string, boolean>} */
|
||||
this.controls = {};
|
||||
/**
|
||||
* 与 mineflayer 保持一致：用带 getter 的 `controlState` 暴露实时控制键。
|
||||
* mineflayer 传给物理引擎的就是这个对象，所以诊断代码按它读输入。
|
||||
*/
|
||||
this.controlState = {};
|
||||
for (const control of ['forward', 'back', 'left', 'right', 'jump', 'sprint', 'sneak']) {
|
||||
Object.defineProperty(this.controlState, control, {
|
||||
get: () => this.controls[control] === true
|
||||
});
|
||||
}
|
||||
this.heldItem = opts.heldItem || null;
|
||||
this.inventory = { slots: opts.slots || [] };
|
||||
this.entities = {};
|
||||
|
||||
@@ -0,0 +1,221 @@
|
||||
'use strict';
|
||||
|
||||
const test = require('node:test');
|
||||
const assert = require('node:assert');
|
||||
|
||||
const { PhysicsRecorder, DEFAULT_MAX_TICKS } = require('../src/core/physicsRecorder');
|
||||
const { FakeBot } = require('./helpers/fakeBot');
|
||||
|
||||
/** 造一个站在石头上的假 bot（脚下是 stone，便于断言方块名） */
|
||||
function setup(options) {
|
||||
const opts = options || {};
|
||||
const bot = new FakeBot({ x: 0, y: 64, z: 0 });
|
||||
bot.blockMap.set('0,63,0', { name: 'stone', boundingBox: 'block' });
|
||||
bot.blockMap.set('0,64,0', { name: 'air', boundingBox: 'empty' });
|
||||
bot.blockMap.set('0,65,0', { name: 'air', boundingBox: 'empty' });
|
||||
const recorder = new PhysicsRecorder(opts);
|
||||
recorder.setBot(bot);
|
||||
return { bot, recorder };
|
||||
}
|
||||
|
||||
/** 模拟一 tick：先改位置/速度/碰撞状态，再触发 physicsTick */
|
||||
function tick(bot, patch) {
|
||||
Object.assign(bot.entity, patch || {});
|
||||
bot.emit('physicsTick');
|
||||
}
|
||||
|
||||
test('没有 bot 时拒绝开始录制', () => {
|
||||
const recorder = new PhysicsRecorder();
|
||||
const result = recorder.start(1);
|
||||
assert.strictEqual(result.ok, false);
|
||||
assert.match(result.message, /没有可录制的连接/);
|
||||
assert.strictEqual(recorder.running, false);
|
||||
});
|
||||
|
||||
test('逐 tick 记录输入、速度、位移与脚下方块', () => {
|
||||
const { bot, recorder } = setup();
|
||||
assert.strictEqual(recorder.start(1).ok, true);
|
||||
assert.strictEqual(recorder.running, true);
|
||||
|
||||
bot.setControlState('forward', true);
|
||||
bot.entity.velocity.set(0.1, -0.078, 0);
|
||||
tick(bot, { position: bot.entity.position.offset(0, 0, 0.1) });
|
||||
tick(bot, { position: bot.entity.position.offset(0, 0, 0.1) });
|
||||
|
||||
const snap = recorder.snapshot();
|
||||
assert.strictEqual(snap.count, 2);
|
||||
assert.strictEqual(snap.physicsEnabled, true);
|
||||
const first = snap.ticks[0];
|
||||
assert.strictEqual(first.control.forward, true);
|
||||
assert.strictEqual(first.control.back, false);
|
||||
assert.strictEqual(first.vx, 0.1);
|
||||
assert.strictEqual(first.onGround, true);
|
||||
assert.strictEqual(first.blockBelow, 'stone');
|
||||
assert.strictEqual(first.blockAtFeet, 'air');
|
||||
assert.strictEqual(first.blockAtHead, 'air');
|
||||
// 录制开始时会先取一次当前位置当基线，所以第一个 tick 也有有效位移
|
||||
assert.strictEqual(first.dz, 0.1);
|
||||
assert.strictEqual(snap.ticks[1].dz, 0.1);
|
||||
assert.strictEqual(snap.inputTicks, 2);
|
||||
assert.strictEqual(snap.inputMovedTicks, 2);
|
||||
assert.strictEqual(snap.maxHorizDelta, 0.1);
|
||||
});
|
||||
|
||||
test('有输入但没位移且物理报告水平碰撞 → 记为「被方块挡住」', () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start();
|
||||
bot.setControlState('forward', true);
|
||||
// 位置不变、物理报告水平碰撞：典型的「撞墙」
|
||||
tick(bot, { isCollidedHorizontally: true });
|
||||
tick(bot, { isCollidedHorizontally: true });
|
||||
|
||||
const snap = recorder.snapshot();
|
||||
assert.strictEqual(snap.inputTicks, 2);
|
||||
assert.strictEqual(snap.inputMovedTicks, 0);
|
||||
assert.strictEqual(snap.blockedTicks, 2);
|
||||
assert.strictEqual(snap.frozenTicks, 0, '报告了碰撞就不算「输入没生效」');
|
||||
});
|
||||
|
||||
test('有输入但没位移且物理没报告碰撞 → 记为「输入没进物理」', () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start();
|
||||
bot.setControlState('forward', true);
|
||||
// 位置不变、速度恒为 0、也没有碰撞报告：输入根本没生效
|
||||
tick(bot, { isCollidedHorizontally: false });
|
||||
tick(bot, { isCollidedHorizontally: false });
|
||||
|
||||
const snap = recorder.snapshot();
|
||||
assert.strictEqual(snap.inputTicks, 2);
|
||||
assert.strictEqual(snap.inputMovedTicks, 0);
|
||||
assert.strictEqual(snap.frozenTicks, 2);
|
||||
assert.strictEqual(snap.blockedTicks, 0, '没报告碰撞就不算「被挡住」');
|
||||
});
|
||||
|
||||
test('没有输入时不计入 inputTicks', () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start();
|
||||
tick(bot);
|
||||
tick(bot);
|
||||
const snap = recorder.snapshot();
|
||||
assert.strictEqual(snap.count, 2);
|
||||
assert.strictEqual(snap.inputTicks, 0);
|
||||
assert.strictEqual(snap.movedTicks, 0);
|
||||
});
|
||||
|
||||
test('停止后摘掉监听并不再记录', () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start();
|
||||
tick(bot);
|
||||
const result = recorder.stop();
|
||||
assert.strictEqual(result.ok, true);
|
||||
assert.strictEqual(recorder.running, false);
|
||||
assert.match(result.message, /共 1 个 tick/);
|
||||
|
||||
tick(bot);
|
||||
assert.strictEqual(recorder.snapshot().count, 1, '停止后不应再记录');
|
||||
assert.strictEqual(bot.listenerCount('physicsTick'), 0, '监听应已摘掉');
|
||||
});
|
||||
|
||||
test('重复 stop 不报错', () => {
|
||||
const { recorder } = setup();
|
||||
recorder.start();
|
||||
assert.strictEqual(recorder.stop().ok, true);
|
||||
assert.match(recorder.stop().message, /没有在录制/);
|
||||
});
|
||||
|
||||
test('滚动缓冲只保留最近 maxTicks 个 tick', () => {
|
||||
const { bot, recorder } = setup({ maxTicks: 3 });
|
||||
recorder.start();
|
||||
for (let i = 0; i < 10; i++) {
|
||||
tick(bot, { position: bot.entity.position.offset(0, 0, 1) });
|
||||
}
|
||||
const snap = recorder.snapshot();
|
||||
assert.strictEqual(snap.count, 3);
|
||||
assert.strictEqual(snap.ticks.length, 3);
|
||||
});
|
||||
|
||||
test('snapshot 的 limit 只影响返回条数，不影响统计', () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start();
|
||||
bot.setControlState('forward', true);
|
||||
for (let i = 0; i < 5; i++) tick(bot, { position: bot.entity.position.offset(0, 0, 1) });
|
||||
|
||||
const snap = recorder.snapshot({ limit: 2 });
|
||||
assert.strictEqual(snap.count, 5);
|
||||
assert.strictEqual(snap.returned, 2);
|
||||
assert.strictEqual(snap.ticks.length, 2);
|
||||
assert.strictEqual(snap.inputMovedTicks, 5);
|
||||
});
|
||||
|
||||
test('给出时长后到点自动停止并摘监听', async () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start(0.05);
|
||||
assert.strictEqual(recorder.running, true);
|
||||
await new Promise((resolve) => setTimeout(resolve, 150));
|
||||
assert.strictEqual(recorder.running, false);
|
||||
assert.strictEqual(bot.listenerCount('physicsTick'), 0);
|
||||
assert.ok(recorder.snapshot().stoppedAt > 0);
|
||||
});
|
||||
|
||||
test('录制时长被上限截断', () => {
|
||||
const { recorder } = setup();
|
||||
const result = recorder.start(9999);
|
||||
assert.match(result.message, /120 秒/);
|
||||
recorder.stop();
|
||||
});
|
||||
|
||||
test('换 bot 时先收尾旧录制', () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start();
|
||||
tick(bot);
|
||||
const other = new FakeBot();
|
||||
recorder.setBot(other);
|
||||
assert.strictEqual(recorder.running, false, '换 bot 应停止录制');
|
||||
assert.strictEqual(recorder.snapshot().count, 1, '旧 bot 录到的内容保留');
|
||||
tick(bot);
|
||||
assert.strictEqual(recorder.snapshot().count, 1, '旧 bot 不再被记录');
|
||||
});
|
||||
|
||||
test('clear 清空已录内容且不影响录制状态', () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start();
|
||||
tick(bot);
|
||||
assert.strictEqual(recorder.snapshot().count, 1);
|
||||
recorder.clear();
|
||||
const snap = recorder.snapshot();
|
||||
assert.strictEqual(snap.count, 0);
|
||||
assert.strictEqual(snap.running, true);
|
||||
});
|
||||
|
||||
test('方块读不到（区块未加载）时记 null 而不是抛错', () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start();
|
||||
bot.blockAt = () => null;
|
||||
tick(bot);
|
||||
const row = recorder.snapshot().ticks[0];
|
||||
assert.strictEqual(row.blockBelow, null);
|
||||
assert.strictEqual(row.blockAtFeet, null);
|
||||
});
|
||||
|
||||
test('录制自身出异常也不影响物理循环', () => {
|
||||
const { bot, recorder } = setup();
|
||||
recorder.start();
|
||||
// 位置是 NaN 时直接跳过，不抛错
|
||||
tick(bot, { position: { x: NaN, y: 0, z: 0 } });
|
||||
assert.strictEqual(recorder.snapshot().count, 0);
|
||||
|
||||
// blockAt 抛错也不能让 physicsTick 崩
|
||||
bot.entity.position = { x: 1, y: 64, z: 1, offset: () => ({ x: 1, y: 63, z: 1 }) };
|
||||
bot.blockAt = () => {
|
||||
throw new Error('炸了');
|
||||
};
|
||||
assert.doesNotThrow(() => bot.emit('physicsTick'));
|
||||
const snap = recorder.snapshot();
|
||||
assert.strictEqual(snap.count, 1);
|
||||
assert.strictEqual(snap.ticks[0].blockBelow, null);
|
||||
});
|
||||
|
||||
test('默认上限是一个合理的正数', () => {
|
||||
assert.ok(DEFAULT_MAX_TICKS >= 20);
|
||||
assert.strictEqual(new PhysicsRecorder().maxTicks, DEFAULT_MAX_TICKS);
|
||||
});
|
||||
+48
-2
@@ -6,6 +6,8 @@ const assert = require('node:assert');
|
||||
const { flattenChunks, boundsOf, timingSafeEqual, WebConsole } = require('../src/web/server');
|
||||
const { TerritoryModel } = require('../src/core/territoryModel');
|
||||
const { PacketCapture } = require('../src/core/packetCapture');
|
||||
const { PhysicsRecorder } = require('../src/core/physicsRecorder');
|
||||
const { FakeBot } = require('./helpers/fakeBot');
|
||||
const { defaultConfig } = require('../src/config/expansionConfig');
|
||||
const { Logger } = require('../src/util/logger');
|
||||
const chunkPos = require('../src/core/chunkPos');
|
||||
@@ -59,12 +61,19 @@ function setupConsole(options) {
|
||||
};
|
||||
const packetCapture = new PacketCapture();
|
||||
packetCapture.setClient(captureClient);
|
||||
// 物理录制接口的桩：同样挂真的 PhysicsRecorder + FakeBot
|
||||
const physicsBot = new FakeBot({ x: 0, y: 64, z: 0 });
|
||||
const physicsRecorder = new PhysicsRecorder();
|
||||
physicsRecorder.setBot(physicsBot);
|
||||
const botManager = {
|
||||
snapshot: () => ({ state: 'online', username: 'TestBot' }),
|
||||
sendCommand: () => {},
|
||||
startPacketCapture: (seconds) => packetCapture.start(seconds),
|
||||
stopPacketCapture: () => packetCapture.stop(),
|
||||
packetCaptureSnapshot: (options) => packetCapture.snapshot(options)
|
||||
packetCaptureSnapshot: (options) => packetCapture.snapshot(options),
|
||||
startPhysicsRecorder: (seconds) => physicsRecorder.start(seconds),
|
||||
stopPhysicsRecorder: () => physicsRecorder.stop(),
|
||||
physicsSnapshot: (options) => physicsRecorder.snapshot(options)
|
||||
};
|
||||
const controller = {
|
||||
target: { x: 2, z: 0 },
|
||||
@@ -92,7 +101,7 @@ function setupConsole(options) {
|
||||
getConfig: () => config,
|
||||
applyConfig: (next) => next
|
||||
}, { host: '127.0.0.1', port: 0 });
|
||||
return { webConsole, model, logger, controller, captureClient, packetCapture };
|
||||
return { webConsole, model, logger, controller, captureClient, packetCapture, physicsBot, physicsRecorder };
|
||||
}
|
||||
|
||||
test('mapPayload 返回己方 / 会话 / 飞地 / 目标与各邦国摘要', () => {
|
||||
@@ -273,3 +282,40 @@ test('HTTP 接口：抓包可开始、取结果（含按包名过滤）、停止
|
||||
await webConsole.stop();
|
||||
}
|
||||
});
|
||||
|
||||
test('HTTP 接口：物理录制可开始、取结果、停止', async () => {
|
||||
const { webConsole, physicsBot } = setupConsole();
|
||||
await webConsole.start();
|
||||
const base = webConsole.baseUrl();
|
||||
try {
|
||||
const started = await fetch(base + '/api/bots/bot/physics/start', {
|
||||
method: 'POST',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify({ seconds: 5 })
|
||||
}).then((r) => r.json());
|
||||
assert.strictEqual(started.ok, true);
|
||||
assert.match(started.message, /已开始录制物理 tick/);
|
||||
|
||||
// 模拟「按着前进但物理没动」：应当被统计成 frozenTicks
|
||||
physicsBot.setControlState('forward', true);
|
||||
physicsBot.emit('physicsTick');
|
||||
physicsBot.emit('physicsTick');
|
||||
|
||||
const snap = await fetch(base + '/api/bots/bot/physics').then((r) => r.json());
|
||||
assert.strictEqual(snap.ok, true);
|
||||
assert.strictEqual(snap.data.running, true);
|
||||
assert.strictEqual(snap.data.count, 2);
|
||||
assert.strictEqual(snap.data.inputTicks, 2);
|
||||
assert.strictEqual(snap.data.inputMovedTicks, 0);
|
||||
assert.strictEqual(snap.data.frozenTicks, 2);
|
||||
|
||||
const limited = await fetch(base + '/api/bots/bot/physics?limit=1').then((r) => r.json());
|
||||
assert.strictEqual(limited.data.count, 2);
|
||||
assert.strictEqual(limited.data.returned, 1);
|
||||
|
||||
const stopped = await fetch(base + '/api/bots/bot/physics/stop', { method: 'POST' }).then((r) => r.json());
|
||||
assert.strictEqual(stopped.ok, true);
|
||||
} finally {
|
||||
await webConsole.stop();
|
||||
}
|
||||
});
|
||||
|
||||
在新工单中引用
屏蔽一个用户