본문으로 건너뛰기

개발자

이 섹션은 NeoTavern이 어떻게 구축되었는지, 그리고 플러그인, 테마, 프로바이더 어댑터로 어떻게 확장할 수 있는지 설명합니다.

이 섹션에서 다루는 내용

개발자 문서는 네 그룹으로 나뉩니다.

  • 아키텍처 — 모노레포 구조, 승인된 기술 스택, 각 워크스페이스 패키지의 역할.
  • 프롬프트 파이프라인 — 채팅을 프로바이더 요청으로 바꾸는 고정된 단계 집합. 인스트럭트 포맷, 토큰화, 컨텍스트 시프팅을 포함합니다.
  • 데이터 및 저장소 — NeoTavern이 구조화된 데이터를 SQLite에 저장하는 방식, 파일과 이미지가 디스크에서 처리되는 방식, 백업 동작 방식.
  • NeoTavern 확장 — Plugin SDK, Theme SDK, 프로바이더 어댑터, 자동 생성 API 레퍼런스, 데스크톱 셸.

어디서 시작할까

코드베이스의 구조를 이해하고 싶다면 아키텍처 개요부터 시작하고, 생성 동작을 작업한다면 프롬프트 파이프라인으로 바로 가세요.

데이터 계층

데이터 및 저장소 섹션은 SQLite 데이터베이스, 파일 시스템 구조, 백업 모델을 다룹니다. 데이터를 영속화하는 모든 것의 레퍼런스입니다.

NeoTavern 확장

NeoTavern은 네 가지 방식으로 확장됩니다.

  • Plugin SDK — 매니페스트, 권한, 프론트엔드 및 백엔드 API, 라이프사이클 훅, 샌드박싱이 있는 플러그인.
  • Theme SDK — 디자인 토큰, 컴포넌트 스킨, 셸 레이아웃으로 만드는 테마.
  • 프로바이더 — 통합 어댑터 계약을 구현하는 프로바이더 어댑터.
  • 레거시 호환성 — SillyTavern 시대 플러그인과 스크립트를 위한 호환 계층.

API 레퍼런스는 모든 사이트 빌드에서 TypeDoc이 SDK 소스로부터 생성하므로, 멤버 페이지는 항상 게시된 패키지와 일치합니다.

데스크톱

데스크톱 섹션은 Tauri 2 셸, Node.js 사이드카, 설치 프로그램과 포터블 빌드의 패키징 방식을 문서화합니다.