故障排除

遇到問題時，先找到與現象對應的條目。先從當前會話、連接狀態或設置中的診斷入口排查恢復，不必先重裝應用或清空數據。

常見問題

以前的會話找不到了

按 ⌘ + K（macOS）或 Ctrl + K（Windows），用會話標題或消息中的關鍵詞搜索。檢查結果中的工作區與會話來源，避免打開另一個同名會話。

如果搜索沒有找到，打開設置 > 對話歷史，分別檢查歸檔和回收站。已歸檔會話可以恢復；回收站中仍可恢復的會話也可以找回。會話狀態快照是額外的恢復入口，但不能恢復項目中被刪除的所有文件。

搜索失敗或結果不完整時，先重試搜索，不要把它當作會話已經刪除。

EvoX 打開了，但模型不回覆

先查看會話是否正在等待批准、登錄或工具結果。如果沒有等待提示，打開設置 > AI 服務：

1. 確認當前會話使用的模型對應哪個提供方和連接實例。
2. 對該實例執行連接測試，保留測試中的原始錯誤。
3. 根據錯誤檢查憑證、接口地址、模型名稱或代理。
4. 測試通過後，在新會話發送一條簡短請求，再回到原任務繼續。

網頁能打開不代表模型接口一定可達。遇到可恢復的瞬時錯誤時，EvoX 會在尚未產生輸出且滿足重試條件的回合中進行有限重試；自動恢復失敗後仍會顯示錯誤。看到恢復或重連提示時，先觀察當前狀態，不連續重發。已有工具輸出、文件寫入或外部操作時，先核對結果再決定是否重試。診斷時優先測試正在使用的連接，不要一次更換所有模型配置。

設置已經保存，行為卻沒有變化

重新打開對應面板，區分“保存失敗”和“已保存但未應用”。後者表示配置已經存下，但運行中的服務尚未確認應用該配置；使用面板提供的重試、服務狀態或重啓入口處理。

還要確認修改的是正確範圍：界面語言不等於回覆語言，風格預設按所選範圍作用於標題、語氣或交付文案。具體説明見設置。

功能或按鈕沒有出現

先檢查 EvoX 版本、當前模式、操作系統與已連接能力。有些操作需要工作區，有些需要已有會話，還有些只在對應插件連接後可用。

如果界面説明該選項受組織策略限制，應按策略處理，不要通過修改本地配置繞過。某個模式沒有按鈕，也不代表其他模式中相似名稱的功能具有相同行為。

沒有收到任務完成通知

打開設置 > 外觀，檢查聲音反饋與通知提示。聲音、系統通知和桌寵氣泡是不同的反饋渠道，打開其中一個不會自動開啓另外兩個。

macOS 通知權限被拒絕時，使用頁面提供的系統設置入口授權，再返回 EvoX 重新檢測。如果提示通知服務不可用，按提示查看日誌或重啓。任務是否完成，以會話中的狀態和結果為準。

任務卡住或執行中斷

先區分等待與失敗

1. 查看最後一條工具記錄，確認是在運行、等待批准、等待登錄，還是已經報錯。
2. 檢查文件選擇器、瀏覽器授權頁和需要確認的彈窗。
3. 需要你提供信息時，直接補充缺少的材料；已經失敗時，先處理明確的錯誤原因。
4. 沒有進展且需要中斷時，使用當前回覆的停止按鈕，或在會話輸入框中按 Esc。

菜單或輸入候選框打開時，Esc 會先處理當前界面。需要停止多個正在執行的任務時，可使用 ⌘ + Shift + K 或 Ctrl + Shift + K。緊急停止不會取消計劃任務之後的調度。

停止後怎樣繼續

先查看已完成的步驟、文件改動和外部操作，再給出範圍明確的後續指令。例如：

先檢查上次任務已經完成的部分，列出剩餘事項。保留現有文件，只繼續未完成的檢查；涉及再次發送或發佈時先告訴我。

停止不會撤銷已經寫入的文件、已經發送的消息或已經提交的外部請求。結果不明確時，先在目標服務中確認，避免重複操作。

如果僅原會話異常、其他會話正常，可以整理當前目標、已有結果和未完成事項，在新會話繼續。不要假定新會話自動擁有舊會話的全部上下文。

蜂羣只有部分任務完成

打開蜂羣面板，分別查看失敗、等待與已完成的分支。保留仍然適用的結果，處理失敗原因後只補做未完成部分；如果各路已經完成但彙總缺失，請主智能體重新整合已有記錄。

請求重試、任務重跑與重新彙總不是同一種恢復動作。遞歸任務有恢復入口時，先檢查任務樹和快照，不要把普通蜂羣的重跑當作快照恢復。詳見恢復與追加。

瀏覽器與聯網搜索

瀏覽器面板打不開

打開設置 > 協作，查看內置瀏覽器的狀態和不可用原因。使用頁面提供的重試入口；如果涉及後台服務，前往高級設置查看診斷結果。

