故障排查
啟動問題
| 症狀 |
原因 |
解決 |
| 首次啟動卡在初始化 |
環境初始化中 |
等待約 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\ |