winget install --id=TauriTavern.TauriTavern -e TauriTavern ports the SillyTavern frontend to a native application and replaces its Node.js backend with a Rust backend built on Tauri.
感谢 @shiyue137 为 TauriTavern 设计 Logo 💛
📦 使用包管理器安装（Windows · macOS · Linux）
在 PowerShell 中运行：
winget install --id TauriTavern.TauriTavern
在 PowerShell 中运行：
scoop bucket add Darkatse https://github.com/Darkatse/Scoop-Darkatse.git
scoop install Darkatse/TauriTavern
在终端中运行：
brew install --cask tauritavern
Arch Linux · AUR
使用你喜欢的 AUR 助手安装 tauritavern-bin：
yay -S tauritavern-bin
该软件包由 @LX2000WASD 维护，感谢他在 TauriTavern-aur 中的持续维护贡献！
Debian · Ubuntu · Fedora · openSUSE · NixOS
脚本会自动识别系统并选择合适的安装方式，也支持其他已经安装 Nix 的 Linux。
稳定版
curl -fsSL https://get.tauritavern.com/linux.sh | sh
Nix / NixOS
已经安装 Nix 的用户可以直接加入当前用户 profile：
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，确认问题是否已经修复。
Windows、macOS 和移动平台可从 Canary Release 下载。
Linux Canary 安装
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 版本需要遵守苹果的 TestFlight 规则，存在使用限制。 > > Windows 便携版（Portable）：需系统已安装 WebView2 运行时。
TauriTavern 把 SillyTavern 移植为真正的原生应用：前端完整保留上游体验（已同步 1.18.0），后端从 Node.js 重构为 Rust（Tauri v2）。
不需要安装 Node.js，不需要命令行，安装即用。你的角色卡、聊天记录、预设、世界书与前端扩展，全部兼容。
> 注：TauriTavern 是独立维护的开源项目，并非 SillyTavern 官方客户端。TauriTavern 完全免费且开源，遵循 AGPL-3.0 许可协议。请在使用前仔细阅读许可条款。
本项目 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
git clone https://github.com/Darkatse/TauriTavern.git
cd TauriTavern
pnpm install
常用命令：
pnpm run check # 前端 guardrails/类型/契约 + Rust dev check
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（AI Agent 界面调试）
项目已接入 Tauri Pilot 的开发专用插件与权限。它让 AI Agent 通过可访问性快照检查和操作桌面端 WebView；普通开发与发行命令不会启用这项能力。
cargo install tauri-pilot-cli # 仅首次需要
pnpm run tauri:dev:pilot
应用启动后，在另一终端按以下顺序操作：
tauri-pilot ping
tauri-pilot snapshot -i
tauri-pilot click @e3 # 使用当前 snapshot 返回的 ref
tauri-pilot diff -i
tauri-pilot logs --level error
交互前先取得 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。
欢迎 Issue 与 PR。提交前请阅读 CONTRIBUTING.md。除紧急修复外，PR 请以 dev 为目标分支。
基于 SillyTavern 与 Tauri 构建，并感谢 Cocktail、Tavern-Helper、LittleWhiteBox、MikTik，以及维护 TauriTavern AUR 软件包 的 @LX2000WASD。
以 AGPL-3.0 许可发布（与 SillyTavern 同系列许可协议）。
我们尽力用爱打造 ❤️ —— TauriTavern 团队