面板能打開但某個網站失敗時，檢查網址、網絡與允許的站點範圍。不要用放開所有站點的方式解決單一地址的訪問問題。

瀏覽器裏沒有我原來的登錄狀態

先檢查設置 > 協作 > 瀏覽器中的身份選擇。EvoX 專屬瀏覽器與日常 Chrome 使用不同環境，日常 Chrome 已登錄不代表專屬瀏覽器也已登錄。

使用獨立環境時，在該環境中完成登錄；需要複用日常 Chrome 時，按使用日常 Chrome完成連接。還應檢查瀏覽器的會話存儲設置，以及是否清理過瀏覽數據。

日常 Chrome 一直等待連接

1. 確認選擇了“接管我的日常 Chrome”，並且 Chrome 仍在運行。
2. 檢查 Playwright Extension 是否安裝，在 EvoX 中點擊重新檢測。
3. 首次發起瀏覽器任務時，在 Chrome 連接頁完成 Allow 授權。
4. 返回原任務檢查連接結果，再決定是否重試。

擴展安裝與連接授權是兩步。不要反覆啓動相同任務來替代授權。如果要撤銷舊訪問權，只關閉靜默連接還不夠，需要按擴展的説明重新生成 token。

聯網搜索報錯或沒有來源

打開設置 > AI 服務 > 聯網搜索，確認所選通道及配置狀態。EvoMap 使用已有模型或內置通道憑證，Tavily 需要 API Key，Google 需要 API Key 與搜索引擎 ID。

憑證拒絕、額度不足、限流和網絡超時應分別處理。需要切換通道時，選擇另一個已經配置好的通道，再執行一次搜索。確認工具結果實際返回了來源，不要把沒有來源的普通模型回答當作搜索成功。

插件與附加應用

插件已安裝，但工具不可用

使用 /mcp 查看 MCP 狀態，並回到插件詳情核對啓用狀態、連接與憑證。已安裝、已啓用和已連接不是同一個狀態。

1. 先完成插件要求的賬號或模型服務配置。
2. 執行連接測試，處理登錄過期或服務啓動錯誤。
3. 確認當前任務可以使用該插件，再重試一個範圍較小的操作。

生圖或語音插件未完成供應商配置時，僅安裝插件不能讓它開始工作。工具仍未出現時，查看當前模式與工具可用範圍，再收集相關診斷信息。詳情見插件。

附加的應用窗口無法讀取

確認目標窗口仍然打開，從輸入框的 @应用 重新選擇。macOS 上檢查 EvoX 所需的屏幕錄製權限；讀取界面文字時檢查並授予所需的輔助功能權限。授權後按系統或應用提示重新打開 EvoX。

部分應用不會提供可讀取的文字，系統拒絕捕獲的受保護窗口不能作為輸入。此時可以改用你主動提供的截圖或文件，而不是重複授權或無限重試。具體條件見附加應用。

編碼與終端

終端無響應，或命令在錯誤的位置運行

先確認終端中是否仍有命令運行，以及它是否正在等待輸入。不要在一個等待中的命令後繼續粘貼新的指令。

在空閒終端中，可以使用以下只讀命令核對目錄和倉庫狀態：

pwd
git status

PowerShell 中也可以用 Get-Location 查看當前目錄。git status 需要當前目錄位於 Git 倉庫中；“不是 Git 倉庫”的提示不代表終端壞了。

如果使用獨立工作副本，核對實際目錄和分支，不要假設它與原項目目錄共享所有未提交文件和依賴。命令表現異常時，先查看項目自己的安裝與啓動説明。

只有終端視圖異常時，先嚐試收起並重新打開面板。需要重啓應用或後台服務前，先保存工作並處理仍在運行的任務。

終端找不到 EvoX 命令

打開設置 > 高級 > 命令行，刷新狀態。如果顯示缺失或需要修復，使用頁面中的安裝或修復按鈕，再重新打開終端驗證。

如果狀態提示被其他命令覆蓋，檢查終端實際解析到的路徑：

將結果與設置中顯示的安裝狀態對照。不要直接刪除不明來源的同名程序；先核對它是否屬於另一套已安裝的工具。

本地預覽鏈接打不開

確認項目的開發服務仍在運行，並使用本次啓動輸出裏的地址與端口。服務重啓後重新檢查監聽端口，舊鏈接不會自動跟隨。

• 連接被拒絕：檢查服務是否已啓動、端口是否正確。
• 頁面空白或報錯：查看開發終端和頁面控制枱中的首個錯誤。
• 遠程任務中的 localhost：它指向運行服務的那台機器；先確認服務所在設備，再使用對應的預覽入口或端口轉發。
• 端口被佔用：先確認佔用者，選擇項目支持的其他端口，不要直接終止未知進程。

計劃任務與文件

計劃任務沒有按時運行

確認任務已啓用，核對下一次運行時間和時區，再打開最近一次運行記錄。

