本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
问题排查
以下各节介绍您在使用 Amazon Quick 桌面应用程序时可能遇到的常见问题以及如何解决这些问题。
安装和启动问题
- macOS 显示 “开发者身份不明” 警告
-
如果 macOS 因为来自身份不明的开发者而阻止您打开 Amazon Quick 桌面应用程序，请按照以下步骤允许打开。
在 Mac 上打开 “系统设置”。
选择 Privacy & Security (隐私与安全性)。
滚动到 “安全” 部分，然后选择有关 Quick 的消息旁边的 “无论如何打开”。
确认您要打开应用程序。
注意
首次启动时，您的操作系统可能会提示您确认要打开该应用程序。选择 “打开” 继续。
- 应用程序无法启动
-
如果 Amazon Quick 桌面应用程序无法启动，请尝试以下步骤。
重新启动计算机并尝试再次打开应用程序。
验证您的操作系统是否满足最低要求。
检查是否有足够的可用磁盘空间。
如果问题仍然存在，请删除该
~/.quickwork/目录 (macOS) 或%USERPROFILE%\.quickwork\目录 (Windows)，然后重新安装应用程序。
警告
删除
~/.quickwork/(macOS) 或%USERPROFILE%\.quickwork\(Windows) 目录会删除所有本地数据，包括对话、知识图谱、内存和保存的凭据。仅在万不得已时才使用此步骤。
连接问题
- Slack 或 Outlook 连接失败
-
如果与 Slack 或 Microsoft Outlook 的连接失败，请尝试以下步骤。
在 “设置” > “功能” > “连接” 中断开服务。
通过选择 “登录” 并完成身份验证流程来重新连接服务。
验证您的账户是否具有第三方服务所需的权限。
检查您的互联网连接是否活跃且稳定。
- 微软 Teams 连接失败
-
如果与微软 Teams 的连接失败，请按照与 Slack 或 Outlook 相同的步骤进行操作。确认贵组织的管理员没有限制第三方应用程序的访问权限。
- 连接显示 “未同步” 状态
-
如果连接显示 “未同步” 状态，请尝试以下步骤。
确认您的互联网连接处于活动状态。
在 “设置” > “功能” > “连接” 中断开服务并重新连接。
如果问题仍然存在，则第三方服务可能会中断。查看服务的状态页面。
- Google 工作空间连接失败
-
如果与谷歌服务（Gmail、谷歌日历、谷歌云端硬盘、谷歌文档、谷歌表格、谷歌幻灯片、Google Meet 或谷歌分析）的连接失败，请验证以下内容。
您的 Google 帐号不受贵组织管理员政策的限制。
您已在登录流程中授予所需的 OAuth 权限。
您使用的是正确的谷歌账号登录。
性能问题
- 反应缓慢
-
如果快速响应速度很慢，请尝试以下步骤。
切换到快速 AI 模型模式以获得更快的响应。在聊天输入区域中选择模型选择器，然后选择快速。
降低思维精力。较低的思维努力（Off 或 Low）会产生更快的响应。
关闭未使用的应用程序以释放系统资源。
检查您的互联网连接速度。AI 模型请求需要与 API Gateway 建立网络连接。
- 高内存使用量
-
如果 Amazon Quick 桌面应用程序使用了过多的内存，请尝试以下步骤。
减少在 “设置” > “我的电脑” 中编入索引的文件夹数量。对不需要语义搜索的文件夹禁用语义搜索，因为语义搜索使用的资源比关键字搜索多。
放下 “设置” > “自定义” > “性能” 中的 “最大并行任务数” 滑块。默认值是 50。减少此值会限制并发后台操作的数量。
重新启动应用程序以清除缓存的数据。
在 “设置” > “我的电脑” > “搜索索引” 中调整搜索索引限制。降低存储限制、用于索引的最大文件大小或索引滑块的最大文件夹大小。
注意
当可用磁盘空间低于 8.0 GiB 时，搜索索引会自动暂停。
文件访问问题
- Quick 找不到文件
-
如果 Quick 找不到您在聊天中引用的文件，请验证以下内容。
该文件的父文件夹将添加到 “设置” > “我的电脑” > “本地文件夹” 中。Quick 只能访问您明确授予访问权限的文件夹中的文件。
选择 “+ 添加文件夹” 以授予对其他文件夹的访问权限。
添加文件夹后，Quick 可以立即读取其中的文件。搜索索引是在后台进行的。
- 搜索未返回任何结果
-
如果文件搜索未返回任何结果，请尝试以下步骤。
确认已在 “设置” > “我的电脑” > “本地文件夹” 中为该文件夹开启关键字搜索。展开文件夹，查看其索引开关。
检查索引状态。带有文件和条目计数的 “就绪” 状态确认索引已完成。
如果您最近添加了新文件夹，请等待索引编制完成。状态显示进度。
在 “设置” > “我的电脑” > “搜索索引” 中检查文件大小是否不大于用于索引的最大文件大小限制。大于此限制的文件在编制索引期间会被跳过，但代理仍可通过直接文件访问来访问。
要进行更广泛的搜索，请在文件夹上启用语义搜索以允许自然语言查询。
浏览器自动化问题
- 浏览器自动化不起作用
-
如果 Quick 无法浏览网页，请尝试以下步骤。
在 “设置” > “功能” > “系统” 中确认已启用浏览器自动化。
如果使用 “使用我的 Chrome” 模式，请在 “设置” > “自定义” > “浏览器” 中验证设置。打开 Chrome 并导航到
chrome://inspect/#remote-debugging。选择 “启用远程调试”。返回 “快速” 并选择 “测试连接” 以验证连接。如果使用默认模式，Quick 会使用您的个人资料副本启动单独的 Chrome 实例。确保您的系统上安装了 Chrome。
预定代理问题
- 预定代理未运行
-
预设代理在您的计算机上本地运行。如果代理未按计划时间运行，请验证以下内容。
您的计算机已在预定时间开机并处于唤醒状态。
Amazon Quick 桌面应用程序正在运行。
代理已启用。在 “设置” > “功能” > “计划任务” 中选中开关，或者从顶部栏中打开 “代理” 面板。
您的互联网连接已激活。访问互联服务或 AI 模型的代理需要网络连接。
重要
如果在安排代理运行时您的计算机已关闭或应用程序已关闭，则代理要等到下一个预定时间才会运行。
- 代理产生意想不到的结果
-
如果定时代理产生意外结果，请尝试以下步骤。
打开 “设置” > “功能” > “计划任务”，然后选择代理。
查看 “提示” 选项卡，验证代理的说明是否正确。
检查 “功能” 选项卡，验证连接的 MCP 服务器是否正确。
考虑在 “概述” 选项卡中更改模型。使用 B alan ce d 或 Smar t 执行更复杂的代理任务。
选择 “运行” 按钮（播放图标）以手动触发代理并观察结果。
MCP 服务器问题
- MCP 服务器无法连接
-
如果 MCP 服务器无法连接，请根据连接类型尝试以下步骤。
本地 MCP 服务器：
验证命令是否正确且可执行文件已安装在您的系统上。
检查参数是否以空格分隔且格式正确。
如果服务器启动时间超过 30 秒（可配置为 5 到 300 秒），请增加 “超时” 值。
验证是否正确设置了所有必需的环境变量。
远程 MCP 服务器：
验证 URL 是否正确且服务器正在运行。
如果需要身份验证，请验证 Toke n 值是否为有效的不记名令牌。
检查您的网络连接和所有防火墙设置。
导入的 MCP 服务器：
验证配置文件路径是否正确。
确保源应用程序（Kiro、Claude Code、AIM 等）已正确安装。
导出诊断
如果您需要共享诊断信息以进行故障排除，则可以从应用程序导出诊断日志。
打开 “设置” > “自定义”。
滚动至 “故障排除” 部分。
从下拉列表中选择一个时间范围（例如，“过去 2 小时”）。
选择 “导出诊断”，将诊断日志保存到您的桌面。
重置应用程序
如果其他故障排除步骤无法解决您的问题，则可以通过清除所有数据来重置应用程序。
警告
此操作不可逆。它会删除所有 Quick 数据，包括对话、缓存的消息、知识图表、保存的凭据和用户首选项。应用程序在清理后退出。
打开 “设置” > “自定义”。
滚动到 “危险区域” 部分。
选择 “清除所有数据”。
确认该操作。
要在 macOS 上完全卸载，请拖
Amazon Quick.app至 “垃圾箱”。在 Windows 上，打开 “设置” > “应用程序” > “已安装的应用程序”，找到 Amazon Quick，然后选择 “卸载”。
获得更多帮助
如果上述故障排除步骤无法解决您的问题，则可以使用以下资源。
导出诊断信息并与您的支持团队共享。
开发者菜单-选择连接状态点（右上角的绿点）以访问任务控制、指标叠加层、调试面板和内存面板，以进行高级诊断。
有关企业帐户的问题，请联系贵组织的 IT 管理员。
请访问 Amazon Quick 文档以获取最新指南。
