保持說明更新 — Noea Code 文件

修改意圖或程式碼後，請檢查說明是否仍適用。用側邊欄的解釋處理全專案需要更新的說明，或用段落的調查檢查單一內容。

辨識變更

「可能已過時」不一定代表結論錯誤，檔案變更可能與結論無關。「未發現變更」也不能證明測試通過或全部功能已完成。

儲存文件，將游標移到段落上，選擇左側的調查。已有側註也可能提供重新調查。

此操作只更新選取內容的說明。內容有未儲存變更時無法調查，Noea 會提示先儲存。

例如，修改避免重複發獎的程式碼後，調查對應規則，確認說明描述的是目前實作。

點選側邊欄的解釋，檢查待調查內容，以及支持檔案已改變的說明。未開啟專案、專案唯讀或未連結實作資料夾時，此操作不可用。

手動啟動解釋會開啟對話，顯示階段、進度與個別結果。執行時不能在該對話傳送一般訊息，但可使用專案中的其他對話。

結束後展開結果，查看哪些說明已更新、哪些仍準確，以及哪些檢查失敗或未完成。任務結束不代表每項檢查都成功。

解釋會比對意圖與程式碼，檢查段落級及局部說明。它保留準確內容、更新需要修正的部分，不一定重寫每份說明。

說明更新不代表重跑了測試。若要驗證行為，在一般對話要求檢查，再調查相關內容。驗證範圍的判讀請參閱閱讀說明與依據。

設定 → 目前專案 → 自動化 → 實作後自動解釋預設啟用，主要觸發條件如下：

自動解釋在背景執行，不建立一般對話。你可繼續原對話，並在執行記錄查看進度。

側邊欄的執行記錄保留解釋任務。展開任務可查看各次執行的唯讀紀錄，切換對話或重新啟動應用程式後仍可查看。

失敗或中斷後，選擇再次執行。既有說明會保留。新一輪結束後，檢查先前失敗或未完成的項目是否已處理。

解釋使用的 Agent 取決於啟動方式。專案操作設定與適用範圍請參閱 Agent、模型與用量。

說明無法更新時，請參閱疑難排解與常見問題。