TauriTavern/README.ru.md

TauriTavern

SillyTavern в виде нативного приложения для компьютеров и мобильных устройств

简体中文 · English · 日本語 · Русский · Português (Brasil)

Скачать · Документация · Релизы · Задачи

_{Спасибо @shiyue137 за логотип TauriTavern 💛}

Скачать

Определяет ваше устройство автоматически · последняя стабильная сборка в один клик

Все платформы · Релизы на GitHub

📦 Установка через менеджер пакетов (Windows · macOS · Linux)

Windows · WinGet

Выполните в PowerShell:

winget install --id TauriTavern.TauriTavern

Windows · Scoop

Выполните в PowerShell:

scoop bucket add Darkatse https://github.com/Darkatse/Scoop-Darkatse.git
scoop install Darkatse/TauriTavern

macOS · Homebrew

Выполните в терминале:

brew install --cask tauritavern

Linux

Arch Linux · AUR

Установите tauritavern-bin с помощью предпочитаемого AUR-помощника:

yay -S tauritavern-bin

Этот пакет поддерживает @LX2000WASD. Благодарим его за постоянную работу над TauriTavern-aur.

Debian · Ubuntu · Fedora · openSUSE · NixOS

Скрипт определит вашу систему и выберет подходящий способ установки. Он также работает в других дистрибутивах Linux, если в них установлен Nix.

Стабильная версия

curl -fsSL https://get.tauritavern.com/linux.sh | sh

Nix / NixOS

Если Nix уже установлен, добавьте TauriTavern прямо в профиль пользователя:

nix profile add github:Darkatse/TauriTavern#tauritavern

Flatpak

flatpak remote-add --user --if-not-exists \
  tauritavern \
  https://flatpak.tauritavern.com/tauritavern.flatpakrepo
flatpak install --user tauritavern com.tauritavern.client

Canary

Canary обновляется ежедневно и включает новые функции и исправления, но может быть менее стабильной, чем стабильная версия. Если вы хотите попробовать последнюю сборку или столкнулись с проблемой в стабильной версии, проверьте, исправлена ли эта проблема в Canary.

Сборки для Windows, macOS и мобильных платформ доступны в разделе Canary Release.

Установка Canary в Linux

Linux

curl -fsSL https://get.tauritavern.com/linux.sh \
  | sh -s -- --channel canary

Nix / NixOS

nix profile add github:Darkatse/TauriTavern/Canary#canary

Tip

iOS: установите приложение через открытое тестирование в TestFlight. Требуется iOS 15.0 или новее. Для iOS 15.0–16.3 предоставляется ограниченная поддержка; полная поддержка начинается с iOS 16.4. На тестовые сборки распространяются правила и ограничения TestFlight.

Портативная версия для Windows: в системе должен быть установлен WebView2 Runtime.

Что такое TauriTavern

TauriTavern переносит SillyTavern в нативное приложение. Фронтенд сохраняет возможности исходного проекта и синхронизирован с версией 1.19.0, а бэкенд переписан с Node.js на Rust с использованием Tauri v2.

Устанавливать Node.js и работать с командной строкой не нужно: достаточно скачать и запустить приложение. Карточки персонажей, чаты, пресеты, информация о мире и расширения фронтенда совместимы с SillyTavern.

Примечание: TauriTavern — независимо поддерживаемый проект с открытым исходным кодом, а не официальный клиент SillyTavern. Он распространяется бесплатно по лицензии AGPL-3.0. Перед использованием ознакомьтесь с условиями лицензии.

Основные возможности

• 🖥️ Пять нативных платформ: Windows, macOS, Linux, Android и iOS с единым пользовательским интерфейсом
• 🎭 Совместимость с SillyTavern: фронтенд синхронизирован с версией 1.19.0, форматы данных и структура каталогов совместимы с исходным проектом
• 🧩 Расширения фронтенда: встроенный нативный Git позволяет устанавливать и обновлять расширения, а также переключать ветки прямо в интерфейсе (плагины бэкенда, рассчитанные только на Node.js, не поддерживаются)
• 🔄 Синхронизация между устройствами: зашифрованное сопряжение по локальной сети или автоматическая отправка через удалённый TT-Sync v2
• 🤖 Agent Framework: вызов инструментов, Skills, субагенты и временная шкала выполнения; разработка продолжается
• 📦 Перенос данных: скрипты экспорта из SillyTavern и импорт внутри приложения
• ⚡ Работа с длинными чатами: поэтапный запуск и виртуализация DOM чата сохраняют плавную работу интерфейса даже в очень длинных беседах
• 🔒 Данные остаются у вас: всё хранится на устройстве; при необходимости доступен портативный режим

