문서 검색...

문서를 검색하려면 입력을 시작하세요

채팅 가이드

트리거와 Lua

모든 메시지 주위를 도는 자동화.

트리거는 캐릭터에 붙는 이벤트 기반 스크립트입니다. 채팅 시작 때나 메시지 전후에 발동하며, 기록을 읽고, 변수를 설정하고, 시스템 텍스트를 주입하고, 전송을 멈출 수 있습니다.

스크립트 형식은 RisuAI 트리거 스크립트 v2와 호환되는 들여쓰기 명령을 쓰므로, 기존 카드의 자동화가 그대로 들어와 동작합니다.

저수준 접근 권한이 있는 스크립트는 채팅 밖으로 닿는 효과를 엽니다:

runLLM checkSimilarity extractRegex runImgGen showAlert sendAIprompt triggerlua

LLM과 이미지 효과는 실제 모델을 호출하고 토큰을 씁니다. 로그인이 필요하며 사용자의 계정을 통해 실행됩니다.

트리거 VM을 넘는 로직이 필요하면 캐릭터가 Lua를 담을 수 있습니다. 런타임은 약 50개의 함수를 제공합니다: 채팅 접근, 변수, 알림, 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 훅은 처리 도중에 텍스트를 고쳐 씁니다: 조립 전 입력, 저장 전 출력, 전송 전 원본 요청.

훅은 같은 단계의 정규식 스크립트와 순서대로 실행됩니다. 전체 파이프라인의 결과는 요청 로그에서 확인하세요.

표시 모드와 요청 모드의 스크립트는 제한된 명령 집합의 샌드박스에서 실행됩니다. 스크립트는 계정, 키, 다른 대화에 손댈 수 없습니다. 최악이라도 자기 대화를 어지럽히는 정도입니다.