# 模型

管理可用的 AI 模型并设置默认对话模型。

## 模型列表

**模型**页面显示 Agora 已知的所有模型，按提供商分组：

- **默认模型** — 新对话使用的模型。点击可更换。
- **可用模型** — 展开每个提供商查看其模型。勾选你想要使用的。

### 启用 / 禁用模型

勾选或取消勾选模型旁的复选框来切换其可用性。禁用的模型不会出现在对话的模型选择器中。

### 重命名模型

点击模型旁的编辑图标（笔）为其设置自定义别名。该别名将在整个应用中显示，替代技术性的模型 ID。

### 同步模型

点击**同步模型**从所有已配置的 API 提供商获取最新的可用模型列表。需要网络连接和有效的 API 密钥。

!!! tip "本地模型"
    本地模型显示在 **Local** 提供商分组下。它们在 **设置 → 提供商 → Local** 中单独管理。

---

## 默认模型

**默认模型**用于所有新对话。更换方式：

1. 点击模型页面顶部的默认模型行
2. 从列表中选择一个模型（仅显示已启用的模型）
3. 更改立即生效

你可以在聊天界面的模型选择器中对每个对话单独覆盖默认模型。

---

## 模型别名

模型别名让你为具有长技术 ID 的模型设置友好名称。例如，你可以将 `openai/gpt-4o-mini` 重命名为"GPT-4o Mini"。

别名在所有地方显示：模型选择器、对话标题和设置页面。

要移除别名，清空文本框并保存。

---

## 常见问题

### 模型未出现

- 点击**同步模型**刷新列表
- 验证你在 **设置 → 提供商** 中是否拥有对应提供商的有效 API 密钥
- 检查网络连接
- 某些提供商可能暂时不可用

### 本地模型未显示

- 在 **设置 → 提供商 → Local** 中导入 GGUF 模型文件
- 模型必须是有效的 GGUF 格式
