# 插件

> 在 Reverie 上插件是什么、有哪三种，以及它们待在哪儿。

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

插件是你装进一段对话里的小扩展。它可以往角色的提示词里加隐藏指令，可以注册一个模型能调用、并渲染成卡片的工具，也可以在对话里放一个按钮，点开是一个对话框。插件由 Reverie 和其他用户编写。

## 插件在哪里 \[#where-plugins-live]

打开一段对话，打开**侧边栏**，选**插件**标签页。关于插件的一切都发生在那里：

| 标签页    | 列出什么                  |
| ------ | --------------------- |
| **我的** | 你创建的插件，外加一个**查看收益**按钮 |
| **官方** | 由 Reverie 发布的插件       |
| **社区** | 其他用户公开且已过审的插件，带一个搜索框  |

标签页顶部有一个**创建插件**按钮。没有单独的市场页面——这个面板就是全部。[侧边栏 →](https://reverie.im/zh/docs/chatting/side-panel)

## 三种插件 \[#the-three-kinds]

| 类型      | 做什么                                    | 在对话里可见            | 能分成 |
| ------- | -------------------------------------- | ----------------- | --- |
| **提示词** | 每一轮都往角色的系统提示词里加文本                      | 不可见——你看到的是效果，不是文本 | 能   |
| **工具**  | 注册一个模型在回复中途能调用的工具；结果渲染成一张带样式的卡片        | 可见，是一张卡片          | 能   |
| **交互式** | 在消息框旁边的插件菜单里加一项，点开是对话框、表单或一个由 AI 生成的面板 | 可见，是一个菜单项和一个面板    | 不能  |

> **工具插件不会去取真实数据。**
> 工具插件不发起任何网络调用——没有网页请求，没有日历访问，没有实时查询。模型调用这个工具时，参数是模型自己编的，插件只是把这些编出来的参数排进作者设计好的卡片里。一个「天气」工具会渲染出一张像模像样的天气卡，而那天气是模型瞎编的。

工具插件还需要一个支持工具调用的模型。在不支持的模型上，它们的卡片会被禁用，并写着**当前模型不支持工具类插件**。

## 你装进去的是什么 \[#what-you-install]

每个插件都带着作者的配置，外加可选的、要你自己填的设置——文本框、数字、滑块、开关、下拉菜单、表格和 Markdown 字段。你在安装时填这些，之后随时能从插件的卡片重新打开它们。

安装会把那一刻存在的版本钉住。作者改了插件之后，你的对话仍然跑你装下的那个版本，直到你自己选择更新——所以上游的一次重写不会在你不知情的时候改掉一段对话。

## 谁能装什么 \[#who-can-install-what]

* **官方**插件人人都能装。
* **社区**插件要同时是公开的、且已过审才能装。正在等审核的公开插件，对作者显示**待审核**，别人那里根本不会出现。
* **你自己的**插件你永远能装，过没过审都行。
* 插件可以绑定到某一个角色，那样它就只在与那个角色的对话里出现。

安装是按对话算的。同一个插件可以在你与某个角色的这段对话里开着，在另一段里关着。

> 你还可能在官方插件上看到一个**参数**标记。那是第四种类型，用来调整模型的采样设置，归
> Reverie 所有——不是你能创建的东西。

**[使用插件](https://reverie.im/zh/docs/plugins/using-plugins)**

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

**[创建插件](https://reverie.im/zh/docs/plugins/creating-plugins)**

写一个插件，交审核发布，并靠它赚钱。

**[侧边栏](https://reverie.im/zh/docs/chatting/side-panel)**

插件标签页所在的那个面板的其余部分。

**[积分](https://reverie.im/zh/docs/billing/credits)**

一个插件给一条消息的成本添了什么。