Снимки экрана

Кратко об архитектуре

Бэкенд на Rust организован как рабочее пространство Cargo (src-tauri/crates/) по принципам Clean Architecture:

• tauritavern: оболочка Tauri, слой команд и корень композиции
• tt-application · tt-ports · tt-domain · tt-contracts: сценарии использования, порты, доменные модели и контракты между crate
• tt-adapter-*: реализации хранилища, HTTP, мультимедиа, синхронизации, расширений и токенизации

Фронтенд состоит из исходного SillyTavern и модульного слоя интеграции с Tauri (src/tauri/main/). Он взаимодействует с бэкендом на Rust через платформенный ABI window.__TAURITAVERN__. Подробнее см. в docs/BackendStructure.md и docs/FrontendGuide.md.

🛠 Разработка (требования · основные команды · Tauri Pilot · портативные сборки · FasTools)

Требования: Rust stable (edition 2024) · Node.js 22.13+ · pnpm 11 · Tauri CLI

git clone https://github.com/Darkatse/TauriTavern.git
cd TauriTavern
pnpm install

Основные команды:

pnpm run check         # проверки фронтенда, типов, контрактов и Rust-кода
pnpm run web:build     # сборка фронтенда с помощью Rspack
pnpm run tauri:dev     # режим разработки для компьютера
pnpm run tauri:build   # сборка установщиков для компьютера
pnpm run android:dev   # режим разработки Android
pnpm run ios:dev       # режим разработки iOS

Tauri Pilot (разработка интерфейса с помощью ИИ-агентов)

В проект входит плагин Tauri Pilot с разрешениями, доступными только при разработке. Он позволяет ИИ-агенту проверять и управлять содержимым WebView на компьютере, в Android и в симуляторе iOS через снимки доступности. Обычные команды разработки и сборки релизов его не включают.

cargo install tauri-pilot-cli  # требуется только один раз
pnpm run tauri:dev:pilot       # компьютер
pnpm run android:dev:pilot     # Android: сначала перенаправьте сокет, см. docs/AndroidDevelopment.md
pnpm run ios:dev:pilot         # симулятор iOS

После запуска приложения откройте другой терминал и выполните основные шаги:

tauri-pilot ping
tauri-pilot snapshot -i
tauri-pilot click @e3          # используйте ref из текущего снимка
tauri-pilot diff -i
tauri-pilot logs --level error

Перед взаимодействием сделайте снимок и выполняйте по одному действию за раз. После асинхронных обновлений используйте wait, а для проверки отдавайте предпочтение assert. Агент с поддержкой MCP может зарегистрировать tauri-pilot mcp как stdio-сервер.

Портативные сборки: pnpm run tauri:build:portable (результат сохраняется в release/). Чтобы принудительно включить портативный режим, задайте TAURITAVERN_RUNTIME_MODE=portable или создайте файл portable.flag.

FasTools: рекомендуемый набор инструментов для разработки и диагностики развёртывания. Сборка выполняется командой pnpm run fastools:build, запуск — pnpm run fastools:run.

Подробности для отдельных платформ приведены в docs/AndroidDevelopment.md и docs/iOSDevelopment.md.

Документация

• 📖 Документация на сайте: руководства на китайском и английском языках по использованию, Agent, архитектуре, API и загрузке
• docs/FrontendGuide.md: архитектура фронтенда и руководство по расширениям
• docs/FrontendHostContract.md: публичный контракт слоя хоста
• docs/BackendStructure.md: Clean Architecture бэкенда и границы crate
• docs/CurrentState/: текущее состояние реализованных модулей

Участие в разработке

Мы принимаем сообщения о проблемах и Pull Request. Перед началом прочитайте CONTRIBUTING.md. Если исправление не срочное, выбирайте целевой веткой dev.

Благодарности и лицензия

Проект основан на SillyTavern и Tauri. Благодарим авторов Cocktail, Tavern-Helper, LittleWhiteBox, MikTik, а также @LX2000WASD за поддержку пакета TauriTavern для AUR.

Проект распространяется по лицензии AGPL-3.0, которая относится к тому же семейству лицензий, что и лицензия SillyTavern.

_{Сделано командой TauriTavern с вниманием к деталям ❤️}