Lyizai/BotStore
1
0
派生 0
代码 工单 合并请求 工作流 软件包 项目 发布 百科 活动
19 提交 1 分支 0 Git 标签
0c6700642e9bd50d57757b9de1b4d1fa93ef975b
提交图
7 次代码提交
作者 SHA1 备注 提交日期
lyizai 51664c55b6 feat: 1.7.0 落地 TODO 全部待办（地面修正 / 手动执行器 / 自救 / 回城 / 租约 / 通知） 
按 TODO.md 的优先级把待办全部落地为代码，详见 CHANGELOG 的 [1.7.0]。

- 「走不动」攻关：地面状态修正（syncGroundToPhysics / trustSetbackOnGround）、
  出站包类型分布、备选执行器 manualMover（只借 A* 规划、自己按键执行）
- 原点自救分两轮并统计成败；回城前评估「原地是否更差」并记录前后坐标
- 新增目标区块租约表（targetLease）避免多机器人撞同一块
- 定时消息支持 cron 与「期望回复」确认；新增人工介入 Webhook 通知（notifier）
- 大地图后台预热与视野裁剪；控制台日志按帧批量写入、配置面板支持搜索

顺带修掉两个影响部署的细节：
- 部署脚本（deploy.js / ssh-helper.js）改为也能从 .env 读 SSH 凭据 ——
  在命令行传密码会留在 shell 历史与进程列表里，写进已被忽略的 .env 更安全；
  显式环境变量仍然优先。.env.example 补上占位符并说明这些只在本机用。
- package.json / package-lock.json 版本对齐到 1.7.0（此前停留在 1.1.0，
  与 CHANGELOG 的语义化版本声明脱节）。

测试：368 → 436 个用例，`npm test` 与 `npm run check` 全绿。
 2026-09-28 22:46:39 +08:00
lyizai 0cd65cf9be fix: 修正原点（00）两种原因的判断依据 —— 两种情况下脚下都是基岩 
用户指出：死亡被卡到 00 时脚下**也是基岩**，所以原来用
lockBelow === 'bedrock' 区分「登录服」和「死亡卡住」是错的，
会把死亡卡住误判成登录服，于是不做自救、只让用户去输验证码。

改成以「服务器有没有要求输入验证码」为唯一可靠信号：
- 要求验证码 -> 判定为登录服，提示人工发验证码（不做无意义的左右移动）
- 没要求验证码 -> 判定为死亡卡住，自动左右移动触发服务器重新传送

自救本身在两种情况下都无害（在登录服里按左右键不会有后果），
所以即使判断错了也不会把事情弄得更糟。

另外：验证码提示往往比 spawn 晚到，所以 _handleAuthPrompt 里也补了一次判断 ——
若提示到达时机器人正好在原点附近，会明确点出「被反复传送刷屏」正是登录服造成的，
把这个因果关系讲清楚，避免用户只看到传送刷屏而不知原因。

同步修正 TODO.md 与 CHANGELOG 里那条错误结论，并标注「不要用基岩做判断依据」。

测试 363 -> 368，全部通过。
 2026-09-28 20:32:49 +08:00
lyizai 42a9dd6cf0 feat: 新增机器人上/下线按钮，识别「账号已在别处登录」与「等待验证码」 
下线按钮
- 顶栏新增「下线 / 上线」切换：下线会断开连接、停止自动重连，并停掉定时消息与
  扩地任务；需要在游戏客户端登同一账号时必须先下线，否则会被服务端以
  「您已经连接到此代理服务器了」反复踢掉
- 接口 POST /api/bots/:id/offline 与 /online；上线时会清掉「已在别处登录」标记
  并把重连计数归零，否则重连会一直退避到最大间隔

识别两类此前「看起来像启动不了」的情况
- 「您已经连接到此代理服务器了」：服务端踢人时发的是聊天组件对象，
  原来 JSON.stringify 之后没法看，关键信息被淹没。新增 extractKickReason()
  提取纯文本，命中后给出「请先在客户端退出」的可操作提示，
  并直接把重连退避到最大间隔，不再频繁硬撞服务器
