本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 问题排查
<a name="desktop-troubleshooting"></a>

以下各节介绍您在使用 Amazon Quick 桌面应用程序时可能遇到的常见问题以及如何解决这些问题。

## 安装和启动问题
<a name="desktop-ts-install"></a>

macOS 显示 “开发者身份不明” 警告  
如果 macOS 因为来自身份不明的开发者而阻止您打开 Amazon Quick 桌面应用程序，请按照以下步骤允许打开。  

1. 在 Mac 上打开 **“系统设置”**。

1. 选择 **Privacy & Security (隐私与安全性)**。

1. 滚动到 “安全” 部分，然后选择有关 Quick 的消息旁边的 “**无论如何打开**”。

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. 检查您的互联网连接是否活跃且稳定。

微软 Teams 连接失败  
如果与微软 Teams 的连接失败，请按照与 Slack 或 Outlook 相同的步骤进行操作。确认贵组织的管理员没有限制第三方应用程序的访问权限。

连接显示 “未同步” 状态  
如果连接显示 “未同步” 状态，请尝试以下步骤。  

1. 确认您的互联网连接处于活动状态。

1. 在 **“设置” > “**功能**” > “连接”** 中断开服务并重新**连接**。

1. 如果问题仍然存在，则第三方服务可能会中断。查看服务的状态页面。

Google 工作空间连接失败  
如果与谷歌服务（Gmail、谷歌日历、谷歌云端硬盘、谷歌文档、谷歌表格、谷歌幻灯片、Google Meet 或谷歌分析）的连接失败，请验证以下内容。  

1. 您的 Google 帐号不受贵组织管理员政策的限制。

1. 您已在登录流程中授予所需的 OAuth 权限。

1. 您使用的是正确的谷歌账号登录。

## 性能问题
<a name="desktop-ts-performance"></a>

反应缓慢  
如果快速响应速度很慢，请尝试以下步骤。  

1. 切换到**快速** AI 模型模式以获得更快的响应。在聊天输入区域中选择模型选择器，然后选择**快速**。

1. 降低**思维精力**。较低的思维努力（Off 或 Low）会产生更快的响应。

1. 关闭未使用的应用程序以释放系统资源。

1. 检查您的互联网连接速度。AI 模型请求需要与 API Gateway 建立网络连接。

高内存使用量  
如果 Amazon Quick 桌面应用程序使用了过多的内存，请尝试以下步骤。  

1. 减少在 “**设置” > “**我的电脑**”** 中编入索引的文件夹数量。对不需要**语义搜索**的文件夹禁用语义搜索，因为语义搜索使用的资源比关键字搜索多。

1. 放下 “**设置” > “**自定义**” > “****性能**” 中的 “**最大并行任务**数” 滑块。默认值是 50。减少此值会限制并发后台操作的数量。

1. 重新启动应用程序以清除缓存的数据。

1. 在 **“设置” > “**我的电脑**” > “****搜索索引” 中调整搜索索引**限制。降低**存储限制**、**用于索引的最大文件大小或索引****滑块的最大文件夹大小**。
当可用磁盘空间低于 8.0 GiB 时，搜索索引会自动暂停。

## 文件访问问题
<a name="desktop-ts-file-access"></a>

Quick 找不到文件  
如果 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. 如果使用默认模式，Quick 会使用您的个人资料副本启动单独的 Chrome 实例。确保您的系统上安装了 Chrome。

## 预定代理问题
<a name="desktop-ts-agents"></a>

预定代理未运行  
预设代理在您的计算机上本地运行。如果代理未按计划时间运行，请验证以下内容。  

1. 您的计算机已在预定时间开机并处于唤醒状态。

1. Amazon Quick 桌面应用程序正在运行。

1. 代理已启用。在 **“设置” > “**功能**” > “****计划任务**” 中选中开关，或者从顶部栏中打开 “**代理**” 面板。

1. 您的互联网连接已激活。访问互联服务或 AI 模型的代理需要网络连接。
如果在安排代理运行时您的计算机已关闭或应用程序已关闭，则代理要等到下一个预定时间才会运行。

代理产生意想不到的结果  
如果定时代理产生意外结果，请尝试以下步骤。  

1. 打开 **“设置” > “****功能**” > “**计划任务**”，然后选择代理。

1. 查看 “**提示**” 选项卡，验证代理的说明是否正确。

1. 检查 “**功能**” 选项卡，验证连接的 MCP 服务器是否正确。

1. 考虑在 “**概述**” 选项卡中更改**模型**。使用 B **alan** ce **d 或 Smar** t 执行更复杂的代理任务。

1. 选择 “**运行**” 按钮（播放图标）以手动触发代理并观察结果。

## MCP 服务器问题
<a name="desktop-ts-mcp"></a>

MCP 服务器无法连接  
如果 MCP 服务器无法连接，请根据连接类型尝试以下步骤。  
**本地 MCP 服务器：**  

1. 验证命令是否正确且可执行文件已安装在您的系统上。

1. 检查参数是否以空格分隔且格式正确。

1. 如果服务器启动**时间**超过 30 秒（可配置为 5 到 300 秒），请增加 “超时” 值。

1. 验证是否正确设置了所有必需的**环境变量**。
**远程 MCP 服务器：**  

1. 验证 URL 是否正确且服务器正在运行。

1. 如果需要身份验证，请验证 Toke **n** 值是否为有效的不记名令牌。

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>

如果其他故障排除步骤无法解决您的问题，则可以通过清除所有数据来重置应用程序。

**警告**  
此操作不可逆。它会删除所有 Quick 数据，包括对话、缓存的消息、知识图表、保存的凭据和用户首选项。应用程序在清理后退出。

1. 打开 **“设置” > “****自定义**”。

1. 滚动到 “**危险区域**” 部分。

1. 选择 “**清除所有数据**”。

1. 确认该操作。

1. 要在 macOS 上完全卸载，请拖`Amazon Quick.app`至 “垃圾箱”。在 Windows 上，打开 **“设置” > “**应用程序**” > “****已安装的应用程序**”，找到 Amazon Quick，然后选择 “**卸载**”。

## 获得更多帮助
<a name="desktop-ts-help"></a>

如果上述故障排除步骤无法解决您的问题，则可以使用以下资源。
+ **导出诊断**信息并与您的支持团队共享。
+ **开发者菜单**-选择连接状态点（右上角的绿点）以访问任务控制、指标叠加层、调试面板和内存面板，以进行高级诊断。
+ 有关企业帐户的问题，请联系贵组织的 IT 管理员。
+ 请访问 Amazon Quick 文档以获取最新指南。