本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 疑難排解
<a name="desktop-troubleshooting"></a>

下列各節說明使用 Amazon Quick 桌面應用程式時可能遇到的常見問題，以及如何解決這些問題。

## 安裝和啟動問題
<a name="desktop-ts-install"></a>

macOS 會顯示「無法識別開發人員」警告  
如果 macOS 因為來自無法識別的開發人員而無法開啟 Amazon Quick 桌面應用程式，請使用下列程序來允許它。  

1. 在 Mac 上開啟**系統設定**。

1. 選擇 **Privacy & Security (隱私權與安全性)**。

1. 捲動至安全區段，然後選擇 Quick 訊息旁的 **Open Anyway**。

1. 確認您要開啟應用程式。
第一次啟動時，您的作業系統可能會提示您確認是否要開啟應用程式。選擇**開啟**以繼續。

應用程式不會啟動  
如果 Amazon Quick 桌面應用程式未啟動，請嘗試下列步驟。  

1. 重新啟動您的電腦，然後再次嘗試開啟應用程式。

1. 確認您的作業系統符合最低需求。

1. 檢查您是否有足夠的可用磁碟空間。

1. 如果問題仍然存在，請刪除`~/.quickwork/`目錄 (macOS) 或`%USERPROFILE%\.quickwork\`目錄 (Windows)，然後重新安裝應用程式。
刪除 `~/.quickwork/`(macOS) 或 `%USERPROFILE%\.quickwork\`(Windows) 目錄會移除所有本機資料，包括對話、知識圖表、記憶體和儲存的登入資料。此步驟僅用於最後的排序。

## 連線問題
<a name="desktop-ts-connections"></a>

Slack 或 Outlook 連線失敗  
如果與 Slack 或 Microsoft Outlook 的連線失敗，請嘗試下列步驟。  

1. 在**設定** > **功能** > **連線**中中斷連線服務。

1. 選擇**登入**並完成身分驗證流程，以重新連線服務。

1. 確認您的帳戶在第三方服務中具有必要的許可。

1. 檢查您的網際網路連線是否作用中且穩定。

Microsoft Teams 連線失敗  
如果與 Microsoft Teams 的連線失敗，請遵循與 Slack 或 Outlook 相同的步驟。確認您的組織的管理員未限制第三方應用程式存取。

連線顯示「未同步」狀態  
如果連線顯示「未同步」狀態，請嘗試下列步驟。  

1. 確認您有作用中的網際網路連線。

1. 在**設定** > **功能** > **連線**中中斷和重新連線服務。

1. 如果問題仍然存在，第三方服務可能會遇到中斷。檢查服務的狀態頁面。

Google Workspace 連線失敗  
如果與 Google 服務的連線 (Gmail、Google Calendar、Google Drive、Google Docs、Google Sheets、Google Slides、Google Meet 或 Google Analytics) 失敗，請確認下列事項。  

1. 您的 Google 帳戶不受組織的管理政策限制。

1. 您已在登入流程中授予必要的 OAuth 許可。

1. 您使用正確的 Google 帳戶登入。

## 效能問題
<a name="desktop-ts-performance"></a>

回應緩慢  
如果快速回應緩慢，請嘗試下列步驟。  

1. 切換到**快速** AI 模型模式，以獲得更快的回應。在聊天輸入區域中選擇模型選取器，然後選取**快速**。

1. 降低**思考工作**量。較低的思考力 （關或低） 可產生更快的回應。

1. 關閉未使用的應用程式以釋放系統資源。

1. 檢查您的網際網路連線速度。AI 模型請求需要與 API Gateway 的網路連線。

高記憶體用量  
如果 Amazon Quick 桌面應用程式使用過多記憶體，請嘗試下列步驟。  

1. 減少**設定** > **我的電腦**中編製索引的資料夾數量。停用不需要的資料夾**語意搜尋**，因為語意搜尋使用的資源多於關鍵字搜尋。

1. 降低**設定** > **自訂** > **效能**中的**平行任務上限**滑桿。預設值為 50。減少此值會限制並行背景操作的數量。

1. 重新啟動應用程式以清除快取的資料。

1. 在**設定** > **我的電腦** > 搜尋索引中調整**搜尋索引**限制。降低**儲存限制**、**索引的檔案大小上限**，或**索引滑桿的資料夾大小上限**。
當可用磁碟空間低於 8.0 GiB 時，搜尋索引會自動暫停。

## 檔案存取問題
<a name="desktop-ts-file-access"></a>

快速找不到檔案  
如果 Quick 找不到您在聊天中參考的檔案，請確認下列事項。  

1. 檔案的父資料夾會新增至**設定** > **我的電腦** > **本機資料夾**。Quick 只能存取您明確授予存取權之資料夾中的檔案。

1. 選擇 **\+ 新增資料夾**以授予其他資料夾的存取權。

1. 新增資料夾後，Quick 可以立即讀取其中的檔案。搜尋的索引會在背景中進行。

搜尋不會傳回任何結果  
如果檔案搜尋未傳回任何結果，請嘗試下列步驟。  

1. 確認在**設定** > **我的電腦** > **本機**資料夾中的資料夾已開啟**關鍵字搜尋**。展開 資料夾以查看其索引切換。

1. 檢查索引狀態。檔案和項目計數的**就緒**狀態會確認索引已完成。

1. 如果您最近新增了資料夾，請等待索引完成。狀態會顯示進度。

1. 檢查檔案是否不大於**設定** > **我的電腦** > **搜尋****索引中索引限制的檔案大小上限**。索引期間會略過大於此限制的檔案，但仍可透過直接檔案存取供代理程式使用。

1. 如需更廣泛的搜尋，請在 資料夾上啟用**語意搜尋**，以允許自然語言查詢。

## 瀏覽器自動化問題
<a name="desktop-ts-browser"></a>

瀏覽器自動化無法運作  
如果 Quick 無法瀏覽網頁，請嘗試下列步驟。  

1. 確認**瀏覽器自動化**已在**設定** > **功能** > **系統中**啟用。

1. 如果使用「使用我的 Chrome」模式，請在**設定** > **自訂** > **瀏覽器**中驗證設定。開啟 Chrome 並導覽至 `chrome://inspect/#remote-debugging`。選擇**啟用遠端偵錯**。返回快速並選擇**測試連線**以驗證連線。

