# Tạo plugin > Dựng một plugin, đưa nó qua xét duyệt, và kiếm tiền từ phần prompt nó góp vào. Source: https://reverie.im/vi/docs/plugins/creating-plugins Language: vi Ai đã đăng nhập cũng viết được plugin. Mở một cuộc trò chuyện, vào thẻ **Plugin** của bảng bên, rồi bấm **Tạo Plugin**. Trình soạn dắt bạn qua ba bước: **Loại**, **Thông tin cơ bản** và **Cấu hình**. ## Chọn một loại \[#pick-a-type] Trong bốn loại plugin, bạn tạo được ba. Loại thứ tư chỉnh các thiết lập lấy mẫu của mô hình và thuộc về Reverie. | Loại | Bạn viết gì | Giới hạn | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Plugin Prompt** | Một mẫu prompt viết bằng Handlebars, được nối vào sau prompt hệ thống của nhân vật | Mẫu tối đa 100.000 ký tự | | **Plugin Công cụ** | Một mẫu prompt, cộng thêm định nghĩa công cụ: tên, mô tả, tham số đầu vào, cấu trúc đầu ra, và một mẫu thẻ HTML/CSS tùy chọn | Tên công cụ bắt đầu bằng chữ cái, chỉ dùng chữ cái, chữ số và gạch dưới, tối đa 64 ký tự; mô tả tối đa 2.000; mẫu thẻ và kiểu dáng mỗi thứ tối đa 100.000 | | **Plugin Tương tác** | Một định danh, cộng ít nhất một trong: nút kích hoạt kèm biểu mẫu, một mặt do AI tạo, hoặc một công cụ mà AI gọi được | Định danh tối đa 80 ký tự, chữ cái/chữ số/gạch nối/gạch dưới, bắt đầu bằng chữ cái hoặc chữ số | Loại thì sau đó không đổi được — **Loại plugin không thể thay đổi khi chỉnh sửa**. > Plugin công cụ không thực hiện yêu cầu mạng nào. Khi mô hình gọi công cụ của > bạn, chính mô hình bịa ra các đối số, còn cấu trúc đầu ra và mẫu thẻ của bạn > chỉ sắp những giá trị bịa ấy lại để hiển thị. Hãy viết những công cụ trình bày > thông tin — bảng trạng thái, thanh đo, túi đồ, gieo xúc xắc — chứ đừng viết > công cụ tự nhận là đi tra cứu cái gì đó. ## Điền phần thông tin cơ bản \[#fill-in-the-basics] **Tên Plugin** là bắt buộc, tối đa 100 ký tự. **Mô tả (Tùy chọn)** tối đa 1.000. Ở đây có hai công tắc, và chúng độc lập với nhau — bạn có thể bật một, bật cả hai, hoặc không bật cái nào: | Công tắc | Tác dụng | | ---------------------------------- | ------------------------------------------------------------------------------------------------- | | **Công khai Plugin** | Gửi phiên bản đó đi xét duyệt. Duyệt xong, nó được liệt kê trong thẻ **Cộng đồng** cho mọi người. | | **Liên kết với Nhân vật Hiện tại** | Giới hạn plugin trong các cuộc trò chuyện với nhân vật mà bạn đang ở cùng. | Một trang do AI tạo gồm hai phần. **Yêu cầu nội dung** là một mẫu giống như mẫu lời nhắc: có thể dùng cùng các trình giữ chỗ như `{{char}}`, `{{user}}` và `{{date}}`, cùng mọi cài đặt bạn mở cho người cài, và cho biết mỗi trang chứa gì, bằng giọng của ai. **Vỏ ứng dụng** chính là trang — HTML, CSS và JavaScript cùng một lược đồ nội dung — được viết một lần và dùng cho mọi trang: AI chỉ viết nội dung, còn vỏ vẽ nội dung đó và xử lý thao tác chạm, lá bài và trạng thái trên thiết bị của người đọc. Hãy tự viết vỏ hoặc nhấn **Viết bằng AI**; phần xem trước chạy vỏ trên nội dung mẫu ngay trong lúc vỏ còn đang được viết. Khi đã có vỏ, **Sửa bằng AI** nhận điều bạn muốn thay đổi và chỉnh lại vỏ hiện tại thay vì làm lại từ đầu, còn **Hoàn tác** khôi phục phiên bản trước lần chạy AI gần nhất. Plugin có trang do AI tạo không thể lưu nếu thiếu vỏ; plugin đã xuất bản trước khi có vỏ vẫn chạy như cũ, và sẽ cần một vỏ vào lần tới bạn chỉnh sửa. Vỏ chạy trong một môi trường cách ly: không thể truy cập mạng, tải tệp hay tập lệnh từ bên ngoài, hay can thiệp vào phần còn lại của ứng dụng. Hình ảnh đến từ chính cuộc trò chuyện (chân dung hoặc ảnh bìa của nhân vật, ảnh đại diện của người đọc, ảnh của bối cảnh hoặc khoảnh khắc), trang không thể trỏ tới bất kỳ đâu khác. Thông qua cuộc trò chuyện, một trang có thể gửi một câu với tư cách người đọc, đưa ra một chỉ dẫn cảnh để nhân vật diễn tiếp, nhờ cuộc trò chuyện rút một kết quả ngẫu nhiên, mở một trang khác, tự viết lại tại chỗ, hoặc đóng lại, và có thể giữ lại những gì người đọc đã làm trên đó — một lá bài đã rút, một ghi chú đã để lại — để chúng vẫn còn khi trang được mở lại. Thời gian hiện tại và bối cảnh thế giới của nhân vật được cung cấp tự động. ## Bắt đầu từ một ví dụ \[#start-from-an-example] **Tải ví dụ** mở ra một danh mục các điểm khởi đầu — Động lực mối quan hệ, Thiết lập bối cảnh, Sổ tri thức / Kho ký ức, Bảng trạng thái nhân vật, Thước đo tình cảm, Xúc xắc / Kiểm tra kỹ năng, Nhảy thời gian, Nhật ký nhân vật, Suy nghĩ nội tâm, Thật hay Thách và nhiều nữa, xếp theo nhóm. Đây là mẫu dành cho trình soạn, không phải plugin mà ai đó đã cài. Chọn một cái sẽ điền sẵn các trường cấu hình để bạn sửa từ một thứ vốn đã chạy được; chẳng có gì trong đó được chia sẻ hay đăng lên cho tới khi bạn lưu và đăng plugin của chính mình. ## Để AI viết bản nháp \[#let-ai-draft-it] Loại nào cũng có trợ thủ AI — **Tạo bằng AI** cho một mẫu prompt có biến, và những thứ tương đương cho cấu hình công cụ lẫn cấu hình tương tác. Bạn tả điều mình muốn trong một hai câu, trình soạn điền các trường. Với plugin tương tác có trang do AI tạo, sau đó nó còn viết luôn **Vỏ ứng dụng**. Những thiết lập bạn mở ra cho người cài cũng điền được theo cách ấy, từ **AI điền cấu hình**. Mỗi lần tạo đều tốn tín dụng. ## Xem trước và Gỡ lỗi là hai chuyện khác nhau \[#preview-and-debug-are-different] | | **Xem trước** | **Gỡ lỗi** | | ----------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | Nó làm gì | Dựng mẫu của bạn bằng các giá trị thử bạn gõ vào — tên nhân vật mặc định là *Alice*, tên người dùng là *User* | Chạy thật bản nháp chưa lưu, với nhân vật của cuộc trò chuyện mà bạn mở trình soạn từ đó | | Nó cho thấy gì | Prompt sinh ra, prompt hệ thống, và phần đầu ra đã dựng | Câu trả lời của nhân vật, đầu ra công cụ đã dựng, vết thực thi, mô hình, thời lượng, token | | Dùng bối cảnh nào | Chỉ các chỗ giữ chỗ | Một bản chụp của nhân vật, kịch bản, persona, ký ức, các tin nhắn gần đây và những plugin đang bật | | Chi phí | Miễn phí | Miễn phí — không trừ tín dụng | | Hạn mức | Không giới hạn | 30 lượt mỗi 3 giờ; hộp thoại hiện số lượt còn lại | Gỡ lỗi còn chặn tin nhắn thử ở 1.000 ký tự và cấu hình thử ở 50.000 ký tự. Plugin công cụ chỉ gỡ lỗi được trên mô hình có hỗ trợ gọi công cụ. ## Đăng và xét duyệt \[#publishing-and-review] Lưu một plugin riêng tư là dùng được ngay — bởi chính bạn — và nó được cài vào cuộc trò chuyện mà bạn đã tạo nó từ đó. Bật **Công khai Plugin** thì thay vào đó phiên bản ấy đi vào xét duyệt: 1. Thẻ hiện **Chờ duyệt** trong thẻ **Của tôi** của bạn, và không ai khác cài được nó. 2. Một lượt kiểm tra sơ bộ tự động chạy theo lịch và ghi lại phán quyết của nó. 3. Rồi một người duyệt hoặc từ chối. Plugin được duyệt hiện **Đã duyệt** và xuất hiện trong thẻ **Cộng đồng**. Bước kiểm tra sơ bộ đọc mã của **Vỏ ứng dụng** cùng với phần còn lại của plugin và có thể tự mình duyệt hoặc từ chối plugin. Với plugin quá dài để đọc kỹ toàn bộ — thường là plugin có vỏ lớn — bước kiểm tra này vẫn có thể từ chối, nhưng chỉ người mới duyệt được. Sửa một plugin đã duyệt sẽ tạo ra phiên bản mới, và nó lại đi qua xét duyệt — thẻ trở về **Chờ duyệt**, còn phiên bản được duyệt trước đó vẫn chạy cho tất cả những ai đã cài nó. > Mỗi lần lưu đều đóng băng một bản sao không đổi được của plugin, kèm cả phần > dịch. Mỗi lượt cài chạy đúng bản sao mà nó đã ghim, nên người cài phiên bản 2 > vẫn ở phiên bản 2 cho tới khi họ bấm cập nhật. Thứ nhân vật mang sẵn chỉ được > ghim một phiên bản đã qua xét duyệt. ## Bạn kiếm được gì \[#what-you-earn] Khi người khác dùng plugin của bạn trong một tin nhắn trả phí, bạn kiếm được **5% chi phí tín dụng của đoạn chữ mà chính plugin của bạn thêm vào prompt** — không phải 5% của tin nhắn. Số tiền là: số token prompt của riêng plugin, nhân với hệ số tín dụng của mô hình, nhân 5%, rồi co lại theo phần của tin nhắn ấy được trả bằng tín dụng trả phí. Không có gì phát sinh khi: | Trường hợp | Vì sao | | -------------------------------------------------- | -------------------------------------------------------------------- | | Plugin là plugin chính thức | Plugin của chính Reverie không trả hoa hồng | | Bạn dùng plugin của chính mình | Không có chuyện tự trả cho mình | | Plugin không có mẫu prompt | Plugin tương tác chẳng kiếm được gì — chúng không thêm gì vào prompt | | Tin nhắn được trả hoàn toàn bằng tín dụng miễn phí | Phần trả phí bằng không | > **Plugin tương tác không bao giờ nhận hoa hồng.** Nếu bạn để tâm tới chuyện > kiếm tiền, hãy làm plugin prompt hoặc plugin công cụ — đó là hai loại góp chữ > vào prompt. ## Nhận tiền \[#getting-paid] Hoa hồng dồn lại thành tín dụng đang chờ và được thanh toán **hằng tháng, vào ngày 1**. Nếu tới lúc thanh toán mà số dư đang chờ của bạn dưới **100 tín dụng** thì tháng ấy không chi trả, và số dư dồn sang tháng sau. **Xem thu nhập** trong thẻ **Của tôi** hiện **Tổng thu nhập**, **Đang chờ**, **Tháng này** và **Lần thanh toán tiếp theo**, một bảng tách theo từng plugin với doanh thu, số lượt dùng và ngày dùng gần nhất, cùng lịch sử thanh toán của bạn. ## Liên quan \[#related] * [Dùng plugin](https://reverie.im/vi/docs/plugins/using-plugins) — người cài nhìn thấy công sức của bạn ra sao * [Plugin](https://reverie.im/vi/docs/plugins) — ba loại đặt cạnh nhau * [Các nguồn thu](https://reverie.im/vi/docs/creators/revenue-streams) — những cách kiếm tiền khác của người tạo * [Tín dụng](https://reverie.im/vi/docs/billing/credits) — tín dụng là gì và tin nhắn được tính giá thế nào