# Paggawa ng mga plugin

> Gumawa ng plugin, ipa-review ito, at kumita mula sa prompt na iniaambag nito.

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

Kahit sinong naka-sign in ay puwedeng sumulat ng plugin. Magbukas ng chat, pumunta sa tab na **Mga Plugin** ng side panel, at pindutin ang **Gumawa ng Plugin**. Dinadala ka ng editor sa tatlong hakbang: **Uri**, **Mga Pangunahin**, at **Configuration**.

## Pumili ng uri \[#pick-a-type]

Tatlo sa apat na uri ng plugin ang puwede mong gawin. Inaayos ng ikaapat ang mga setting ng sampling ng model at pag-aari ito ng Reverie.

| Uri                    | Ang isinusulat mo                                                                                                                                          | Mga limitasyon                                                                                                                                                                                               |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Prompt Plugin**      | Prompt template, nakasulat sa Handlebars, na idinudugtong sa system prompt ng karakter                                                                     | Template na hanggang 100,000 character                                                                                                                                                                       |
| **Tool Plugin**        | Prompt template dagdag ang depinisyon ng tool: pangalan, paglalarawan, mga input parameter, istruktura ng output, at opsyonal na HTML/CSS na card template | Nagsisimula sa titik ang pangalan ng tool at gumagamit ng mga titik, digit at underscore, hanggang 64 na character; paglalarawan na hanggang 2,000; card template at mga style na hanggang 100,000 bawat isa |
| **Interactive Plugin** | Identifier at kahit isa sa mga ito: trigger button na may form, surface na ginawa ng AI, o tool na matatawag ng AI                                         | Identifier na hanggang 80 character, mga titik/digit/hyphen/underscore, nagsisimula sa titik o digit                                                                                                         |

Hindi na mababago ang uri pagkatapos — **Hindi mababago ang uri ng plugin habang nag-e-edit**.

> Walang ginagawang network request ang tool plugin. Kapag tinawag ng model ang tool mo,
> ang model ang nag-iimbento ng mga argument, at inaayos ng istruktura ng output at card template mo
> ang mga inimbentong value na iyon para ipakita. Sumulat ng mga tool na nagpapakita ng
> impormasyon — mga status panel, meter, inventory, dice roll — hindi mga tool
> na nagsasabing may hinahanap sila.

## Punan ang mga pangunahin \[#fill-in-the-basics]

Kailangan ang **Pangalan ng Plugin**, hanggang 100 character. Opsyonal ang **Paglalarawan**, hanggang 1,000.

Dalawang switch ang narito, at magkahiwalay sila — puwede mong i-set ang alinman, pareho, o wala:

| Switch                              | Epekto                                                                                                          |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Gawing Pampubliko ang Plugin**    | Ipinapadala ang bersyon para sa review. Kapag naaprubahan, nakalista ito sa tab na **Community** para sa lahat. |
| **Iugnay sa Kasalukuyang Karakter** | Nililimitahan ang plugin sa mga chat sa karakter na kinaroroonan mo.                                            |

Ang content request ng surface na ginawa ng AI ay template na kagaya ng prompt template: magagamit nito ang parehong mga placeholder, gaya ng `{{char}}`, `{{user}}` at `{{date}}`, at anumang setting na inilalantad mo sa mga nag-i-install. Binubuo ang page na nagagawa nito mula sa takdang hanay ng mga component — mga header, talata, quote, stat tile, progress bar, rating, timeline, checklist, tag, listahan ng mga fact, callout, dialogue bubble, choice grid, switchable na tab, larawan, naka-collapse na spoiler block, button, at text field na puwedeng sulatan ng mambabasa — at pinipili nito ang itsura batay sa kahulugan: isang tono, isang card style (plain, paper, glass o frame) at isang density, na sumusunod lahat sa theme ng mambabasa. Galing sa mismong chat ang mga larawan — ang portrait o banner ng karakter, ang avatar ng mambabasa, ang artwork ng scenario o moment — at wala nang ibang maituturo ang page. Kaya ng mga button nito na magsalita para sa mambabasa, magtakda ng direksyon ng eksena na gagampanan ng karakter, bumunot ng random na resulta sa device ng mambabasa, magbukas ng mas malalim na page, i-refresh ang page sa kinalalagyan nito, o isara ito. Awtomatikong ibinibigay ang kasalukuyang oras at ang world canon ng karakter.

## Magsimula sa halimbawa \[#start-from-an-example]

Binubuksan ng **Mag-load ng Halimbawa** ang katalogo ng mga panimulang punto — Dynamics ng Relasyon, Setup ng Eksena, Lorebook / Imbakan ng Memorya, Status Panel ng Karakter, Sukatan ng Pagmamahal, Dice / Pagsubok ng Skill, Paglipas ng Oras, Diary ng Karakter, Mga Panloob na Saloobin, Truth or Dare at iba pa, naka-grupo ayon sa kategorya.

Mga template ito para sa editor, hindi mga plugin na in-install ng sinuman. Pinupunan ng pagpili ng isa ang mga field ng configuration para makapag-edit ka mula sa isang bagay na gumagana na; walang naise-share o napa-publish dito hangga't hindi mo sine-save at pina-publish ang sarili mong plugin.

## Hayaang ang AI ang mag-draft \[#let-ai-draft-it]

May AI helper ang bawat uri — **I-generate gamit ang AI** para sa prompt template na may mga variable, at mga katumbas para sa mga configuration ng tool at interactive. Ilalarawan mo ang gusto mo sa isa o dalawang pangungusap at pupunuin ng editor ang mga field. Mapupunan din sa ganitong paraan ang mga setting na inilalantad mo sa mga nag-i-install, mula sa **Punan ang Configuration gamit ang AI**. Gumagastos ng credits ang bawat generation.

