Plugin

Un plugin è codice JavaScript che gira quando un messaggio parte o torna. Usalo per riscrivere testo, tenere contatori o iniettare note nel prompt.

I plugin sono globali: una volta attivato, un plugin gira in ogni chat. Gestiscili sotto Plugin nel menu della chat. Incolla il codice o importa un file .js.

Registra un gestore per uno di questi quattro momenti:

input request output display

Il gestore riceve il testo e restituisce la sostituzione. Non restituire nulla lo lascia invariato.

uno.registerHandler("output", (text) => {
  return text.replace(/\bcolour\b/g, "color");
});

Gli handler girano in ordine e non bloccano mai una risposta. Quello che genera un errore o supera i cinque secondi viene saltato, e passa il testo originale.

Dentro un gestore l'oggetto uno legge e scrive la conversazione. Ogni chiamata restituisce una promise.

const name = await uno.getName();
const last = await uno.getUserLastMessage();
await uno.setChatVar("mood", "curious");
const mood = await uno.getChatVar("mood");

L'insieme completo copre i messaggi della chat, i campi di personaggio e persona, le variabili della chat, le voci del lorebook, l'espansione delle macro, il conteggio dei token e una richiesta https con limite di frequenza.

Gli script scritti per JanitorAI girano così come sono, con lo stesso oggetto context. Qualsiasi cosa lascino in character.personality e character.scenario diventa il prompt di quel turno.

if (context.chat.last_message.toLowerCase().indexOf("storm") !== -1) {
  context.character.scenario += "\nA storm is rolling in.";
}

Valgono anche le loro regole: lo stato si azzera a ogni turno, quindi riscrivi nello scenario tutto ciò che vuoi conservare.

I plugin vengono eseguiti in un frame isolato, senza accesso a chat, file, cookie o al tuo accesso. Non possono leggere la pagina né fare richieste di rete proprie.

Tutto ciò che un plugin raggiunge passa dall'API descritta sopra. Comunque, installa solo codice di cui ti fidi: un plugin può riscrivere ciò che invii e ciò che leggi.