# 使用插件

> 在一段对话里安装、启用和配置插件。

Source: https://reverie.im/zh/docs/plugins/using-plugins
Language: zh

插件是按对话安装的，入口在对话侧边栏的**插件**标签页。你需要登录——没登录的话，这个标签页只会让你去登录。

## 安装一个插件 \[#install-a-plugin]

### 打开插件标签页 \[#open-the-plugins-tab]

在一段对话里打开侧边栏，选**插件**。在**我的**、**官方**和**社区**之间切换。**社区**标签页有一个搜索框，能匹配插件的名字和描述。

### 看一眼费用估算 \[#read-the-cost-estimate]

每张卡片上都写着这个插件给每条消息添多少积分，按这段对话当前用的模型算出来。换模型会改变这个估算，安装对话框里也会把它完整重复一遍。

### 安装 \[#install]

按**安装**。如果这个插件有设置项，会先弹出**安装插件**对话框：把字段填好并保存。带设置项的插件还提供 **AI 生成**，它会照你写的一段描述把那些字段填上。

### 在这段对话里启用它 \[#enable-it-for-this-chat]

已安装插件的卡片上有一个开关。开着表示这个插件在这段对话里生效；关着表示它还装着，但什么也不做。任何时候都能用**配置插件**重新打开设置，用**卸载**把它移除。

启用了的交互式插件会出现在消息框旁边的插件菜单里。只有至少有一个交互式插件开着的时候，那个菜单才在。

你可以在新对话发出第一条消息之前就把插件配好。对话一开始它们就生效。

## 顺序标记与五个提示词插件的上限 \[#the-order-badge-and-the-five-prompt-limit]

每个启用的插件上都有一个 **#1*\*、\*\*#2*\*、**#3**…… 的标记。那个数字是它在这段对话里的位置，按你安装的先后排定，而哪些提示词插件被应用，由它决定。

> **一段对话里最多只有五个提示词插件会被应用**。开到第六个，按顺序排在前五的会跑，其余的被悄悄跳过——卡片上看着是开着的，也照样显示费用估算，却对回复毫无贡献。工具插件和交互式插件不计入这五个。把某个提示词插件关掉，它的名额就让给顺序里的下一个，所以与其猜是哪五个赢了，不如把不需要的关掉。

工具插件和交互式插件没有数量上限，但每个工具插件都会把自己的描述塞进每一次请求，所以每多一个，卡片上的费用估算就往上抬一点。

## 模型支持 \[#model-support]

工具插件只在支持工具调用的模型上工作。在不支持的模型上，卡片会被禁用，并写着**当前模型不支持工具类插件**。提示词插件和交互式插件在所有模型上都能工作。[选择模型 →](https://reverie.im/zh/docs/reference/choosing-a-model)

## AI 生成面板 \[#ai-generated-panels]

有些交互插件会打开一个由角色即时生成内容的面板，例如日记或状态板。生成一页会消耗积分，面板会在第一次时请你确认。

它生成的每一页都会随聊天保存。在任何设备上重新打开面板，都会直接显示上一页，不会再次生成；面板上的**历史记录**按钮会列出该插件在本次聊天中生成过的往期页面，打开往期页面不花费任何积分。新页面会参考之前的页面来写，所以日记会延续而不是从头开始；从页面上发出的消息也会让角色在回复时知道你刚刚读到的内容。角色在聊天时也会记着每个面板的最新一页，日记或状态板里已经确立的内容会保持一致。面板顶部还可以切换为用你的聊天模型来生成页面，而不是默认的快速模型；群聊里可以选择这是谁的页面；页面上也可能提供输入框，让你用自己的话回应。

分叉出的聊天会保留分叉点之前生成的页面。删除消息会一并删除在这些消息之后生成的页面；当一个插件的历史积累过多时，最早的页面会被清理。你也可以在历史面板里自行删除某一页，之后角色也不会再参考它。

## 版本与更新 \[#versions-and-updates]

已安装插件的卡片会显示你正在跑的版本，比如 **v3**。作者发布了更新的版本后，卡片上会冒出一个写着那个版本号的更新控件，在你按下它之前什么都不会变。你的对话一直跑你装下的那个确切版本，连它在你这门语言里的措辞也一样。

## 角色自带的插件 \[#character-defaults]

角色的创作者可以把工具插件和交互式插件随角色一起发出去。你打开与这个角色的对话时，它们已经装好了，而且和别的插件一样能关掉。如果同一个插件你自己也装了，以你自己的设置为准。

创作者只能附上已经过审的版本，所以访客永远不会跑到一个没审过的草稿。

除此之外没有别的东西是预装的。一段新对话在你装插件、或角色创作者附了插件之前，一个插件都不跑。

## 生成图片 \[#image-generation]

对话里的图片生成，是靠安装官方的图片生成插件打开的。它的安装对话框会让你确认生成图片要花积分；你不确认，安装就不完成。[生成图片 →](https://reverie.im/zh/docs/media/image-generation)

## 你自己创建的插件 \[#plugins-you-created]

**我的**标签页对你写的插件还提供**编辑**、**调试**和**删除**，外加**查看收益**。删除你创建的插件是永久的，删之前会先确认。

## 相关 \[#related]

* [插件](https://reverie.im/zh/docs/plugins) — 三种类型，以及每种能做什么
* [创建插件](https://reverie.im/zh/docs/plugins/creating-plugins) — 写一个你自己的并发布出去
* [侧边栏与设置](https://reverie.im/zh/docs/chatting/side-panel) — 同一个面板里的其他标签页
* [积分](https://reverie.im/zh/docs/billing/credits) — 每条消息的费用怎么算