日志与故障排查

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 权限，用手机自带的文件管理器就能打开。

按 MCP 名称过滤

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

崩溃了怎么办

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

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

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

后台运行保活

「设置」里的后台运行保活开关打开后，系统通知栏会显示一个常驻服务，防止 AI 执行超长任务（比如编译）时切到后台被系统杀掉。

跑长任务前建议打开它。

访问 App 私有目录

项目文件和 AI 配置放在应用私有目录里，普通文件管理器默认看不到。几种访问办法：

文件管理器挂载（推荐）：App 实现了标准的 DocumentsProvider，用手机自带的「文件」管理器或第三方文件管理器（MT 管理器、Solid Explorer 等）可以找到并挂载 App 的私有根目录。挂载后能看到：

• projects/：工作区项目。通过「添加本地目录」加进来的外部工作区不在这里，它们在你自己选的设备目录下。
• aicode/：对应容器内的 ~/.aicode，里面有 skills/（技能）、docs/（文档）、mcp.json（MCP 配置）等。

具体的挂载步骤见常见问题。

内置终端：切到终端页，cd ~/.aicode 直接看，用 vi 或 cat 查看编辑。

直接让 AI 做：AI 就跑在容器里，你可以说"把 ~/.aicode/mcp.json 打印出来看看"或者"在 ~/.aicode/skills/ 下写一个新技能"。

Root 设备：直接进 /data/data/com.aicode/files/（部分系统等价路径是 /data/user/0/com.aicode/files/）。其中 projects/ 是工作区根，aicode/ 对应 ~/.aicode，rootfs/ 是容器系统。注意 debug 构建的包名是 com.aicode.debug，两者私有目录完全隔离。