# 建立插件

> 製作插件、送出審核，並從它貢獻的提示詞中賺取收益。

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

任何已登入的人都能撰寫插件。開啟聊天，前往側邊面板的**插件**分頁，然後按下**建立插件**。編輯器會帶你完成三個步驟：**類型**、**基本資訊**和**設定**。

## 選擇類型 \[#pick-a-type]

四種插件類型中，你可以建立其中三種。第四種用來調整模型的取樣設定，由 Reverie 管理。

| 類型        | 你要撰寫的內容                                            | 限制                                                                     |
| --------- | -------------------------------------------------- | ---------------------------------------------------------------------- |
| **提示詞插件** | 一份以 Handlebars 撰寫的提示詞範本，會附加在角色的系統提示詞之後             | 範本最多 100,000 個字元                                                       |
| **工具插件**  | 一份提示詞範本，加上工具定義：名稱、描述、輸入參數、輸出結構，以及選用的 HTML/CSS 卡片範本 | 工具名稱以字母開頭，只能使用字母、數字和底線，最多 64 個字元；描述最多 2,000 個字元；卡片範本和樣式各最多 100,000 個字元 |
| **互動式插件** | 一個識別碼，加上至少一項：附表單的觸發按鈕、AI 生成的介面，或 AI 可呼叫的工具         | 識別碼最多 80 個字元，可使用字母、數字、連字號和底線，開頭必須是字母或數字                                |

類型之後無法更改——**編輯時無法變更插件類型**。

> 工具插件不會發出任何網路請求。模型呼叫你的工具時，參數是由模型編造的，
> 你的輸出結構和卡片範本只是把這些編造出來的值排列呈現。請撰寫用來呈現資訊
> 的工具——狀態面板、量表、物品欄、擲骰——而不是聲稱能查詢某些資料的工具。

## 填寫基本資訊 \[#fill-in-the-basics]

**插件名稱**為必填，最多 100 個字元。**描述**為選填，最多 1,000 個字元。

這裡有兩個開關，彼此獨立——你可以只開其中一個、兩個都開，或都不開：

| 開關           | 效果                                   |
| ------------ | ------------------------------------ |
| **公開插件**     | 將這個版本送出審核。核准後，它會列在**社群**分頁中，所有人都看得到。 |
| **與目前的角色關聯** | 將插件限定在你目前所在角色的聊天中使用。                 |

AI 生成介面的內容要求是一份範本，就像提示詞範本一樣：它可以使用相同的預留位置，例如 `{{char}}`、`{{user}}` 和 `{{date}}`，以及你開放給安裝者的任何設定項目。它產生的頁面由一組固定的元件組成——標題、段落、引言、統計方塊、進度條、評分、時間軸、核取清單、標籤、資訊清單、提示框、對話泡泡、選項格、可切換的分頁、圖片、預設收合的劇透區塊、按鈕，以及讀者可以輸入文字的欄位——並依照語意挑選外觀：色調、卡片樣式（樸素、紙張、玻璃或外框）和密度，全都會跟隨讀者的主題。圖片來自聊天本身——角色的肖像或橫幅、讀者的頭像、情境或時刻的配圖——頁面無法指向其他任何來源。它的按鈕可以代替讀者發言、設定讓角色接著演出的場景指示、在讀者的裝置上隨機抽出結果、開啟更深一層的頁面、就地重新整理頁面，或關閉頁面。目前時間和角色的世界設定會自動提供。

## 從範例開始 \[#start-from-an-example]

**載入範例**會開啟一份起始範本目錄——關係動態、場景設定、設定集 / 記憶庫、角色狀態面板、好感度量表、骰子 / 技能檢定、時間流逝、角色日記、內心想法、真心話大冒險等等，依類別分組。

這些是給編輯器使用的範本，而不是任何人安裝過的插件。挑選其中一個會填好設定欄位，讓你從一個已經能運作的版本開始修改；在你儲存並發布自己的插件之前，它不會被分享或發布。

## 讓 AI 起草 \[#let-ai-draft-it]

