文件
BotStore/test/expansionController.test.js
T
lyizai 0783249d1e fix: 定位「寻路恒定 47 节点」的根因(专属配置被冻结)并改为按进度判超时
找到「寻路怎么调都只探索 47 个节点」的真凶
- 启动任务时若带了配置,会被整份存为该机器人的专属配置覆盖。它是一份**完整快照**,
  等于把当时那一刻的全局配置冻结在这个机器人身上,之后改全局配置再也影响不到它。
  实测这台机器人的覆盖里 allowBreak/allowParkour 都是 false,所以我前面所有
  「放开挖方块 / 跑酷 / 不限搜索半径」的排查全部无效,一直在跟同一份旧配置较劲。
- 清除覆盖后寻路器的邻居生成数从 **2 变成 15**,机器人开始真正移动。
- 现在保存覆盖时会明确记一条日志(含策略/邦国/数量),说明「此后全局改动不影响它」。
- 新增「清除专属配置」按钮与 POST /api/bots/:id/settings/clear-config,
  并在配置面板提示该机器人是否有专属覆盖 —— 这是「改了全局却没生效」的唯一退路。

寻路超时改为按进度判定
- 原来只看墙钟时间:目标常在几百格外,而寻路速度受地形与反作弊回弹影响可能只有
  正常步行的十分之一,于是「走得慢但在稳步接近」会被误判成卡死,然后 /u return
  回城把进度全部清零。现在只要与目标的曼哈顿距离有实质缩短就重置这一段计时。
- 首次观察只记录距离基准、不续期,保证「原地不动」仍会照常超时。

新增寻路诊断(排查这类问题的关键手段)
- GET /api/bots/:id/status 的 pathingDiag 暴露:起点可走邻居数与具体坐标、
  寻路器能否通过 world.getBlock 读到方块、四向可见距离。
- 邻居数极少(如 2)说明不是目标太远,而是移动生成器从起点就找不到分支,
  此时调任何搜索参数都没用。

测试 355 -> 360,全部通过。
2026-09-28 19:43:15 +08:00

