🤖 RisuAI Bot Tester

GitHub Copilot, Claude, ChatGPT 등 AI 어시스턴트와 함께 RisuAI 봇을 쉽게 제작하는 웹 기반 개발 툴

코파일럿과 같은 CLI 혹은 IDE의 LLM을 활용하여 대화형으로 봇의 설정, 정규식, 로어북, CBS 스크립트를 작성하고 테스트할 수 있습니다. 복잡한 설정 파일을 직접 편집할 필요 없이 자연어로 AI에게 요청하여 봇을 완성할 수 있습니다.

✨ 주요 기능

• 🎯 AI 친화적 개발: GitHub Copilot, Cursor, Continue 등 IDE AI 도구와 완벽 호환
• 💬 Chat: editinput → editoutput → editdisplay 플로우 실시간 테스트
• 🔧 Regex: 정규식 스크립트 작성 및 즉시 검증
• 📚 Lorebook: 로어북 항목 관리 및 키워드 매칭 시뮬레이션
• ⚙️ CBS: RisuAI의 {CBS} 문법 실시간 실행 및 디버깅

🚀 시작하기

사전 준비

1. Node.js 설치 (v18 이상 권장)

   • Node.js 공식 사이트에서 다운로드

2. pnpm 설치

   npm install -g pnpm

설치 방법 (VS Code 예시)

1. RisuAI 메인 프로젝트 클론

   git clone https://github.com/kwaroran/RisuAI
   cd RisuAI

2. Bot Tester 프로젝트 클론

   # RisuAI 폴더 내부에서 실행
   git clone https://github.com/tammy3211/RisuAI_bot_test

3. VS Code로 RisuAI 폴더 열기

   code .

4. 의존성 설치

   터미널 열기 (`Ctrl + `` 또는 상단 메뉴 → 터미널 → 새 터미널)

   # RisuAI 메인 프로젝트 의존성 설치
   pnpm install
   
   # Bot Tester 프로젝트로 이동 후 의존성 설치
   cd RisuAI_bot_test
   pnpm install

5. 개발 서버 실행

   pnpm dev

6. 브라우저에서 접속

   • http://localhost:3000 자동으로 열림

📖 사용 방법

1. 새로운 봇 만들기

save/ 폴더에 원하는 봇 이름으로 폴더를 생성합니다:

save/
└── 내봇이름/
    ├── description.md      # 봇 설명 및 기본 설정
    ├── regex/
    │   └── regex.json      # 정규식 규칙
    └── lorebook/
        └── lorebook.json   # 로어북 항목

2. AI 어시스턴트와 함께 봇 개발하기

GitHub Copilot 사용 예시:

1. 봇 폴더의 description.md 파일을 엽니다

2. Copilot Chat을 실행 (Ctrl + I 또는 Cmd + I)

3. 자연어로 요청합니다:

   "판타지 세계관의 마법사 캐릭터를 만들어줘.
   이름은 아리사이고 불 마법을 전문으로 해."
   

4. Regex 탭에서 정규식 추가:

   "사용자가 '마법'이라고 말하면 '주문'으로 바꿔줘"
   

5. Lorebook 탭에서 세계관 추가:

   "아카데미라는 키워드가 나오면 '마법 아카데미는 300년 전통의...'
   이라는 설명을 추가해줘"
   

3. 테스트하기

• Chat 탭: 실제 대화를 시뮬레이션하며 User의 Input과 AI의 Output을 실험해볼 수 있습니다
• Lorebook 탭: 키워드 트리거를 테스트하고 컨텍스트 삽입 및 프롬프트 순서를 확인합니다
• Regex 탭: 패턴 매칭을 즉시 확인하고 수정합니다.
• CBS 탭: {CBS} 실행 결과를 실시간으로 확인합니다

4. 봇 구조

save/내봇이름/
├── description.md        # 봇 설명 및 기본 설정
├── first_mes.md          # 봇의 첫 메시지
├── assets/
│   ├── icon/             # 봇 아이콘 에셋
│   ├── other/            # 아이콘 외 기타 에셋
│   └── assets.json       # 에셋 정보 (자세한 내용은 assets.md 참고)
├── lorebook/
│   ├── content/          # 로어북 content 내용
│   └── lorebook.json     # 로어북 정보 (자세한 내용은 lorebook.md 참고)
├── regex/
│   ├── out/              # regex script의 out 내용
│   └── regex.json        # regex script 정보 (자세한 내용은 regex.md 참고)
└── triggerscript/
    ├── backgroundDOM.md  # 봇의 'backgroundembedding' 내용
    └── lua_script/
        └── main.lua      # 봇의 Lua 스크립트 (자세한 내용은 lua.md 참고)

📁 프로젝트 구조

RisuAI_bot_test/
├── docs/                  # Agent를 위한 .md 파일
├── lib/                   # Svelte UI 컴포넌트
│   ├── chat/              # 채팅 시뮬레이터 UI
│   ├── regex/             # 정규식 에디터 & 테스터
│   ├── lorebook/          # 로어북 관리 인터페이스
│   ├── cbs/               # CBS 스크립트 에디터
│   ├── shared/            # 공통 컴포넌트 (BotList, 로더 등)
│   └── UI/                # 재사용 가능한 UI 요소
├── ts/                    # RisuAI 핵심 모듈 (from main project)
│   ├── ChatParser.ts      # 채팅 메시지 파싱
│   ├── regexProcessor.ts  # 정규식 처리
│   ├── lorebookRunner.ts  # 로어북 매칭 로직
│   └── mockDatabase.ts    # 로컬 스토리지 DB 인터페이스
├── save/                  # 봇 데이터 저장소
│   ├── Airisu(example)/   # 샘플 봇
│   └── [YourBot]/         # 사용자 봇
├── template/default       # 봇 기본 탬플릿
├── public/                # 정적 리소스
│   └── lua/               # Lua 스크립트 지원
├── App.svelte             # 메인 앱
├── main.ts                # 앱 엔트리 포인트
└── vite.config.ts         # Vite 설정

🛠️ 기술 스택

• Frontend: Svelte 5 (Runes API)
• Language: TypeScript
• Styling: Tailwind CSS
• Build Tool: Vite
• Package Manager: pnpm

🙏 Thanks To

• RisuAI

📄 라이센스

이 프로젝트는 MIT License로 배포됩니다.

RisuAI 메인 프로젝트와 동일한 라이센스를 따릅니다.

🔗 관련 링크

• RisuAI 메인 프로젝트

---