- 「请直接输入验证码进行验证」：账号绑定过之后服务器仍可能每次登录都要求验证码，
  而原来的正则只认「完成验证 / 身份验证」，漏掉了这句话，用户只看到机器人卡在大厅。
  现在补上匹配，并在控制台弹出醒目提示 + 把输入框 placeholder 换成「输入验证码后回车发送」

测试 343 -> 355，全部通过。
 2026-09-28 14:21:14 +08:00
lyizai abecdd2648 fix: 修复实机运行才暴露的 8 个缺陷，新增控制台添加玩家与移动测试 
首次真正连上线上服务器（Debian 12 + pm2 + 端口 78）后暴露的问题，单元测试全绿但机器人干不了活：

致命
- 寻路插件从未加载：项目从没调用 bot.loadPlugin(pathfinder)，bot.pathfinder 恒为
  undefined、isReady() 恒为 false，扩地任务连启动都启动不了，界面只显示含糊的
  「机器人尚未就绪」。现在 createBot 后立刻加载，失败时明确报错。

登录门禁相关（三处死锁）
- preLoginCommands 白名单：/login、/register、简幻通的 /auth 本身就是登录流程的一部分，
  原先被门禁一并拦下，形成「要先登录才能发登录指令」
- 验证码常被要求直接当聊天内容发出（不是指令），原先被 sendChat 的门禁挡住；
  现在服务器明确要求验证时自动放行，另有 server.allowChatBeforeLogin 兜底
- 配置了登录指令却没有密码时 loggedIn 永久为 false，控制台连手动指令都发不出；
  现在走与其他「服务器不回提示」一致的超时兜底并给出说明

可用性
- 离线时指令被静默丢弃却回报「已发送」；现在要求已连接并进入世界，失败信息区分
  「未连接」「登录被拒」「未通过验证」
- 「被服务器传送」日志洪水：实测 3 分钟 748 行，会冲光日志缓冲并打满 WebSocket；
  现在按 30 秒窗口聚合，断开时刷出未汇总计数
- 识别外站账号绑定流程并给出可操作告警，新增 server.authCommand 模板
- 重连指数退避（server.reconnectMaxDelayMs）
- 控制台瓦片 URL 与后端路由不一致

新增
- 控制台添加 / 移除玩家：不必改 .env 重启。密码只写入 data/bots.credentials.json
  （强制 0600），不进仓库、不出现在任何响应里；.env 与凭据文件同名时以 .env 为准，
  .env 里的账号不允许从控制台移除
- 手动移动测试接口与按钮：绕开寻路器直接按方向键，返回真实位移，
  用于区分「算不出路径」与「根本走不动」
- 位置同步诊断：位置包收发计数、onGround、游戏模式、维度、脚下方块与六向实心
- grim.reportOnGroundFromWorld：按世界数据修正出站 onGround（默认开启）
- scripts/check-protocol.js：核对包名与字段名同目标版本协议是否一致

文档
- README 新增「部署到服务器」与「机器人走不动的排查方法」两章

已知限制：实测本服上 mineflayer 客户端无法移动（按方向键 2 秒位移 0.00~0.02 格，
服务端每 tick 回弹一次），已排除区块数据、onGround、Grim 层、游戏模式、物理引擎、
寻路插件、teleport_confirm 协议字段等因素，彻底定位需与原生客户端逐字节对比移动包。
连接 / 登录 / 指令 / 聊天 / 公屏日志 / 大地图均正常。

测试从 263 增至 290，全部通过。
 2026-09-27 23:06:39 +08:00
lyizai 2671da95d5 fix: 打通登录门禁死锁，失败信息区分未连接/登录被拒/未通过验证 
继续修复部署时暴露的门禁设计问题：

- 登录门禁死锁：/login、/register、简幻通的 /auth 本身就是登录流程的一部分，
  原先门禁把它们一并拦下，形成「要先登录才能发登录指令」，账号永远卡在未验证状态。
  新增 server.preLoginCommands 白名单（默认 login,l,register,reg,auth），
  这些前缀在未验证时也放行，其余指令仍要求已完成验证。

- 离线时指令被静默丢弃却回报「已发送」：bot.chat() 在未连接时无处可发。
  canSendCommand() 现在要求已连接并进入世界，失败信息区分
  「未连接」「登录被服务器拒绝」「未通过登录验证」三种情况并给出对应建议。

