# 使用插件

> 在聊天中安裝、啟用和設定插件。

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

插件以聊天為單位安裝，入口在聊天側邊面板的**插件**分頁。你需要先登入——否則分頁只會顯示登入提示。

## 安裝插件 \[#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-TW/docs/reference/choosing-a-model)

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

有些互動式插件會開啟一個由角色當場填寫內容的面板，例如日記或狀態看板。生成一頁會消耗點數，面板會在第一次生成時請你確認。

它生成的每一頁都會隨聊天保存。在任何裝置上重新開啟面板，都會直接顯示最後一頁，不會重新生成；面板的**歷史紀錄**按鈕會列出這個插件在本聊天中先前生成的頁面，開啟這些頁面不會花費任何點數。新的頁面會參考先前的頁面撰寫，所以日記會接續下去，而不是從頭開始；從頁面送出的訊息也會讓角色在回覆時知道你剛才在看什麼。角色在聊天時也會記得每個面板的最新一頁，讓日記或狀態看板中已經確立的內容保持一致。面板頂端還能讓你改用聊天模型來撰寫頁面，而不是預設的快速模型；在群組聊天中則可以選擇這是誰的頁面；頁面也可能提供文字欄位，讓你用自己的話回應。

分支出的聊天會保留分支點之前生成的頁面。刪除訊息會一併移除在這些訊息之後生成的頁面，而當插件的歷史紀錄變得很長時，最舊的頁面會被捨棄。你也可以自己從歷史紀錄面板刪除某一頁；之後角色也不會再參考它。

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

已安裝插件的卡片會顯示你正在執行的版本，例如 **v3**。作者發布較新的版本後，卡片上會出現標示該版本的更新控制項，在你按下之前什麼都不會改變。你的聊天會持續執行你安裝的那個確切版本，包括它在你使用的語言中的措辭。

## 角色預設插件 \[#character-defaults]

角色的創作者可以把工具插件和互動式插件隨角色一起提供。你開啟與該角色的聊天時，這些插件就已經安裝好了，而且可以像其他插件一樣關閉。如果你自己也安裝了同一個插件，會以你自己的設定為準。

創作者只能附加已通過審核的版本，所以訪客永遠不會執行到未經審核的草稿。

除此之外沒有任何預先安裝的插件。新的聊天在你安裝插件、或角色創作者附加插件之前，不會執行任何插件。

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

聊天中的圖片生成功能，需要安裝官方的圖片生成插件才會開啟。它的安裝對話框會請你確認生成圖片會消耗點數；在你確認之前，安裝不會完成。[生成圖片 →](https://reverie.im/zh-TW/docs/media/image-generation)

## 你建立的插件 \[#plugins-you-created]

**我的**分頁也為你撰寫的插件提供**編輯**、**偵錯**和**刪除**，以及**查看收益**。刪除你建立的插件是永久性的，刪除前會先請你確認。

## 相關內容 \[#related]

* [插件總覽](https://reverie.im/zh-TW/docs/plugins) — 三種插件以及各自能做什麼
* [建立插件](https://reverie.im/zh-TW/docs/plugins/creating-plugins) — 撰寫並發布你自己的插件
* [側邊面板](https://reverie.im/zh-TW/docs/chatting/side-panel) — 同一個面板中的其他分頁
* [點數](https://reverie.im/zh-TW/docs/billing/credits) — 每則訊息的費用如何計算