## Magkaiba ang Preview at Debug \[#preview-and-debug-are-different]

|                          | **Preview**                                                                                                                            | **Debug**                                                                                                           |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Ano ang ginagawa nito    | Nire-render ang template mo gamit ang mga test value na tina-type mo — *Alice* ang default na pangalan ng karakter, *User* ang sa user | Totoong pinapatakbo ang hindi pa naka-save na draft laban sa karakter na pinagbuksan mo ng editor mula sa chat nito |
| Ano ang ipinapakita nito | Ang nabuong prompt, system prompt, at ang na-render na output                                                                          | Ang sagot ng karakter, na-render na tool output, execution trace, model, tagal, mga token                           |
| Kontekstong ginagamit    | Mga placeholder lang                                                                                                                   | Snapshot ng karakter, scenario, persona, mga memorya, mga kamakailang mensahe at mga naka-enable na plugin          |
| Gastos                   | Libre                                                                                                                                  | Libre — walang sinisingil na credits                                                                                |
| Allowance                | Walang limitasyon                                                                                                                      | 30 run kada 3 oras; ipinapakita ng dialog ang natitirang run                                                        |

Nililimitahan din ng Debug ang test na mensahe sa 1,000 character at ang test na configuration sa 50,000 character. Made-debug lang ang tool plugin sa model na may kakayahang gumamit ng tool.

## Pag-publish at review \[#publishing-and-review]

Kapag nag-save ka ng pribadong plugin, magagamit mo na ito kaagad — ikaw, at naka-install ito sa chat kung saan mo ito ginawa. Kapag in-on ang **Gawing Pampubliko ang Plugin**, mapupunta naman sa review ang bersyong iyon:

1. Ipinapakita ng card ang **Sinusuri** sa tab mo na **Akin**, at walang ibang makakapag-install nito.
2. Tumatakbo ayon sa iskedyul ang isang automated na paunang pagsusuri at itinatala ang hatol nito.
3. Isang tao ang nag-aapruba o tumatanggi. Ipinapakita ng mga naaprubahang plugin ang **Live** at lumalabas sila sa tab na **Community**.

Gumagawa ng bagong bersyon ang pag-edit ng naaprubahang plugin, na dadaan ulit sa review — babalik sa **Sinusuri** ang card habang patuloy na tumatakbo ang dating naaprubahang bersyon para sa lahat ng nag-install nito.

> Bawat save ay nagyeyelo ng hindi nababagong kopya ng plugin, kasama ang mga
> salin nito. Pinapatakbo ng mga installation ang kopyang na-pin nila, kaya ang mga taong
> nag-install ng version 2 ay mananatili sa version 2 hanggang pindutin nila ang update. Ang mga default ng
> karakter ay puwede lang mag-pin ng bersyong nakapasa na sa review.

## Ano ang kikitain mo \[#what-you-earn]

Kapag ginamit ng ibang tao ang plugin mo sa isang bayad na mensahe, kikita ka ng **5% ng halaga sa credits ng text na mismong idinadagdag ng plugin mo sa prompt** — hindi 5% ng mensahe. Ang halaga ay ang sariling mga prompt token ng plugin, pinarami ng credit multiplier ng model, beses 5%, iniangkop sa bahagi ng mensaheng iyon na binayaran gamit ang bayad na credits.

Walang nalilikha kapag:

| Kaso                                                  | Bakit                                                                          |
| ----------------------------------------------------- | ------------------------------------------------------------------------------ |
| Opisyal ang plugin                                    | Walang commission ang sariling mga plugin ng Reverie                           |
| Ginagamit mo ang sarili mong plugin                   | Walang pagbabayad sa sarili                                                    |
| Walang prompt template ang plugin                     | Walang kinikita ang mga interactive plugin — wala silang idinadagdag sa prompt |
| Buong binayaran ang mensahe gamit ang libreng credits | Zero ang bahaging bayad                                                        |

> **Hindi kailanman kumikita ng commission ang mga interactive plugin.** Kung mahalaga sa iyo ang kumita,
> gumawa ng prompt o tool plugin — iyon ang dalawang uri na nag-aambag ng
> text sa prompt.

## Pagtanggap ng bayad \[#getting-paid]

Naiipon ang mga commission bilang nakabinbing credits at sine-settle **buwan-buwan, tuwing ika-1**. Kung mas mababa sa **100 credits** ang nakabinbin mong balanse sa settlement, walang ibabayad sa buwang iyon at ililipat ang balanse sa susunod.

Ipinapakita ng **Tingnan ang Kita** sa tab na **Akin** ang **Kabuuang Kinita**, **Nakabinbin**, **Ngayong Buwan** at **Susunod na Settlement**, isang breakdown kada plugin na may kita, bilang ng paggamit at petsa ng huling paggamit, at ang history ng iyong mga settlement.

## Kaugnay \[#related]

* [Paggamit ng mga plugin](https://reverie.im/fil/docs/plugins/using-plugins) — paano nakikita ng mga nag-i-install ang gawa mo
* [Pangkalahatang-ideya ng mga plugin](https://reverie.im/fil/docs/plugins) — ang tatlong uri, magkakatabi
* [Mga pinagkukunan ng kita](https://reverie.im/fil/docs/creators/revenue-streams) — ang iba pang paraan ng pagkita ng mga creator
* [Credits](https://reverie.im/fil/docs/billing/credits) — ano ang credit at paano pinepresyuhan ang mga mensahe
