故障排查
启动问题
| 症状 |
原因 |
解决 |
| 首次启动卡在初始化 |
环境初始化中 |
等待约 30 秒；超过 2 分钟重启 |
| 连续启动失败 |
配置损坏 |
自动进入安全模式，可回滚到最近正常配置 |
| 窗口位置丢失 |
拔掉外接屏 |
自动校验显示器范围，回退默认位置 |
登录问题
| 症状 |
原因 |
解决 |
| 扫码后无响应 |
网络不通或授权服务不可达 |
检查网络；确认环境配置 |
| 登录状态频繁丢失 |
长时间未使用导致登录过期 |
重新扫码登录 |
| 看不到组织模型 |
组织未配置策略 |
联系组织管理员 |
蓝信渠道问题
| 症状 |
原因 |
解决 |
| 机器人不回复消息 |
WS 断连或群策略拦截 |
渠道页检查连接状态；检查群聊是否启用 |
| 群里 @机器人无反应 |
未开启该群 |
右键会话 → 对话设置 → 启用此对话 |
| 审批卡片过期 |
660 秒超时 |
重新发起操作 |
模型调用问题
| 症状 |
原因 |
解决 |
| 模型无响应 |
API Key 无效或网络不通 |
设置、模型，测试连通性 |
| 图片上传后无识别 |
模型不支持图片输入 |
配置图片识别回退模型 |
| 思考级别不可选 |
模型不支持推理 |
仅 reasoning 模型显示思考选择器 |
性能问题
| 症状 |
解决 |
| 输入法选字延迟 |
检查是否有超大附件在加载 |
| 切换会话闪烁 |
仅最后一条消息播入场动画；检查系统减弱动态效果设置 |
| 长时间使用内存增长 |
关闭不需要的会话；重启应用 |
诊断工具
设置 → 关于 → 版本信息下方有「诊断报告」按钮，一键生成包含环境信息的报告供技术支持分析。
反馈问题时带上这些
联系支持时提供以下信息可以大幅加快定位：
- 诊断报告：设置 → 关于 → 诊断报告，一键生成
- 会话 ID：出问题的会话侧栏右键 → 重命名，弹窗标题里的编号就是会话 ID（或在诊断报告中查找）
- 复现步骤：从打开应用到出错，具体做了什么；能稳定复现的最好，偶发的注明频率
- 报错截图：连同消息流里的错误卡片一起截，别只截弹窗
敏感信息不用担心：诊断报告与日志里的 API Key、Token 均已脱敏，可以放心提供。
日志位置
需要手动查日志时（如支持人员要求）。日志是一个 JSONL 文件，包含主进程、内核与工具调用的结构化事件；API Key、Token、消息正文均已脱敏：
| 系统 |
路径 |
| macOS/Linux |
~/.lanmate/agent/logs/ |
| Windows |
%USERPROFILE%\.lanmate\agent\logs\ |