- 前端配置表单支持 list 类型字段（逗号分隔的字符串数组）。

测试从 252 增至 263，全部通过。
 2026-09-27 22:11:52 +08:00
lyizai d6b1339867 fix: 修正服务器反复传送刷屏日志、识别外站账号绑定流程、重连指数退避 
部署到 Debian 服务器时暴露的三个真实缺陷：

1. 「被服务器传送」日志洪水
   账号未完成服务器验证时服务端每 tick 强推一次位置，实测 3 分钟刷出 748 行日志，
   几十分钟就会冲光 2000 条的日志环形缓冲并把 WebSocket 打满。
   现改为首次立即记录、其余按 30 秒窗口聚合成一条，断开连接时刷出未汇总计数。

2. 外站账号绑定流程无法识别
   原先只认 /login 与 /register，遇到简幻通这类要求 /auth <UID> <验证码> 或扫码绑定的
   服务器时，表现只是「连上→被传送→120 秒后被踢→重连」的静默死循环。
   现新增 NEED_AUTH_PATTERN 识别并输出可操作的中文告警（每连接一次），
   新增 server.authCommand 模板供有固定验证码的服务器自动过验证。

3. 重连无退避
   连续被踢时每 10 秒硬撞服务器。现按指数退避拉长（server.reconnectMaxDelayMs，
   默认上限 120 秒），成功进入世界后清零；抽出 computeReconnectDelay 便于测试。

顺带补充 README 的「部署到服务器」章节（Node ≥ 22 要求、私有运行时、pm2、日志分文件、排障表）。

测试从 242 增至 252，全部通过。
 2026-09-27 22:02:24 +08:00
lyizai 39624da2d5 feat: 支持多机器人挂机、开拓日志、公屏完整日志与大地图 
多机器人（src/bot/botPool.js、src/config/botsConfig.js）
- .env 用 MC_BOTS 一次配置多个账号（JSON 数组或 用户名:密码 逗号分隔），未配置时回退单机器人
- 每个机器人独立连接 / 登录 / 扩地状态机，共享一份领土数据服务与运行日志
- 密码只从 .env 读取；data/bots.json 只存启用状态、备注名、自动开始与各自的配置覆盖
- 每个机器人可覆盖全局配置（策略 / 目标邦国 / 目标数量等），未覆盖字段回退全局默认

开拓日志（src/core/expansionLog.js）
- 逐条记录开拓玩家、邦国、区块、方块坐标、时间与判定来源，追加写入 data/expansion-log.jsonl
- 支持按机器人 / 邦国 / 时间筛选、统计、导出带 BOM 的 CSV，超过 16MB 自动轮转

游戏公屏完整日志与聊天框（src/core/chatLog.js）
- 每个机器人的全部公屏 / 系统 / 动作栏消息按机器人分文件留档，自身发出的聊天与指令同样留档
- 控制台新增公屏聊天页签与消息发送框

登录验证门禁
- 游戏侧：未完成登录验证时拒绝发送指令 / 聊天，isReady() 也不放行扩地任务；
  新增 server.loginConfirmTimeoutMs 兜底，避免服务器不回提示导致永远卡在未登录
- 控制台侧：新增 WEB_PASSWORD 与 /api/login、/api/session，页面登录框验证通过才允许操作

大地图（src/core/bigMapService.js）
- 爬取服务器地图站点（squaremap）的瓦片图片与领土标记，一张图上看全部机器人坐标
- 坐标系对源站实测标定并用 27 个王城交叉验证；瓦片磁盘缓存，层级 0 启动预爬取、更高层级按需穿透
- 领土按 markers.json 原始多边形绘制（预编译 Path2D，even-odd 保留孔洞），叠加王城与机器人标签

配套改造
- TerritoryModel 新增 flyingChunksOf / ownChunksOf，邦国归属改为按名称显式传入，
  不再依赖全局 selfStateName（多机器人会互相覆盖）
- Web 接口以 /api/bots/:id/... 为主，原单机器人接口保留为默认机器人的等价别名
- 新增 scripts/check-web-ids.js 校验前端元素引用一致性

测试从 154 增至 242，全部通过。
 2026-09-27 21:22:57 +08:00