# 日志与故障排查

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 配置存放在应用私有目录，普通文件管理器看不到，访问方式见[文件浏览与代码编辑](https://aicode.murk.top/md/guide/files.md#工作区文件在手机上的位置)。

## 按 MCP 名称过滤

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

## 崩溃如何处理

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

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

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

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

如果 AI 执行长任务（如编译、深度代码审查）或终端运行耗时命令时切到后台经常被杀掉，请前往「设置 → 软件权限」开启**后台运行保活**、**忽略电池优化**与**自启动管理**，详见[软件权限](https://aicode.murk.top/md/guide/app-permissions.md)。