當前版本：v0.7.8
本章節彙整了使用者最常遇到的問題與解決方案。若您遇到無法解決的技術問題，請先檢查此頁面。
1. 模型連接與 Wizard 問題
- Ollama 模型無法連接：確認系統列是否有圖示，並在瀏覽器存取 http://localhost:11434 驗證服務是否正常。
- 供應商顯示鎖頭：這代表您目前使用的是「公開測試版本」，除 Ollama 外的供應商目前定調為功能開發中尚未開放。
2. 對話與標籤引用問題
- 選取標籤後膠囊未出現：請確保已升級至 v0.7.8 或更新版本。此版本修復了附件路徑還原邏輯，提升了引用成功率。
- 找不到剛上傳的附件：請確認該工作區的「跨對話檔案共用」開關是否已開啟。
3. 任務與檔案權限問題
- Access Denied 錯誤：Agent 試圖存取「授權根目錄」以外的檔案。請檢查工作區設定中的目錄路徑。
4. 程式崩潰與渲染問題
- 灰畫面處理：系統會顯示救援視窗，請優先點擊「重新載入」。若無效，請選擇「強制重置」以清除快取。
- 圖表顯示空白：系統採用非同步渲染，請稍候 1-2 秒或重新載入對話。
5. 知識庫召回問題
- embed func not provided：嵌入模型尚未啟動。請確認已下載正確的模型並在設定中正確配置。
- 搜尋結果失準：通常是索引模型與搜尋模型不一致。若曾更換嵌入模型，請重新「建立索引」。
6. 取得系統日誌 (Logs)
若問題持續，請提供位於 %APPDATA%\desktop-agent-hjplus\logs\ 下的 app.log 與 mcp.log 檔案。