596 行
22 KiB
JavaScript
原始文件 Blame 文件历史

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。
'use strict';
const test = require('node:test');
const assert = require('node:assert');
const fs = require('fs');
const os = require('os');
const path = require('path');
const { ExpansionController, State } = require('../src/controller/expansionController');
const { TerritoryModel } = require('../src/core/territoryModel');
const { defaultConfig } = require('../src/config/expansionConfig');
const { Logger } = require('../src/util/logger');
const { FakeBot } = require('./helpers/fakeBot');
const chunkPos = require('../src/core/chunkPos');
/** 假寻路服务 */
class FakePathing {
constructor() {
this.calcFailed = false;
this.currentTarget = null;
this._pathing = false;
this.pathCalls = 0;
}
pathTo(chunk) {
this.currentTarget = chunk;
this._pathing = true;
this.pathCalls++;
return true;
}
cancel() {
this._pathing = false;
}
isPathing() {
return this._pathing;
}
applyConfig() {}
}
/** 假数据服务 */
class FakeDataService {
constructor(model) {
this.model = model;
this.sessionClaims = [];
this.refreshCount = 0;
}
getModel() {
return this.model;
}
setSelectedStateName(name) {
this.model.setSelfStateName(name);
}
addSessionClaim(chunk) {
this.sessionClaims.push(chunk);
this.model.addSessionClaim(chunk);
}
refreshAsync() {
this.refreshCount++;
}
async detectStateByPlayer() {
return null;
}
snapshot() {
return { stateCount: this.model.stateCount };
}
}
/** 假机器人管理器 */
class FakeBotManager {
constructor(bot, model) {
this.bot = bot;
this.pathing = new FakePathing();
this.grim = null;
this.eater = null;
this.boat = null;
this.guard = null;
this.connection = { username: 'TestBot' };
this.commands = [];
this._model = model;
}
isReady() {
return true;
}
isSpawned() {
return true;
}
sendCommand(command) {
if (command) this.commands.push(command);
}
applyConfig() {}
}
/**
* 搭建被测环境。
* @param {{states?: Record<string, Array<[number, number]>>, selfName?: string, x?: number, z?: number, config?: object}} [options]
*/
function setup(options) {
const opts = options || {};
const states = opts.states || { A: [[0, 0]] };
const map = new Map();
for (const [name, coords] of Object.entries(states)) {
map.set(name, {
name,
capital: { x: coords[0][0], z: coords[0][1] },
chunks: new Set(coords.map(([x, z]) => chunkPos.key(x, z))),
color: 0x75bd20
});
}
const model = new TerritoryModel(map);
if (opts.selfName) model.setSelfStateName(opts.selfName);
const bot = new FakeBot({ x: (opts.x === undefined ? 0 : opts.x) * 16 + 8, y: 64, z: (opts.z === undefined ? 0 : opts.z) * 16 + 8 });
const botManager = new FakeBotManager(bot, model);
const dataService = new FakeDataService(model);
const logger = new Logger({ echo: false });
const controller = new ExpansionController({ botManager, dataService, logger });
const config = defaultConfig();
config.enforceClaimTime = false;
config.autoEat = false;
config.autoAttack = false;
config.durabilityGuard = false;
config.autoBoat = false;
Object.assign(config, opts.config || {});
return { controller, botManager, dataService, model, bot, logger, config };
}
test('start:自动识别所在邦国并下发开垦模式指令', async () => {
const { controller, botManager, config, model } = setup({ selfName: '' });
const ok = await controller.start(config);
assert.strictEqual(ok, true);
assert.strictEqual(model.selfStateNameValue(), 'A', '应自动识别为所在邦国 A');
assert.ok(botManager.commands.includes('u claimmode'), '应发送开垦模式指令');
assert.strictEqual(controller.state, State.PATHING);
assert.ok(controller.target, '应选出目标区块');
assert.strictEqual(botManager.pathing.pathCalls, 1, '应下发一次寻路');
});
test('start:指定不存在的邦国时拒绝启动', async () => {
const { controller, config } = setup();
config.stateName = '不存在的国';
const ok = await controller.start(config);
assert.strictEqual(ok, false);
assert.strictEqual(controller.state, State.IDLE);
assert.ok(controller.status.includes('不存在'));
});
test('start:不在开垦时段时登记等待自动开始', async () => {
const { controller, config } = setup();
const hour = new Date().getHours();
config.enforceClaimTime = true;
// 构造一个一定不含当前小时的时段
config.claimStartHour = (hour + 2) % 24;
config.claimEndHour = (hour + 3) % 24;
if (config.claimStartHour >= config.claimEndHour) config.claimEndHour = config.claimStartHour + 1;
const ok = await controller.start(config);
assert.strictEqual(ok, true);
assert.strictEqual(controller.isWaitingForClaimTime(), true);
assert.strictEqual(controller.state, State.IDLE);
assert.ok(controller.status.includes('等待开垦时段'));
});
test('到达目标区块后进入等待开垦状态', async () => {
const { controller, botManager, config, bot } = setup();
await controller.start(config);
const target = controller.target;
// 把机器人移到目标区块
bot.entity.position.x = target.x * 16 + 8;
bot.entity.position.z = target.z * 16 + 8;
controller.tick();
assert.strictEqual(controller.state, State.WAITING);
assert.strictEqual(botManager.pathing.isPathing(), false, '到达后应取消寻路');
});
test('开垦成功消息推进计数并进入 SUCCESS', async () => {
const { controller, config, bot, dataService } = setup();
await controller.start(config);
const target = controller.target;
bot.entity.position.x = target.x * 16 + 8;
bot.entity.position.z = target.z * 16 + 8;
controller.tick();
assert.strictEqual(controller.state, State.WAITING);
controller.monitor.onChat(`疆土(${target.x},${target.z}) [${target.x * 16},${target.z * 16}] 已为你的邦国开拓`);
assert.strictEqual(controller.completedClaims, 1);
assert.strictEqual(controller.state, State.SUCCESS);
assert.strictEqual(dataService.sessionClaims.length, 1);
assert.ok(dataService.refreshCount > 0, '占领成功后应触发一次地图刷新');
});
test('同一区块的重复成功消息只计一次', async () => {
const { controller, config, bot } = setup();
await controller.start(config);
const target = controller.target;
bot.entity.position.x = target.x * 16 + 8;
bot.entity.position.z = target.z * 16 + 8;
controller.tick();
const message = `疆土(${target.x},${target.z}) [0,0] 已为你的邦国开拓`;
controller.monitor.onChat(message);
controller.monitor.onChat(message);
assert.strictEqual(controller.completedClaims, 1);
});
test('通用成功消息只在机器人确实位于目标区块时生效', async () => {
const { controller, config, bot } = setup();
await controller.start(config);
const target = controller.target;
// 机器人不在目标区块上
bot.entity.position.x = (target.x + 5) * 16;
bot.entity.position.z = (target.z + 5) * 16;
controller.playerChunk = { x: target.x + 5, z: target.z + 5 };
controller.monitor.onChat('你的疆土已开拓');
assert.strictEqual(controller.completedClaims, 0, '不在目标区块时不得计为成功');
bot.entity.position.x = target.x * 16 + 8;
bot.entity.position.z = target.z * 16 + 8;
controller.playerChunk = { x: target.x, z: target.z };
controller.monitor.onChat('你的疆土已开拓');
assert.strictEqual(controller.completedClaims, 1);
});
test('目标已被他人占领时跳过', async () => {
const { controller, config, model } = setup();
await controller.start(config);
const target = controller.target;
// 地图刷新后该区块变成他国领土
model.allClaimedChunks().add(chunkPos.key(target.x, target.z));
controller.tick();
assert.strictEqual(controller.state, State.NEXT);
assert.strictEqual(controller.status, '跳过已占领区块');
});
test('目标不再与己方领土接壤时跳过', async () => {
const { controller, config, model } = setup();
await controller.start(config);
const target = controller.target;
// 清空己方领土,使目标不再接壤
model.selfState().chunks.clear();
controller.tick();
assert.strictEqual(controller.state, State.NEXT);
assert.strictEqual(controller.status, '跳过不接壤区块');
});
test('寻路超时会重新寻路,重试耗尽后走两步', async () => {
const { controller, botManager, config } = setup({ config: { waitTimeoutSeconds: 5, retries: 2, sideStepMaxRounds: 2 } });
await controller.start(config);
const callsAfterStart = botManager.pathing.pathCalls;
// 把阶段开始时间拨回 10 秒前,触发超时
controller.stageStartedMillis = Date.now() - 10000;
controller.tick();
assert.strictEqual(controller.retryCount, 1);
assert.strictEqual(controller.state, State.PATHING, '未耗尽重试时应继续寻路');
assert.strictEqual(botManager.pathing.pathCalls, callsAfterStart + 1);
controller.stageStartedMillis = Date.now() - 10000;
controller.tick();
assert.strictEqual(controller.sideStepping, true, '重试耗尽后应进入走两步阶段');
assert.strictEqual(controller.sideStepCount, 1);
});
test('连续超时累计达到阈值时回城', async () => {
const { controller, botManager, config } = setup({
config: { waitTimeoutSeconds: 5, retries: 1, sideStepMaxRounds: 0, returnThresholdSeconds: 1 }
});
await controller.start(config);
controller.stageStartedMillis = Date.now() - 10000;
controller.tick(); // 第一次超时:重试次数达到上限(retries=1),走两步轮数为 0 → giveUp → 回城
assert.strictEqual(controller.state, State.RETURNING);
assert.ok(botManager.commands.includes('u return'), '应发送回城指令');
});
test('回城等待结束后重新规划(非耐久保护触发)', async () => {
const { controller, config } = setup({
config: { waitTimeoutSeconds: 5, retries: 1, sideStepMaxRounds: 0, returnThresholdSeconds: 1, returnWaitSeconds: 1 }
});
await controller.start(config);
controller.stageStartedMillis = Date.now() - 10000;
controller.tick();
assert.strictEqual(controller.state, State.RETURNING);
controller.returnStartMillis = Date.now() - 5000;
controller.tick();
assert.strictEqual(controller.state, State.PATHING, '回城完成后应重新规划并开始寻路');
assert.strictEqual(controller.consecutiveTimeoutMillis, 0, '连续超时计数应清零');
});
test('耐久保护触发回城并在传送后停止任务', async () => {
const { controller, botManager, config } = setup({ config: { durabilityGuard: true, returnWaitSeconds: 1 } });
botManager.guard = {
check: () => ({ slot: 0, name: '主手', percent: 5, itemName: 'diamond_sword' }),
reset: () => {}
};
await controller.start(config);
controller.tick();
assert.strictEqual(controller.state, State.RETURNING);
assert.ok(botManager.commands.includes('u return'));
controller.returnStartMillis = Date.now() - 5000;
controller.tick();
assert.strictEqual(controller.state, State.STOPPED, '耐久保护回城后应停止任务');
});
test('达成目标数量后进入 COMPLETE', async () => {
const { controller, config, bot } = setup({ config: { targetCount: 1 } });
await controller.start(config);
const target = controller.target;
bot.entity.position.x = target.x * 16 + 8;
bot.entity.position.z = target.z * 16 + 8;
controller.tick(); // → WAITING
controller.monitor.onChat(`疆土(${target.x},${target.z}) [0,0] 已为你的邦国开拓`); // → SUCCESS
controller.tick(); // SUCCESS → NEXT
controller.tick(); // NEXT → 达成目标 → COMPLETE
assert.strictEqual(controller.state, State.COMPLETE);
assert.strictEqual(controller.completedClaims, 1);
assert.strictEqual(controller.isRunning(), false);
});
test('stop 后进入 STOPPED 且不再运行', async () => {
const { controller, botManager, config } = setup();
await controller.start(config);
controller.stop();
assert.strictEqual(controller.state, State.STOPPED);
assert.strictEqual(controller.isRunning(), false);
assert.strictEqual(botManager.pathing.isPathing(), false, '停止时应取消寻路');
});
test('stop 可取消「等待自动开始」', async () => {
const { controller, config } = setup();
const hour = new Date().getHours();
config.enforceClaimTime = true;
config.claimStartHour = (hour + 2) % 24;
config.claimEndHour = (hour + 3) % 24;
if (config.claimStartHour >= config.claimEndHour) config.claimEndHour = config.claimStartHour + 1;
await controller.start(config);
assert.strictEqual(controller.isWaitingForClaimTime(), true);
controller.stop();
assert.strictEqual(controller.isWaitingForClaimTime(), false);
assert.strictEqual(controller.state, State.IDLE);
});
test('自动游泳:水中按住跳跃键,离开水后松开', async () => {
const { controller, botManager, config, bot } = setup();
botManager.grim = {
controls: {},
setControlState(control, state) { this.controls[control] = state; },
setLook() {}
};
await controller.start(config);
bot.entity.isInWater = true;
controller.tick();
assert.strictEqual(botManager.grim.controls.jump, true, '水中应按住跳跃键上浮');
bot.entity.isInWater = false;
controller.tick();
assert.strictEqual(botManager.grim.controls.jump, false, '离水后应松开跳跃键');
});
test('船上不自动游泳', async () => {
const { controller, botManager, config, bot } = setup();
botManager.grim = {
controls: {},
setControlState(control, state) { this.controls[control] = state; },
setLook() {}
};
await controller.start(config);
bot.entity.isInWater = true;
bot.vehicle = { id: 1 };
controller.tick();
assert.notStrictEqual(botManager.grim.controls.jump, true, '坐船时不应按跳跃键');
});
test('snapshot 暴露任务状态供控制台展示', async () => {
const { controller, config } = setup();
await controller.start(config);
const snapshot = controller.snapshot();
assert.strictEqual(snapshot.running, true);
assert.strictEqual(snapshot.state, State.PATHING);
assert.ok(snapshot.target);
assert.strictEqual(snapshot.completedClaims, 0);
assert.strictEqual(snapshot.withinClaimTime, true);
assert.strictEqual(snapshot.claimModeSent, true);
});
test('exportLogs 写出状态摘要与全部日志', async () => {
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'autostore-log-'));
const file = path.join(dir, 'debug.log');
const { controller, config } = setup();
await controller.start(config);
const result = controller.exportLogs(file);
assert.strictEqual(result, file);
const content = fs.readFileSync(file, 'utf8');
assert.ok(content.includes('AutoStore Bot 调试日志'));
assert.ok(content.includes('状态:'));
assert.ok(content.includes('开始自动扩地'));
fs.rmSync(dir, { recursive: true, force: true });
});
test('未启动任务时 tick 不做任何事', () => {
const { controller } = setup();
assert.doesNotThrow(() => controller.tick());
assert.strictEqual(controller.state, State.IDLE);
});
test('寻路中只要在稳步接近目标,就不算超时(慢速推进不会被回城打断)', async () => {
const { controller, config, bot } = setup({ config: { waitTimeoutSeconds: 5, retries: 3 } });
await controller.start(config);
const target = controller.target;
assert.ok(target, '应选出目标区块');
// 先跑一次 tick 建立距离基准(plan() 会把基准清空,首次观察只记录不续期)
// 把机器人放在目标西侧 10 个区块处,后面每步靠近 2 格
const place = (offsetX) => {
bot.entity.position.x = (target.x + offsetX) * 16 + 8;
bot.entity.position.z = target.z * 16 + 8;
};
place(-10);
controller.tick();
// 模拟「走得很慢但在推进」:每次 tick 靠近 2 个区块,但耗时都超过超时阈值
for (let step = 1; step <= 4; step++) {
place(-10 + step * 2);
controller.stageStartedMillis = Date.now() - 10000; // 每次都「已超时」
controller.tick();
assert.strictEqual(controller.retryCount, 0,
`第 ${step} 次推进不应被判定为超时(retryCount=${controller.retryCount})`);
assert.notStrictEqual(controller.state, State.RETURNING, '不应触发回城');
}
assert.strictEqual(controller.consecutiveTimeoutMillis, 0, '有推进时连续超时应清零');
});
test('寻路中原地不动时仍然会超时并重试(回归保护)', async () => {
const { controller, config } = setup({ config: { waitTimeoutSeconds: 5, retries: 3 } });
await controller.start(config);
controller.tick(); // 首次 tick 只记录距离基准
controller.stageStartedMillis = Date.now() - 10000;
controller.tick();
assert.strictEqual(controller.retryCount, 1, '原地不动必须照常判超时');
});
test('规划队列为空时直接进入 COMPLETE', async () => {
// 己方领土被完全包围且无空位:构造一个只有 1 个区块、四周全被他国占领的局面
const { controller, config } = setup({
states: {
A: [[0, 0]],
B: [[1, 0], [-1, 0], [0, 1], [0, -1]]
},
selfName: 'A'
});
await controller.start(config);
assert.strictEqual(controller.state, State.COMPLETE);
assert.strictEqual(controller.status, '没有可用的相邻无主区块');
});
// ==================== 多机器人:邦国归属与开拓日志 ====================
test('start 把识别到的邦国固化到 stateName,不依赖全局 selfStateName', async () => {
const { controller, config } = setup({ selfName: 'A' });
await controller.start(config);
assert.strictEqual(controller.stateName, 'A');
assert.strictEqual(controller.config.stateName, 'A', '应写回任务配置供规划器使用');
});
test('两个机器人各自开拓不同邦国时互不覆盖', async () => {
const map = new Map([
['A', { name: 'A', capital: { x: 0, z: 0 }, chunks: new Set([chunkPos.key(0, 0)]), color: 0x75bd20 }],
['B', { name: 'B', capital: { x: 20, z: 20 }, chunks: new Set([chunkPos.key(20, 20)]), color: 0xff43de }]
]);
const model = new TerritoryModel(map);
const logger = new Logger({ echo: false });
const makeController = (name) => {
const bot = new FakeBot({ x: 0, y: 64, z: 0 });
const botManager = new FakeBotManager(bot, model);
botManager.connection = { username: name };
const dataService = new FakeDataService(model);
const controller = new ExpansionController({ botManager, dataService, logger, botId: name, botName: name });
const config = defaultConfig();
config.enforceClaimTime = false;
config.autoEat = false;
config.autoAttack = false;
config.durabilityGuard = false;
return { controller, config, model };
};
const first = makeController('BotA');
first.config.stateName = 'A';
const second = makeController('BotB');
second.config.stateName = 'B';
await first.controller.start(first.config);
await second.controller.start(second.config);
// 全局 selfStateName 会被最后启动的机器人改写,但各控制器仍按自己的邦国工作
assert.strictEqual(first.controller.stateName, 'A');
assert.strictEqual(second.controller.stateName, 'B');
first.controller.playerChunk = { x: 0, z: 0 };
second.controller.playerChunk = { x: 20, z: 20 };
first.controller.monitor.onChat('疆土(0,1) [8,24] 已为你的邦国开拓');
second.controller.monitor.onChat('疆土(20,21) [328,344] 已为你的邦国开拓');
assert.ok(model.state('A').chunks.has(chunkPos.key(0, 1)), 'A 的新占领应记到 A 名下');
assert.ok(!model.state('A').chunks.has(chunkPos.key(20, 21)));
assert.ok(model.state('B').chunks.has(chunkPos.key(20, 21)), 'B 的新占领应记到 B 名下');
});
test('占领成功时写入开拓日志(含玩家、区块、时间与来源)', async () => {
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'autostore-claimlog-'));
const { ExpansionLog } = require('../src/core/expansionLog');
const expansionLog = new ExpansionLog({ filePath: path.join(dir, 'expansion-log.jsonl') });
const { controller, config, bot } = setup();
controller.expansionLog = expansionLog;
controller.botId = 'BotA';
controller.botName = 'BotA';
await controller.start(config);
const target = controller.target;
bot.entity.position.x = target.x * 16 + 8;
bot.entity.position.z = target.z * 16 + 8;
controller.tick();
const before = Date.now();
controller.monitor.onChat(`疆土(${target.x},${target.z}) [${target.x * 16 + 1},${target.z * 16 + 2}] 已为你的邦国开拓`);
const rows = expansionLog.list();
assert.strictEqual(rows.length, 1);
const entry = rows[0];
assert.strictEqual(entry.bot, 'BotA');
assert.strictEqual(entry.botId, 'BotA');
assert.strictEqual(entry.state, 'A');
assert.strictEqual(entry.cx, target.x);
assert.strictEqual(entry.cz, target.z);
assert.strictEqual(entry.bx, target.x * 16 + 1);
assert.strictEqual(entry.bz, target.z * 16 + 2);
assert.strictEqual(entry.source, 'chat');
assert.ok(entry.t >= before && entry.t <= Date.now());
assert.strictEqual(entry.sessionCount, 1);
fs.rmSync(dir, { recursive: true, force: true });
});
test('无坐标的通用成功消息记为 chat-generic 来源', async () => {
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'autostore-claimlog2-'));
const { ExpansionLog } = require('../src/core/expansionLog');
const expansionLog = new ExpansionLog({ filePath: path.join(dir, 'expansion-log.jsonl') });
const { controller, config, bot } = setup();
controller.expansionLog = expansionLog;
await controller.start(config);
const target = controller.target;
bot.entity.position.x = target.x * 16 + 8;
bot.entity.position.z = target.z * 16 + 8;
controller.tick();
controller.monitor.onChat('你的疆土已开拓');
const rows = expansionLog.list();
assert.strictEqual(rows.length, 1);
assert.strictEqual(rows[0].source, 'chat-generic');
assert.strictEqual(rows[0].bx, null);
fs.rmSync(dir, { recursive: true, force: true });
});
test('同一区块重复成功只记一条开拓日志', async () => {
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'autostore-claimlog3-'));
const { ExpansionLog } = require('../src/core/expansionLog');
const expansionLog = new ExpansionLog({ filePath: path.join(dir, 'expansion-log.jsonl') });
const { controller, config, bot } = setup();
controller.expansionLog = expansionLog;
await controller.start(config);
const target = controller.target;
bot.entity.position.x = target.x * 16 + 8;
bot.entity.position.z = target.z * 16 + 8;
controller.tick();
const message = `疆土(${target.x},${target.z}) [0,0] 已为你的邦国开拓`;
controller.monitor.onChat(message);
controller.monitor.onChat(message);
assert.strictEqual(expansionLog.list().length, 1);
fs.rmSync(dir, { recursive: true, force: true });
});