疑難排解與常見問題 — Noea Code 文件

先閱讀失敗操作的提示，再檢查專案、Agent 與任務狀態。以下各節指引常見問題的處理位置。

初始設定無法進入工作台

初始設定要求至少一個 Agent 完成安裝、登入及驗證。只安裝或關閉登入視窗不夠，清單必須顯示就緒。

開啟 Agent 詳細資訊，解決登入、網路或驗證問題後重新檢查。參閱安裝與準備。

先檢查網路及系統 HTTP(S) 代理。代理環境變數優先，此機制不支援 SOCKS。下載暫停接收資料時可能顯示準備中，請觀察更新，回報失敗時再重試。

反覆失敗時，複製 Agent 診斷，註明問題發生在下載執行環境、安裝 Agent，還是驗證連線。

Noea 以驗證結果判斷 Agent 是否就緒。檢查帳號或供應商、可用額度及模型設定。OpenCode 請重新整理供應商清單、確認連線，再驗證一次。

模型選擇若要求先連線，請連接工作階段後再檢查。一個 Agent 支援的設定，不代表另一個也支援。

情況	處理方式
選取資料夾不是 Noea 專案。	程式碼請用打開實作資料夾；現有專案請選實際專案資料夾。
專案資料夾移動了。	用打開現有的 Noea 專案選取目前位置。
專案資料夾被刪除。	先從垃圾桶、資源回收筒或備份還原，再開啟。
設定無效。	保留原內容，檢查設定或提交診斷；不要重新初始化覆寫。
資料由較新版應用程式寫入。	更新應用程式後再開啟。
資料版本不相容。	保留專案及應用程式資料副本，依具體提示處理，不要覆寫不相容資料。

在設定 → 目前專案 → 專案檢查實作資料夾。尚未連結時請連結；舊路徑不可存取時，重新定位原程式碼資料夾。

也要確認 Agent 已就緒。意圖檔案可讀，不代表實作資料夾與 Agent 都準備好了。

儲存意圖後調查相關段落，或從側邊欄執行解釋。需求若需修改程式碼，先在對話實作，再調查。

先前的文字指編輯前的意圖；可能已過時表示支持檔案後來有變更。請依目前內容重新檢查，參閱保持說明更新。

側邊欄的未發現變更不代表全部測試通過或沒有缺口。

檢查設定 → 目前專案 → 自動化 → 實作後自動解釋。一般對話只改程式碼、直接實作，以及失敗或停止的實作都不觸發。

需要時手動執行。任務結束仍有失敗或未完成檢查時，展開結果、處理原因後再次執行。參閱完整的自動觸發規則。

提議提示文件已變更時，選擇請 AI 代理依目前版本重新提議。整理方案過時時，選擇重新整理。

一般提議可編輯新增或替換文字，但不支援逐項或逐檔接受。整理草稿為唯讀，可保留提議刪除的內容後再接受整份方案。

Noea 明確指出訊息未送達 Agent 時可重試。若可能已送達，先檢查執行軌跡與檔案變更，避免重複執行。

Agent 已收到訊息但中途停止時，傳送新指示請它檢查目前狀態並繼續。標示實作未完成的提議卡片也提供繼續實作。

編輯訊息、分支對話或停止執行，都不會回復檔案變更。

MCP 請使用測試連線，依結果檢查命令、URL、授權及環境變數。測試成功後，仍須確認對話已選取伺服器，且 Agent 支援其連線方式。

MCP 設定變更需要 Agent 重新連線；新增或移除 Skill 則需要新對話。解釋與整理任務不使用這些擴充功能。參閱加入 MCP 伺服器與 Skills。

儲存衝突表示編輯期間，另一個操作改變了磁碟檔案。請另存目前內容，或重新載入磁碟版本。重新載入會捨棄未儲存編輯。

引用失效時，確認檔案或資料仍存在，且實作資料夾可存取。舊說明若已不符合文件，返回其段落閱讀最新說明，必要時重新調查。

使用側邊欄的意見回饋，描述目標、實際結果及導致問題的步驟。留下電子郵件方便追蹤，或聯絡 [email protected]。

需要診斷時，從設定 → 關於匯出，或從 Agent 詳細資訊面板複製。診斷可能包含本機狀態與日誌，分享前請檢查。意見回饋不會自動附加這些檔案。