TauriTavern for Mac

SillyTavern 的原生应用 —— 桌面与移动，开箱即用

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

下载 · 文档 · Releases · Issues

感谢 @shiyue137 为 TauriTavern 设计 Logo ?

下载

自动识别你的设备 · 一键获取最新稳定版

全部平台下载 · GitHub Releases

? 使用包管理器安装（Windows · macOS · Linux）

Windows · WinGet

在 PowerShell 中运行：

Windows · Scoop

在 PowerShell 中运行：

macOS · Homebrew

在终端中运行：

Linux

Arch Linux · AUR

使用你喜欢的 AUR 助手安装 tauritavern-bin：

该软件包由 @LX2000WASD 维护，感谢他在 TauriTavern-aur 中的持续维护贡献！

Debian · Ubuntu · Fedora · openSUSE · NixOS

脚本会自动识别系统并选择合适的安装方式，也支持其他已经安装 Nix 的 Linux。

稳定版

Nix / NixOS

已经安装 Nix 的用户可以直接加入当前用户 profile：

Flatpak

Canary

Canary 版本每天更新，包含最新功能和修复，但稳定性可能不如稳定版。如果你希望体验最新版本，或在稳定版中遇到问题，可以先尝试 Canary，确认问题是否已经修复。

Windows、macOS 和移动平台可从 Canary Release 下载。

Linux Canary 安装

Linux

Nix / NixOS [!TIP] iOS 用户：通过 TestFlight 公开外测 安装，需要 iOS 15.0 或更高版本。iOS 15.0–16.3 仅提供有限支持，完整支持从 iOS 16.4 开始。请注意 TestFlight 版本需要遵守苹果的 TestFlight 规则，存在使用限制。 Windows 便携版（Portable）：需系统已安装 WebView2 运行时。 鸿蒙用户（Beta）：Release 里的 HAP 适用于 HarmonyOS NEXT。请使用自己的证书签名安装，推荐使用 Auto-Installer（小白调试助手）。当前仅在模拟器上进行过测试。

这是什么

TauriTavern 把 SillyTavern 移植为真正的原生应用：前端完整保留上游体验（已同步 1.19.0），后端从 Node.js 重构为 Rust（Tauri v2）。

不需要安装 Node.js，不需要命令行，安装即用。你的角色卡、聊天记录、预设、世界书与前端扩展，全部兼容。 注：TauriTavern 是独立维护的开源项目，并非 SillyTavern 官方客户端。TauriTavern 完全免费且开源，遵循 AGPL-3.0 许可协议。请在使用前仔细阅读许可条款。

特性亮点 ?️ 全平台原生：Windows、macOS、Linux、Android、iOS，桌面与移动同一份体验；原生鸿蒙版当前处于 Beta 支持。 ? 完整 SillyTavern 体验：前端同步上游 1.19.0，数据格式与目录布局完全兼容 ? 前端扩展生态：内置原生 Git，安装、更新、切换分支都在界面内完成（不支持上游 Node-only 后端插件） ? 内置多设备同步：局域网加密配对同步，或经远端 TT-Sync v2 自动上传 ? Agent 框架：工具调用、Skills、子代理与运行时间线，持续演进中 ? 一键迁移：SillyTavern 数据导出脚本 + 应用内导入，平滑搬家 ⚡ 性能工程：分阶段启动、聊天虚拟DOM加载，超长聊天记录依然流畅 ? 数据自主：数据完全保存在本地，支持便携模式

截图

架构速览

本项目 Rust 后端是遵循 Clean Architecture 的 Cargo workspace（src-tauri/crates/）： tauritavern：Tauri host、命令层与组合根 tt-application · tt-ports · tt-domain · tt-contracts：用例、端口、领域模型与跨 crate 契约 tt-adapter-*：存储、HTTP、媒体、同步、扩展、分词等具体实现

前端为上游 SillyTavern + 模块化 Tauri 注入层（src/tauri/main/），经 window.__TAURITAVERN__ 平台 ABI 与 Rust 后端通信。详情请见 docs/BackendStructure.md 与 docs/FrontendGuide.md。

? 开发与构建（前置要求 · 常用命令 · Tauri Pilot · 便携构建 · FasTools）

前置要求：Rust stable（支持 edition 2024）· Node.js 22.13+ · pnpm 11 · Tauri CLI

常用命令：

Tauri Pilot（AI Agent 界面调试）

项目已接入 Tauri Pilot 的开发专用插件与权限。它让 AI Agent 通过可访问性快照检查和操作桌面端、Android 与 iOS 模拟器中的 WebView；普通开发与发行命令不会启用这项能力。

应用启动后，在另一终端按以下顺序操作：

交互前先取得 snapshot，每次只执行一个操作；异步更新后使用 wait，并优先用 assert 验证结果。支持 MCP 的 Agent 可将 tauri-pilot mcp 注册为 stdio server。

便携版构建：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/：已落地模块的实现状态

贡献

欢迎 Issue 与 PR。提交前请阅读 CONTRIBUTING.md。除紧急修复外，PR 请以 dev 为目标分支。

致谢与许可