1. 如果使用預設模式， 會使用設定檔的副本快速啟動個別的 Chrome 執行個體。確保您的系統上已安裝 Chrome。

## 排定的客服人員問題
<a name="desktop-ts-agents"></a>

排程的代理程式未執行  
排程的代理程式會在您的電腦本機執行。如果代理程式未在排定的時間執行，請確認下列事項。  

1. 您的電腦已在排程時間開啟並喚醒。

1. Amazon Quick 桌面應用程式正在執行。

1. 代理程式已啟用。檢查**設定** > **功能** > **排程任務**中的切換，或從頂端列開啟**客服人員**面板。

1. 您的網際網路連線已啟用。存取連線服務或 AI 模型的代理程式需要網路連線。
如果您的電腦關閉，或應用程式在代理程式排程執行時關閉，代理程式會等到下一次排程的時間才會執行。

客服人員產生非預期的結果  
如果排程的代理程式產生非預期的結果，請嘗試下列步驟。  

1. 開啟**設定** > **功能** > **排程任務**，然後選取客服人員。

1. 檢閱**提示**索引標籤，確認客服人員的指示正確無誤。

1. 檢查**功能**索引標籤，確認已連接正確的 MCP 伺服器。

1. 請考慮在**概觀**索引標籤中變更**模型**。針對更複雜的客服人員任務使用**平衡**或**智慧**。

1. 選擇**執行**按鈕 （播放圖示） 以手動觸發代理程式並觀察結果。

## MCP 伺服器問題
<a name="desktop-ts-mcp"></a>

MCP 伺服器無法連線  
如果 MCP 伺服器無法連線，請根據連線類型嘗試下列步驟。  
**本機 MCP 伺服器：**  

1. 確認命令正確，且您的系統已安裝可執行檔。

1. 檢查引數是否以空格分隔且格式正確。

1. 如果伺服器需要超過 30 秒才能啟動 （可設定為 5 到 300 秒），請增加**逾時**值。

1. 確認已正確設定任何必要的**環境變數**。
**遠端 MCP 伺服器：**  

1. 確認 URL 正確且伺服器正在執行。

1. 如果需要身分驗證，請確認**權杖**值是有效的承載權杖。

1. 檢查您的網路連線和任何防火牆設定。
**匯入的 MCP 伺服器：**  

1. 驗證組態檔案路徑是否正確。

1. 確保來源應用程式 (Kiro、Claude Code、AIM 等） 已正確安裝。

## 匯出診斷
<a name="desktop-ts-diagnostics"></a>

如果您需要共用診斷資訊以進行故障診斷，您可以從應用程式匯出診斷日誌。

1. 開啟**設定** > **自訂**。

1. 捲動至**故障診斷**區段。

1. 從下拉式清單中選取時間範圍 （例如，**過去 2 小時**)。

1. 選擇**匯出診斷**，將診斷日誌儲存至桌面。

## 重設應用程式
<a name="desktop-ts-reset"></a>

如果其他疑難排解步驟無法解決您的問題，您可以透過清除所有資料來重設應用程式。

**警告**  
此動作不可復原。它會移除所有快速資料，包括對話、快取訊息、知識圖表、儲存的登入資料和使用者偏好設定。應用程式會在清除後結束。

1. 開啟**設定** > **自訂**。

1. 捲動至**危險區域**區段。

1. 選擇**清除所有資料**。

1. 確認動作。

1. 若要在 macOS 上完全解除安裝，請拖曳`Amazon Quick.app`至 Trash。在 Windows 上，開啟**設定** > **應用程式** > **安裝的應用程式**，尋找 Amazon Quick，然後選擇**解除安裝**。

## 取得其他協助
<a name="desktop-ts-help"></a>

如果上述疑難排解步驟無法解決您的問題，您可以使用下列資源。
+ **匯出診斷**並與您的支援團隊共用。
+ **開發人員功能表** – 選擇連線狀態點 （右上角的綠點），以存取任務控制、指標浮水印、偵錯面板和記憶體面板以進行進階診斷。
+ 如有企業帳戶問題，請聯絡組織的 IT 管理員。
+ 如需最新指引，請參閱 Amazon Quick 文件。