# 连接配置文件

规范地址：https://xstavern.com/wiki/usage/api-connections/connection-profiles/
原文：https://sillytaverncn.net/usage/api-connections/connection-profiles/
核对日期：2026-11-03
授权迁移，保留作者、上游许可与出处。

连接配置文件



# 连接配置文件

保存连接配置文件以快速切换不同的 API、模型和格式化模板。当您积极使用多个 API 连接或需要在不同配置之间切换而无需浏览菜单时，这很有用。

## 访问连接配置文件

从 SillyTavern 1.12.6 或更高版本开始，此功能作为内置扩展默认启用，并在 API 连接菜单中可用。如果您希望*禁用*它，请打开扩展面板，点击"管理扩展"，在列表中找到连接配置文件，取消选中"已启用"复选框，然后点击"关闭"。

## 保存的内容

连接配置文件存储以下选项。

### 通用

* [API 类型、模型和服务器 URL](/Usage/API_Connections/index.md)
* [设置预设](/Usage/Common-Settings.md)

### 文本补全 API

* [系统提示词及其状态](/Usage/Prompts/advancedformatting.md#系统提示词)
* [指令模式状态和模板](/Usage/Prompts/instructmode.md)
* [上下文模板](/Usage/Prompts/advancedformatting.md#上下文模板)
* [分词器](/Usage/Prompts/advancedformatting.md#分词器)

### 聊天补全 API

* 代理预设

## 管理连接配置文件

!!! info 注意
配置文件只保存下拉字段中的选择，而不了解底层设置。这意味着通过切换到不同的配置文件，您将丢失未保存的更改。为了防止这种情况，如果您不想丢失临时更改，请确保更新所有预设和模板。
!!!

* 要保存配置文件，请设置所有必需的设置并点击"创建"按钮。然后检查设置并为配置文件提供名称。**名称应该是唯一的。**
* 要查看所选配置文件的详细信息，请点击"信息"按钮。再次点击以隐藏详细信息。
* 连接配置文件设置保存在 `settings.json` 中，在您按下"更新"按钮之前不会更改关联的配置文件保存文件。这意味着如果您设置了一个配置文件，但在更新之前切换到另一个配置文件，您将丢失所有先前的更改。
* 要从保存的配置文件恢复更改的选择，请点击"重新加载"按钮。
* 要删除配置文件，请点击"删除"按钮并确认删除。**此操作不可逆。**

## 斜杠命令

可以使用以下斜杠命令管理连接配置文件。

1. `/profile [name]` - 如果提供了参数，则切换到该配置文件；如果没有提供参数，则获取当前配置文件的名称。
2. `/profile-create [name]` - 将当前设置保存为具有提供名称的新配置文件。
3. `/profile-list` - 返回可用配置文件名称的 JSON 序列化数组。
4. `/profile-get [name]` - 获取具有提供名称的配置文件的详细信息，作为 JSON 序列化对象。
5. `/profile-update` - 使用当前设置更新所选配置文件。

许可与致谢：https://xstavern.com/wiki/licensecredits/