문서 검색...

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

채팅 가이드

트리거와 Lua

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

트리거 스크립트

트리거는 캐릭터에 붙는 이벤트 기반 스크립트입니다. 채팅 시작이나 메시지 전후에 발동하며, 기록 읽기, 변수 설정, 시스템 텍스트 주입, 전송 중지가 가능합니다.

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

저수준 효과

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

runLLM checkSimilarity extractRegex runImgGen showAlert sendAIprompt triggerlua

LLM과 이미지 효과는 실제 모델을 호출하고 토큰을 씁니다. 로그인이 필요하며 당신 계정으로 실행됩니다.

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