故障排查手册：连不上、生成失败与性能问题

排查的总套路

三层工具由浅入深：

用户设置顶行的入口。每个生成请求记录完整生命周期与状态流转，含流式响应的 Token 统计（从 SSE 事件提取），也覆盖图像生成与向量嵌入调用。每用户最多保留最近约两百条记录。

典型用法：

都在用户设置抽屉的「日志」入口：选来源、按时间或条数筛选、搜索、复制。

用户设置里的 导出调试日志 会把日志快照与问题前后的完整上下文打包——交这个，不要只交截图。配合诊断开关（需要证据时的专项记录）效果最好。

症状	先查什么
界面打不开	服务起没起、端口对不对、白名单有没有拦（见鉴权与安全）
生成报错	请求检查器看响应体；核对密钥与模型名
回复特别慢	运行面板找卡住的环节；编排 Agent 是否配了慢模型
记忆不生成	记忆图提取模型的 API 是否可用；开关状态
Skill 不生效	是否挂载给 Agent、作用域对不对、引用名是否失效
扩展装了没反应	第三方扩展目录在数据目录外，迁移时容易漏（见搬家教程）
安卓反复崩溃	应用会自动进安全模式禁用第三方扩展；先排查最近装的扩展

管理面板里装的服务端插件依赖缺失时，在插件标签页补装依赖再重启。需要编译原生模块的包在安卓端装不了（安装流程不执行构建脚本），先在桌面端装好再拷目录。