搜尋文件...

開始輸入以搜尋文件

聊天指南

觸發器與 Lua

圍繞每則訊息運行的自動化。

觸發腳本

觸發器是掛在角色上的事件驅動腳本。它們在聊天開始時或訊息前後觸發,能讀取歷史、設定變數、注入系統文字或停止一次傳送。

腳本格式使用與 RisuAI 觸發腳本 v2 相容的縮排式命令,因此現有卡片的自動化可匯入並運行。

低階效果

擁有低階存取權限的腳本解鎖能伸出聊天之外的效果:

runLLM checkSimilarity extractRegex runImgGen showAlert sendAIprompt triggerlua

LLM 與圖像效果會呼叫真實模型並消耗 token;它們需要登入並經由你的帳戶運行。

Lua 腳本

對於超出觸發器 VM 的邏輯,角色可攜帶 Lua。內嵌執行環境公開約 50 個函式的 API:聊天存取、變數、提醒、LLM 呼叫等,與 RisuAI 的 Lua 介面相容。

lua
onOutput = async(function(triggerId)
  local msg = getChat(triggerId, -1)
  if string.find(msg.data, "secret") then
    alertNormal(triggerId, "Secret mentioned!")
  end
end)
listenEdit("editoutput", function(triggerId, data)
  return data:gsub("%s+$", "")
end)

編輯掛鉤

Lua 可註冊在傳輸途中改寫文字的掛鉤:組裝前的你的輸入、保存前的模型輸出,以及傳送前的原始請求。

掛鉤與同階段的正規表示式腳本按順序運行;用請求記錄查看整條管線的最終結果。

安全

顯示與請求腳本模式運行在命令集受限的沙箱中。腳本無法觸及你的帳戶、金鑰或其他對話;一個壞腳本最多也只能攪亂它自己的聊天。

UnoRouter 中的觸發腳本與 Lua