故障排除

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

Windows

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

如果应用程序已安装但无法启动，请尝试从 Microsoft Store 安装，而不是直接安装程序 - Store 版本会处理其自己的依赖项。

macOS

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

确保将 9xchat 拖入 应用程序，而不是从安装的磁盘映像运行它。

Linux

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

移动的

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

响应失败或中途停止

按顺序完成这些工作：

1. 检查您的连接。 云模型需要互联网访问。本地模特做 不是——如果云请求失败但本地请求有效，则问题出在网络或提供商，而不是 9xchat。

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

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

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

模型丢失或无法加载

• 云模型需要积分或配置的 API 密钥 提供者。在 Library → Models下，提供程序将保持标记为Inactive，直到您添加其密钥 - 该标签是查看您无法访问的内容的最快方法。

• 本地模型需要您的本地跑步者启动，然后 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：多个选项卡、浮动窗口、迷你聊天、快速助手、代理工具、实时网络搜索、图像游乐场、麦克风输入和存储系统。 积分、专业版和使用情况 列出了完整的拆分。

如果您已付款，请确认此设备已使用持有订阅的 UID 登录，并且您没有超出设备限制 - 一台免费设备，三台专业版设备。在三台设备上按照 UID 连接、切换或删除设备。

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

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

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

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

这里没有任何帮助

通过 support 联系：

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