故障排除

该应用程序将无法安装或打开

Windows

如果 SmartScreen 阻止安装程序，请选择 更多信息 → 仍然运行。桌面版本是经过代码签名的，因此通常不会出现。

macOS

如果 macOS 拒绝打开该应用程序，请打开 系统设置 → 隐私和安全 并允许它在那里，然后再次启动它。

请确认已将 9xChat 拖入应用程序，而不是直接从已挂载的磁盘映像运行。

Linux

检查下载的文件是否被标记为可执行。如果不是，请设置其可执行位并再次运行。

移动的

通过 Google Play 或 App Store 安装，以便更新自动到达。如果应用程序无法启动，请更新它，然后重新启动您的设备。

响应失败或中途停止

按顺序完成这些工作：

1. 检查您的连接。 云模型需要互联网访问。本地模特做 不需要。如果云端请求失败而本地请求正常，问题出在网络或服务商，而非 9xchat。

2. 检查您的信用余额。 如果您使用 9xchat 信用并且他们有 耗尽，请求停止。充值或切换到您自己的 API 密钥。

3. 检查您的 API 密钥。 如果您带来了自己的密钥，请确认它仍然存在 有效并且该提供商有剩余配额。

4. 尝试不同的模型。 如果一种模型失败而另一种模型成功，则问题 与特定型号或提供商相关。

模型丢失或无法加载

• 云模型需要积分或配置的 API 密钥 服务商。在资料库 → 模型中，服务商会一直标记为未启用，直到你添加其密钥。这个标签能最快地告诉你哪些服务商尚无可用的访问途径。

• 本地模型需要先启动本地运行器，9xChat 才能访问它们。 首先启动它，然后重新打开模型列表。

您的 API 密钥被拒绝

故障出在提供商处，因此修复也在那里：

1. 再次粘贴密钥，不要有前导或尾随空格。
2. 确认密钥属于您添加它的提供商。
3. 检查密钥是否仍然存在并且未被撤销或轮换。
4. 检查您是否已为该提供商设置了计费设置和剩余配额： 没有余额的有效密钥与坏密钥的失败方式相同。
5. 确认您选择的型号是您的帐户允许使用的型号。一些 模型需要与提供商建立单独的层。

密钥以加密方式存储在您的计算机上。如果某个密钥在任何地方都无法工作，请在提供商处更换它，而不是重新安装 9xchat。

本地模型无法连接

1. 启动本地运行程序并确认它在 9xchat 外部响应。
2. 确认运行器正在 9xChat 预期的地址和端口监听。
3. 确认模型本身已被拉动和加载，而不仅仅是跑步者正在运行。
4. 重新打开 库 → 模型，以便刷新列表。

本地模型不需要密钥，也不需要积分。如果本地模型有效而云模型无效，则问题出在您的密钥、余额或网络上。

工具或 MCP 服务器不工作

1. 检查该工具是否已启用。 每个工具下面都有一个启用开关 库→工具。

2. 检查套餐。 智能体工具和实时网页搜索需要 Pro。参见 免费版与 Pro。

3. **阅读安全行。**它说明了该工具需要哪些权限。一个工具 无法达到其需要的东西失败而不是询问。

4. 对于 MCP 服务器，确认已提供所需的机密：一个条目 仍然标记需要配置尚未设置。配置预览显示了它运行的确切命令，如果服务器从未启动，则值得重新阅读。

5. **隔离它。**禁用该工具，问同样的问题，看看是否 行为改变。这告诉您该工具是否完全参与其中。

知识搜索一无所获

必须先对集合建立索引，然后才能对其进行搜索。

• 确认文件已添加到集合中，而不仅仅是附加到聊天中。
• 确认搜索知识工具已启用。
• 如果您添加文件时无法访问嵌入提供程序， 搜索会退回到关键字匹配，并且会错过任何需要索引的内容。一旦可以访问提供程序，请重新添加文件。

请参阅 知识和记忆 。

附件将不被处理

• 确认您选择的模型接受该文件类型。纯文本模型 无法读取图像，模型列表标记处理视觉。
• 非常大的文件可能会超出模型的上下文。尝试使用较小的提取物，或 具有更大上下文窗口的模型。
• 如果文件在其他地方正确打开但在此处失败，请尝试将其转换为 首先是通用格式。