每種類型都有 AI 助手——帶變數的提示詞範本使用 **AI 生成**，工具和互動式設定也有對應的功能。你用一兩句話描述想要的內容，編輯器就會填好欄位。你開放給安裝者的設定項目也能用這種方式填寫，入口是 **AI 填寫設定**。每次生成都會消耗點數。

## 預覽和偵錯不一樣 \[#preview-and-debug-are-different]

|        | **預覽**                                     | **偵錯**                       |
| ------ | ------------------------------------------ | ---------------------------- |
| 功能     | 用你輸入的測試值呈現範本——角色名稱預設為 *愛麗絲*，使用者名稱預設為 *使用者* | 以你開啟編輯器時所在聊天的角色，實際執行尚未儲存的草稿  |
| 顯示內容   | 產生的提示詞、系統提示詞，以及呈現結果                        | 角色回覆、工具呈現結果、執行追蹤、模型、耗時、Token |
| 使用的上下文 | 只有預留位置                                     | 角色、情境、人設、記憶、近期訊息和已啟用插件的快照    |
| 費用     | 免費                                         | 免費——不會扣點數                    |
| 額度     | 無限制                                        | 每 3 小時 30 次；對話框會顯示剩餘次數       |

偵錯還會將測試訊息限制在 1,000 個字元，測試設定限制在 50,000 個字元。工具插件只能在支援工具的模型上偵錯。

## 發布與審核 \[#publishing-and-review]

儲存私人插件後，它就能立刻使用——你自己可以用，而且它會安裝到你建立它的那個聊天中。開啟**公開插件**後，這個版本則會改為送出審核：

1. 卡片會在你的**我的**分頁中顯示**待審核**，其他人無法安裝。
2. 自動預檢會定期執行，並記錄它的判定結果。
3. 由真人核准或拒絕。核准的插件會顯示**已核准**，並出現在**社群**分頁中。

編輯已核准的插件會建立新版本，並再次經過審核——卡片會回到**待審核**，而先前核准的版本則會繼續為所有已安裝的人運作。

> 每次儲存都會凍結一份不可變更的插件副本，包括它的翻譯。安裝執行的是它固定
> 的那份副本，所以安裝第 2 版的人會一直使用第 2 版，直到他們按下更新為止。
> 角色預設插件只能固定已通過審核的版本。

## 你能賺到多少 \[#what-you-earn]

當其他人在付費訊息中使用你的插件時，你會賺到\*\*你的插件本身加進提示詞的文字所耗點數的 5%\*\*——而不是整則訊息的 5%。金額的計算方式是：插件本身的提示詞 Token 數，乘以模型的點數倍率，再乘以 5%，然後依該則訊息中以付費點數付款的比例調整。

以下情況不會產生任何分潤：

| 情況          | 原因                          |
| ----------- | --------------------------- |
| 插件是官方插件     | Reverie 自己的插件不發放分潤          |
| 你使用自己的插件    | 不能付給自己                      |
| 插件沒有提示詞範本   | 互動式插件賺不到分潤——它們沒有在提示詞中加入任何內容 |
| 訊息完全以免費點數付款 | 付費比例為零                      |

> **互動式插件永遠不會產生分潤。** 如果你在意收益，請製作提示詞插件或工具
> 插件——只有這兩種類型會貢獻提示詞文字。

## 領取收益 \[#getting-paid]

分潤會先累積為待結算點數，並在**每月 1 日**結算。如果結算時你的待結算餘額低於 **100 點**，當月不會發放，餘額會滾入下個月。

**我的**分頁中的**查看收益**會顯示**累計收益**、**待結算**、**本月**和**下次結算**，以及依插件區分的明細（收益、使用次數和最後使用日期）和你的結算紀錄。

## 相關內容 \[#related]

* [使用插件](https://reverie.im/zh-TW/docs/plugins/using-plugins) — 安裝者看到的你的作品
* [插件總覽](https://reverie.im/zh-TW/docs/plugins) — 三種插件並列比較
* [收益來源](https://reverie.im/zh-TW/docs/creators/revenue-streams) — 創作者的其他收益方式
* [點數](https://reverie.im/zh-TW/docs/billing/credits) — 什麼是點數，以及訊息如何計價