故障排查
啓動問題
| 症狀 |
原因 |
解決 |
| 首次啓動卡在初始化 |
環境初始化中 |
等待約 30 秒；超過 2 分鐘重啓 |
| 連續啓動失敗 |
配置損壞 |
自動進入安全模式，可回滾到最近正常配置 |
| 窗口位置丟失 |
拔掉外接屏 |
自動校驗顯示器範圍，回退預設位置 |
登錄問題
| 症狀 |
原因 |
解決 |
| 掃碼後無響應 |
網絡不通或授權服務不可達 |
檢查網絡；確認環境配置 |
| 登錄狀態頻繁丟失 |
長時間未使用導致登錄過期 |
重新掃碼登錄 |
| 看不到組織模型 |
組織未配置策略 |
聯繫組織管理員 |
藍信渠道問題
| 症狀 |
原因 |
解決 |
| 機械人不回覆消息 |
WS 斷連或羣策略攔截 |
渠道頁檢查連接狀態；檢查羣聊是否啓用 |
| 羣裏 @機械人無反應 |
未開啓該羣 |
右鍵會話 → 對話設定 → 啓用此對話 |
| 審批卡片過期 |
660 秒超時 |
重新發起操作 |
模型調用問題
| 症狀 |
原因 |
解決 |
| 模型無響應 |
API Key 無效或網絡不通 |
設定、模型，測試連通性 |
| 圖片上傳後無識別 |
模型不支援圖片輸入 |
配置圖片識別回退模型 |
| 思考級別不可選 |
模型不支援推理 |
僅 reasoning 模型顯示思考選擇器 |
性能問題
| 症狀 |
解決 |
| 輸入法選字延遲 |
檢查是否有超大附件在加載 |
| 切換會話閃爍 |
僅最後一條消息播入場動畫；檢查系統減弱動態效果設定 |
| 長時間使用記憶體增長 |
關閉不需要的會話；重啓應用 |
診斷工具
設定 → 關於 → 版本訊息下面有「診斷報告」掣，一鍵生成包含環境資訊嘅報告畀技術支援分析。
反饋問題時帶埋呢啲
聯絡支援時提供以下資訊可以快好多搵到問題：
- 診斷報告：設定 → 關於 → 診斷報告，一鍵生成
- 會話 ID：出問題嗰個會話側欄右鍵 → 重命名，彈窗標題入面嘅編號就係會話 ID（或者喺診斷報告度搵）
- 復現步驟：由開 app 到出錯，實際做咗乜；穩定復現嘅最好，偶發嘅註明頻率
- 報錯 screenshot：連訊息流入面嘅錯誤卡一齊截，唔好齋截彈窗
敏感資料唔使擔心：診斷報告同日誌入面嘅 API Key、Token 已經脫敏，可以放心畀。
日誌位置
要手動查日誌時（例如支援人員要求）。日誌係一個 JSONL 檔案，包含主程序、核心同工具調用嘅結構化事件；API Key、Token、訊息正文都已經脫敏：
| 系統 |
路徑 |
| macOS/Linux |
~/.lanmate/agent/logs/ |
| Windows |
%USERPROFILE%\.lanmate\agent\logs\ |