故障排查

启动失败/白屏

• 清除浏览器缓存和IndexedDB(隐私/无痕模式测试)
• Android：系统设置→应用→AIaW→存储→清除数据(会丢失对话历史)
• 确认npm install无错误(node_modules完整)
• 隐私设置是否禁用IndexedDB(部分浏览器严格模式)

API调用失败

• 确认API Key正确且未过期(点击显示密钥检查)
• 检查网络连接(AI调用需要互联网)
• Cerebras:stream_options已自动移除
• MiniMax:think块尾部已自动过滤
• Base URL无多余尾部斜杠(/v1而非/v1/)

MCP插件不工作

• 点击刷新按钮重新拉取manifest
• 检查插件是否需要独立API Key
• Android WebView限制部分浏览器API→USB连接Chrome DevTools远程调试

文件操作失败

• Android：确认存储权限已授予+先执行mountDir选择工作目录
• iOS：标准文件选择器，无持久化挂载，每次需重新选择
• 大文件(>50K字符)：使用readFile的offset/limit参数分页读取

导出/导入失败

• 大量对话导出需等待几秒
• 导入必须是AIaW格式.json文件
• 跨版本可能有兼容差异
• API密钥不包含在导出中(需重新输入)

Python执行失败

• 首次加载Pyodide(约8MB)需几秒到十几秒
• 确认语法在Pyodide 3.12兼容范围(os/subprocess/threading不可用)
• numpy/pandas/matplotlib已预装，其他包需micropip安装(需C扩展的包可能不可用)

构建失败

• Android：确认ANDROID_HOME环境变量+SDK Platform 34已安装
• iOS：确认Xcode 15+和Signing Team正确
• npx cap sync手动同步Web和原生平台
• Gradle依赖下载问题→检查代理/VPN设置