日志与故障排查

App 出问题时，日志是最直接的线索。「设置 → 日志」可以直接在应用内看。

应用内看日志

进去默认定位到今天的日志，页面上能做这些事：

• 日志等级：顶部设置行显示当前等级，点击从底部面板选择（Verbose / Debug / Info / Warn / Error / None）。遇到 bug 时建议调成 Debug，日常保持 Info。正式版默认是 Info，过滤掉调试噪音。
• 切换文件：点「日志文件」行从底部弹出日期列表，默认选中今天。
• 搜索与复制：关键字实时过滤，右上角一键复制当前筛选结果。
• 彩色分级：Verbose 灰、Debug 蓝、Info 绿、Warn 橙、Error 红。
• 单行复制：点任意一行复制这条完整日志（含时间、等级、来源）；长按弹菜单可以选复制范围——本条、本条及堆栈、或只要消息内容。
• 实时滚动：默认开启，每 3 秒自动刷新并跟随最新；关掉后停止刷新，保持你手动浏览的位置。

为了避免大日志卡顿，应用内只显示当前文件在筛选条件下的最后一部分，完整文件需到文件系统查看。

日志文件在哪

/storage/emulated/0/Android/data/com.aicode/files/logs/

无需 root 权限，用手机自带的文件管理器即可打开。

工作区项目文件与 AI 配置存放在应用私有目录，普通文件管理器看不到，访问方式见文件浏览与代码编辑。

按 MCP 名称过滤

排查 MCP 连不上的问题时，进「设置 → MCP 服务器」，编辑某个服务器后点右上角的日志按钮，会跳到日志页并自动按这个服务器名过滤（页面顶部有过滤徽章，可一键清除）。列表页右上角的日志按钮则是看全部日志。

崩溃如何处理

App 遇到未捕获的异常不会直接闪退，而是全屏显示一个崩溃错误页：

• 页面展示崩溃时的版本、设备、时间和完整堆栈。
• 点「复制错误信息」可以复制完整的崩溃报告（含堆栈和日志文件路径），直接粘贴发给开发者即可，无需自行查阅日志。
• 可以选「重启应用」回到主界面，或者「退出应用」完全退出。

崩溃日志同样会落盘到上面那个 logs/ 目录。

长任务切后台被中断如何处理

如果 AI 执行长任务（如编译、深度代码审查）或终端运行耗时命令时切到后台经常被杀掉，请前往「设置 → 软件权限」开启后台运行保活、忽略电池优化与自启动管理，详见软件权限。