Перейти к основному содержимому

Разработчикам

В этом разделе объясняется, как устроен NeoTavern и как вы можете расширять его плагинами, темами и адаптерами провайдеров.

Что охватывает этот раздел​

Документация разработчика разбита на четыре группы:

  • Архитектура — структура монорепозитория, утверждённый стек технологий и обязанности каждого пакета рабочей области.
  • Конвейер промптов — фиксированный набор этапов, превращающих чат в запрос к провайдеру, включая instruct-форматы, токенизацию и контекст-шифтинг.
  • Данные и хранилище — как NeoTavern хранит структурированные данные в SQLite, как файлы и изображения обрабатываются на диске и как работают резервные копии.
  • Расширение NeoTavern — Plugin SDK, Theme SDK, адаптеры провайдеров, генерируемый справочник API и десктопная оболочка.

С чего начать​

Начните с Обзора архитектуры, если хотите понять форму кодовой базы, или сразу переходите к Конвейеру промптов, если работаете над поведением генерации.

Слой данных​

Раздел Данные и хранилище охватывает базу данных SQLite, структуру файловой системы и модель резервных копий. Это справочник по всему, что сохраняет данные.

Расширение NeoTavern​

NeoTavern расширяется четырьмя способами:

  • Plugin SDK — плагины с манифестом, разрешениями, frontend- и backend-API, хуками жизненного цикла и песочницей.
  • Theme SDK — темы, построенные из дизайн-токенов, скинов компонентов и макетов оболочки.
  • Провайдеры — адаптеры провайдеров, реализующие единый контракт адаптера.
  • Совместимость с наследием — слой совместимости для плагинов и скриптов эпохи SillyTavern.

Справочник API генерируется из исходников SDK инструментом TypeDoc при каждой сборке сайта, поэтому его страницы участников всегда соответствуют опубликованным пакетам.

Десктоп​

Раздел Десктоп документирует оболочку Tauri 2, sidecar на Node.js и то, как упаковываются установщики и портативные сборки.