MaaEnd常见问题排查指南：日志导出、调试图像与Issue反馈的完整流程

MaaEnd常见问题排查指南日志导出、调试图像与Issue反馈的完整流程【免费下载链接】MaaEndMaaEnd 终末地小助手基于视觉 AI 的「明日方舟终末地」自动化工具项目地址: https://gitcode.com/gh_mirrors/maa/MaaEndMaaEnd 是基于视觉 AI 的「明日方舟终末地」自动化工具遇到问题时掌握日志导出、保存调试图像和规范的 Issue 反馈方法能让开发者快速定位问题。本篇面向新手带你走完这套完整的排查流程。1. 核心原则先升级到最新版本 在提交任何 Issue 之前请务必确认你使用的是最新版。MaaEnd 迭代速度很快不少 Bug 已在新版中修复而新版本通常会自动更新无需手动操作。2. 一键导出运行日志debug 文件夹日志是排查问题最重要的第一现场项目说明日志位置debug文件夹快捷导出点击运行日志面板右上角的 ️ 图标可直接导出需要上传导出的MaaEnd-logs-xxx.zip压缩包⚠️ 两个常见错误姿势❌ 不要复制日志文字粘贴到 Issue 里❌ 不要对日志窗口截图直接上传 zip 压缩包开发者才能高效分析。3. 关键截图版本信息 问题画面 ️提交 Bug Report 时还需要两张截图软件画面问题发生时的完整软件界面截图版本信息设置→调试页面中的版本信息截图版本信息能帮助开发者确认你运行的具体构建避免我这边复现不了的无效沟通。4. 识别漏点/点错开启保存调试图像 ️如果问题表现为漏识别、点错位置比如按钮没点到、图标没认出来需要让 MaaEnd 留下现场照片在设置中开启保存调试图像再次复现问题上传debug/vision/目录下生成的调试图片若文件过大无法上传可先传到用户 QQ 群文件1062010346并在 Issue 里备注具体文件名小贴士反馈完成后记得关闭该开关否则调试图会持续生成硬盘容量会爆炸官方文档原话不然硬盘会爆炸确信 。5. 程序闪退提交 Crash Dump 如果程序直接消失或弹出错误框属于崩溃类问题请尝试提供 Crash Dump 文件路径C:\Users\用户名\AppData\Local\CrashDumps\和C:\CrashDumps文件最近生成的.dmp文件这类文件能直接暴露崩溃堆栈比任何截图都有说服力。6. 进阶用日志分析工具读懂运行轨迹 对于地图移动、路线规划类问题MaaEnd 的开发者工具提供了可视化的日志分析能力它可以从日志包中提取每次寻路动作区分实际采用的步行规划与被滑索淘汰的基线绘制实测轨迹并在地图上展示滑索架的通过情况。日志只在浏览器本地读取不会上传。该功能主要面向开发者调试普通用户遇到寻路异常时只需把日志 zip 包完整上传即可后端团队会借助类似工具快速还原现场。相关说明可参考 docs/zh_cn/developers/components/map-navigator.md。7. 反馈渠道速查清单 ✅渠道用途Issue提交 Bug Report / 功能建议附日志与截图用户 QQ 群1062010346使用问题、功能建议、存放过大调试文件开发 QQ 群1072587329开发者技术讨论不受理用户问题完整规范见官方文档docs/zh_cn/users/troubleshooting.md8. 排查流程一图流总结 更新到最新版本确认问题仍存在导出debug文件夹下的日志 zip运行日志面板 ️ 一键导出截图问题画面 设置 → 调试的版本信息识别类问题开启保存调试图像复现一次附debug/vision/图片崩溃类问题附.dmp文件提交 Issue附上以上全部材料按这套流程准备材料你的反馈基本能一次到位帮助 MaaEnd 小助手变得更快更稳【免费下载链接】MaaEndMaaEnd 终末地小助手基于视觉 AI 的「明日方舟终末地」自动化工具项目地址: https://gitcode.com/gh_mirrors/maa/MaaEnd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考