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