FAQ

常见问题 · FAQ

大模型 / 配置

Q: 自然语言指令没反应 / 日志报 deepseek_key_missing? 没配 API Key。设置环境变量 DEEPSEEK_API_KEY,或在 aibot.json 的 deepseek.apiKey 填入。详见 Getting Started。注意:即使没配 Key,确定性的 /aibot task 命令仍可用。

Q: 能用 DeepSeek 以外的模型吗? 可以。把 deepseek.baseUrl 指向任意 OpenAI 兼容端点,并设置对应 model。见 Configuration。

Q: 一个目标消耗了很多 token? 调小 brain.maxTurnsPerRequest / maxToolCallsPerTurn,并引导模型用高层工具(mine_ore / gather)而非低层逐格操作。可关闭 exposeLowLevelTools。见 Brain and Tools。

行为问题

Q: Bob 站着不动 / 卡住了? 可能被 StuckWatcher 判卡死并中止任务。看日志里的 task_stuck_aborted。若发生在它正常干活时,通常是某任务该豁免监控(isWaiting())。见 Safety Net。

Q: 让它挖钻石,结果做完铁镐就停了? 这是历史问题的典型场景:挖钻石需要先有铁镐(前置),引擎会倒推出"挖铁→做铁镐→再挖钻石"。若中途某步(如采木)在恶劣环境失败,目标可能中断。现已有 userGoal 保护(防降级偷换目标)与无树兜底(大范围探树)。仍失败请看日志定位失败步。见 Goal Engine。

Q: Bot 死了? 检查死因:diag_bot_died 日志会标注 fall / in_lava / air 等。安全网会处理溺水 / 岩浆 / 围殴,挖掘式移动也会在溺水 / 挨打时熔断。极端恶劣环境仍可能致死。见 Safety Net。

Q: 它会瞬移 / 边走边跳,很出戏? 新版已修:行走只在落地且确有台阶 / 缺口时单跳一次(不兔子跳),采集换片改为走过去(不瞬移),下挖为台阶式。见 Safety Net。

Q: 周围没树 / 没矿,它就放弃了? 采集与挖矿都有大范围 palette 扫描探测:身边找不到会远程定位资源并寻路过去。若整片区域确实没有该资源,才会失败。

命令 / 权限

Q: 命令用不了 / 面板提示权限不足? /aibot 命令需要命令权限(OP)。客户端面板的动作也走服务器命令,受服务器权限配置限制。见 Client Panel。

Q: 怎么知道有哪些命令 / 参数? 游戏内 /aibot 后按 Tab 自动补全。常用命令见 Commands。

性能

Q: TPS 掉了? 用 /aibot observe tps 查看。大范围扫描已做限频护 TPS;可减少同时活跃的 bot 数量,或调小 perception.radius。

开发

Q: 改了 Minecraft / Fabric 相关代码编译报错? 多半是版本签名变化。本项目锁定 Yarn 1.21.3+build.2,改物品组件 / 进食 / 燃料 / 挖掘速度 / 熔炉 / 客户端网络前先确认签名。见 Developer Guide。

Q: 怎么验证一个行为是否正常? 用 /aibot verify <bot> <feature> 跑内置场景,或 /aibot deplint <bot> <spec> 离线审计规划链。见 Developer Guide。

---

没找到答案?欢迎到 GitHub Issues 提问。