聊天指南
觸發器與 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 可註冊在傳輸途中改寫文字的掛鉤:組裝前的你的輸入、保存前的模型輸出,以及傳送前的原始請求。
掛鉤與同階段的正規表示式腳本按順序運行;用請求記錄查看整條管線的最終結果。
安全
顯示與請求腳本模式運行在命令集受限的沙箱中。腳本無法觸及你的帳戶、金鑰或其他對話;一個壞腳本最多也只能攪亂它自己的聊天。