故障排查
先找到出问题的层级,再采用最小且安全的修复方式。
大多数 MengBot 故障来自四个层级之一:桌面应用、本地智能体 CLI、已连接的服务,或计算机后端。
我的日志在哪里?
Windows、macOS 和 Linux 上的日志位置,以及如何在移除敏感信息后分享它们。
应用启动与端口
应用无法打开、本地服务器不可用,或端口被占用。
智能体引擎
CLI 缺失、模型不可用、身份验证失败,或重连循环。
已连接的应用
OAuth 已完成但工具未出现,或账号断开连接。
桌面更新
下载一直转圈、重启没有反应,或新版本无法启动。
云端浏览器中的 Google 登录
在机器人的浏览器中,通行密钥登录停在“正在验证是您本人”。
从任意聊天中报告缺陷:@devs
在与机器人的任意聊天中,无论是在桌面应用还是云端,输入 @devs(它是 @ 列表中的最后一项),再写几句出了什么问题,然后发送。输入它本身就是发送的决定:不需要再按其他东西。
回复该消息的机器人会补充一段简短摘要:你所说的故障、它在对话中自己看到的内容,以及复现步骤。MengBot 会补充自身的事实:应用版本、计算机的系统、运行在桌面还是云端、机器人的引擎和模型、该对话中最近的错误、服务器最新的警告和错误,以及对话的 id。密钥、密码、令牌、Cookie 和网址参数会先被遮蔽。对话的其余内容绝不会发送,任何文件也不会发送。
聊天中会有一行文字说明报告去了哪里,例如 已发送给 MengBot 团队(报告 …)。我们的团队会通过电子邮件收到它,并会回复 you@example.com。 回复地址是你登录时使用的电子邮件,或你个人资料中的电子邮件。如果报告暂时无法发送(没有连接,或过去一小时内报告过多),该行文字会说明情况:报告已保存,稍后会自行发送,因此无需再次发送。
在你的消息下方,你可以跟踪它的后续进展:先是 已收到,我们正在查看,团队修复后会变成 已在 0.1.135 中修复,将在你的下次更新中提供。当应用(或云端)运行该版本时,你会在同一聊天中收到一条消息 已在 0.1.135 中修复。要再试一次吗?,以及一条通知。应用大约每小时一次、并在每次启动时向 MengBot 团队询问你的报告;它只发送报告的 id。
收集有用的证据
在提交问题之前,请记录:
- MengBot 版本和操作系统;
- 所选的引擎和模型;
- 确切可见的错误,而不只是“它失败了”;
- 同一个智能体 CLI 在终端中直接运行是否正常;
- 仅重启受影响的任务是否会改变结果;
- 来自 设置 → 通用 → 诊断 → 导出诊断… 的文件,该文件会移除密钥和密码(参见我的日志在哪里?)。
切勿发布 API 密钥、OAuth 回调 URL、持有者令牌或安全凭据文件的内容。