本地任務需要計算機開機、EvoX 與所需服務可用，項目目錄仍然存在。任務已開始但失敗時，繼續檢查模型連接、插件授權和目錄權限。睡眠、斷網和目錄移動與“定時配置錯誤”需要分別處理。

修改後可以在確認不會造成重複外部操作的前提下手動運行一次，檢查結果。任務使用獨立工作副本時，清理該目錄前先暫停相關計劃並保存改動。

回覆説生成了文件，卻找不到

先找實際文件路徑或產物附件。回覆中描述了文件內容，不代表文件已經寫入磁盤。

核對文件屬於哪個項目、工作副本或執行設備，再檢查路徑和文件名。文件在遠程環境生成時，需要使用對應的下載或傳輸入口，不能只在本地同名目錄中尋找。

文件存在，但預覽不正常

先區分文件內容與預覽器問題：用對應的本地應用打開同一個文件進行對照。

• 辦公文件或 PDF 字體、分頁異常：檢查字體是否可用、資源是否完整；需要時重新導出。
• HTML 空白：檢查腳本錯誤和相對資源路徑，避免引用僅在生成機器上存在的絕對路徑。
• 顯示舊內容：確認打開的是最新文件或產物版本，再刷新預覽。

重新生成前保留原文件，避免把預覽問題誤判為內容丟失。

診斷與恢復

打開設置 > 高級查看後台服務狀態、健康摘要和配置檢查。診斷會區分警告與失敗，併為部分問題提供前往設置、授權或重啓服務的入口。

建議按以下順序處理：

1. 記錄錯誤、發生時間與當前任務狀態。
2. 運行診斷，優先處理與當前故障相關的失敗項。
3. 完成修復後刷新檢查，確認狀態確實恢復。
4. 用一條簡單請求驗證，再繼續原任務。

後台服務無法連接時，診斷中的桌面端服務狀態與後台檢查結果分別展示。“檢查不可用”或超時不等於檢查通過。

重啓服務、清除歷史和恢復初始設置是不同操作。不要把清空數據作為第一步；確實需要重置時，先備份重要文件，並閲讀確認框中的刪除範圍。

反饋與日誌

在應用菜單中打開問題反饋，或按 ⌘ + Shift + U（macOS）、Ctrl + Shift + U（Windows）。提交前審閲報告中的截圖與診斷內容。

需要日誌時，前往設置 > 高級中的服務詳情，使用打開日誌文件夾或複製診斷信息。不同安裝與系統使用各自的日誌路徑，優先使用應用入口定位，不必猜測固定目錄。應用菜單中的關於可用於查看版本。

報告中寫清楚：

问题：我做了什么，出现了什么异常
环境：EvoX 版本、操作系统、所在模式
时间：发生时间与时区
步骤：如何从正常状态复现问题
预期：希望得到什么结果
实际：错误文字、截图或失败状态
已尝试：做过哪些恢复操作，结果如何

分享前檢查日誌、截圖及複製的診斷信息，刪除或遮蓋 API Key、令牌、會話內容、客户資料，以及含用户名或內部項目名稱的本地敏感路徑，只保留排查需要的信息。不要把所有工作目錄或完整聊天記錄無差別打包上傳。

/feedback 在會話中生成反饋請求提示模板時，不代表報告已經提交。以問題反饋窗口顯示的提交結果為準。

按連接定位問題

先確定哪一條連接出了問題，再修改對應設置。模型、搜索、瀏覽器、插件和 EvoMap Hub 使用不同連接，不能用其中一個成功推斷其他都正常。

找到失敗的位置

先做四步檢查

1. 記錄失敗動作與時間，保留脱敏後的錯誤信息。
2. 打開對應連接面板，確認實際賬號、地址和實例。
3. 使用該連接的測試或重試入口。
4. 回到原任務，用同一個小請求確認是否恢復。

只修改與故障有關的一項，避免同時更換模型、代理和憑證後無法知道哪一步有效。

代理與後台服務

在高級設置中檢查代理配置與實際代理狀態。操作系統能打開網站，並不保證後台服務使用相同網絡路徑。

修改後按界面提示重新連接或重啓對應服務，檢查生效狀態。分別檢查模型連接、搜索服務與本地 MCP 進程的依賴。

瀏覽器連接

EvoX 專屬瀏覽器與日常 Chrome 是不同身份。前者使用獨立環境，未登錄的網站需要在該環境中登錄；後者需要擴展與連接授權。

擴展“已安裝”不等於“已授權連接”。需要完整步驟時，閲讀使用日常 Chrome。

按錯誤類型處理

失敗的操作涉及遠端寫入時，先查詢實際狀態，再決定是否重試，避免重複發送或創建。

提供可用的診斷信息

報告系統、應用版本、連接類型、發生時間、預期與實際結果，以及脱敏錯誤。不要附帶完整密鑰、訪問令牌或包含私人內容的整段日誌。

代理與服務選項見網絡與後台運行。

EvoX 文檔 · 功能 · 參考資料