图像生成失败

• 编辑图像区域、重新生成已生成的图像，以及在聊天中使用图像 需要 Pro。图像试验场免费。
• 确认已选择图像模型。它与你的 聊天模型。
• 如果您通过 9xchat 积分生成，请检查您的积分余额。
• 有些提示词是被服务商而非 9xChat 拒绝的；重新措辞 通常比重试更快。

听写或大声朗读失败

两者都需要一个可用的音频提供商，并且都没有本地选项。

• 确认您的 转录提供程序已在设置 → 默认下设置 型号。
• 请在操作系统的隐私设置中授予 9xChat 麦克风权限， 在 macOS 上，路径为系统设置 → 隐私与安全性 → 麦克风。
• 即使您的聊天模型是本地的，两者都需要连接。

听写和语音聊天需要 Pro；朗读免费。

积分用完的速度比预期要快

每条消息都会显示其自身的成本、延迟和令牌细分，并且会话会显示运行总计。如果总数看起来有误，请打开每条消息的数据，看看是哪个交易所造成的：长上下文、推理令牌和大附件都会增加单轮的成本。

您可以通过降低模型设置中的最大完成令牌和上下文限制来限制每次聊天，并且上下文屏蔽减少每条消息重新发送的历史记录量。

要完全停止花费积分，请添加您自己的 API 密钥或使用本地模型。

某个功能呈灰色或缺失

在免费账户上，需要 Pro 的功能会打开 Pro 功能对话框，Pro 设置则显示 Premium 标签，包括多标签页、聊天窗口、快捷助手、智能体工具、实时网页搜索、图像编辑、听写和语音聊天等。免费版与 Pro 列出了完整区别。

如果已经付费，请确认此设备登录的是持有订阅的 UID。打开个人资料查看套餐和剩余天数。按照你的 UID 与设备中的说明连接、切换或移除设备。

“本次请求的点数不足”

本次请求的费用超过剩余余额。选择购买点数，或将聊天切换到使用自己的 API 密钥的模型或本地模型，后两者从不消耗点数。余额可在个人资料中查看。

“已达到设备数量上限”

你的 UID 的全部设备名额均已占用：免费账户或试用期间一台，Pro 三台。选择管理设备并移除不再使用的设备（在 iOS 上，请在浏览器中使用许可页面），然后重新登录。不要创建新的 UID，否则原有套餐和点数不会随之转移。参见你的 UID 与设备。

“未检测到付款”

在浏览器中付款后，选择确认付款，9xChat 就会检查你的账户。如果显示未检测到付款，付款可能仍在处理中：请等待一分钟后选择重试。如果误关了付款页面，请选择打开付款页面。在 Google Play 或 App Store 的购买可通过价格页面上的恢复购买找回。

Handoff 代码无法使用

• 代码几分钟后会过期，且只能使用一次。请在发送设备上取消， 然后再次选择获取配对代码。
• 在接收设备的**接收聊天…**中输入全部 6 位数字。
• 传输完成前，请保持两个对话框打开，并让两台设备均保持联网。

参见 Handoff。

另一台设备上缺少某些内容

您的工作区存储在每台设备本地，因此使用相同 UID 登录的第二台计算机不会继承您的聊天、笔记或记忆。这是预期的结果，而不是错误。

• **内存是每个设备的。**全新安装从无内存开始。
• 切换 将两个设备配对进行一次对话；它不会复制其余部分 您的工作空间。
• 要自行移动材料，请使用设置 → 数据和导出。

您的订阅确实遵循 UID，因此即使内容不传输，通过 UID 进行验证的设备也会选择 Pro。

这里没有任何帮助

联系支持时请勾选包含诊断信息。这会附上版本、存储数据、数量统计和近期错误的类别，绝不包含提示词、标题、文件名或密钥。这能最快地省去一轮问答；隐私列出了具体发送的内容。

通过 support 联系：

• 你的操作系统和 9xChat 版本，
• 您使用的型号和提供商，
• 无论您是使用积分、自己的密钥还是本地模型，
• 你做了什么以及确切的可见错误。