已知问题

下面列出几个比较常见的坑。一旦遇到，多半要在系统设置或 VPN 配置里处理，而不是改 app。

本地 HTTP 通信可能被拦截

Local Dream 的界面与设备上的 C++ 推理后端之间通过 127.0.0.1:8081 的 HTTP 通信（即 HTTP API 参考 中说明的同一个后端）。任何干扰 localhost HTTP 流量的东西都会让生成无法启动。

常见原因：

• 某些会拦截或转发本地流量的 VPN / 代理应用
• 部分 OEM ROM 的"网络受限"、"后台冻结"或激进的省电/流量策略，会阻断 app 的本地 socket

如果你完全无法运行任何模型，请先检查这些 —— 关掉 VPN 和代理，到系统设置里把 Local Dream 的网络权限放开，然后重试。

MediaTek 设备 GPU 生成结果异常

部分 MediaTek 设备上用 GPU 生成会产生花屏或其他错误结果。原因是这些设备缺失 GPU runtime 所需要加载的 OpenCL 库。

遇到这种情况，请暂时改用 CPU（或在受支持的骁龙设备上改用 NPU）。

切换到后台可能导致 NPU 卡住

Local Dream 使用 Android 前台服务运行模型，因此切到后台后生成仍会继续——长时间生成和批量任务都是这样设计的。

不过在 NPU 路径上，部分设备在某一步推理进行时切到后台会卡死。在使用 NPU 生成时请尽量保持应用在前台。